2026-08-01 19:39:59 +09:00
2026-08-01 19:39:59 +09:00

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를 참고하세요.

S
Description
No description provided
Readme
45 MiB
Languages
TypeScript 98.8%
CSS 0.8%
HTML 0.3%
JavaScript 0.1%