# 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 (기억 저장소)
```

## 실습 과제
1. `docker ps`로 내 컨테이너 상태 확인하기
2. PostgreSQL에서 내 레벨 정보 조회하기
3. ChromaDB에서 최근 기억 검색하기

## 성능 지표
- 응답 시간: < 2초 (목표)
- 메모리 사용량: < 1GB (임베딩 제외)
- 동시 처리: 5개 요청

## 다음 단계
Part 4 [[../400_growth/README|성장과 진화]]에서 이 아키텍처 위에서 어떻게 성장하는지 학습하세요.

## 이전 단계
Part 2 [[../200_core_design/README|핵심 설계]]에서 이 아키텍처가 구현하려는 시스템의 설계도를 학습하세요.
