Spring 측 AI 연동과 Feed 추천의 설계·결정·구현 기록입니다. 이 구역은 AI 파트가 소유합니다. 공용 계약의 단일 원본은 Team-PinLog/docs의 static/05_AI_설계.md이고, 이 구역은 그 계약을 Spring에서 어떻게 구현하는지만 다룹니다.
모든 AI 연동 문서를 관통하는 전제:
동일한 context_id는 항상 동일한 Context 본문을 의미한다.
이 구역은 AI 파트가 작성·관리합니다. back 코드 변경에 수반되는 문서 갱신은 백엔드도 편집할 수 있습니다. 단 troubleshooting/·implements/는 기록 보존 구역입니다. 회고와 복기에서 과거 이력을 추적할 수 있도록, 항목을 삭제하지 말고 상태 표시만 갱신해 주세요. spec/은 현재 유효한 명세이므로 이 보존 제약의 대상이 아닙니다.
| 구역 | 내용 |
|---|---|
spec/ |
설계·구현 명세 — "무엇을 만들 것인가" |
proposals/ |
제안·결정(P 번호) + 미결 — "왜 그렇게 정했나" |
implements/ |
구현 리포트 — "어떻게 만들었나" |
troubleshooting/ |
문제 해결 |
WORKLOG.md |
시간순 작업 로그 |
- AI 연동: ai-integration · context-state-sync · ai-rescan-scheduler · deletion-cancellation · ai-response-assembly
- Feed 추천: feed-recommendation · feed-event · feed-profile-cache · feed-scoring · feed-tests
spec/은 아직 코드가 없는 구현 예정 명세입니다. Feed는 Spring 단독 기능이며 요청 시 FastAPI·LLM·Embedding을 호출하지 않습니다.