Files
memento-frontend/README.md
T
DongHyeonkaandClaude Opus 5 c7caeefd06 chore: rename the imported template to memento
Takes over the identity the template left generic. The application name
becomes Memento in the browser title, the shell header and the home
page, in both the Korean and English catalogs.

The browser storage namespace moves from `ca-frontend` to `memento`,
which also moves the OPFS root directory, its mutation lock and the
journal metadata prefix. Nothing is migrated, because this repository
has never been deployed and so no origin holds data under the old
prefix. The tests that assert those key strings move with them.

Release provenance needs no edit here: the builder and verifier ids are
derived from the `name` in package.json upstream, so changing that one
line renames them too.

The template name is left alone in docs/, where it is part of the record
of work that actually happened in that repository, and in the secret
scan tool id, which is an internal identifier matched by a validator on
both sides rather than a product name.

README.md now describes this repository and, more importantly, records
how to merge from upstream and exactly which files carry a memento value
and will therefore be where conflicts land.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-20 13:52:24 +09:00

2.4 KiB

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