Issue AX: [Project+Agent] 퍼블리싱 템플릿 — 고르기 전 조작 가능한 데모 + 실제 씨딩

[dldnsgkr]

🔥 Issue 개요

퍼블리싱 템플릿은 API 에 이미 있지만 아무 일도 하지 않는다.

• startMode 는 blank / template 로 검증되고, templateType 은 슬러그 형식([a-z0-9][a-z0-9_-]{0,49})만 검증된다 — 카탈로그 대조가 없어 존재하지 않는 템플릿도 통과한다
• 값은 projects.template_type 에 저장되지만 읽는 코드가 하나도 없다
• 실제로는 CodeAgentService 가 백지에서 전부 생성한다

즉 사용자가 템플릿을 골라도 조용히 무시되고 백지 생성된다. ProjectCreationService 주석이 이 사실을 명시하고 있다.

기획 요구는 (1) 고르기 전에 조작해보며 확인하고, (2) 끌어와 그대로 만든 뒤 내용만 바꾸거나 디자인을 조금 손보는 것이다.

🎯 목표

• 템플릿 데모를 고르기 전에 조작하면서 볼 수 있게 한다
• 고른 템플릿이 실제로 프로젝트에 심긴다 (조용한 무시 제거)
• 심은 뒤 수정분이 diff 로 보인다 (fix(change): 신규 프로젝트의 첫 변경 내역이 diff 가 아니라 git 도움말이었다 #317 재사용)

✅ 작업 범위

• 포함 범위:
  • Dvely/qeploy-templates 저장소 신설 — 소스 + 매니페스트 + GH Pages 데모
  • BE 카탈로그 API (GET /api/v1/templates, /{id})
  • templateType 검증을 슬러그 형식 → 카탈로그 대조로 교체
  • 첫 CODE 스텝에서 템플릿 소스를 /workspace/app 에 씨딩 + 프롬프트 분기("생성" → "수정")
• 제외 범위:
  • FE 템플릿 갤러리 UI (FE 세션)
  • 템플릿 콘텐츠 제작 자체
  • 스키마 변경 — 기존 컬럼을 그대로 쓴다

✅ Task List (PR 단위)

• PR-1 설계 문서 (docs/template-architecture-design.md)
• PR-2 qeploy-templates 저장소 + 템플릿 2~3 종 + Pages 발행
• PR-3 BE 카탈로그 API + templateType 카탈로그 대조 검증
• PR-4 첫 CODE 스텝 씨딩 + 프롬프트 분기

✅ 완료 기준

• 템플릿을 골라 만든 프로젝트의 첫 프리뷰가 그 템플릿과 같게 보인다
• 존재하지 않는 templateType 이 400 으로 거절된다
• 씨딩 후 첫 수정분이 diff API 로 보인다
• 테스트 통과 · state.md / api.md 갱신

📌 참고

• 설계: docs/template-architecture-design.md
• 데모에 프리뷰 컨테이너를 쓰지 않는 이유: 컨테이너 1 개당 1GB 상한 · dev 박스 RAM 3.7GB
• GH Pages iframe 임베드 가능 실측(2026-09-10): 정상 문서에 X-Frame-Options · frame-ancestors 없음
• 씨딩을 생성 시점에 두지 않는 이유: 과거 생성 시점 스캐폴딩이 한 번도 실행되지 않았다 (ProjectCreationService 주석)