인수인계서 — 세션 85 (CMS Dashboard 구축 — Supabase 아카이브 웹앱)
작성일: 2026-03-25 이전 세션: session84
작업 요약
00-general-pro-web의 콘텐츠(00~08 + docs/)를 Supabase DB로 마이그레이션하고, Next.js 15 기반 CMS 대시보드를 구축하여 웹에서 탐색/검색/편집 가능하게 함.
수정 파일
00-general-pro-web 측 (2개)
| # | 파일 | 변경 내용 |
|---|---|---|
| 1 | .gitignore | .next/ 추가, cms-dashboard 격리 주석 |
| 2 | .mcp.json | 신규 — Supabase MCP 서버 설정 |
cms-dashboard/ (별도 git repo, 42개 파일)
| # | 파일 | 변경 내용 |
|---|---|---|
| 1 | supabase/migrations/001_schema.sql | DB 스키마 (folders + documents + RPC 3개 + RLS) |
| 2 | scripts/migrate-to-supabase.ts | 1,411 파일 → Supabase 마이그레이션 스크립트 |
| 3 | src/app/layout.tsx | 루트 레이아웃 (사이드바 + 카테고리 네비) |
| 4 | src/app/page.tsx | 대시보드 홈 (통계, 최근 업데이트, 카테고리 그리드) |
| 5 | src/app/browse/page.tsx | 13개 카테고리 카드 그리드 |
| 6 | src/app/browse/[...path]/page.tsx | 동적 폴더/문서 브라우저 |
| 7 | src/app/doc/[id]/page.tsx | 문서 뷰어 (마크다운 + 코드) |
| 8 | src/app/doc/[id]/edit/page.tsx | 문서 편집기 |
| 9 | src/app/new/page.tsx | 새 문서 생성 |
| 10 | src/app/search/page.tsx | 풀텍스트 검색 (한/영 필터) |
| 11 | src/app/api/documents/route.ts | GET(목록+검색), POST(생성) |
| 12 | src/app/api/documents/[id]/route.ts | GET, PUT, DELETE |
| 13 | src/app/api/folders/route.ts | GET(트리), POST(생성) |
| 14 | src/app/api/stats/route.ts | GET(대시보드 통계) |
| 15 | src/lib/supabase/client-*.ts | Supabase 클라이언트 3종 (browser, server, admin) |
| 16 | src/lib/types/cms.ts | CMS 도메인 타입 + ROOT_CATEGORIES |
| 17 | src/lib/utils/metadata-parser.ts | frontmatter/JSDoc/docstring 파서 |
| 18 | src/components/viewer/*.tsx | 마크다운 뷰어, 코드 뷰어, 메타데이터 패널 |
검증 결과
npx next build— 성공 (에러 0개, 10개 라우트)npm run dev+/api/stats— 1,411 문서, 327 폴더, 13 카테고리 정상 응답- Supabase 마이그레이션 — 1,411/1,411 성공, 실패 0개
- GitHub push —
kimdooo-a/General-promain 브랜치 완료
터치하지 않은 영역
- CLAUDE.md 폴더 구조에 cms-dashboard 미등록 (별도 repo라 불필요)
- _COMPONENT_MAP.md 미갱신 (cms-dashboard는 별도 프로젝트)
- CodeMirror 에디터 — 설치만 했고 textarea로 대체 중 (Phase 2 개선 대상)
- Vercel 배포 — 환경변수 설정 필요 (사용자 액션)
알려진 이슈
- Vercel 환경변수 3개 미설정 시 배포 후 페이지 미작동
- CodeMirror 에디터 미적용 (현재 기본 textarea)
- 디자인 스킬(ui-ux-pro-max, frontend-design, theme-factory) 미적용 — 기본 Tailwind 스타일만
다음 작업 제안
- Vercel 배포 완료 — 환경변수 3개 입력 후 Deploy
- CodeMirror 에디터 적용 — 마크다운 분할 프리뷰 + 코드 구문 하이라이팅
- 디자인 개선 —
/ui-ux-pro-max+/frontend-design스킬로 UI 리파인 - Supabase MCP 활용 — 다음 세션부터 DB 직접 제어 가능