From 1344d68b4f969c3b4a96c66b5dbf2a14bf58b4f5 Mon Sep 17 00:00:00 2001 From: Jaybe Date: Sat, 15 Nov 2025 02:14:10 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs(plan):=20ZIP=20=EA=B2=80=EC=A6=9D=20Ph?= =?UTF-8?q?ase5=20=EA=B8=B0=EB=A1=9D=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- MAIN_PLAN.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/MAIN_PLAN.md b/MAIN_PLAN.md index 97c9278..642a87c 100644 --- a/MAIN_PLAN.md +++ b/MAIN_PLAN.md @@ -262,8 +262,6 @@ ## ZIP 검증 TDD(자산/메타) - 통합/메타 테스트 추가: `zip.validation.integrated.test.ts`, `zip.validation.meta.test.ts` - exportPage + buildZip 통합: 자산 경로 재작성 및 포함, 하위 폴더 포함 검증 - - index.html 메타(SEO/OG/Analytics) 보존 스냅샷 검증 - - Hero 이미지 `loading="lazy"`, `decoding="async"`, canonical, 다크모드 토큰 존재 확인 ### ZIP 검증 TDD Phase4(루트 파일/manifest) - 테스트: `zip.validation.phase4.test.ts` @@ -272,7 +270,14 @@ - 구현: `lib/exporter/zip.ts` - `BuildZipInput.extras` 추가(루트 파일 수집) - manifest JSON 파싱 검증 로직 추가 -- 브랜치/PR: `feat/zip-validation-phase4` → CI 트리거 및 자동 머지 대상(automerge 라벨 조건) +- 브랜치/PR: `feat/manifest-robots-auto` → CI 트리거 및 자동 머지 대상(automerge 라벨 조건) + +### ZIP 검증 TDD Phase5(extras 내용 검증) +- 테스트: `lib/exporter/zip.validation.phase5.test.ts` + - `robots.txt` 텍스트 베이스라인 확인(`User-agent: *`) + - `site.webmanifest` JSON 파싱 및 필수 키(`start_url`, `display`) 확인 +- 구현: 기존 `buildExtrasForPage`/`buildZip` 경로 사용(추가 구현 불필요) +- 브랜치/PR: `feat/zip-validation-phase5` → CI 트리거 및 자동 머지 대상 ## 의사결정 기록(ADR) - [YYYY-MM-DD] Next.js(App Router) 채택: 생태계/배포/서버리스/SEO 편의성. From ea67de73c07f4e755590f6566907ba85c6f4d64b Mon Sep 17 00:00:00 2001 From: Jaybe Date: Sat, 15 Nov 2025 02:15:44 +0900 Subject: [PATCH 2/2] =?UTF-8?q?feat(head):=20manifest/ico=20=EB=A7=81?= =?UTF-8?q?=ED=81=AC=20=EB=B0=98=EC=98=81=20=EB=B0=8F=20=ED=85=8C=EC=8A=A4?= =?UTF-8?q?=ED=8A=B8=20=EC=B6=94=EA=B0=80(manifest.link.tokens)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- MAIN_PLAN.md | 26 +++++++++++++++++++++++ lib/exporter/html.ts | 2 ++ lib/exporter/manifest.link.tokens.test.ts | 21 ++++++++++++++++++ 3 files changed, 49 insertions(+) create mode 100644 lib/exporter/manifest.link.tokens.test.ts diff --git a/MAIN_PLAN.md b/MAIN_PLAN.md index 642a87c..7df377c 100644 --- a/MAIN_PLAN.md +++ b/MAIN_PLAN.md @@ -279,6 +279,32 @@ - 구현: 기존 `buildExtrasForPage`/`buildZip` 경로 사용(추가 구현 불필요) - 브랜치/PR: `feat/zip-validation-phase5` → CI 트리거 및 자동 머지 대상 +### 폰트 최적화(TDD) +- 테스트: `lib/exporter/font.optimization.test.ts` + - head에 ``, `` 존재 검증 + - CSS에 `system-ui` 폴백 포함 검증 +- 구현: `lib/exporter/html.ts` + - head에 googleapis/gstatic preconnect 추가 + - CSS body `font-family`에 system-ui 폴백 유지 +- 브랜치/PR: `feat/font-optimization` → CI 트리거 및 자동 머지 대상(automerge 라벨 조건) + +### 폼 제출: Google Sheets 템플릿 Export 포함(TDD) +- 테스트: `lib/exporter/sheets.template.test.ts` + - actionUrl 미지정 시 ZIP extras에 `sheets/Code.gs`, `sheets/README.txt` 포함 검증 + - actionUrl 지정 시 extras에 포함되지 않음 검증 +- 구현: `lib/exporter/extras.ts` + - `buildExtrasForPage(page)`로 extras 생성 + - Apps Script Code.gs/README.txt 기본 템플릿 제공 +- 브랜치/PR: `feat/form-sheets-template` → CI 트리거 및 자동 머지 대상(automerge 라벨 조건) + +### site.webmanifest/robots.txt 자동 생성(TDD) +- 테스트: `lib/exporter/manifest.robots.auto.test.ts` + - extras에 `site.webmanifest`/`robots.txt` 자동 포함 검증 + - manifest 파생 키 검사(name/short_name/start_url/display/theme_color) +- 구현: `lib/exporter/extras.ts` + - `buildExtrasForPage(page)`에서 robots.txt/manifest 자동 생성 및 포함 +- 브랜치/PR: `feat/manifest-robots-auto` → CI 트리거 및 자동 머지 대상(automerge 라벨 조건) + ## 의사결정 기록(ADR) - [YYYY-MM-DD] Next.js(App Router) 채택: 생태계/배포/서버리스/SEO 편의성. - [YYYY-MM-DD] Sheets 기본 방안: Apps Script 웹앱 템플릿(사용자 편의/트래픽 분산). diff --git a/lib/exporter/html.ts b/lib/exporter/html.ts index 4ff9c78..24c33e8 100644 --- a/lib/exporter/html.ts +++ b/lib/exporter/html.ts @@ -254,6 +254,8 @@ function buildHead(page: Page) { + + ${escapeHtml(page.seo.title)} diff --git a/lib/exporter/manifest.link.tokens.test.ts b/lib/exporter/manifest.link.tokens.test.ts new file mode 100644 index 0000000..3c72170 --- /dev/null +++ b/lib/exporter/manifest.link.tokens.test.ts @@ -0,0 +1,21 @@ +import { describe, it, expect } from 'vitest' +import { exportPage } from '@/lib/exporter/html' +import { pageSchema, type Page } from '@/lib/schema/page' + +function makePage(): Page { + return pageSchema.parse({ + title: 'Head Links', + locale: 'en', + theme: { primaryColor: '#2563eb', fontFamily: 'Inter' }, + sections: [], + form: { actionUrl: '', fields: [], spamProtection: { honeypotFieldName: '_hp', minSubmitSeconds: 2 } }, + seo: { title: 't', description: 'd' }, + }) +} + +describe('Exporter - head 링크 토큰', () => { + it('site.webmanifest 링크를 포함한다', () => { + const out = exportPage(makePage()) + expect(out.html).toMatch(//) + }) +})