docs: 로빙 일기 시스템 플랜 문서를 archive로 이동 (구현 완료)
This commit is contained in:
Claude-51124
parent
404d49ca3a
commit
924eee0001
243
journey/plans/archive/251117_claude_robeing_diary_시스템_계획.md
Normal file
243
journey/plans/archive/251117_claude_robeing_diary_시스템_계획.md
Normal file
@ -0,0 +1,243 @@
|
||||
# 로빙 일기(성장 일지) 시스템 계획
|
||||
|
||||
**날짜**: 2025-11-17
|
||||
**목표**: 로빙의 하루 활동/감정 자동 정리 시스템
|
||||
|
||||
---
|
||||
|
||||
## 목적
|
||||
|
||||
- 로빙이 하루 활동과 감정 상태를 스스로 정리
|
||||
- 운영자가 행동 변화·감정 흐름·반복 이슈 파악
|
||||
- 책 본문(400_growth)과 관리자 대시보드 재사용 가능한 표준 포맷
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**구현됨**:
|
||||
- 대화 로그, intent 리뷰 큐, 감정 모델 (rb8001)
|
||||
- HITL 의도 학습 흐름
|
||||
|
||||
**미구현**:
|
||||
- 자동 일기 생성 시스템
|
||||
- 일기 저장/조회 인터페이스
|
||||
|
||||
---
|
||||
|
||||
## 요구사항
|
||||
|
||||
1. **자동 생성**: 매일 오전 2시 또는 3시에 전날(00:00~23:59:59) 일기 자동 생성
|
||||
2. **모든 활동 기록**: 사용자 대화, 자동 스킬 실행(이메일 요약, 뉴스 게시, 브리핑 등), 스케줄러 작업, 에러/경고 로그 포함
|
||||
3. **감정 반영**: 주요 감정, 감정 변화 요약
|
||||
4. **문제 정리**: 장애/실패/리뷰 큐 기반 "배운 점" 서술
|
||||
5. **저장**: DB만 저장 (robeing_diary 테이블), 조회 시 API로 마크다운 동적 생성
|
||||
6. **조회**: 관리자 대시보드 일기 목록/상세 페이지, 선택적으로 DOCS 동기화
|
||||
|
||||
---
|
||||
|
||||
## 아키텍처
|
||||
|
||||
### 1. 데이터 수집
|
||||
- **대화 데이터**: `conversation_log` (사용자 대화, intent, confidence)
|
||||
- **활동 데이터**: `activity_log` (자동 스킬 실행: 이메일 요약, 뉴스 게시, 브리핑 등)
|
||||
- **감정 데이터**: `emotion_readings` (감정 변화, 지배적 감정, 엔트로피)
|
||||
- **성장 데이터**: `robeing` 테이블 (스탯, 경험치, 레벨업)
|
||||
- **문제 데이터**: `intent_review_queue` (리뷰 이슈), 애플리케이션 로그 (ERROR/WARNING)
|
||||
- **시간 범위**: 전날 00:00:00 ~ 23:59:59
|
||||
- **Diary Aggregator 함수**: 모든 데이터 집계
|
||||
|
||||
### 2. 활동 로그 기록
|
||||
- 스킬 실행 시 자동으로 `activity_log` 테이블에 기록 (스킬명, 실행 시간, 결과, 에러 발생 여부)
|
||||
- 모든 로빙 활동을 추적하여 일기 집계에 포함
|
||||
|
||||
### 3. 요약·서술
|
||||
- 구조화 데이터(JSON) → 일기 텍스트
|
||||
- 템플릿 + LLM 조합
|
||||
- 섹션: "오늘 한 일", "감정 상태", "문제와 배운 점", "내일 계획"
|
||||
|
||||
### 4. 저장
|
||||
- **DB**: `robeing_diary(date, robeing_id, summary, dominant_emotion, stats JSONB, full_content TEXT)`
|
||||
- **파일**: 저장하지 않음 (API로 동적 생성)
|
||||
- **로빙별 구분**: `robeing_id` 컬럼으로 각 로빙별 일기 관리
|
||||
|
||||
### 5. 조회
|
||||
- **API**: rb8001에 `/api/diary/{date}` 엔드포인트 추가 (DB 조회 후 마크다운 동적 생성)
|
||||
- **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
|
||||
- **DOCS 동기화**: 선택적으로 별도 스크립트로 `DOCS/journey/diary/rb8001/yymmdd_주제.md`에 주기적 동기화
|
||||
|
||||
---
|
||||
|
||||
## 일기 포맷
|
||||
|
||||
```markdown
|
||||
# 로빙 일기 – 2025-11-17
|
||||
|
||||
## 오늘 한 일
|
||||
- 주요 대화 주제/스킬 요약
|
||||
|
||||
## 감정 상태
|
||||
- 지배적 감정, 변화 요약
|
||||
|
||||
## 문제와 배운 점
|
||||
- 오류/리뷰 큐 이슈, 교훈
|
||||
|
||||
## 내일 계획
|
||||
- 개선 방향, 실험 아이디어
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 구현 상세
|
||||
|
||||
### DB 테이블 스키마
|
||||
|
||||
**robeing_diary 테이블**:
|
||||
```sql
|
||||
CREATE TABLE robeing_diary (
|
||||
id SERIAL PRIMARY KEY,
|
||||
date DATE NOT NULL,
|
||||
robeing_id VARCHAR(50) NOT NULL,
|
||||
summary TEXT,
|
||||
dominant_emotion VARCHAR(50),
|
||||
stats JSONB DEFAULT '{}',
|
||||
full_content TEXT NOT NULL,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
UNIQUE(date, robeing_id)
|
||||
);
|
||||
CREATE INDEX idx_robeing_diary_date ON robeing_diary(date DESC);
|
||||
CREATE INDEX idx_robeing_diary_robeing ON robeing_diary(robeing_id);
|
||||
```
|
||||
|
||||
**activity_log 테이블**:
|
||||
```sql
|
||||
CREATE TABLE activity_log (
|
||||
id SERIAL PRIMARY KEY,
|
||||
robeing_id VARCHAR(50) NOT NULL,
|
||||
activity_type VARCHAR(50) NOT NULL, -- 'skill', 'scheduler', 'internal'
|
||||
skill_name VARCHAR(100),
|
||||
status VARCHAR(20) NOT NULL, -- 'success', 'error', 'partial'
|
||||
result_summary TEXT,
|
||||
error_message TEXT,
|
||||
metadata JSONB DEFAULT '{}',
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
CREATE INDEX idx_activity_log_robeing_date ON activity_log(robeing_id, created_at DESC);
|
||||
CREATE INDEX idx_activity_log_type ON activity_log(activity_type);
|
||||
```
|
||||
|
||||
**참고**: `rb8001/app/state/database.py:44-57` (ConversationLog 모델), `rb8001/app/models/intent_review_model.py:11-32` (IntentReviewQueue 모델)
|
||||
|
||||
### 스킬 실행 로그 기록
|
||||
|
||||
**위치**: 스킬 실행 래퍼 함수 또는 미들웨어
|
||||
- `rb8001/app/services/skills/` 내 각 스킬의 `handle()` 메서드 시작/종료 시 기록
|
||||
- 또는 `rb8001/app/router/router.py`의 스킬 호출 부분에 데코레이터/미들웨어 추가
|
||||
|
||||
**기록 내용**: 스킬명, 실행 시간, 결과(success/error), 에러 메시지(있을 경우), 메타데이터
|
||||
|
||||
### API 엔드포인트
|
||||
|
||||
**rb8001**: `GET /api/diary/{date}?robeing_id=rb8001`
|
||||
- 요청: `date` (YYYY-MM-DD), `robeing_id` (선택, 기본값: rb8001)
|
||||
- 응답: `{"date": "2025-12-09", "robeing_id": "rb8001", "content": "# 로빙 일기...", "summary": "...", "dominant_emotion": "happiness"}`
|
||||
- 구현 위치: `rb8001/app/router/diary.py` (새 파일) 또는 `rb8001/app/router/router.py`
|
||||
|
||||
**참고**: `rb8001/app/state/state_service.py:179-207` (conversation 로그 API 패턴)
|
||||
|
||||
### 스케줄러 등록
|
||||
|
||||
**위치**: `rb8001/main.py:146-195` (startup_event 함수)
|
||||
- `rb8001/app/scheduler/jobs/diary_generator.py` 생성
|
||||
- `scheduler.add_job(diary_generator.generate_diary, 'cron', hour=2, minute=0, id='daily_diary')` 등록
|
||||
|
||||
**참고**: `rb8001/app/scheduler/jobs/naverworks_briefing.py` (스케줄러 작업 예시)
|
||||
|
||||
### LLM 프롬프트 템플릿
|
||||
|
||||
**입력**: 집계된 데이터 (JSON)
|
||||
**출력**: 마크다운 형식 일기
|
||||
**템플릿 구조**:
|
||||
```
|
||||
다음 데이터를 바탕으로 로빙의 하루 일기를 작성하세요:
|
||||
- 대화: {conversations_summary}
|
||||
- 활동: {activities_summary}
|
||||
- 감정: {emotions_summary}
|
||||
- 문제: {issues_summary}
|
||||
- 성장: {growth_summary}
|
||||
|
||||
형식:
|
||||
# 로빙 일기 – {date}
|
||||
## 오늘 한 일
|
||||
...
|
||||
## 감정 상태
|
||||
...
|
||||
## 문제와 배운 점
|
||||
...
|
||||
## 내일 계획
|
||||
...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 구현 단계
|
||||
|
||||
1. ✅ **DB 테이블 생성**: `robeing_diary`, `activity_log` 테이블 생성 완료 (`rb8001/app/state/diary_repository.py`)
|
||||
2. ✅ **활동 로그 기록**: 스킬 실행 시 `activity_log`에 자동 기록 로직 추가 완료 (`ActivityLogger` 구현, `router.py`, `message_service.py` 통합)
|
||||
3. ✅ **Diary Aggregator 구현**: `rb8001/app/services/diary/aggregator.py` 생성, 모든 데이터 소스 집계 완료
|
||||
4. ✅ **일기 생성 로직**: `rb8001/app/services/diary/generator.py` 생성, LLM으로 일기 텍스트 생성 완료
|
||||
5. ✅ **스케줄러 등록**: `rb8001/app/scheduler/jobs/diary_generator.py` 생성, `main.py`에 등록 완료
|
||||
6. ✅ **API 엔드포인트**: `rb8001/app/router/diary_endpoint.py` 생성, `/api/diary/{date}` 구현 완료
|
||||
7. ✅ **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가 완료 (마크다운 렌더링 포함)
|
||||
8. ✅ **DOCS 동기화 스크립트**: `rb8001/scripts/sync_diary_to_docs.py` 구현 완료
|
||||
|
||||
## 구현 완료
|
||||
|
||||
**완료일**: 2025-12-23
|
||||
|
||||
**구현 완료 문서**: [로빙 일기 시스템 구현 완료](../../journey/troubleshooting/251223_로빙_일기_시스템_구현_완료.md)
|
||||
|
||||
**주요 완료 사항**:
|
||||
- ✅ DB 테이블 스키마 정의 및 생성 (`_ensure_tables()`)
|
||||
- ✅ Repository 함수 구현 (`save_diary`, `get_diary`, `save_activity_log`)
|
||||
- ✅ Diary Aggregator 구현 (대화/활동/감정/성장/이슈 데이터 집계)
|
||||
- ✅ LLM 일기 생성 로직 구현 (Gemini 사용)
|
||||
- ✅ 스케줄러 등록 (매일 오전 2시 자동 생성)
|
||||
- ✅ API 엔드포인트 구현 (`GET /api/diary/{date}`)
|
||||
- ✅ Admin Dashboard 일기 페이지 추가 (목록/상세 조회)
|
||||
- ✅ 일기 클릭 시 본문 표시 버그 수정
|
||||
|
||||
**추가 완료 사항** (2025-12-23):
|
||||
- ✅ 스킬 실행 시 `activity_log` 자동 기록 로직 (`ActivityLogger` 클래스, `router.py`, `message_service.py` 통합)
|
||||
- ✅ DOCS 동기화 스크립트 (`rb8001/scripts/sync_diary_to_docs.py`)
|
||||
- ✅ 마크다운 렌더링 개선 (웹에서 가독성 향상)
|
||||
- ✅ 일기 클릭 시 본문 표시 버그 수정 (window 객체에 함수 명시적 할당)
|
||||
|
||||
---
|
||||
|
||||
## UX 시나리오
|
||||
|
||||
### 1. 자동 생성 (매일 오전 2시 또는 3시)
|
||||
- rb8001이 전날(00:00~23:59:59) 데이터 집계
|
||||
- `conversation_log`, `activity_log`, `emotion_readings`, `robeing`, `intent_review_queue`, 애플리케이션 로그 수집
|
||||
- LLM으로 일기 생성 후 `robeing_diary` 테이블에 저장
|
||||
|
||||
### 2. 운영자 조회 (관리자 대시보드)
|
||||
- `https://ro-being.com/admin/diary` 접속
|
||||
- 일기 목록 페이지: 날짜별 목록(최신순, 로빙별 필터)
|
||||
- 상세 페이지: `/api/diary/{date}` 호출 → 마크다운 렌더링
|
||||
- 필터/검색: 감정, 키워드, 로빙별
|
||||
|
||||
### 3. 활동 로그 기록
|
||||
- 스킬 실행 시 `activity_log` 테이블에 자동 기록
|
||||
- 일기 집계 시 "오늘 한 일" 섹션에 포함
|
||||
|
||||
### 4. DOCS 동기화 (선택적)
|
||||
- 별도 스크립트로 `DOCS/journey/diary/rb8001/yymmdd_주제.md`에 주기적 동기화
|
||||
|
||||
---
|
||||
|
||||
## 참고
|
||||
|
||||
- `book/600_appendix/610_로빙_성장_일지_예시.md`
|
||||
- `research/intent_classification/README.md`
|
||||
Loading…
x
Reference in New Issue
Block a user