ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
DOCS/000_프로젝트_종합_v3.md
happybell80 725ad0876c fix: 문서 파일 실행 권한 제거 
- 모든 .md, .html 파일 권한을 644로 정상화
- .gitignore 파일 권한도 644로 수정
- 문서 파일에 실행 권한은 불필요하고 보안상 바람직하지 않음
- deprecated 아이디어 폴더 생성 및 레벨별 UI 변경 아이디어 이동
2025-08-18 00:37:51 +09:00

360 lines
13 KiB
Markdown
Raw Blame History

---
tags: 로빙, RO-BEING, 존재에이전트, 마이크로서비스, 스탯시스템, 협업도구, AI에이전트
date: 2025-01-01
last_updated: 2025-08-08
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 │ │
│ │(테스트) │ │(미디어) │ │(메인) │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 스킬 서비스: │
│ ┌─────────┐ ┌─────────┐ ┌──────────┐ │
│ │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 R as rb10508(51124)
participant E as Embedding
participant DB as PostgreSQL
participant C as ChromaDB
U->>S: 메시지 입력
S->>N: Webhook 전달
N->>R: 요청 라우팅
R->>DB: 스탯/레벨 조회
R->>E: 텍스트 임베딩
E-->>R: 384차원 벡터
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.01.31)
### 완료된 기능
1. **인프라**
- Docker 기반 컨테이너 아키텍처
- Gitea Actions CI/CD 파이프라인
- nginx 리버스 프록시 (SSL)
- 2서버 분리 운영 (51123/51124)
2. **핵심 기능**
- Slack 실시간 대화 인터페이스
- PostgreSQL + ChromaDB 하이브리드 메모리
- 기본 스킬: email, news, pdf_summary
- 스탯 시스템 기초 구현
3. **운영 중 서비스**
- rb8001 (테스트용)
- rb10408 (미디어 특화)
- rb10508 (메인 프로덕션)
- skill-email (Gmail 연동)
- skill-news (뉴스 큐레이션)
- skill-embedding (중앙 임베딩 서비스)
### 최근 성과 (2025년 8월)
#### 메모리 최적화 대성공
- **임베딩 서비스 분리**: 중앙 서비스(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 기반 아키텍처**: 마이크로서비스 간 느슨한 결합
#### 운영 지표
- 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*
Reference in New Issue View Git Blame Copy Permalink