DOCS/README.md

# 로빙(RO-BEING) 프로젝트 문서

> 기억하고 성장하는 존재형 AI 에이전트의 모든 것

## 문서 구조

이 문서는 **개발 블로그**이자 **책 원고**의 이중 목적으로 작성되었습니다.

### 목차 (로빙: 존재형 에이전트의 탄생)

#### Part 1: 철학과 배경 (100_philosophy)
- [110. 왜 AI에게 존재를 기대하는가?](./100_philosophy/110_왜_AI에게_존재를_기대하는가.md)
- [120. 도구를 넘어 디지털 동료로](./100_philosophy/120_도구를_넘어_디지털_동료로.md)
- [130. 존재형 에이전트란 무엇인가?](./100_philosophy/130_존재형_에이전트란_무엇인가.md)
- [140. 기억, 감정, 윤리의 삼각형](./100_philosophy/140_기억_감정_윤리_삼각형.md)
- [150. 게임적 메타포로 바라본 AI](./100_philosophy/150_게임적_메타포로_바라본_AI.md)

#### Part 2: 핵심 설계 (200_core_design)
- [210. 스탯과 성장 시스템: 레벨 1에서 20까지](./200_core_design/210_스탯과_성장_시스템_레벨1에서_20까지.md)
- [220. 기억 모듈: 정보 엔트로피와 감정 기반 저장](./200_core_design/220_기억모듈_정보엔트로피와_감정기반_저장.md)
- [230. 감정윤리 필터: LLM 후처리와 정체성](./200_core_design/230_감정윤리_필터_LLM후처리와_정체성.md)
- [240. 스킬 시스템: 함수형 자동화와 컨텍스트](./200_core_design/240_스킬시스템_함수형_자동화와_컨텍스트.md)
- [250. 스킬 사례 분석: PDF, 뉴스, 회의](./200_core_design/250_스킬_사례_분석_PDF_뉴스_회의.md)
- [260. 아이템 시스템: 외부도구 통합과 권한 관리](./200_core_design/260_아이템시스템_외부도구_통합과_권한관리.md)

#### Part 3: 기술 아키텍처 (300_architecture)
- [310. 전체 시스템 구조: 컨테이너와 마이크로서비스](./300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md)
- [320. Slack 기반 인터페이스 설계](./300_architecture/320_Slack_기반_인터페이스_설계.md)
- [330. 백엔드: PostgreSQL + ChromaDB Vector Memory](./300_architecture/330_백엔드_PostgreSQL_ChromaDB_Vector_Memory.md)
- [340. GUI 공유 아키텍처: 레벨 기반 권한](./300_architecture/340_GUI_공유_아키텍처_레벨기반_권한.md)
- [350. DID 기반 정체성과 다중 에이전트](./300_architecture/350_DID_기반_정체성과_다중에이전트.md)
- [360. 로빙 컨테이너 경량화 전략](./300_architecture/360_로빙_컨테이너_경량화_전략.md)

#### Part 4: 성장과 진화 (400_growth)
- [410. 레벨업 알고리즘과 사용자 피드백](./400_growth/410_레벨업_알고리즘과_사용자_피드백.md)
- [420. 경험 기반 성장 곡선 설계](./400_growth/420_경험_기반_성장_곡선_설계.md)
- [430. 기억의 망각과 요약: 장기 컨텍스트 최적화](./400_growth/430_기억의_망각과_요약_장기컨텍스트_최적화.md)
- [440. 스카웃 가능한 에이전트란?](./400_growth/440_스카웃_가능한_에이전트란.md)

#### Part 5: 비즈니스와 미래 (500_business)
- [510. 3개월 MVP 개발기: 구조, 일정, 시행착오](./500_business/510_3개월_MVP_개발기_구조_일정_시행착오.md)
- [520. 외부 스타트업과의 PoC 사례](./500_business/520_외부_스타트업과의_PoC_사례.md)
- [530. MMP 이후의 과제: 비용, 확장성, 표준화](./500_business/530_MMP_이후의_과제_비용_확장성_표준화.md)
- [540. SaaS와 GUI 통합 전략](./500_business/540_SaaS와_GUI_통합_전략.md)
- [550. 수익 모델과 비즈니스 전략](./500_business/550_수익모델과_비즈니스_전략.md)

#### Part 6: 부록 (600_appendix)
- [610. 로빙 성장 일지 예시](./600_appendix/610_로빙_성장_일지_예시.md)
- [620. 주요 스킬 및 로그 예시](./600_appendix/620_주요_스킬_및_로그_예시.md)
- [630. 로빙 이력서 및 스카웃 정보 포맷](./600_appendix/630_로빙_이력서_및_스카웃_정보_포맷.md)
- [640. 향후 버전 로드맵](./600_appendix/640_향후_버전_로드맵.md)
- [650. 용어집](./600_appendix/650_용어집.md)

### 번호 체계
- **첫 번째 자리**: Part 번호
- **두 번째 자리**: Chapter 번호
- **세 번째 자리**: Section 번호
- 예: `123_파일명.md` = Part 1, Chapter 2, Section 3

## 프로젝트 현황

- **현재 단계**: MVP 85% 완성
- **운영 중**: 3개 로빙 (rb8001, rb10408, rb10508) + 2개 스킬 서비스 (email, news)
- **기술 스택**: FastAPI, PostgreSQL, ChromaDB, Slack API, Docker
- **서버 구성**: 51123 (메인 서비스), 51124 (컨테이너 운영)
- **다음 목표**: Thread Digest 완성, 레벨업 시스템 구현

## 기존 문서 바로가기

