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

2.1 KiB

Raw Blame History

250730 프로젝트 문서 일관성 수정

문제 상황

프로젝트 문서들 간에 심각한 논리적 불일치가 발견됨:

스킬 아키텍처 충돌: skillhub_architecture.md는 Python 패키지 기반 플러그인 시스템을 설명하지만, 실제 구현은 HTTP API 기반 마이크로서비스
데이터베이스 구현 격차: 설계 문서는 PostgreSQL + ChromaDB + Neo4j + Redis를 명시하지만, 실제로는 PostgreSQL + ChromaDB만 운영 중
스탯 시스템 불일치: 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

2.1 KiB Raw Blame History