MinKy Development Plan

이 파일은 해야 할 작업들을 관리합니다. 에이전트는 세션 시작 시 이 파일을 읽고, 작업 추가/완료 시 업데이트합니다.

🎯 다음 세션 우선 작업

✅ 보안 이슈 수정 완료 (2026-02-20)

우선순위 1 - 즉시 수정 필요: ✅ 완료

Document 엔드포인트 인증 추가 (Critical 3건) - 커밋 1e5da9a3
- GET /documents/{id} - AuthUser 추가 + 소유권 확인
- PUT /documents/{id} - AuthUser 추가 + 소유권 확인
- DELETE /documents/{id} - AuthUser 추가 + 소유권 확인

우선순위 2 - 프로덕션 전 수정: ✅ 완료

List 엔드포인트 인증 추가 (High) - 커밋 1e5da9a3
- GET /documents - 사용자 소유 문서 + 공개 문서만 반환
JWT 저장 방식 개선 (High) - 커밋 28fd3bbf
- localStorage → HttpOnly 쿠키로 변경
- XSS 공격 방지 완료

✅ Phase 1-3 완료! Phase 4 준비

Phase 1 (Knowledge Understanding) 완료:

✅ pgvector 설정 및 마이그레이션
✅ Document Understanding 파이프라인
✅ 벡터 임베딩 API (7개 엔드포인트)
✅ RAG 검색 API (3개 엔드포인트)
✅ 프론트엔드 검색 UI
✅ 프론트엔드 채팅 UI
✅ API 문서화

Phase 2 (Real-time Features) 완료:

✅ WebSocket 실시간 연결 (/ws)
✅ Chat 스트리밍 응답 (SSE)
✅ 프론트엔드 스트리밍 UI

Phase 3 (Knowledge Graph Enhancement) 완료 (2026-02-24):

✅ Path Finding - BFS 최단 경로 탐색 (커밋 b2829e36)
✅ Cluster Analysis - Label Propagation 알고리즘 (커밋 acba9ad5)
✅ Timeline View - 날짜 범위 필터링 (커밋 a04a78de)
✅ Graph Export - JSON/CSV 내보내기 (커밋 be39fef8)

Phase 4 (Frontend Enhancement) 완료 (2026-02-24):

✅ 지식 그래프 상세 패널 강화 (커밋 7c9ea5b9)
- 생성일 표시 (상대 시간 + 툴팁)
- 노드 통계 (연결 수, 평균 강도, 문서 수)
- 클러스터 정보 표시
- 빠른 액션 (경로 탐색, 연결 필터, 내보내기)
✅ 문서 목록 대시보드 개선 (커밋 0930033f, 9956d3c3)
- 정렬 옵션 추가 (최근/오래된 업데이트, 제목 A-Z/Z-A)
- 그리드/리스트 뷰 토글 (localStorage 저장)
- 태그 필터 추가 (멀티 선택, 태그별 문서 수 표시)
✅ 검색 결과 하이라이팅 개선 (커밋 fb2a8daf)
- CSS 클래스명 통일 (.search-highlight)
- SearchResultItem에서 중복 로직 제거, 유틸리티 함수 사용
- SourceDocuments에 검색어 하이라이팅 추가
✅ 채팅 UI 개선 (커밋 c3374b02)
- 소스 카드 클릭 시 문서로 이동 가능
- 복사 버튼 애니메이션 (체크마크 아이콘)
- 글자 수 제한 진행 바 표시

Phase 5 (Production Readiness) 완료 (2026-02-24):

✅ 환경 변수 보안화 (커밋 a8129087)
- docker-compose.yml에서 하드코딩된 비밀번호 제거
- ${VAR:?required} 문법으로 필수 변수 체크
- .env.example 포괄적 문서화
✅ Redis 기반 Rate Limiting (커밋 a8129087)
- RateLimiterBackend trait 추상화
- RedisRateLimiter (프로덕션), InMemoryRateLimiter (개발)
- REDIS_URL 환경변수로 자동 선택
✅ DB 커넥션 풀 프로덕션 설정 (커밋 a8129087)
- min_connections, acquire_timeout, max_lifetime, idle_timeout
✅ Health 엔드포인트 확장 (커밋 a8129087)
- /api/health/ready (K8s readiness probe)
- /api/health/live (K8s liveness probe)
- DB 풀 통계, Redis 상태, 응답 시간 측정
✅ Redis 프로덕션 설정 (커밋 a8129087)
- 메모리 제한 (256mb 기본), LRU 퇴거 정책, AOF 영속성

