docs(review): 결정 대기 항목의 결정과 이유를 적는다
문제: 13.5절의 건너뛴 20건과 5절의 확장 지점 범위가 결정을 기다리고 있었다. 결정이 없어서 0929/08-02·08-03, 13-01 같은 항목이 계속 미뤄졌다. 방법: 사용자가 결정을 오케스트레이터에게 맡겼다. 14절에 항목마다 결정, 이유, 버린 대안을 적었다. 레지스트리 기준선 재승인도 이 위임으로 한다는 것을 함께 적었다. 처리 결과는 구현을 합친 뒤 14.2절에 적는다. 위험: 08-03(raw mutation 제거)과 0929/05-03(recipe port 통합)은 다운스트림 코드를 깨는 공개 계약 변경이다. CHANGELOG에 이행 방법을 함께 적어야 한다. 검증: 문서만 바꿨다. 결정 근거는 각 영역 문서의 최소 개선 방향·대안 비교와 지난밤 에이전트 보고에서 가져왔다.
This commit is contained in:
@@ -365,6 +365,8 @@
|
||||
|
||||
### 13.5 건너뛴 것 — 결정이 필요하다
|
||||
|
||||
> 2026-11-03에 14절에서 모두 결정했다.
|
||||
|
||||
| ID | 건너뛴 이유 | 정할 것 |
|
||||
|---|---|---|
|
||||
| 08-08, 08-03 | 리뷰의 수정안(파일 분리)만으로는 효과가 없다. 배럴이 다시 내보내는 모듈은 side effect가 있다고 보고 모두 초기 청크에 들어간다. design-system을 side effect 없는 모듈로 선언하면 초기 JS가 1,067 B 줄지만 초기 청크가 16개에서 21개로 는다 | 바이트와 요청 수 중 무엇을 줄일지 |
|
||||
@@ -408,3 +410,36 @@
|
||||
### 13.8 마지막 게이트 (`e4ace51`, 오케스트레이터, 2026-11-02 00:32~)
|
||||
|
||||
`test:sample-removal`(설치 기능 0개에서 타입 검사·커버리지·빌드 포함) 통과, `check:bundle` 통과(초기 JS 203,816 / 204,800 B). `check:architecture`, `check:types`, `lint`, unit 2,497건, component 228건, integration 159건, contract 23건, runtime-schema 56건, `verify:documentation`, `check:adapter-inventory`, `check:ci`, `test:system` 112건, `check:design-system`, `check:i18n` 통과. 그 전 검증(`373b27b` 기준)에서 e2e 3엔진 187건 통과·3건 skip, 규모 측정은 `9333595`에서 다시 쟀다. 실제 Gitea runner에서는 돌리지 않았다(6절).
|
||||
|
||||
## 14. 결정 (2026-11-03)
|
||||
|
||||
사용자가 13.5절과 5절의 결정을 오케스트레이터에게 맡겼다("결정 대기 부분을 지금 바로 결정하고 처리"). 아래가 그 결정이다. 레지스트리 기준선 재승인도 이 위임으로 했다(승인자 `DongHyeonka`, 이유 문장에 위임을 적음). 처리 결과는 14.2절에 적는다.
|
||||
|
||||
### 14.1 결정표
|
||||
|
||||
| ID | 결정 | 이유 | 버린 대안 |
|
||||
|---|---|---|---|
|
||||
| 5절 확장 지점 (09-02, 09-03) | (가) 템플릿이 확장 지점을 연다. 개선 순서 3(매뉴얼·생성 명령) 전에 한다 | 제품이 템플릿 파일을 고치면 동기화마다 충돌한다(tech-log 10, memento 4). 매뉴얼과 생성 명령이 기능 추가 경로를 고정하므로 경로를 먼저 확정해야 한다 | (나) 템플릿 파일 수정을 공식 경로로 문서화: 충돌 비용이 계속 남는다 |
|
||||
| 08-08 | design-system 모듈을 side effect 없음으로 선언해 갤러리 전용 primitive를 초기 청크에서 뺀다 | 예산이 걸린 지표는 바이트다(−1,067 B, 여유 984 → 약 2,000 B). 늘어나는 청크(16 → 21)는 modulepreload로 병렬로 받아 HTTP/2에서 왕복이 늘지 않는다. 재검토: HTTP/1.1 호스팅 | 파일 분리만(실측 효과 없음), `manualChunks` 이름 고정(제품이 primitive를 쓸 때마다 다시 맞춤) |
|
||||
| 08-03 | raw mutation 입력을 공개 훅에서 빼고 테스트 harness로 옮긴다(**BREAKING**). raw query 입력은 남기되, 세션 경계를 넘어 결과를 보일 수 있으면 함께 뺀다 | 멱등 키 없는 중복 생성과 동작하지 않는 "다시 보내기"는 쓰기 경로에서만 생긴다. 읽기는 다시 보내도 부작용이 없고 memento가 raw query를 12곳에서 쓴다 | 둘 다 제거(다운스트림 query가 깨지는데 얻는 안전이 작다), 현상 유지 |
|
||||
| 0929/01-01 ④ | 실패를 만드는 곳에서 출처(BFF 발급 / object store)를 표시하고 번역이 그것으로 나눈다. BFF 발급 401·403 → `NONE`, object store PUT 403 → `RESUME`(기존 보존 조건) | 백엔드 code를 바꾸지 않고 프론트 안에서 끝난다. 출처는 실패를 만드는 곳만 정확히 안다 | 백엔드가 code를 나눔(두 repo 계약 변경), code로 추측(두 출처의 code가 같다) |
|
||||
| 0929/03-04 | 보낸 요청 id를 실행 결과에 싣고, 반사 헤더가 없으면 그 값을 문의 식별자로 쓴다 | 결과 불명 쓰기는 문의가 가장 필요한 경우다. 화면 쪽 줄은 `e54fbf2`가 이미 넣었다 | — |
|
||||
| 0929/05-01 | 손상 행은 건너뛰고 수를 보고한다. 승인된 LOGOUT·ACCOUNT_DELETION이 손상 때문에 끝나지 않으면 mutation lease 안에서 partition 디렉터리를 지운다 | 계정 삭제 뒤 개인 바이트가 남으면 삭제 계약 위반이고 스스로 풀리지 않는다. 손상은 보고 수로 드러난다 | 현상 유지(삭제 영구 실패), 건너뛰기만(손상 행 바이트가 남음), journal DB 전체 삭제(다른 partition까지 지움) |
|
||||
| 0929/05-03 | recipe 쪽 같은 이름 port를 지우고 src port를 다시 내보낸다. recipe fake는 src port를 구현하거나 catalog에서 뺀다 | 갈라진 복사본이 port 변경을 하나도 반영하지 못했다(05-01~05-14). 다운스트림이 쓰면 컴파일 오류로 드러난다 | 이름만 `*Sketch`로 표시(중복 유지비 남음), 두 벌 비교 테스트(두 벌 유지) |
|
||||
| 0929/05-04, file-transfer 예산, realtime 여유 | 레시피 예산 규칙을 바꾼다. 이번 수정을 합친 뒤 측정값 + 3%를 100 B 단위로 올린 값으로 한 번 정하고, 근거를 예산 옆에 적는다. 그 뒤 3%를 넘는 증가는 커밋 본문에 이유를 쓰고 올린다. file-transfer 인상(55,700 → 56,100)은 받아들이고 새 규칙으로 다시 정한다 | 수정마다 100 B씩 올리는 지금 규칙은 한도가 "직전 측정값"이라 증가를 묻는 신호가 되지 못한다 | 수정마다 100 B(현상), 레시피 예산에서 kernel 제외(kernel 증가를 놓침) |
|
||||
| 0929/06-05 | SW가 `ACTIVE`·`REMOVE_REGISTRATION`일 때만 cache policy에 `service-worker.js` `no-cache`를 요구하고 live probe가 확인한다 | 새 워커와 자기 해제 워커는 페이지 없이 복구하는 유일한 경로다 | — |
|
||||
| 0929/07-01 (2)(3) | 현재 diff와 맞지 않는 증거 행이 있으면 실패하고 목록을 보인다. `update:registry-baseline`이 설명이 끝난 행을 지운다. 이력 파일은 두지 않는다 | 목록 출력만으로는 아무도 보지 않는다(M0). 정리가 자동이라 실패 비용이 작다. git 이력이 이력이다 | 목록 출력, 이력 파일로 이동 |
|
||||
| 0929/07-03 | (B) `paramsSchema`·`searchSchema`를 allowlist에서 빼고 `loadingSurface`는 이름 형식만 본다. 두 번째 기능 테스트로 "governance 무수정"을 고정한다. 기준선 재승인 | 기능 하나 추가가 템플릿 파일 수정을 요구하는 지점이고 두 다운스트림 모두 충돌했다 | (A) 문서만 정정(기능마다 비용 반복), (C) 기능이 allowlist 값을 기여(등록 규약이 하나 더 생김) |
|
||||
| 0929/08-02 | 문구 literal 검사를 ESLint `no-restricted-syntax`(JSXText, 표시·접근성 속성)로 옮기고 `check:i18n`은 catalog parity와 raw backend 메시지만 본다 | 지금 검사는 한국어 주석을 걸고 영어 문구를 놓친다. ESLint 설정은 제품이 덮어쓸 수 있는 자리라 확장 지점 결정과 무관하게 할 수 있다 | 정규식 검사 보강(주석·문자열 구분을 다시 구현) |
|
||||
| 0929/08-03 | (B) catalog 문자열의 `{이름}`에서 파라미터 타입을 만든다. 값 타입은 `string \| number` | 새 개념 없이 기능이 템플릿 파일을 고치지 않는다 | (C) 기능이 파라미터 타입을 따로 선언(catalog와 따로 맞춰야 함) |
|
||||
| 0929/10-02 | ①② 한다. 플랫폼 화면 테스트를 테스트 전용 라우트로 옮기고 스타터 검사는 `starter-*` 파일로 모은다. HTTP 시나리오와 타입 음성 fixture를 테스트 계약으로 옮겨 샘플 제거 뒤에도 남긴다 | 선언된 제거 경로에서 가드레일이 조용히 사라지고, 동기화마다 같은 파일이 충돌한다 | ③ "함께 사라지는 검사" 목록만 문서화(검사는 계속 사라짐) |
|
||||
| 04-02 | (a) effect·recovery·close 마감의 failureKind를 설계 13.1 표에 맞춘다 | 관측에서 "서버가 조용함"과 "우리 effect가 멈춤"을 나눌 수 있어야 한다. 운영 중인 제품이 없어 지금이 가장 싸다 | (b) 문서만(관측에서 구분 안 됨) |
|
||||
| 09-06 (3) | context 라우트를 불러올 때 handle id가 기능 계약 라우트 id에 없으면 기능 id·라우트 id를 담아 실패한다 | 헬퍼 방식은 그 헬퍼를 쓰는 context만 지킨다. 적재 검사는 모든 context에 걸리고, 모든 context를 불러오는 단위 테스트가 개발 단계에서 잡는다 | 헬퍼 제공(선택형), 생성기 검사(생성기는 handle을 모름) |
|
||||
| 16-03 | `EXTERNAL_BEARER`로 바꾸고 옛 이름은 한 릴리스 동안 `@deprecated` 별칭으로 둔다. 기준선 재승인 | 제품 코드가 지워진 샘플 이름을 계속 쓰게 된다 | 이름 유지 |
|
||||
| 12-04 (4) | `token-contract.ts`에 "제품이 싣는 글꼴" 목록을 두고 디자인 규칙이 허용한다 | memento 토큰이 이미 규칙에 걸린다. 목록이 없으면 제품이 템플릿 스크립트를 고친다 | 메시지·문서만(막히는 경우가 그대로) |
|
||||
| 12-05 | `check:feature-index`는 지우지 않는다. `verify:extreme-scale`이 쓴다. 이유 문구만 실제 사용처로 고친다 | 사용처가 있다 | 삭제 |
|
||||
| 10-04 정책 | 유지한다. 빠른 계층에는 quarantine이 없다. 불안정한 테스트는 고치거나 느린 계층으로 옮긴다. 허용 목록은 필요해질 때 둔다 | 규칙이 하나라 예외를 기억할 필요가 없다 | quarantine 허용 목록(지금 대상 0건) |
|
||||
| registry-baseline `source` | 0929/07-03·16-03 재승인 때 함께 고친다 | 재승인을 한 번으로 묶는다 | — |
|
||||
| 13-01 | (c) live probe가 배포된 `buildId`·`releaseId`를 승격 후보와 비교한다. `production_gate`는 다시 빌드하지 않고 후보 `dist`를 본다. 비어 있는 배포 슬롯 job을 선언하고, 비어 있으면 `UNVERIFIED`로 끝난다 | 지금 PASS는 "떠 있는 이전 release가 맞다"는 거짓 PASS다. CD 자동화(로드맵 6)의 전제다 | (b) 비교만(운영 단계가 항상 FAIL), (d) 별도 workflow(Gitea에서 run 간 artifact 전달 미검증) |
|
||||
| 13-02 | 예약 이름(`example.*`, `.example`, `.invalid`, `.test`)을 공개 대상 승인에서 거절하고 README 예시 URL을 빈칸으로 바꾼다 | 자리표시자 endpoint가 운영 승인을 받는다 | 프로필 기본값 비우기(예시로 읽히지 않고 세 프로필을 다 바꿔야 함) |
|
||||
| 13.6 OPFS 여러 페이지 purge | 고친다. 0929/05-02의 "건너뛴 객체가 있으면 true" 규칙은 지키고, 페이지 넘김 때문에 생긴 true만 없앤다 | 다 지웠는데 남았다고 보고하고 sweep을 건너뛴다 | — |
|
||||
|
||||
Reference in New Issue
Block a user