DOCS/journey/troubleshooting/250730_happybell80_프로젝트문서일관성수정.md
Claude-51124 22557e7132 docs: 오래된 트러블슈팅 아카이브 및 구조 정리
- 7-8월 초기 구축 문서 12개를 _archive/troubleshooting/2025_07-08_initial_setup/로 이동
- book/300_architecture/390_human_in_the_loop_intent_learning.md를 journey/research/intent_classification/로 이동 (개발 여정 문서)
- 빈 폴더 제거 (journey/assets/*)
2025-11-17 14:06:05 +09:00

53 lines
2.1 KiB
Markdown

# 250730 프로젝트 문서 일관성 수정
## 문제 상황
프로젝트 문서들 간에 심각한 논리적 불일치가 발견됨:
1. **스킬 아키텍처 충돌**: skillhub_architecture.md는 Python 패키지 기반 플러그인 시스템을 설명하지만, 실제 구현은 HTTP API 기반 마이크로서비스
2. **데이터베이스 구현 격차**: 설계 문서는 PostgreSQL + ChromaDB + Neo4j + Redis를 명시하지만, 실제로는 PostgreSQL + ChromaDB만 운영 중
3. **스탯 시스템 불일치**: PRD는 5종 스탯(기억/연산/반응/공감/통솔), 종합 문서는 4+1 스탯(윤리 추가)으로 혼재
## 해결 방안
happybell80님의 방향성 확인:
- 실제 구현(HTTP API 마이크로서비스)이 맞음
- Neo4j, Redis도 추가 예정
- 스탯은 5종(기억/연산/공감/통솔/윤리) - 반응 제외
## 수정 작업
### 1. skillhub_architecture.md
- 전면 개편: Python 플러그인 → HTTP API 마이크로서비스
- 현재 구현 상태 반영 (skill-email:8501, skill-news:8505)
- Docker 기반 배포 구조 명시
### 2. 00_아키텍쳐.md
- Polyglot Persistence 섹션 수정
- PostgreSQL, ChromaDB: "(현재 운영 중)"
- Neo4j, Redis: "(구현 예정)"
### 3. PRD.md
- 5종 스탯으로 통일 (반응 제외, 윤리 추가)
- 데이터베이스에 Neo4j, Redis 추가 (계획 표시)
### 4. 00_프로젝트_종합_v2.md
- "4+1 핵심 스탯" → "5종 핵심 스탯"
- 데이터베이스 구현 상태 명시
- 버전 2.2로 업데이트
### 5. robeing_stats_growth_design.md
- 4종 → 5종 스탯으로 수정
- 윤리 스탯 성장 단계 추가:
- 1~10: 안전 체크, 공정성 검토
- 11~20: 편향 경고, 위험 방지
- 21~30: 도덕적 판단, 선행 체크
## 결과
모든 문서가 현재 구현 상태와 일치하도록 수정 완료. 향후 계획(Neo4j, Redis)도 명확히 표시.
## 교훈
프로젝트 진행 중 방향성이 바뀔 때는 관련 문서를 즉시 업데이트해야 함. 특히 아키텍처 문서는 실제 구현과 항상 동기화되어야 함.
## 담당자
- 요청: happybell80
- 작업: admin (51123 서버)
- 일시: 2025-07-30 09:30 KST