docs(records): 기록·설계서·결정 기록 67개에 한국어 머리 블록을 단다
문제: 옮긴 기록은 지금 동작을 설명하는지, 상태가 무엇인지, 지금 정본이 어디인지 알 길이 없다. 설계서·계획서 27개와 docs/architecture 목표 설계 16개에는 상태 칸이 없고, VD는 「상태: Accepted」 같은 영어 값을 쓴다. 고른 방법: docs-system.md 4절 형식으로 맨 위에 머리 블록을 달고 본문은 한 글자도 고치지 않는다. 상태는 기계 변환이다. - 설계서: Accepted·확정·정본·설계 완료 → 채택, 상태 줄이 없으면 확인 안 함 (채택 4, 확인 안 함 21) - 계획서: 체크 상자가 모두 표시됐으면 끝남, 아니면 확인 안 함. SPEC.md는 같은 폴더 plan.md와 같은 근거(0.2.0으로 끝난 라운드)로 끝남 (끝남 5, 확인 안 함 14. 이미 블록이 있던 5개는 그대로) - 결정 기록: Accepted → 채택, 날짜가 붙은 뒤늦은 보완 메모가 본문에 있으면 채택(보완) (채택 14, 채택(보완) 9). 프론트 VD는 처음부터 한국어로 썼고 번역하지 않으므로 둘째 줄은 「원문이다」 문구다. - 작성일: 파일 이름 날짜 → 본문 날짜 줄(VD는 `결정일:`) → git 첫 추가일. 위험: VD-09·11·13은 git으로 보면 결정 뒤 본문이 그 자리에서 고쳐졌지만 본문에 날짜 표시가 없어 기계 규칙대로 채택으로 두었다. 보완으로 올릴지는 사람이 정한다. 「현재 정본」은 지금 있는 살아 있는 문서나 코드 경로만 쓴다. 검증: 블록과 그 뒤 빈 줄 하나를 빼면 72개 모두 `git show HEAD:`와 바이트가 같다. 뒤 커밋의 문서 검사 head 규칙으로 돌려 문제 0건.
This commit is contained in:
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: TypeScript 7과 ESLint 10으로 옮길 때 컴파일러와 운영 소스를 한꺼번에 바꾸지 않고 JS·TS 파일이 같은 품질 게이트를 통과하게 하는 도구 구성을 정한 결정이다.
|
||||
- 현재 정본: `eslint.config.ts`, `tsconfig.json`, `scripts/check-architecture.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-01: TypeScript 7과 ESLint 10의 점진적 전환 도구
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 라우터를 React Router Data Mode로 바꾸고 실행 route는 registry에서 만들며 서버 상태는 계속 application input과 TanStack Query가 소유한다는 결정이다.
|
||||
- 현재 정본: `src/presentation/routes/`, `src/contracts/routes.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-03: React Router Data Mode와 서버 상태 소유권
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 폼은 외부 폼 라이브러리 대신 native form 이벤트를 쓰는 local `useAppForm` facade로 처리하고 검증 오류·충돌·저장 실패를 구분해 보여 준다는 결정이다.
|
||||
- 현재 정본: `src/presentation/forms/`, `src/presentation/templates/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-04: Native form controller와 local facade
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 아이콘은 `lucide-react`를 한 파일 facade 뒤에 두고 의미 이름만 노출하며, 복합 control은 headless 라이브러리 없이 native 요소로 만든다는 결정이다.
|
||||
- 현재 정본: `src/presentation/design-system/`, `docs/styling/design-tokens.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-05: Semantic icon facade와 native-first interaction
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 다국어 문구는 표준 Intl과 한국어 기준 typed local catalog로 처리하고 i18n 라이브러리는 기본으로 넣지 않는다는 결정이다.
|
||||
- 현재 정본: `src/presentation/i18n/`, `scripts/check-i18n.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-06: Intl과 typed local message catalog
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 운영 진단은 `DiagnosticsPort`, 의미 이벤트는 `TelemetryPort`로 나누고 닫힌 registry와 값 정책을 통과한 값만 보낸다는 결정이다.
|
||||
- 현재 정본: `src/adapters/diagnostics/`, `src/adapters/telemetry/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-07: Diagnostics와 telemetry exporter 경계
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: Storybook은 개발용 정적 산출물로만 쓰고, 시각 회귀는 운영 build를 고정된 Chromium으로 찍은 스크린샷과 비교한다는 결정이다.
|
||||
- 현재 정본: `.storybook/`, `docs/testing/taxonomy.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-08: 개발용 Storybook과 로컬 시각 회귀 증적
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: lockfile 전체에서 의존성 목록·라이선스·SBOM·출처 증명을 만들고, 외부 취약점 보고와 서명된 증거가 없으면 승격(promotion)을 실패로 둔다는 결정이다.
|
||||
- 현재 정본: `docs/security/supply-chain.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-09: 공급망 inventory, license, vulnerability, SBOM과 provenance
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: realtime·offline·PWA 같은 선택 기능 12개를 recipe catalog로 두고, 실제 제품 요구가 생기기 전에는 설치하지 않는다는 결정이다.
|
||||
- 현재 정본: `config/recipes/frontend-capability-recipes.json`, `docs/architecture/optional-adapter-recipes.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-10: 선택형 frontend capability recipe
|
||||
|
||||
- 상태: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-27
|
||||
- 요약: File·Blob·파일 선택기·IndexedDB·OPFS·Cache Storage를 기존 `StoragePort`와 섞지 않는 별도 경계로 두고, reference runtime은 제품에 조립하지 않은 채 둔다는 결정이다.
|
||||
- 현재 정본: `src/adapters/browser-files/`, `src/adapters/storage/`, `config/recipes/frontend-capability-recipes.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-11: Browser file and origin-storage 경계
|
||||
|
||||
- 상태: Accepted — native reference runtime available, not composed
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: presigned 전송과 Image CDN에서 BFF 제어 경로와 저장소·CDN 데이터 경로를 나누고, 브라우저는 발급받은 정확한 capability만 쓴다는 결정이다.
|
||||
- 현재 정본: `src/adapters/browser-transfer/`, `docs/operations/browser-transfer-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-12: Presigned transfer, resumable upload와 Image CDN 경계
|
||||
|
||||
- 상태: Accepted — reference runtime available, not composed
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: server state cache, Web Storage, IndexedDB 영속화, 탭 간 무효화를 한 추상으로 합치지 않고 scope와 영속화 경계를 따로 정한다는 결정이다.
|
||||
- 현재 정본: `src/adapters/query-cache/`, `src/adapters/cross-context-invalidation/`, `src/contracts/storage-keys.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-13: Client cache scope, persistence와 탭 간 일관성 경계
|
||||
|
||||
- 상태: Accepted — staged implementation required
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: Range로 이어받는 다운로드와 백그라운드 다운로드를 일반 스트리밍 다운로드와 다른 capability로 두고, 재개 근거는 서버가 준 불변 세대와 강한 validator로 한다는 결정이다.
|
||||
- 현재 정본: `config/recipes/frontend-capability-recipes.json`, `docs/operations/browser-transfer-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-14: Resumable download와 background download 경계
|
||||
|
||||
- 상태: Accepted — production design complete, implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: VD-11 reference runtime을 제품에 조립하기 전에 필요한 origin 저장소 수명 주기, migration, 선택형 파일 capability의 공통 계약을 정한 결정이다.
|
||||
- 현재 정본: `src/adapters/storage/`, `src/adapters/platform/`, `docs/operations/browser-file-storage-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-15: Origin storage lifecycle, migration, and optional file capabilities
|
||||
|
||||
- 상태: Accepted design — implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 파일·전송·이미지 capability를 계정 범위의 단일 composition owner가 정해진 순서로 만들고 Image delivery를 그 위에 붙인다는 결정이다.
|
||||
- 현재 정본: `src/adapters/browser-transfer/`, `config/recipes/frontend-capability-recipes.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-16: Browser transfer composition과 Image delivery
|
||||
|
||||
- 상태: Accepted — design complete, implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: API transport는 operation registry가 고르고 feature port는 protocol을 모르게 하며, REST 실행 경로를 정한 결정이다.
|
||||
- 현재 정본: `src/adapters/http/`, `docs/architecture/backend-api-and-server-state-contract.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-23: API transport selection과 REST execution
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 입력·명령·전송·응답 검증 경계를 나누고 runtime schema와 boundary mapper가 각 경계에서 할 일을 정한 결정이다.
|
||||
- 현재 정본: `src/adapters/http/http-execution-v3.ts`, `src/contracts/boundary-mapper.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-24: Runtime Schema와 boundary Mapper
|
||||
|
||||
- 상태: Accepted — reference typed codec/mapper baseline은 2026-11-03에 지웠다(`12f3bb7`, `MAPPER_REGISTRY`·`RUNTIME_SCHEMA_CODECS` 삭제). 지금 schema는 V3 descriptor 검증기와 FE-REG-SCHEMA 행, mapping은 descriptor의 `mapSuccess`다. artifact governance pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: TanStack Query를 유일한 기본 server state owner로 두고 bound query, 입력 기반 mutation 조정, 세션 세대에 따른 cache 수명 주기를 정한 결정이다.
|
||||
- 현재 정본: `src/presentation/adapters/query/`, `src/adapters/query-cache/`, `src/bootstrap/server-state-generation-store.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-25: Server State Cache lifecycle
|
||||
|
||||
- 상태: Accepted — reference bound-query/input-aware mutation baseline composed, lifecycle delta pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 운영 GraphQL은 고정 endpoint와 persisted operation ID로만 보내고 임의 query 문자열은 허용하지 않는다는 결정이다.
|
||||
- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `docs/operations/api-contract-and-server-state-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-26: Persisted GraphQL operation
|
||||
|
||||
- 상태: Accepted design — reference runtime implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: gRPC-Web은 protocol profile을 섞지 않고 unary와 server stream만 지원하며 client·양방향 stream은 브라우저 한계로 보장하지 않는다는 결정이다.
|
||||
- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-27: gRPC-Web unary와 server stream
|
||||
|
||||
- 상태: Accepted design — common coordinator available, wire adapter pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: SSE·WebSocket·Web Push·제한된 Polling을 서로 다른 capability로 나누고 연결 복구와 자원 상한을 정한 결정이다.
|
||||
- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/`, `docs/architecture/optional-adapter-recipes.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-28: Realtime events, Web Push와 bounded polling
|
||||
|
||||
- 상태: Accepted — reference runtime available, product implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: Connect-Web을 쓸 때 protocol, runtime, message encoding, framing을 따로 고르고 VD-27의 gRPC-Web 상태 기계와 섞지 않는다는 결정이다.
|
||||
- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-29: Connect-Web과 browser Protobuf runtime
|
||||
|
||||
- 상태: Accepted design — common coordinator available, wire adapter pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: Protobuf schema와 codegen 관리 방식을 정하고, 기본 공개 adapter는 curated REST BFF로 두며 REST transcoding gateway와 섞지 않는다는 결정이다.
|
||||
- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `src/contracts/browser-rpc.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# VD-30: Protobuf contract와 REST transcoding gateway
|
||||
|
||||
- 상태: Accepted design — schema/codegen과 provider runtime implementation pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 기능 화면을 만들기 전에 템플릿이 줄 디자인 시스템의 소유권, 계층, 기본 구성요소, 외부 라이브러리 경계와 검증 방법을 정한 설계다.
|
||||
- 현재 정본: `src/presentation/design-system/`, `docs/styling/design-tokens.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 디자인 시스템 플랫폼 계약
|
||||
|
||||
이 문서는 도메인 기능을 추가하기 전에 프론트엔드 스켈레톤이 제공해야 하는
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 새 프론트 제품의 출발점이 갖춰야 할 공통 역량을 실제 호출 경로와 게이트 기준으로 다시 평가하고 RP-01~RP-12 결과를 누적한 검토다.
|
||||
- 현재 정본: `docs/architecture/overview.md`, `config/recipes/frontend-capability-recipes.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 프론트엔드 플랫폼 역량 재검토
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 선언된 프론트 계약을 실제 runtime과 자동 검증까지 잇는 P0·P1·P2 구현 순서와 브랜치 계획을 정한 설계다.
|
||||
- 현재 정본: `docs/architecture/overview.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 프론트엔드 플랫폼 구현 로드맵
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 프론트 플랫폼의 위험을 unit·contract·MSW·브라우저·시각 회귀 중 어느 테스트 계층에서 막을지 정한 테스트 전략이다.
|
||||
- 현재 정본: `docs/testing/taxonomy.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 프론트엔드 플랫폼 테스트 전략
|
||||
|
||||
이 문서는 도메인 기능을 추가하기 전과 추가한 후에 프론트엔드 플랫폼의 위험을
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: inbound·outbound 포트와 adapter의 방향, React·Router·Query·HTTP 같은 기술의 자리, 새 adapter와 feature를 더하는 순서를 정한 설계다.
|
||||
- 현재 정본: `docs/architecture/layers.md`, `docs/architecture/frontend-application-foundation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 프론트엔드 포트·어댑터와 경계 설계
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: typed route, 접근 guard, lazy chunk 복구, 이동할 때의 focus·취소 처리, 공통 page template과 재사용 패턴의 기준을 정한 설계다.
|
||||
- 현재 정본: `src/presentation/routes/`, `src/presentation/templates/`, `docs/manual/reference/patterns.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 라우팅, 페이지 템플릿, 재사용 패턴
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: TypeScript 전용 경계를 지키는 법과 local·URL·server·form·영속 상태를 둘 곳, HTTP·재시도·오류 책임을 나누는 법을 정한 설계다.
|
||||
- 현재 정본: `docs/manual/reference/patterns.md`, `src/presentation/adapters/query/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# TypeScript, 상태 소유권, 데이터 흐름
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-27
|
||||
- 요약: File·Blob·파일 선택기·다운로드·IndexedDB·OPFS·Cache Storage를 운영에 넣을 때의 경계, 프로토콜, 실패·복구 정책과 승격 증거를 정한 설계다.
|
||||
- 현재 정본: `src/adapters/browser-files/`, `src/adapters/storage/`, `docs/operations/browser-file-storage-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Browser file and origin-storage platform
|
||||
|
||||
이 문서는 File, Blob, 파일 선택기, 다운로드, IndexedDB, OPFS, Cache Storage를
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: REST·GraphQL·Connect·gRPC-Web·Protobuf gateway에 걸친 API 계약, runtime schema, boundary mapper와 TanStack Query 기반 server state의 현재·목표 상태를 정한 설계다.
|
||||
- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `docs/operations/api-contract-and-server-state-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# API contract, Schema, Mapper와 Server State platform
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: TanStack Query memory cache, Local·Session Storage, IndexedDB 영속화 경계, 탭 간 무효화의 소유권과 프로토콜, 복구 방법을 정한 설계다.
|
||||
- 현재 정본: `src/adapters/query-cache/`, `src/contracts/storage-keys.ts`, `docs/operations/client-cache-and-storage-recovery.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Client cache and browser storage platform
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: gRPC-Web·Connect-Web·Protobuf 계약과 codegen·REST gateway의 브라우저 쪽 설계로, provider 중립 Browser RPC V3 공통 runtime까지만 두고 vendor 선택은 미룬 설계다.
|
||||
- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Protobuf browser transport와 REST Gateway
|
||||
|
||||
- 상태: production design accepted, product/provider selection pending
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 프론트의 파일 capability에 맞춰 제품 backend가 만들 object storage·multipart·서명 capability 같은 서버 쪽 기반을 정한 인계 설계다.
|
||||
- 현재 정본: `docs/manual/02-decision-tables.md`, `src/adapters/http/fileserver-upload.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Server file capability infrastructure handoff
|
||||
|
||||
- 상태: 설계 완료. 짝 백엔드 템플릿은 구현하지 않음(2026-09-25 제거)
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-30
|
||||
- 요약: 파일·저장소·cache·전송·Image CDN 같은 브라우저 데이터 capability의 현재·목표 상태와 남은 일, 승격 조건을 한곳에 모은 상태 대장이다.
|
||||
- 현재 정본: `config/recipes/frontend-capability-recipes.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Browser data capability completion ledger
|
||||
|
||||
## 1. 목적
|
||||
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-30
|
||||
- 요약: Runtime Config·boot, HTTP client, Router, Query·Mutation, realtime, Worker, Service Worker, offline command의 구현 결정을 닫은 상세 설계로, 다른 설계서가 런타임 결정의 정본으로 가리키던 문서다.
|
||||
- 현재 정본: `docs/architecture/frontend-application-foundation.md`, `src/bootstrap/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계
|
||||
|
||||
- 작성일: 2026-07-30
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-30
|
||||
- 요약: presigned URL, multipart·재개 업로드, 스트리밍 다운로드, Image CDN의 제어·데이터 경로 경계와 무결성·만료·복구 계약을 정한 설계다.
|
||||
- 현재 정본: `src/adapters/browser-transfer/`, `docs/operations/browser-transfer-recovery.md`, `docs/manual/02-decision-tables.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Presigned transfer, resumable upload, streaming download and Image CDN
|
||||
|
||||
이 문서는 presigned URL, multipart/resumable upload, streaming download와
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-30
|
||||
- 요약: SSE·WebSocket·Web Push·제한된 Polling을 도입할 때의 선택 기준, 포트 경계, 이벤트 계약, 재연결·복구와 승격 조건을 정한 설계다.
|
||||
- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Realtime events, Web Push, and bounded polling
|
||||
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-31
|
||||
- 요약: 설치된 route·계약·런타임 능력을 레지스트리에서만 파생해 보여 주는 플랫폼 구성 화면(`/examples/platform`)을 더하는 설계다.
|
||||
- 현재 정본: `src/presentation/examples/platform-overview-page.tsx`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 플랫폼 구성 화면 (`EXAMPLES_PLATFORM`) 설계
|
||||
|
||||
작성일: 2026-07-31
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 런타임 정합성 작업을 마무리하고 저장소 전체 리뷰에서 나온 query 무효화·mutation intent·release 증거·게이트 결함을 단계별로 고치는 수정 설계다.
|
||||
- 현재 정본: `src/contracts/query-invalidation.ts`, `src/contracts/mutation-intent.ts`, `docs/security/supply-chain.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Refactoring Review Remediation Design
|
||||
|
||||
## Purpose
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: release 산출물과 boot 프로토콜에서 실패를 통과시키던 경로를 먼저 막고, 런타임 소유권을 드러낸 뒤 도구와 큰 adapter를 정리하는 단계별 리팩터링 설계다.
|
||||
- 현재 정본: `scripts/contracts/release-artifacts.ts`, `src/bootstrap/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Runtime Integrity Refactor Design
|
||||
|
||||
## Purpose
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 테스트 보증과 CI/CD 실행을 `test-assurance-platform`과 `cicd-platform`으로 옮기고 이 repo에는 제품 코드와 제품 테스트만 남기는 설계다.
|
||||
- 현재 정본: `docs/operations/ci-quality-gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Platform-owned Frontend Assurance and Delivery Design
|
||||
|
||||
## Purpose
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: provider 증거 파일의 생성부터 봉인·게시까지를 guardian 프로세스 하나가 맡아, 중간에 죽어도 정본 증거가 남지 않고 바로 다시 시도할 수 있게 하는 설계다.
|
||||
- 현재 정본: `scripts/lib/provider-raw-guardian.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Provider Evidence Guardian Transaction Design
|
||||
|
||||
## Goal
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: risk-coverage 산출물 schema를 정책과 따로 version 3으로 올리고, 설치된 Vitest·V8이 내는 counter 유무 분류를 고정하는 계약 설계다.
|
||||
- 현재 정본: `scripts/check-v8-coverage-counter-semantics.ts`, `scripts/check-risk-coverage.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# V8 Coverage Counter Contract Design
|
||||
|
||||
## Goal
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-16
|
||||
- 요약: 어댑터 그룹의 `index.ts` 배럴을 실제 공개 경계로 만들고 그룹 밖은 배럴만 import하게 게이트로 강제하는 설계다.
|
||||
- 현재 정본: `docs/architecture/layers.md`, `.dependency-cruiser.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 어댑터 배럴(`index.ts`)을 공개 경계로 승격 — 설계서
|
||||
|
||||
- 대상 레포: `/home/donghyeon/workspace/desktop-server-git/clean-architecture-frontend-template`
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-16
|
||||
- 요약: 어댑터 4곳에 흩어진 IndexedDB 연결·트랜잭션 구현을 `src/adapters/platform/` 커널로 모으는 설계다.
|
||||
- 현재 정본: `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/platform/indexeddb-transaction.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# IndexedDB 커널 승격 — 구체 설계
|
||||
|
||||
> 대상 브랜치: `develop` (5434760)
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-20
|
||||
- 요약: `memento-frontend`를 이 템플릿에서 upstream 추적 방식으로 파생하는 절차와 그 전에 템플릿에서 고칠 것을 정한 설계다.
|
||||
- 현재 정본: `README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# memento-frontend를 이 템플릿에서 파생시키기 — 설계서
|
||||
|
||||
- 작성일: 2026-09-20
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-31
|
||||
- 요약: 플랫폼 구성 화면이 정적 선택뿐 아니라 런타임 해석 결과까지 보여 주고 진입 경로와 브라우저 회귀 시험을 갖추게 하는 구현 계획이다.
|
||||
- 현재 정본: `src/presentation/examples/platform-overview-page.tsx`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 플랫폼 구성 화면 완성 구현 계획
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 중복된 HTTP 실행 경로를 없애고 Service Worker 활성화 상한과 신원 확인을 강화한 뒤 큰 브라우저 adapter를 나누는 구현 계획이다.
|
||||
- 현재 정본: `src/adapters/http/`, `src/adapters/service-worker/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# HTTP Worker and Adapter Remediation Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: coverage·시나리오·CI·아키텍처 게이트가 실제 운영 동작을 재고, 측정 대상이 비었거나 모자라면 실패하게 하는 구현 계획이다.
|
||||
- 현재 정본: `docs/operations/ci-quality-gates.md`, `scripts/check-architecture.ts`, `scripts/check-risk-coverage.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Quality and Architecture Remediation Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 생성한 Release Manifest V2 산출물을 검증할 수 있게 하고, 브라우저가 V1/V1 또는 V2/V2 boot 프로토콜 짝만 받게 하는 구현 계획이다.
|
||||
- 현재 정본: `scripts/contracts/release-artifacts.ts`, `src/bootstrap/load-release-manifest.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Release and Boot Integrity Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 불변 release bundle 하나를 만들고, 모든 산출물·provider 보고·schema·digest가 그 바이트를 가리킬 때만 승격을 통과시키는 구현 계획이다.
|
||||
- 현재 정본: `docs/security/supply-chain.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Release Evidence Remediation Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: topic 무효화가 실제 bound query 전부에 닿게 하고, 논리적 mutation마다 고유한 intent와 결과를 반영한 낙관적 상태를 지키게 하는 구현 계획이다.
|
||||
- 현재 정본: `src/contracts/query-keys.ts`, `src/contracts/mutation-intent.ts`, `src/presentation/adapters/query/`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Runtime Correctness Remediation Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 인증 scope가 바뀐 뒤 이전 계정의 query와 낙관적 상태가 화면에 남거나 다시 쓰이지 않게 하는 구현 계획이다.
|
||||
- 현재 정본: `src/bootstrap/server-state-generation-store.ts`, `src/presentation/adapters/query/server-state-scope-provider.tsx`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Scope-Owned Server State Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: `cicd-platform`이 프론트 workflow 조정, 후보 생성, 공급망 증거, 불변 게시와 정확한 후보 승격을 혼자 맡게 하는 그 repo의 구현 계획이다.
|
||||
- 현재 정본: `docs/operations/ci-quality-gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# CI/CD Frontend Assurance and Delivery Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 끝남
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: coverage 출처 이름과 정적 분류를 Vitest·V8이 실제로 내는 counter에 맞추는 구현 계획이다.
|
||||
- 현재 정본: `scripts/check-risk-coverage.ts`, `config/testing/risk-coverage.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Counter-bearing Coverage Provenance Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 이 템플릿을 `test-assurance-platform`과 `cicd-platform`의 얇은 소비자로 바꾸면서 제품 소스·테스트·fixture를 그대로 두는 이행 계획이다.
|
||||
- 현재 정본: `docs/operations/ci-quality-gates.md`, `docs/testing/taxonomy.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Frontend Thin Platform Consumer Migration Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. Use `superpowers:using-git-worktrees` before editing.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 보안 리뷰에서 나온 증거·수명 주기·staging·출력·신선도·workflow 결함을 닫고, 캡처한 후보 archive와 다섯 파일 bundle 검증기만 승격 근거로 삼게 하는 수정 계획이다.
|
||||
- 현재 정본: `docs/security/supply-chain.md`, `scripts/lib/promotion-stager.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Promotion Security Review Fixes Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: guardian이 시작할 때 정리 권한을 spawn 전에 할당한 파일 신원에서만 얻게 하면서, 덮어쓰지 않는 게시와 즉시 재시도를 지키는 구현 계획이다.
|
||||
- 현재 정본: `scripts/lib/provider-raw-guardian.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Provider Evidence Guardian Transaction Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 캡처한 불변 후보를 무작위 비공개 staging 폴더 하나에 다섯 파일과 v3 검증 기록으로 마무리하는 구현 계획이다.
|
||||
- 현재 정본: `scripts/lib/promotion-stager.ts`, `scripts/lib/stage-verified-promotion-cli.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Security Finalizer Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: `test-assurance-platform`이 프론트 제품 suite의 선택·계획·실행·정규화·증거·판정을 모두 맡도록 넓히는 그 repo의 구현 계획이다.
|
||||
- 현재 정본: `docs/testing/taxonomy.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Test Assurance Frontend Capability Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 끝남
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: risk-coverage 산출물 schema version 3을 내고, 설치된 Vitest·V8의 counter 분류를 격리된 자식 실행에서 계속 검증하게 하는 구현 계획이다.
|
||||
- 현재 정본: `scripts/check-v8-coverage-counter-semantics.ts`, `scripts/check-risk-coverage.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# V8 Coverage Counter Contract Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: 확인된 adapter 정확성·수명 주기 결함을 모두 닫고 version 호환을 지킨 뒤에야 상태 기계 분리나 선택 capability 승격을 하는 수정 계획이다.
|
||||
- 현재 정본: `docs/operations/adapter-remediation-ledger.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Adapter Correctness and Refactoring Remediation Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 끝남
|
||||
- 작성일: 2026-09-16
|
||||
- 요약: 어댑터 16개 그룹 모두에 `index.ts` 공개 경계를 세우고 그룹 밖은 배럴만 import하게 게이트로 강제하는 구현 계획이다.
|
||||
- 현재 정본: `docs/architecture/layers.md`, `.dependency-cruiser.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 어댑터 배럴 공개 경계 확립 Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 끝남
|
||||
- 작성일: 2026-09-16
|
||||
- 요약: 어댑터 4곳의 IndexedDB 연결·트랜잭션 구현을 `src/adapters/platform/` 커널 두 파일로 모아 서로 다르던 동작을 하나로 맞추는 구현 계획이다.
|
||||
- 현재 정본: `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/platform/indexeddb-transaction.ts`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# IndexedDB 커널 승격 Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 끝남
|
||||
- 작성일: 2026-09-25
|
||||
- 요약: 2026-09-25 성숙도 리뷰 발견 138건을 고칠 때의 공통 완료 기준, 방향이 갈린 항목의 결정, repo 밖 사용자 몫을 정한 명세이고, 라운드는 v0.2.0(2026-09-27)으로 끝났다.
|
||||
- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# SPEC: 성숙도 리뷰(2026-09-25) 전 항목 반영
|
||||
|
||||
## 목적
|
||||
|
||||
Reference in New Issue
Block a user