42eaf455826891dd36035c25e96f347b0e4ad558
memento-frontend
clean-architecture-frontend-template에서 파생된 프론트엔드입니다. 아키텍처 경계,
통합 동작, 릴리스 일관성, 접근성, 성능, 운영이 관례가 아니라 실행 가능한 계약으로
강제됩니다. 그 계약들의 설계 문서는 docs/ 아래에 그대로 승계되어 있습니다.
로컬 실행
.nvmrc의 Node 버전(현재 24.14.0)과 Corepack이 필요합니다. pnpm 버전은
package.json에 고정되어 있습니다.
corepack pnpm install --frozen-lockfile
corepack pnpm dev
런타임 공개 설정은 public/config.json에 있고 제품 트리가 마운트되기 전에 검증됩니다.
클라이언트 시크릿은 금지입니다.
템플릿에서 변경분 받아오기
이 레포는 템플릿을 upstream 원격으로 추적합니다. 템플릿이 개선되면 머지로 받아옵니다.
git fetch upstream
git merge upstream/main
upstream이 없으면 한 번 등록합니다.
git remote add upstream https://git.learn.hyeonworks.com/donghyeon.kang/clean-architecture-frontend-template
리브랜딩된 지점
머지 충돌은 아래 파일에서만 날 수 있습니다. 충돌이 나면 memento 쪽 값을 유지하고 나머지 변경은 템플릿 쪽을 받으면 됩니다.
| 파일 | memento 값 |
|---|---|
package.json (name) |
memento-frontend |
index.html (<title>) |
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/ 아래 설계·리뷰 문서에 남아 있는 템플릿 이름은 템플릿에서 실제로 일어난 작업의
기록이므로 바꾸지 않습니다.
검증
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를 참고하세요.
Languages
TypeScript
98.8%
CSS
0.8%
HTML
0.3%
JavaScript
0.1%