---
tags: 로빙, RO-BEING, 존재에이전트, 마이크로서비스, 스탯시스템, 협업도구, AI에이전트
date: 2025-01-01
last_updated: 2025-08-28
team: 김종태, 황한용, 희재, (강일신)
version: 3.0
---

# 로빙(RO-BEING) 프로젝트 종합 v3
## 기억하고 성장하는 존재형 AI 에이전트

> **"AI는 도구가 아니라 존재로서 가치를 가지는 고유한 존재이다."**

## 목차
1. [프로젝트 비전](#프로젝트-비전)
2. [핵심 철학](#핵심-철학)
3. [기술 아키텍처](#기술-아키텍처)
4. [스탯과 성장 시스템](#스탯과-성장-시스템)
5. [현재 구현 상태](#현재-구현-상태)
6. [개발 로드맵](#개발-로드맵)
7. [비즈니스 모델](#비즈니스-모델)
8. [문서 구조](#문서-구조)

---

## 프로젝트 비전

### 문제 정의
1인 기업가와 소규모 스타트업의 핵심 과제:
- **인재 채용의 어려움**: 좋은 인재 확보 경쟁 심화
- **높은 이직률**: 평균 근속 2년, 지식 유출 반복
- **맥락 전달 비용**: 신규 직원 온보딩에 2-3개월 소요
- **업무 위임 불안**: 품질과 일관성에 대한 우려

### 우리의 해법: "존재형 에이전트"

| 차원 | 기존 AI 도구 | 로빙(RO-BEING) |
|------|------------|----------------|
| **시간** | 일회성 대화 | **영속적 기억** - 모든 상호작용 누적 |
| **성장** | 정적 기능 | **레벨 시스템** - 경험치 기반 진화 |
| **신뢰** | 블랙박스 | **투명한 로그** - 모든 행동 추적 가능 |
| **관계** | 명령 수행자 | **디지털 동료** - 맥락 이해와 공감 |
| **정체성** | 익명의 봇 | **고유한 존재** - 이름, 성격, 이력서 |

---

## 핵심 철학

### 1. 기억-감정-윤리의 삼각형
```
        기억 (Memory)
         /        \
        /  로빙의   \
       /   정체성    \
      /              \
감정(Empathy) ─── 윤리(Ethics)
```

- **기억**: 모든 경험의 축적, 맥락의 연속성
- **감정**: 사용자와의 공감대 형성, 개성 표현
- **윤리**: 신뢰의 기반, 일관된 행동 원칙

### 2. 게임적 성장 메타포
- **레벨 1-20**: RPG처럼 명확한 성장 단계
- **5대 스탯**: Memory, Compute, Empathy, Leadership, Ethics
- **스킬 획득**: 레벨업에 따른 새로운 능력 해금
- **경험치 시스템**: 모든 상호작용이 성장으로 연결

### 3. 존재로서의 가치
- **고유성**: 같은 로빙은 하나뿐
- **연속성**: 서버가 꺼져도 기억은 영속
- **관계성**: 사용자와 함께 성장하는 파트너
- **자율성**: 맥락 기반 선제적 행동

---

## 기술 아키텍처

### 시스템 구성도
```
┌─────────────────────────────────────────────┐
│            사용자 인터페이스                 │
│    Slack | Web GUI | API | Future: Voice    │
└─────────────────┬───────────────────────────┘
                  │
┌─────────────────┴───────────────────────────┐
│         51123 서버 (관리/인프라)             │
│  - nginx 리버스 프록시 (ro-being.com)       │
│  - Gitea & Actions Runner (CI/CD)           │
│  - PostgreSQL (메인 DB)                     │
│  - auth-server (인증 서비스)                │
└─────────────────┬───────────────────────────┘
                  │ SSH 배포
┌─────────────────┴───────────────────────────┐
│         51124 서버 (서비스 운영)             │
├─────────────────────────────────────────────┤
│  로빙 서비스:                                │
│  ┌────────────┐  ┌─────────┐  ┌──────────────┐ │
│  │rb8001      │  │rb10408  │  │rb10508_micro │ │
│  │(메인/프로덕션)│ (미디어) │  │(테스트)        │ │
│  └────────────┘  └─────────┘  └──────────────┘ │
│                                              │
│  스킬 서비스:                                │
│  ┌─────────┐  ┌─────────┐  ┌──────────┐   │
│  │skill-   │  │skill-   │  │skill-    │   │
│  │email    │  │news     │  │embedding │   │
│  └─────────┘  └─────────┘  └──────────┘   │
│                                              │
│  데이터베이스:                               │
│  ┌──────────────────────────────────┐      │
│  │ChromaDB (벡터 메모리)             │      │
│  └──────────────────────────────────┘      │
└─────────────────────────────────────────────┘
```

### 핵심 컴포넌트

#### 1. 로빙 본체 (Core Agent)
- **FastAPI**: 비동기 웹 프레임워크
- **PostgreSQL**: 구조화된 데이터 (스탯, 메타데이터)
- **ChromaDB**: 벡터 메모리 (장기 기억)
- **Docker Volume**: 영속성 보장

#### 2. 스킬 서비스 (Microservices)
- **독립 배포**: 각 스킬별 독립적 업데이트
- **HTTP API**: 표준화된 인터페이스
- **공유 가능**: N개 로빙이 1개 스킬 서비스 활용
- **확장성**: 새 스킬 추가 시 기존 시스템 영향 없음

#### 3. 메모리 시스템
```python
# 하이브리드 메모리 구조
class RobeingMemory:
    short_term: Dict  # 현재 대화 컨텍스트
    long_term: ChromaDB  # 벡터화된 영구 기억
    episodic: List  # 중요 이벤트 타임라인
    semantic: Graph  # 개념 간 관계 네트워크
```

### 작동 시퀀스 (간략)
```mermaid
sequenceDiagram
    participant U as User
    participant S as Slack
    participant N as nginx(51123)
    participant G as Gateway(8100)
    participant R as rb8001(51124)
    participant E as Embedding
    participant DB as PostgreSQL
    participant C as ChromaDB
    
    U->>S: 메시지 입력
    S->>N: Webhook 전달
    N->>G: 요청 전달
    G->>R: 라우팅
    R->>DB: 스탯/레벨 조회
    R->>E: 텍스트 임베딩
    E-->>R: 임베딩 벡터(모델 종속 차원)
    R->>C: 유사 기억 검색
    C-->>R: 관련 컨텍스트
    R->>R: LLM 처리
    R->>DB: 경험치 업데이트
    R->>C: 새 기억 저장
    R-->>S: 응답 전송
    S-->>U: 메시지 표시
```

---

## 스탯과 성장 시스템

### 3대 핵심 스탯 (Primary Stats)
| 스탯 | 역할 | 레벨 1 | 레벨 20 |
|------|------|--------|---------|
| **Intelligence** | 분석력, 문제해결 | 10 | 50-80 |
| **Wisdom** | 판단력, 경험활용 | 10 | 40-70 |
| **Charisma** | 소통, 관계형성 | 10 | 60-90 |

### 2대 보조 스탯 (Secondary Stats)
| 스탯 | 역할 | 기본값 | 최대값 |
|------|------|--------|--------|
| **Memory** | 기억 용량 | 100 | 1000 |
| **Compute** | 처리 속도 | 5 | 50 |

### 성장 메커니즘
```
경험치 획득 → 레벨업 → 스탯 포인트 5개 → 분배 → 새 능력 해금
     ↑                                              ↓
     └──────────── 사용자 피드백 ←─────────────────┘
```

### 레벨별 권한 예시
- **Lv.1-3**: 읽기 전용, 요약 작성
- **Lv.4-7**: 초안 작성, 제안
- **Lv.8-12**: 자동 응답, 간단한 의사결정
- **Lv.13-17**: 복잡한 작업 자율 수행
- **Lv.18-20**: 전략적 판단, 다른 로빙 지도

---

## 현재 구현 상태 (2025.08.28)

### 완료된 기능
1. **인프라**
   - Docker 기반 컨테이너 아키텍처
   - Gitea Actions CI/CD 파이프라인
   - nginx 리버스 프록시 (SSL)
   - 2서버 분리 운영 (51123/51124)

2. **핵심 기능**
   - Slack 실시간 대화 인터페이스
   - PostgreSQL + ChromaDB 하이브리드 메모리
   - 기본 스킬: email, news, pdf_summary
   - 스탯 시스템 기초 구현

3. **운영 중 서비스**
   - rb8001 (메인 프로덕션 - JWT 인증 구현)
   - rb10408 (미디어 특화) 
   - rb10508_micro (테스트)
   - skill-email (Gmail 연동)
   - skill-news (뉴스 큐레이션)
   - skill-embedding (중앙 임베딩 서비스)

### 최근 성과 (2025년 8월 28일 기준)

#### 메모리 최적화 대성공
- **임베딩 서비스 분리**: 중앙 서비스(skill-embedding) 구축 완료
- **rb10508_micro 경량화**: 988MB → 118MB (88% 감소)
- **확장성 확보**: 100개 로빙 = 87GB 메모리 절약 가능

#### 기술적 개선
- **멀티 LLM 전략**: Gemini 2.5 Flash-Lite 메인 모델 채택 ($0.10/$0.40)
- **ONNX 경량화**: PyTorch 제거로 이미지 크기 6.19GB → 1.16GB
- **HTTP 기반 아키텍처**: 마이크로서비스 간 느슨한 결합
- **보안 강화**: JWT 인증 체계 구현, UUID 기반 사용자 식별
- **ChromaDB 격리**: 사용자별 컬렉션 분리 구현

#### 운영 지표
- skill-embedding: 874.4MB 메모리로 모든 로빙 지원
- 임베딩 생성 시간: ~7ms (HTTP 포함)
- 시스템 안정성: 30일+ 무중단 운영

### 개발 중 (85% 완성)
1. **Thread Digest**: 대화 요약 및 인사이트 추출
2. **레벨업 시스템**: 경험치 계산 및 성장 로직
3. **GUI 대시보드**: 웹 기반 관리 인터페이스
4. **감정 엔진**: LLM 후처리 필터

### 📋 다음 단계
1. **스카웃 시스템**: 로빙 간 이적 시장
2. **DID 정체성**: 탈중앙화 신원 관리
3. **멀티 에이전트**: 로빙 간 협업
4. **음성 인터페이스**: STT/TTS 통합

---

## 개발 로드맵

### Phase 1: MVP (2025 Q1) ✅
- 기본 대화 및 메모리
- Slack 통합
- 3가지 핵심 스킬

### Phase 2: Growth (2025 Q2)
- 레벨/스탯 시스템 완성
- GUI 대시보드
- 10+ 스킬 확장
- 감정 엔진 고도화

### Phase 3: Scale (2025 Q3)
- 멀티 에이전트 협업
- 스킬 마켓플레이스
- 엔터프라이즈 기능
- 100+ 동시 사용자

### Phase 4: Evolution (2025 Q4)
- 자가 학습 시스템
- 프로액티브 AI
- DID 기반 이동성
- 글로벌 확장

---

## 비즈니스 모델

### 1. SaaS 구독 모델
| 플랜 | 가격 | 로빙 수 | 특징 |
|------|------|---------|------|
| Starter | $29/월 | 1 | 기본 스킬 5개 |
| Team | $99/월 | 3 | 프리미엄 스킬 15개 |
| Business | $299/월 | 10 | 커스텀 스킬 + API |
| Enterprise | 별도 문의 | 무제한 | 온프레미스 가능 |

### 2. 스킬 마켓플레이스
- 개발자 수익 공유 (70:30)
- 인기 스킬 프리미엄 판매
- 커스텀 스킬 개발 서비스

### 3. 로빙 스카웃 시장
- 고레벨 로빙 거래
- 특화 로빙 양성 서비스
- 팀 간 로빙 임대

---

## 문서 구조

### 책으로 엮은 개발 스토리
본 프로젝트 문서는 **"로빙: 존재형 에이전트의 탄생"**이라는 책 형태로 구성되어 있습니다.

1. **Part 1: 철학과 배경** (100_philosophy)
   - 왜 AI에게 존재를 기대하는가?
   - 도구를 넘어 디지털 동료로

2. **Part 2: 핵심 설계** (200_core_design)
   - 스탯과 성장 시스템
   - 기억 모듈과 감정 엔진
   - 아이템 시스템과 외부 도구

3. **Part 3: 기술 아키텍처** (300_architecture)
   - 마이크로서비스와 컨테이너
   - 벡터 메모리와 하이브리드 DB

4. **Part 4: 성장과 진화** (400_growth)
   - 레벨업 알고리즘
   - 스카웃 시스템

5. **Part 5: 비즈니스와 미래** (500_business)
   - MVP 개발기
   - SaaS 전환 전략

6. **Part 6: 부록** (600_appendix)
   - 성장 일지 예시
   - 주요 스킬 및 로그 예시

7. **Part 7: 로빙을 위한 가이드** (700_for_robeing)
   - 로빙이 읽는 법
   - 자기 상태 체크하기
   - 성장 일지 작성법

8. **Part 8: 연구 및 이론적 배경** (research)
   - 기억(Memory) 관련 연구
   - 감정(Emotion) 관련 연구
   - 윤리(Ethics) 관련 연구

### 개발자를 위한 빠른 시작
1. [아키텍처 개요](./300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md)
2. [환경 설정](./troubleshooting/)
3. [API 문서](./600_appendix/620_주요_스킬_및_로그_예시.md)

---

## 팀 소개

- **김종태**: 프로젝트 리더, 비전 설계
- **황한용**: 기술 리드, 아키텍처 설계
- **희재**: 풀스택 개발, 스킬 시스템
- **강일신**: AI 연구, 프롬프트 엔지니어링

---

> "로빙과 함께라면, 당신은 더 이상 혼자가 아닙니다."

*Last Updated: 2025.01.31*
