Wiki v1 현황 조사
2026-09-23 작업 시작 시 저장소와 보존 대상 조사
조사 범위
2026-09-23에 AGENTS.md, 루트의 Subchi-Wiki-v1-설계-및-Codex-작업지시.md 전체, 설정, 문서 전체, 프런트엔드 및 Knowledge API 코드·테스트를 확인했다. 운영 사이트, OCI 구성 및 실데이터는 조회하지 않았다.
시작 시 Markdown/MDX 문서는 15개였다. SAP·Projects·Development·Notes 소개와 하위 분류 소개가 대부분이고 실질적인 상세 문서는 Development/Tools/knowledge-api-analysis다. 투자관리, IM01~IM07, PS, WBS, OCI 운영 상세 문서는 없다. 새 콘텐츠가 없는 관점은 빈 허브로 공개하지 않는다.
실제 라우트와 파일
| 라우트 | 파일 / 역할 | 처리 |
|---|---|---|
/ | src/pages/index.tsx, 홈과 업로드·분석 모달 | IMPROVE, API 흐름 KEEP |
/?add-source=1 | 파일 선택 → 업로드 → 분석 → KnowledgeReview | KEEP |
/knowledge | src/pages/knowledge.tsx, 자료 목록·검색·검토 | KEEP |
/docs/intro | docs/intro.mdx | KEEP |
/docs/SAP/, /docs/SAP/Functional/, /docs/SAP/Technical/ | 해당 폴더 index.md | URL KEEP, 탐색 IMPROVE |
/docs/Development/ | docs/Development/index.md | KEEP |
/docs/Development/Infrastructure/, /docs/Development/Web/, /docs/Development/Tools/, /docs/Development/Troubleshooting/ | 해당 폴더 index.md | KEEP |
/docs/Development/Tools/knowledge-api-analysis | API·분석·검토·영속 저장 상세 문서 | 본문 KEEP, 관계 IMPROVE |
/docs/Projects/ | docs/Projects/index.md | KEEP |
/docs/Notes/, /docs/Notes/Inbox/, /docs/Notes/Drafts/, /docs/Notes/References/ | 해당 폴더 index.md | KEEP |
/blog | Docusaurus 기본 블로그 | KEEP |
/markdown-page | src/pages/markdown-page.mdx | KEEP |
MOVE 대상 없음. 기존 문서 ID와 permalink를 유지한다.
기존 구현
- Docusaurus 3.10.2, React 19, TypeScript 6, npm. 전체 문서를 한 autogenerated sidebar에 표시한다.
- 홈은 SAP·Projects·Development·Notes 카드와 자료 추가 모달을 제공한다.
- Wiki 본문 검색 엔진은 없다.
/knowledge검색은 업로드 자료 제목·원본 파일명 검색으로 별개의 기능이다. POST /api/upload,POST /api/analyze/{stored_filename},GET /api/parse/{stored_filename},GET /api/health,GET /api/sources,GET /api/sources/{source_id},POST /api/sources/{source_id}/review,POST /api/sources/{source_id}/content-review가 존재한다.- 원본
/app/uploads, 기본 SQLite/app/data/knowledge.db;KNOWLEDGE_DB_PATH로 변경 가능. 최초 분석과 사용자 검토본을 별도로 저장한다. Wiki Markdown 생성은 구현되어 있지 않다. services/knowledge-api/Dockerfile은 API 컨테이너 정의다. 실제 OCI Compose·프런트엔드 배포·Nginx Proxy Manager 설정은 저장소에서 확인되지 않는다. README의 GitHub Pages 명령은 운영 사실의 근거로 사용하지 않는다.
기존 작업과 안전 경계
시작 시 .gitignore, AGENTS.md, 설정, 홈 TSX/CSS가 수정 상태였고, 명세, 로그 3개, API 문서, services/, src/components/KnowledgeReview/, 자료 관리 페이지와 tests/가 untracked였다. 이 상태를 기준으로 작업하며 기존 변경을 되돌리지 않는다. /tmp/wiki-v1-before에 소스 스냅샷·해시와 기존 routes를 기록했다. 비밀값, DB, 업로드는 읽거나 복사하지 않았다.
위험 및 확인 제한
- SAP 상세 데이터가 없으므로 설계 예시의 투자→PS 경로를 검증할 수 없다.
- AI 지식 문서가 없으므로 AI 허브를 만들지 않는다. 기존 AI 분석은 지식 도구로 연결한다.
- 운영 인증·프록시·모델 및 실제 Docling 처리는 로컬 빌드로 증명할 수 없다.
- 기존에 준비된
/tmp/wiki-management-venv만 백엔드 모의 테스트에 사용 가능하다. OCI·Docker·실제 모델 호출은 하지 않는다. - 스크린샷·실제 모바일 동작은 브라우저 런타임 확보 여부에 따라 별도로 기록한다.
단계 0 결과
변경 파일: 이 현황 문서. 변경 전 npm run typecheck, npm run build, Node 검토 모델 테스트 5개 통과. 다음 단계는 기존 주소를 보존하는 경로 매핑과 콘텐츠가 없는 관점의 처리 확정이다.
2026-09-24 추가 조사와 구현 범위
시작 시 기존 v1 작업과 API·검토 UI·문서·테스트는 대부분 modified/untracked였다. 이를 /tmp/wiki-v2-before의 소스 스냅샷과 비교한다. 이전 로그·백업·문서·업로드를 삭제하지 않는다.
기존 upload endpoint는 파일과 source만 저장했으며 홈 화면이 upload 직후 analyze를 호출했다. 파싱 본문은 저장하지 않았다. sources에는 분석·검토본이 있으나 독립 처리 상태나 텍스트 지식 객체는 없었다. 이를 확인한 뒤 implementation-map의 추가 설계대로 확장했다.
새 파일군: processing.py, knowledge-add.tsx, knowledge-entries.tsx, knowledgeApi.ts, test_repository_knowledge.py. 기존 /knowledge는 자료 저장소로 확장하고 기존 /?add-source=1은 해당 페이지 업로드로 연결한다. 기존 IA/허브/문서 URL·검토 계약은 유지한다. 새 지식 API는 sources와 분리된 knowledge_entries를 사용한다. 운영 DB/파일/비밀값은 조사하지 않았다.