# memento-frontend `clean-architecture-frontend-template`에서 파생된 프론트엔드입니다. 아키텍처 경계, 통합 동작, 릴리스 일관성, 접근성, 성능, 운영이 관례가 아니라 실행 가능한 계약으로 강제됩니다. 그 계약들의 설계 문서는 `docs/` 아래에 그대로 승계되어 있습니다. ## 로컬 실행 `.nvmrc`의 Node 버전(현재 24.14.0)과 Corepack이 필요합니다. pnpm 버전은 `package.json`에 고정되어 있습니다. ```bash corepack pnpm install --frozen-lockfile corepack pnpm dev ``` 런타임 공개 설정은 `public/config.json`에 있고 제품 트리가 마운트되기 전에 검증됩니다. 클라이언트 시크릿은 금지입니다. ## 템플릿에서 변경분 받아오기 이 레포는 템플릿을 `upstream` 원격으로 추적합니다. 템플릿이 개선되면 머지로 받아옵니다. ```bash git fetch upstream git merge upstream/main ``` `upstream`이 없으면 한 번 등록합니다. ```bash git remote add upstream https://git.learn.hyeonworks.com/donghyeon.kang/clean-architecture-frontend-template ``` ### 리브랜딩된 지점 머지 충돌은 아래 파일에서만 날 수 있습니다. 충돌이 나면 memento 쪽 값을 유지하고 나머지 변경은 템플릿 쪽을 받으면 됩니다. | 파일 | memento 값 | | --- | --- | | `package.json` (`name`) | `memento-frontend` | | `index.html` (``) | `Memento` | | `src/presentation/i18n/catalog.ts` (`common.appName`, `route.APP_HOME.title`, ko/en) | `Memento` | | `src/presentation/pages/home-page.tsx` | `Memento` | | `src/contracts/storage-keys.ts` (`APP_NAMESPACE`) | `memento` | | `src/adapters/storage/opfs/opfs-policy.ts` | `memento-opfs-v1` | | `src/adapters/storage/opfs/indexeddb-opfs-journal.ts` | `memento-opfs-metadata-v1` | | `README.md` | 이 파일 | 릴리스 증적에 박히는 builder/verifier ID는 `package.json`의 `name`에서 파생되므로 따로 고칠 것이 없습니다. `docs/` 아래 설계·리뷰 문서에 남아 있는 템플릿 이름은 템플릿에서 실제로 일어난 작업의 기록이므로 바꾸지 않습니다. ## 검증 ```bash corepack pnpm lint corepack pnpm check:types corepack pnpm check:architecture corepack pnpm check:adapter-inventory corepack pnpm test:all corepack pnpm build corepack pnpm verify:release ``` 전체 게이트 목록과 의미는 `docs/operations/ci-quality-gates.md`를 참고하세요.