Skip to main content

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파일 선택 → 업로드 → 분석 → KnowledgeReviewKEEP
/knowledgesrc/pages/knowledge.tsx, 자료 목록·검색·검토KEEP
/docs/introdocs/intro.mdxKEEP
/docs/SAP/, /docs/SAP/Functional/, /docs/SAP/Technical/해당 폴더 index.mdURL KEEP, 탐색 IMPROVE
/docs/Development/docs/Development/index.mdKEEP
/docs/Development/Infrastructure/, /docs/Development/Web/, /docs/Development/Tools/, /docs/Development/Troubleshooting/해당 폴더 index.mdKEEP
/docs/Development/Tools/knowledge-api-analysisAPI·분석·검토·영속 저장 상세 문서본문 KEEP, 관계 IMPROVE
/docs/Projects/docs/Projects/index.mdKEEP
/docs/Notes/, /docs/Notes/Inbox/, /docs/Notes/Drafts/, /docs/Notes/References/해당 폴더 index.mdKEEP
/blogDocusaurus 기본 블로그KEEP
/markdown-pagesrc/pages/markdown-page.mdxKEEP

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/파일/비밀값은 조사하지 않았다.