Deploy

Vercel Docs Deploy

현재 문서는 빌드가 필요 없는 정적 HTML/CSS라 Vercel로 배포할 수 있다. 프로젝트 루트에 있는 vercel.json은 / 요청을 /docs/index.html로 보내도록 구성한다.

Recommended

GitHub repo 연결

문서 폴더를 포함한 repo를 Vercel에 연결한다. Framework Preset은 Other, Build Command는 비워둔다.

Local

Vercel CLI

로컬에서 바로 확인하려면 프로젝트 루트에서 vercel, 배포 확정은 vercel --prod를 실행한다.

배포 전 확인

  1. python scripts/verify_docs.py로 필수 HTML 문서와 링크를 확인한다.
  2. 브라우저에서 docs/index.html과 docs/project-brief.html를 열어 시스템 그림이 읽히는지 본다.
  3. Vercel 프로젝트가 repo root를 기준으로 배포되는지 확인한다.
  4. 배포 URL에서 /, /project-brief.html, /operations/current-handoff-2026-05-17.html를 확인한다.

반복 실수 방지: root와 site 이중 미러링

Vercel deploy repo는 현재 site/ 사본과 root 사본을 함께 가진다. 새 문서를 추가하면 site/learning/example.html만 커밋되고, 실제 Vercel이 서빙하는 learning/example.html이 untracked로 남아 404가 날 수 있다.

증상 원인 재발 방지 체크
새 문서 URL만 404 site/에는 있지만 root mirror가 커밋되지 않음. 배포 후 deploy repo에서 git status --short를 확인한다.
/index.html은 200인데 /learning/...은 404 허브 문서는 갱신됐지만 새 디렉터리 root 파일이 누락됨. 새로 추가한 정확한 URL을 -DocsUrl로 확인한다.
배포 스크립트 후 untracked 폴더가 남음 새 root mirror 경로가 commit 범위에서 빠짐. git add <folder> 후 추가 commit/push를 한다. 
필수 후속 확인
cd C:\Users\hi\Downloads\종설_작업중\landmark-assistant\deploy-repos\landmark-assistant-sprint1
git status --short

# 새 learning 문서를 추가했다면 root mirror가 남지 않았는지 확인
git add learning
git commit -m "Expose learning docs at root"
git push

주의

현재 문서 workspace는 모델 학습 repo와 별도 위치에 있을 수 있다. Vercel에 올리려면 문서 workspace 자체를 GitHub repo로 만들거나, 기존 repo에 docs, scripts, vercel.json을 포함시켜야 한다.