E2E 테스트 결과:

PostgreSQL 데이터베이스 마이그레이션 실행
- pgvector 0.8.0 소스 빌드 및 설치 완료
- minky_rust_db 생성 및 4개 마이그레이션 적용 완료
- 빌드: 0 errors, 0 warnings
OpenAI API 크레딧 부족 - 새 API 키 또는 크레딧 보충 필요
Rust 서버 기동 확인 (/api/health 응답 정상)
프론트엔드-백엔드 통합 테스트 완료
RAG 파이프라인 E2E 테스트 (API 키/크레딧 필요)
documents CRUD DB 연동 구현 완료

코드 품질 개선:

Rust clippy 경고 80개 → 0개 (type alias, Display impl, derive, allow)
Frontend 테스트 520개 통과
Rust 단위 테스트 1,465개 통과 (routes 100% 커버리지)
Auth 라우트 실제 구현 (login, register, refresh, /me)
Documents 인증 연동 (AuthUser 추출기로 user_id 교체)
AuthUser 연동 (tags, categories, comments, notifications, workflows, versions, attachments)
ESLint 경고 592 → 0개 (2026-03-01 완료, 100% 해결)
- PropTypes 추가 (27개 컴포넌트)
- 접근성 개선 (jsx-a11y: onKeyDown, role, tabIndex)
- label-input 연결 (htmlFor/id)
- 코드 품질 수정 (no-case-declarations, eslint-disable)
- 테스트 파일 PropTypes 규칙 비활성화

사용 방법:

/ci start     # CI/CD 세션 시작 (권장)
/pm           # PM 에이전트 시작
/validate     # 빌드/테스트/린트 검증

참고 파일:

PROGRESS.md - 완료된 작업 상세 내역
Docs/GETTING_STARTED.md - 설치 및 설정 가이드

Current Phase: Phase 1 - Knowledge Understanding

목표

문서 업로드 시 AI가 자동으로 이해하고, 벡터 임베딩으로 저장하여 자연어 검색 가능하게

TODO (우선순위 순)

🔴 High Priority - ✅ ALL COMPLETED

pgvector 설정 ✅ (2026-02-19 완료)
- PostgreSQL에 pgvector 확장 설치
- 벡터 컬럼이 있는 테이블 마이그레이션 작성
- 임베딩 모델/서비스 구현
- 결과: migrations/003_pgvector_embeddings.sql, models/embedding.rs, services/embedding_service.rs
Document Understanding 파이프라인 ✅ (2026-02-19 완료)
- 문서 업로드 시 Claude로 분석
- 핵심 주제, 요약, 인사이트 추출
- 결과: services/understanding_service.rs, routes/understanding.rs
벡터 임베딩 서비스 ✅ (2026-02-19 완료)
- OpenAI text-embedding-3-small 연동 (1536 dimensions)
- 문서/청크별 임베딩 생성 및 저장
- 결과: routes/embeddings.rs (7개 엔드포인트)

🟡 Medium Priority - ✅ ALL COMPLETED

RAG 검색 API ✅ (2026-02-19 완료)
- 자연어 질문 → 벡터 검색 → 컨텍스트 조합 → Claude 답변
- /api/search/ask, /api/search/semantic, /api/search/history
- 결과: models/rag.rs, services/rag_service.rs, routes/rag.rs
시맨틱 청킹 ✅ (2026-02-19 완료)
- 문서를 의미 단위로 분할 (ChunkEmbedding 모델)
- 청크별 임베딩 저장 및 검색
- 결과: chunk_embeddings 테이블, POST /api/embeddings/chunks/{id}

🟢 Low Priority - ✅ ALL COMPLETED

관련 문서 자동 연결 ✅ (2026-02-19 완료)
- 벡터 유사도 기반 관련 문서 추천
- 결과: GET /api/embeddings/similar/{id}, RelatedDocsList 컴포넌트
대화형 채팅 UI ✅ (2026-02-19 완료)
- React 채팅 인터페이스 (5개 컴포넌트)
- 마크다운 렌더링, 코드 하이라이팅
- 결과: frontend/src/components/Chat/, ChatPage.jsx

