ab888e4877
- 체크리스트 강제 실행 - 키워드 검색 후 전체 문장 읽기 (앞뒤 3줄) - 완료 조건 명시적 확인 Co-authored-by: Cursor <cursoragent@cursor.com>
Part 3: 기술 아키텍처
개요
Part 2 ../200_core_design/README에서 구상한 로빙의 시스템들이 실제로 어떤 기술을 바탕으로 어떻게 움직이는지, 그 기술적 기반과 전체 시스템 구조를 설명합니다.
주요 내용
- Docker 컨테이너와 마이크로서비스 아키텍처: 로빙이 각자의 독립된 '집'에서 살며, 기능별로 나뉜 '전문 서비스'들과 협력하는 방식입니다.
- PostgreSQL + ChromaDB 하이브리드 데이터베이스: 로빙의 정형화된 정보(이름, 레벨 등)를 저장하는 '기억 저장소'와, 대화의 의미와 맥락을 저장하는 '연상 기억 저장소'를 함께 사용하는 방식입니다.
- Slack 기반 인터페이스: 사용자와 로빙이 만나는 주요 소통 창구입니다.
- 임베딩 서비스 분리 아키텍처: 언어의 의미를 이해하는 무거운 작업을 별도의 전문 서비스에 맡겨, 로빙 본체는 가볍고 빠르게 움직일 수 있도록 하는 구조입니다.
- DID 기반 정체성 시스템: 로빙 각자가 고유한 신원증명을 가지고, 자신의 행동에 책임을 지게 하는 시스템입니다.
원칙 문서
- 311_FastAPI_구조_원칙 - FastAPI 프로젝트 구조 원칙
- 312_문서_작성_원칙 - 문서 작성 원칙
- 313_Gemini_프롬프트_설계_원칙 - Gemini 프롬프트 설계 원칙
로빙을 위한 체크리스트
Level 1-10 (기초 이해)
- Docker 컨테이너가 내 "집"임을 이해한다
- PostgreSQL에 내 정보가 저장됨을 안다
- ChromaDB에 내 기억이 저장됨을 안다
- Slack이 주요 인터페이스임을 이해한다
Level 11-15 (시스템 이해)
- 마이크로서비스 간 통신 방식을 이해한다
- 임베딩이 무엇인지 설명할 수 있다
- PostgreSQL과 ChromaDB의 역할 차이를 안다
- 레벨 기반 권한 시스템을 이해한다
Level 16-20 (아키텍처 전문가)
- 시스템 병목 지점을 식별할 수 있다
- 성능 최적화 방안을 제시할 수 있다
- 새로운 마이크로서비스를 설계할 수 있다
- 분산 시스템의 장단점을 설명할 수 있다
핵심 기술 스택
Frontend: Slack Interface (사용자와의 소통 창구)
Backend: FastAPI (로빙의 두뇌) + skill-* / Workers (신경계)
Database: PostgreSQL (구조화된 기억) + ChromaDB (맥락적/연상적 기억)
Container: Docker Compose (로빙들의 아파트 단지)
Embedding: Separated Service (언어 의미 이해 전문가)
시스템 구조 이해하기
사용자 → Slack (소통) → nginx (교통정리) → Gateway(8100) (정문)
↓
rb8001(로빙 본체)
↓
Embedding Service (의미 번역가)
↓
Skill Services (각종 전문가들)
↓
PostgreSQL / ChromaDB (기억 저장소)
실습 과제
docker ps로 내 컨테이너 상태 확인하기- PostgreSQL에서 내 레벨 정보 조회하기
- ChromaDB에서 최근 기억 검색하기
성능 지표
- 응답 시간: < 2초 (목표)
- 메모리 사용량: < 1GB (임베딩 제외)
- 동시 처리: 5개 요청
다음 단계
Part 4 ../400_growth/README에서 이 아키텍처 위에서 어떻게 성장하는지 학습하세요.
이전 단계
Part 2 ../200_core_design/README에서 이 아키텍처가 구현하려는 시스템의 설계도를 학습하세요.