[Project+Agent] 퍼블리싱 템플릿 구조 설계 [ #318 ] - #319
Merged
Merged
Conversation
템플릿은 API 에 이미 있지만 아무 일도 하지 않는다. startMode/templateType 이 검증·저장되고 소비처가 없어, 사용자가 템플릿을 골라도 조용히 무시되고 백지 생성된다. 구조를 "org GH Pages 냐 / FE 냐 / BE 냐" 로 잡으면 답이 안 나온다. 템플릿은 데모와 소스라는 두 역할을 하고 요구 조건이 정반대라서다. 데모는 전원에게 동일한 정적 자원이고, 소스는 사용자 프로젝트로 복사되는 파일 트리다. 그래서 저장소 하나에 둘 다 두고, 데모는 GH Pages 로 발행하며, BE 는 카탈로그만 소유한다. - 데모에 프리뷰 컨테이너를 쓰지 않는다 — 컨테이너 1 개당 1GB 상한, dev 박스 RAM 3.7GB - FE·BE 가 소스를 들지 않는다 — jar 가 이미 158MB 고, 씨딩은 서버 컨테이너 안에서 일어난다 - 씨딩은 첫 CODE 스텝 — 생성 시점 스캐폴딩은 과거에 한 번도 실행되지 않았다 - GH Pages iframe 임베드 가능은 실측했다(2026-09-10) Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
개요
퍼블리싱 템플릿 구조 설계 문서다. 코드 변경은 없다.
왜 지금인가
템플릿은 API 에 이미 있는데 아무 일도 하지 않는다.
startMode/templateType이 검증·저장되지만 읽는 코드가 없어, 사용자가 템플릿을 골라도 조용히 무시되고 백지 생성된다. 새 기능이 아니라 뚫린 구멍을 메우는 일이라 스키마 변경 없이 시작할 수 있다.설계 요지
질문이 "org GH Pages 냐 / FE 냐 / BE 냐"로 잡혀 있었는데, 셋 중 하나를 고르는 문제가 아니다. 템플릿은 데모(고르기 전 조작)와 소스(프로젝트에 심는 씨앗)라는 두 역할을 하고 요구 조건이 정반대다.
qeploy-templates), 소스·데모·카탈로그 동거씨딩하면 CODE 프롬프트가 "백지에서 만들어라" → "이걸 고쳐라"로 바뀌고, 그 수정분이 #317 의 diff API 로 그대로 보인다.
실측한 것
X-Frame-Options·CSP frame-ancestors없음(2026-09-10) → 우리 UI 안 iframe 으로 조작 가능. 404 페이지만 제한적 CSP 를 보내는데 정상 문서와 무관하다templateType검증은 슬러그 형식만 본다 → 존재하지 않는 템플릿도 통과한다열린 결정
문서 말미에 3 개를 남겼다 —
templateType컬럼명 유지 여부, 소스 취득 방식(raw vs 얕은 clone), 썸네일 생성 방식.범위
문서만. 후속 PR 은 #318 의 Task List 를 따른다. FE 갤러리는 FE 세션.
Closes 없음 — #318 은 PR-2~4 가 남아 열어둔다.
🤖 Generated with Claude Code
https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93