Backlog (Phase 2+)

Blocked / Waiting

현재 없음

Notes

Rust 백엔드 (minky-rust/) 기준으로 개발
Python 백엔드 (app/)는 레거시, 참고용
임베딩 API 선택: OpenAI text-embedding-3-small 권장 (.claude/references/apis/embedding-apis.md 참조)

Completed (Phase 0)

CI/CD 통합 시스템 완성 (2026-02-19)
- ci-runner.md, health-checker.md 에이전트
- /ci, /health 커맨드
- 파이프라인: default.yml, hotfix.yml, validate-only.yml
- ci-trigger.yml GitHub Actions
- CLAUDE.md PM/CI 자동화 프로토콜 추가
PM 자동화 시스템 완성 (2026-02-19)
- state-manager.md - 상태 저장/복구, 체크포인트, 롤백
- work-scheduler.md - 작업 대기열, 의존성 관리
- feedback-loop.md - 패턴 학습, 인사이트 추출
- notifier.md - 알림, 리포트 생성
- 커맨드: /state, /queue, /feedback, /notify
- 설정: .claude/config.json
- 상태 파일: .claude/state/*
- PM 에이전트 Enhanced 업그레이드
GitHub 이슈/PR 자동화 시스템 (2026-02-19)
- issue-manager.md - 이슈 관리 (1시간마다 분석)
- issue-developer.md - 이슈 해결 및 PR 생성
- technical-writer.md - 기술 보고서 작성
- github-automation.md - GitHub 자동화 설정
- 커맨드: /issue, /issue-dev, /tech-report, /setup-github
- GitHub Actions: issue-triage, pr-check, tech-report
- LessonLearn 폴더 및 라벨 체계 구축
PM 에이전트 시스템 구축 (2026-02-18)
- pm.md - 프로젝트 매니저 (메인 오케스트레이터)
- task-executor.md - 태스크 실행기
- code-reviewer-minky.md - 코드 리뷰어
- validator.md - 검증 에이전트
- progress-tracker.md - 진행 상황 추적기
- 커맨드: /pm, /next, /review, /validate, /progress
- 스킬: pm/SKILL.md
지식 관리 에이전트 시스템 구축 (2026-02-18)
- doc-analyzer, knowledge-linker, search-assistant
- insight-extractor, summary-writer, reference-manager
커맨드 시스템 구축 (2026-02-18)
- /ingest, /ask, /capture, /summarize
- /related, /status, /ref-save, /ref-search
스킬 시스템 구축 (2026-02-18)
- doc-understanding, semantic-search, rag-answering
- knowledge-linking, tacit-extraction
레퍼런스 시스템 구축 (2026-02-18)
- .claude/references/ 디렉토리 및 인덱스
- PKM 도구 조사, RAG 패턴, Embedding API 비교 저장
- 모든 에이전트에 레퍼런스 활용 안내 추가

Last updated: 2026-02-19 (16차 세션 - Rust 778개, Frontend 337개, Criterion 벤치마크 추가)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

MinKy Development Plan

🎯 다음 세션 우선 작업

✅ 보안 이슈 수정 완료 (2026-02-20)

✅ Phase 1-3 완료! Phase 4 준비

Current Phase: Phase 1 - Knowledge Understanding

목표

TODO (우선순위 순)

🔴 High Priority - ✅ ALL COMPLETED

🟡 Medium Priority - ✅ ALL COMPLETED

🟢 Low Priority - ✅ ALL COMPLETED

Backlog (Phase 2+)

Blocked / Waiting

Notes

Completed (Phase 0)

FilesExpand file tree

PLAN.md

Latest commit

History

PLAN.md

File metadata and controls

MinKy Development Plan

🎯 다음 세션 우선 작업

✅ 보안 이슈 수정 완료 (2026-02-20)

✅ Phase 1-3 완료! Phase 4 준비

Current Phase: Phase 1 - Knowledge Understanding

목표

TODO (우선순위 순)

🔴 High Priority - ✅ ALL COMPLETED

🟡 Medium Priority - ✅ ALL COMPLETED

🟢 Low Priority - ✅ ALL COMPLETED

Backlog (Phase 2+)

Blocked / Waiting

Notes

Completed (Phase 0)