### 철학과 비전
- [AI Agent 차별화 방안](./docs/philosophy/AI%20agent%20차별화%20방안%20제안.md)
- [PERSONOS 인간-에이전트 인터페이스](./docs/philosophy/PERSONOS_인간–에이전트%20인터페이스%20프로토콜%20v1.md)
- [로빙 스탯 성장 설계](./docs/philosophy/robeing_stats_growth_design.md)
- [에이전트 게이미피케이션 시스템](./docs/philosophy/에이전트%20게이미피케이션%20시스템%20통합%20설계.md)

### 아키텍처
- [아키텍처 개요](./docs/architecture/00_아키텍처.md)
- [로빙 아키텍처](./docs/architecture/아키텍처_로빙.md)
- [로빙 컨테이너 아키텍처 설계](./docs/architecture/로빙_컨테이너_아키텍처_설계.md)
- [Nginx 아키텍처](./docs/architecture/Nginx_아키텍처.md)
- [스킬 허브 아키텍처](./docs/architecture/skillhub_architecture.md)
- [경량 버전 제의](./docs/architecture/로빙_아키텍쳐_설계_경량.md)

### 구현 가이드
- [MVP 단계 상세 계획](./docs/implementation/01_MVP%20단계_%20자세한%20계획.md)
- [PRD 문서](./docs/implementation/prd.md)
- [개발 작업 목록](./docs/implementation/tasks.md)

### AI 메모리 시스템
- [AI 에이전트의 장기 기억 관리](./docs/ai-memory/AI%20에이전트의%20장기%20기억%20관리_%20정보%20가치%20판단_신뢰성%20검증_망각과%20효율성%20최적화_by%20grok.md)
- [기억모듈 설계](./docs/ai-memory/기억모듈01.md)
- [로빙 스탯기반 LLM 모델 업그레이드](./docs/ai-memory/로빙_스탯기반_LLM_모델_업그레이드_및_100대_모델_순위.md)

### 스킬과 스탯 시스템
- [에이전트 스탯 스킬 클래스 구조](./docs/skills-stats/에이전트%20스탯%20스킬%20클래스%20구조.md)
- [외부도구 아이템화 및 스마트폰 오버레이](./docs/skills-stats/외부도구_아이템화_및_스마트폰_오버레이_활용방안.md)

### 연구 자료
- [종합 AI 모델 분석 보고서](./docs/research/종합%20AI%20모델%20분석%20보고서_%20전략적%20의사결정을%20위한%20성능,%20비용%20및%20기술%20사양%20비교_by%20Gemini.md)

### 함수형 프로그래밍 아키텍처
- [로빙의 존재와 함수형 프로그래밍](./docs/guide/functional-programing/로빙_존재와_함수형_프로그래밍.md) - 철학적 배경과 점진적 적용 전략
- [함수형 구현 패턴과 사례](./docs/guide/functional-programing/함수형_구현_패턴과_사례.md) - 실제 코드 패턴과 리팩토링 가이드
- [함수형 적용 가이드라인](./docs/guide/functional-programing/함수형_적용_가이드라인.md) - 구성요소별 순수함수 가능성 분석과 실전 적용 기준

### 가치 판단 및 평가 시스템
- [로빙의 가치 판단 아키텍처](./docs/guide/evaluation/00_평가_종합.md) - 4축 가치 판단 시스템과 메타인지 설계
- [평가 시스템 구현 가이드라인](./docs/guide/evaluation/평가_가이드라인.md) - 단계별 구현 계획과 개발자 매뉴얼

### 설정 및 설치 가이드
- [프로젝트 설정 가이드](./docs/setups/setup-guide.md)
- [Slack 설정 최종 가이드](./docs/setups/slack-setup-final.md)
- [Slack 테스트 가이드](./docs/setups/slack-test-guide.md)
- [Socket Mode 테스트 가이드](./docs/setups/socket-mode-test.md)
- [이메일 설정 가이드](./docs/setups/Email_readme.md) - Gmail API 실시간 수신 및 발송 완전 가이드

### 트러블슈팅
- [troubleshooting](./troubleshooting/) - 문제 해결 가이드 모음
  - [GitHub에서 Gitea 마이그레이션](./troubleshooting/20250714_migration_from_github.md)
  - [nginx 프록시 및 CI/CD 배포 문제 해결](./troubleshooting/250728_happybell80_nginx프록시및CI배포문제해결.md) - 51123/51124 서버 배포 이슈

### 외부 참조
- [Slack API 문서](https://api.slack.com/web)
- [OpenAI API 문서](https://platform.openai.com/docs)
- [Gemini API 문서](https://ai.google.dev/docs)
- [FastAPI 문서](https://fastapi.tiangolo.com/)
- [LangChain 문서](https://docs.langchain.com/)

## 문서 활용 가이드

### 프로젝트 이해하기
1. [프로젝트 종합 v2](./00_프로젝트_종합_v2.md) 읽기
2. [철학과 비전](./docs/philosophy/) 문서들 확인
3. [아키텍처](./docs/architecture/) 문서들로 시스템 구조 이해
4. [MVP 상세 계획](./docs/implementation/01_MVP%20단계_%20자세한%20계획.md) 확인

### 개발 환경 구축하기
1. [설정 가이드](./docs/setups/setup-guide.md) 기본 설치
2. [Slack 설정 가이드](./docs/setups/slack-setup-final.md) Slack 연동
3. [테스트 가이드](./docs/setups/slack-test-guide.md) 동작 확인

## 문서 기여 가이드

- 새로운 문서는 적절한 디렉토리에 마크다운(.md) 형식으로 작성
- 문서 추가 시 이 README.md에 링크 추가
- 기술 문서는 코드 예시와 함께 작성 권장