docs(manual): 본문에 남은 이력 ID 19줄을 내용과 날짜로 바꾼다
문제: docs/manual 본문 19줄이 "리뷰 02-01 결정", "1라운드 06-01·06-03",
"리뷰 README 13.2, 09-02", "(05-01, 04-01, 06-01)", "sample P30 결정"처럼
지난 리뷰 번호만으로 이유를 댄다. 그 리뷰를 모르는 독자는 따라갈 수
없고, docs-writing.md 4절 6단계가 금지한다. 16줄은 --history 검사가
찾았고, 3줄은 걷어낸 뒤 grep으로 다시 읽어 찾았다.
고른 방법: 문장의 뜻은 두고 괄호만 바꾼다.
- 문장이 이미 내용을 말하는 곳(6줄)은 괄호를 지운다
- 지난 일이 근거인 곳은 날짜와 일어난 일로 바꾼다. 예: "2026-11-01
소유자 결정", "2026-11-01부터. 전에는 비어 있으면 검증을 건너뛰었다"
- README 제목 "1라운드 수정으로 생긴 패턴 (리뷰 README 13절)"은
"리뷰 뒤 첫 수정으로 생긴 패턴"으로 바꾼다. 이 제목을 가리키는 링크는
repo에 없다
걷어낸 번호와 원래 괄호, 원래 리뷰 문서와 발견 내용은
docs/work/evidence.md 8절에 표로 더했다(2026-11-06 표와 같은 칸).
버린 대안: 리뷰 문서로 링크 걸기. 본문이 다시 이력을 가리킨다.
위험·한계: 날짜와 "전에는" 문장은 1101 README 13절·15절과 영역 문서의
색인 문장에서 옮겼다. 코드로 다시 확인하지는 않았다. evidence.md 9절
T4-1 행("16줄은 고치지 않음")은 그때의 기록이라 고치지 않았다.
검증(desktop worktree, 이 커밋과 같은 트리 8ff82a67):
- python3 scripts/check-work-docs.py --history docs/manual
lines with history IDs: 0, rc=0
- python3 scripts/check-work-docs.py rc=0(분량, 본문 이력 0, 링크)
- python3 scripts/check-work-docs.py --links docs/manual docs/work
링크 113개, 깨진 것 0
- ./gradlew :app-bootstrap:documentContractTest rc=0, 22개 클래스
66건 통과, 실패·skip 0. docs/manual과 docs/work를 읽는 테스트는 없다
(src의 Java·Gradle에서 파일 이름·폴더 경로 grep, 주석 2곳만 걸림)
- grep -e 리뷰 -e 라운드 -e 결정 docs/manual/*.md로 남은 줄을 읽었다.
모두 날짜와 내용이 있는 문장이다
This commit is contained in:
@@ -37,7 +37,7 @@
|
||||
- **예외**: ② — 여러 서비스가 쓰는 플랫폼 기능, 배포마다 켜고 끄는 기능, 자기 설정 prefix와 자기
|
||||
저장소를 가진 기능. 이때는 capability 완료 기준 7개를 모두 지킨다(`AGENTS.md`, 10장).
|
||||
- **다시 볼 조건**: 파생 서비스가 둘 이상 생겨 같은 업무 기능을 공유하거나, application-core 컴파일·테스트
|
||||
시간이 문제가 되면 ①을 ②로 옮긴다(리뷰 01 영역 5.2절).
|
||||
시간이 문제가 되면 ①을 ②로 옮긴다.
|
||||
|
||||
### 판단: ③을 써도 되나
|
||||
|
||||
@@ -51,7 +51,7 @@
|
||||
| 계층 | 패키지 | 하위 패키지 |
|
||||
| --- | --- | --- |
|
||||
| domain | `dev.caskeleton.domain.<f>` | fake·계약은 testFixtures `dev.caskeleton.domain.<f>.testkit` |
|
||||
| application | `dev.caskeleton.application.<f>` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지(sample P30 결정과 같다) |
|
||||
| application | `dev.caskeleton.application.<f>` | 종류별 하위 패키지(`command`, `usecase`, `port`)를 만들지 않는다. 기능별 한 패키지(`sample-portfolio`도 2026-09-29에 이 배치로 옮겼다) |
|
||||
| outbound | `dev.caskeleton.adapter.outbound.<leaf>.<f>` | |
|
||||
| inbound | `dev.caskeleton.adapter.inbound.web.<f>` | |
|
||||
| bootstrap | `dev.caskeleton.bootstrap.autoconfigure.<f>` | `@AutoConfiguration`만(`BOOTSTRAP_AUTOCONFIGURE_STEREOTYPES_ARE_AUTO_CONFIGURATIONS`) |
|
||||
|
||||
@@ -127,8 +127,8 @@ capability 스트림 db/migration/jpa/<capability> 각자 histor
|
||||
- 이미 적용된 파일은 고치지 않는다. 고치면 체크섬 불일치로 기동이 멈추고, `repair`는 쓰지 않는다
|
||||
(`docs/jpa/migration-guide.md`).
|
||||
- 같은 스트림 안에서 기존 두 버전 사이에 끼워야 하면 소수 버전(`V8_1`)을 쓴다. 샘플 테스트 일부가 운영
|
||||
스트림과 샘플 스트림을 한 목록으로 합치는데, 정수 V9 이상은 운영이 이미 쓰고 있어서 `V8_1`을 골랐다
|
||||
(리뷰 README 13.2, 09-02).
|
||||
스트림과 샘플 스트림을 한 목록으로 합치는데, 정수 V9 이상은 운영이 이미 쓰고 있어서 2026-11-01 샘플에
|
||||
포스터 제목 유일 제약을 더할 때 `V8_1`을 골랐다.
|
||||
- 기존 데이터가 새 제약을 어기면 마이그레이션이 이유를 남기고 멈추게 쓴다(`V8_1`의 `DO $$` 블록). 조용히
|
||||
지우지 않는다.
|
||||
- 운영 중인 테이블을 잠그는 문장(`ALTER TABLE`, `CONCURRENTLY` 없는 `CREATE INDEX`, `UPDATE`·`DELETE`, 기존
|
||||
|
||||
@@ -85,13 +85,13 @@ claim의 lease가 작업 시작 전에 끝나면 두 저장소 모두 시작을
|
||||
소유자 결정). 거꾸로 말하면 `replay-ttl`(`APP_IDEMPOTENCY_TTL`)은 lease 이상, `failure-retention`
|
||||
이하로 둔다.
|
||||
|
||||
409를 `retryable=true`로 바꾼 이유(리뷰 02-01 결정): 같은 키 재전송은 서버가 안전하게 판정하므로 다시
|
||||
409를 `retryable=true`로 바꾼 이유(2026-11-01 소유자 결정): 같은 키 재전송은 서버가 안전하게 판정하므로 다시
|
||||
보내는 것이 맞고, 새 키로 보내면 서버가 막지 못한다. 짝 프론트 분류기도 이 표를 따른다.
|
||||
|
||||
## 결과 불명을 만드는 곳마다 같은 규칙
|
||||
|
||||
리뷰가 찾은 반복 원인 1번이 "결과 불명을 확실함으로 기록"이었다(05-01, 04-01, 06-01). 새 경계를
|
||||
만들 때 아래 질문에 답한다.
|
||||
2026-11-01 성숙도 리뷰가 찾은 반복 원인 첫째가 "결과 불명을 확실함으로 기록"이었다. 알림 발송·DB
|
||||
커밋·메시지 relay 세 경계에서 같은 실수가 나왔다. 새 경계를 만들 때 아래 질문에 답한다.
|
||||
|
||||
- **고르는 기준**: 실패한 호출이 **상대편에서 이미 효과를 냈을 수 있는가**.
|
||||
- **기본값**: 그럴 수 있으면 "결과 불명"으로 분류한다. 재시도 가능(`retryable=true`)으로 분류하지
|
||||
@@ -101,7 +101,8 @@ claim의 lease가 작업 시작 전에 끝나면 두 저장소 모두 시작을
|
||||
- 메시지 발행 응답 없음 → `OutboxPublishAmbiguousException`(application-core `outbox`)
|
||||
- 알림 발송 시작 뒤 crash → 재발송하지 않고 reconcile(application-notification evidence 모델)
|
||||
- **예외**: 요청이 상대에게 **도달하기 전**에 실패한 것이 증명되면(연결 수립 실패, 실행 전 거부)
|
||||
재시도 가능이다. 반대 방향 실수(확실히 안 간 것을 불명으로)도 결함이다(리뷰 05-17).
|
||||
재시도 가능이다. 반대 방향 실수(확실히 안 간 것을 불명으로)도 결함이다(2026-11-01 성숙도 리뷰가
|
||||
Redis 연결 수립 실패에서 찾았다).
|
||||
- 불명 상태를 푸는 방법(reconcile, 키 재전송, 운영자 확인)을 runbook에 적는다(`docs/runbooks/`).
|
||||
|
||||
## 지금 이해하면 되는 것
|
||||
|
||||
@@ -42,8 +42,8 @@ gRPC/GraphQL/WebSocket: 같은 ApiErrorCarrier를 자기 status 모양으로
|
||||
| DB·외부 의존 실패 | adapter가 shared-contract carrier(`PersistenceFailureException`, `DependencyFailureException`)로 | 분류표대로(04·05장) |
|
||||
|
||||
- `IllegalArgumentException`을 "서버 조립이 틀렸다"에 쓰지 않는다. web은 그것을 400으로 바꾸고 WARN
|
||||
한 줄만 남긴다(`GlobalExceptionHandler`). 서버 결함이 클라이언트 오류 통계에 섞여 경보가 울리지 않는다
|
||||
(리뷰 01-04). 서버 쪽 잘못은 `IllegalStateException`(500, 로그)이다.
|
||||
한 줄만 남긴다(`GlobalExceptionHandler`). 서버 결함이 클라이언트 오류 통계에 섞여 경보가 울리지 않는다.
|
||||
서버 쪽 잘못은 `IllegalStateException`(500, 로그)이다.
|
||||
- 메시지는 로그용이다. 클라이언트에는 코드와 category별 고정 문구(`ClientErrorMessages`)만 간다.
|
||||
메시지에 SQLState·내부 경로·토큰을 넣어도 클라이언트에 새지 않지만, 로그 정책은 지킨다.
|
||||
|
||||
|
||||
@@ -25,7 +25,8 @@
|
||||
| 프록시 가능 | `src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/authz/RequiresPermissionProxyabilityTest.java` |
|
||||
|
||||
검사 자동 설정은 인증 체인(`WebSecurityAutoConfiguration`)과 **분리**되어 있다. 서비스가 자기 인증
|
||||
방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(1라운드 07-03 수정).
|
||||
방식으로 인증 체인을 바꿔도 권한 검사는 꺼지지 않는다(2026-11-01부터. 전에는 샘플이 인증 체인 자동 설정을
|
||||
빼자 권한 검사도 함께 빠졌다).
|
||||
|
||||
### 지켜야 할 것 셋
|
||||
|
||||
@@ -48,8 +49,8 @@
|
||||
### 역할은 어디서 오나
|
||||
|
||||
JWT의 `realm_access.roles`와 **자기 client**(`app.security.audience`)의 `resource_access.<client>.roles`만
|
||||
읽는다. audience는 필수다(1라운드 02-03 수정). 같은 issuer의 다른 client가 같은 이름의 역할을 정의해도
|
||||
이 서비스 권한이 되지 않는다(`JwtToAuthenticatedPrincipalConverter`, `docs/runbooks/auth-audience-mismatch.md`).
|
||||
읽는다. audience는 필수다(2026-11-01부터. 전에는 비어 있으면 검증을 건너뛰었다). 같은 issuer의 다른
|
||||
client가 같은 이름의 역할을 정의해도 이 서비스 권한이 되지 않는다(`JwtToAuthenticatedPrincipalConverter`, `docs/runbooks/auth-audience-mismatch.md`).
|
||||
|
||||
## 객체 단위 권한
|
||||
|
||||
@@ -143,7 +144,7 @@ JWT의 `realm_access.roles`와 **자기 client**(`app.security.audience`)의 `re
|
||||
## web 없는 조립
|
||||
|
||||
web이 빠진 조립(gRPC 전용·배치 전용)에는 `@RequiresPermission`을 검사할 advisor가 없다. 그런 조립에
|
||||
권한을 선언한 bean이 있으면 `PermissionEnforcementGuard`가 기동을 실패시킨다(리뷰 01-06). web 없이
|
||||
권한을 선언한 bean이 있으면 `PermissionEnforcementGuard`가 기동을 실패시킨다. web 없이
|
||||
조립하는 서비스는 자기 전송에 맞는 검사 advisor를 함께 넣어야 기동한다.
|
||||
|
||||
## 지금 이해하면 되는 것
|
||||
|
||||
@@ -46,7 +46,8 @@ fake와 실제 adapter가 **같은 계약**을 통과해야 fake 위의 유스
|
||||
- **고르는 기준**: 포트 인터페이스가 어느 leaf에 있나.
|
||||
- **기본값**: 그 leaf의 `src/testFixtures/java/.../<f>/testkit/`. domain 포트면 domain-core,
|
||||
application 포트면 application-core. 소비 leaf는 `testImplementation testFixtures(project(':<owner>'))`.
|
||||
- **예외**: 없다. 테스트 안 private fake는 계약 밖에 있어 실제와 갈라진다(리뷰 01-05의 lock fake).
|
||||
- **예외**: 없다. 테스트 안 private fake는 계약 밖에 있어 실제와 갈라진다(2026-11-01 성숙도 리뷰가
|
||||
분산 lock 포트 계약 테스트 안의 fake에서 찾았다).
|
||||
|
||||
## lane과 단계
|
||||
|
||||
@@ -71,7 +72,8 @@ lane으로 선언하고 단계를 지정한다. 선언은 `ca.strict-test-lane`(
|
||||
- **예외**: 반드시 실행돼야 하는 소수 테스트(계약 자격 검사)는 `requires(클래스)` + `rejectSkipped = true`로
|
||||
이름을 박는다. 이름이 바뀌거나 지워지면 lane이 실패한다.
|
||||
- 새 lane이 어떤 단계에도 속하지 않으면 PR 게이트의 `verifyStrictLaneStages --dry-run`이 실패한다
|
||||
(1라운드 08-01). 단계는 집계 태스크(`integrationCheck` 등)를 통해 붙고, workflow 파일을 고치지 않는다.
|
||||
(2026-11-01부터. 전에는 어떤 workflow도 돌리지 않는 strict lane이 14개 있었다). 단계는 집계
|
||||
태스크(`integrationCheck` 등)를 통해 붙고, workflow 파일을 고치지 않는다.
|
||||
|
||||
## 지금 이해하면 되는 것
|
||||
|
||||
|
||||
@@ -35,7 +35,7 @@ DB 저장과 broker 발행을 따로 하면(dual write) 둘 중 하나만 성공
|
||||
6. schema를 출시한다: `src/test/resources/contracts/released-payload-schemas.sha256`에 새 version 파일의
|
||||
해시를 한 줄 더한다. 출시한 version 파일은 고치지 않는다 — 바뀌면 `ReleasedPayloadSchemaContract`
|
||||
테스트가 실패한다. 필드를 바꾸는 변경은 새 version으로 낸다. 절차: `src/application-core/README.md`
|
||||
"payload version 올리기"(리뷰 06-10).
|
||||
"payload version 올리기".
|
||||
|
||||
## 판단 지점
|
||||
|
||||
@@ -61,7 +61,7 @@ draft는 `IntegrationEventDrafts.draft(contract, eventId, aggregate, order, occu
|
||||
|
||||
- event id: 정규 소문자 UUIDv7, 소비자 중복 제거 키. draft(`IntegrationEventDraft`)가 다른 값(대문자,
|
||||
v4, `event-1` 같은 문자열)을 거부하므로 업무 쓰기에서 바로 실패한다 — 커밋된 뒤 relay에서 DEAD가 되지
|
||||
않는다(리뷰 06-06). 같은 작업의 재시도가 같은 event id를 내야 하면(durable operation) 작업 id를 쓰고,
|
||||
않는다. 같은 작업의 재시도가 같은 event id를 내야 하면(durable operation) 작업 id를 쓰고,
|
||||
작업 id가 UUIDv7이 아니면 작업 id와 접수 시각에서 UUIDv7을 파생한다.
|
||||
- correlation: 헬퍼가 정한다. 요청의 correlation id가 `IntegrationIdentity` 문법·길이에 맞으면 그것,
|
||||
아니면 event id. 문법 밖 헤더가 업무 쓰기를 실패시키지 않는다. 값을 미리 검사해야 하면 문법을 베끼지
|
||||
@@ -70,7 +70,7 @@ draft는 `IntegrationEventDrafts.draft(contract, eventId, aggregate, order, occu
|
||||
- tenant 범위: tenant가 없는 기능은 `IntegrationEventDrafts.SINGLE_TENANT_SCOPE`(`global`).
|
||||
- aggregate 순서: `OutboxAggregateSequencePort.nextSequence(aggregate)`로 같은 `tx.inWrite` 안에서
|
||||
받는다(V21 카운터, 커밋 순서를 따른다). 이벤트가 하나뿐인 aggregate는 `AggregateOrder.first()`. 발생
|
||||
시각(벽시계)은 쓰지 않는다 — 서버 시계가 어긋나면 순서가 뒤집힌다(리뷰 06-07). 벽시계 번호를 쓰던
|
||||
시각(벽시계)은 쓰지 않는다 — 서버 시계가 어긋나면 순서가 뒤집힌다. 벽시계 번호를 쓰던
|
||||
서비스가 포트로 옮기면 V21 floor 덕분에 새 번호는 옛 번호 뒤에서 시작한다. 그래서 첫 번호가 1이
|
||||
아니라 약 1.7×10¹⁵일 수 있다. 소비자는 번호를 "마지막으로 본 값보다 큰가"로만 비교하고 연속성을
|
||||
가정하지 않는다. 비교는 aggregate identity(tenant scope 포함) 단위다. tenant scope를 바꾸는 배포는 옛
|
||||
@@ -83,8 +83,8 @@ draft는 `IntegrationEventDrafts.draft(contract, eventId, aggregate, order, occu
|
||||
선언이 없어서, bean이 되면 전송 계층이 **권한 검사 없이** 닿는다. 그래서 bean으로 등록하면
|
||||
`PermissionEnforcementGuard`가 기동을 실패시킨다(07장 「시스템이 부르는 쓰기」).
|
||||
- broker의 **재시도 가능한** 거부와 응답 없음은 DEAD가 아니라 backoff 재시도다. broker가 멈춰도 대량
|
||||
DEAD가 되지 않는다(1라운드 06-01·06-03). 대신 끝이 없다: 진짜 인증 오류, Kafka adapter가 이름을 모르는
|
||||
broker 거부도 영원히 재시도된다. 행의 `last_failure_code`와 로그의 `error.reason`이 원인 코드를 남기고,
|
||||
DEAD가 되지 않는다(2026-11-01부터. 전에는 broker가 몇 분만 멈춰도 행이 대량으로 DEAD가 됐다). 대신
|
||||
끝이 없다: 진짜 인증 오류, Kafka adapter가 이름을 모르는 broker 거부도 영원히 재시도된다. 행의 `last_failure_code`와 로그의 `error.reason`이 원인 코드를 남기고,
|
||||
`outbox.retry.long.size`가 오래 재시도 중인 행을 센다. 처분(보류·재개·skip)은 publish-failed runbook
|
||||
§4.1이다.
|
||||
- 발행 응답을 못 받으면 결과 불명(`OutboxPublishAmbiguousException`) — 05장 규칙과 같다.
|
||||
|
||||
@@ -56,7 +56,7 @@
|
||||
## 따라 할 예시는 하나
|
||||
|
||||
예시가 셋(sample-portfolio 수직, onboarding fixture, durable operation)이라 어느 것을 베끼느냐에 따라
|
||||
배치가 달라졌다(리뷰 2026-11-01 01-01·07-09). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다.
|
||||
배치가 달라졌다(2026-11-01 성숙도 리뷰). 이제 **새 업무 기능의 예시는 생성 명령의 출력 하나**다.
|
||||
|
||||
| 코드 | 역할 | 따라 하나 |
|
||||
| --- | --- | --- |
|
||||
@@ -65,9 +65,9 @@
|
||||
| `src/app-bootstrap/src/test/java/dev/caskeleton/onboarding/**` | ArchUnit 규칙이 새 기능 모양에 적용되는지 확인하는 테스트 fixture | 따르지 않는다 |
|
||||
| `application-core/.../operation` + `DurableOperationAutoConfiguration`(composition:durable-operation) | 템플릿 플랫폼 기능 | 조립 모양(`@ConditionalOnBean` + 유스케이스 `@Bean`)만 본다 |
|
||||
|
||||
## 1라운드 수정으로 생긴 패턴 (리뷰 README 13절)
|
||||
## 리뷰 뒤 첫 수정으로 생긴 패턴
|
||||
|
||||
리뷰 뒤 1라운드에서 굳은 모양이다. 각 장에 반영했다.
|
||||
2026-11-01 성숙도 리뷰 뒤 같은 날 한 첫 수정에서 굳은 모양이다. 각 장에 반영했다.
|
||||
|
||||
| 패턴 | 근거 코드 | 장 |
|
||||
| --- | --- | --- |
|
||||
|
||||
+26
-1
@@ -150,7 +150,7 @@
|
||||
- 나머지 20건은 round6 Minor다(`RR6-01-02`~`06`·`08`·`09`, `RR6-02-02`·`04`·`05`, `RR6-03-02`~`05`, `RR6-04-01`~`06`). README 17절은 영역별 건수만 적었고, r10 묶음이 영역 단위로 고쳤다.
|
||||
- 이 검사는 "색인에 이름이 있나"만 본다. 고쳤는지는 처리 표와 확인 리뷰가 본다. 앞으로의 리뷰 README는 모든 ID를 이름으로 적는다(`improve.md` 4.1절 7단계).
|
||||
|
||||
## 8. `docs/manual/`에서 걷어낸 이력 ID (2026-11-06)
|
||||
## 8. `docs/manual/`에서 걷어낸 이력 ID (2026-11-06, 2026-11-07)
|
||||
|
||||
`docs/manual/` 본문에서 리뷰 ID와 번호만 쓴 결정을 걷어냈다. 문장의 뜻은 그대로이고, 괄호 안 근거만 여기로 옮겼다. 줄 번호는 걷어내기 전 기준 커밋 `06f520e6`의 줄이다.
|
||||
|
||||
@@ -167,6 +167,31 @@
|
||||
|
||||
- `RR-01-11`·`RR-02-10`·`RR-03-11`은 2차 재리뷰(`round2/`) 문서의 발견이다. 그 문서들은 1차 번호에 이어 `RR-` 접두어를 그대로 썼다(머리말 「표기」).
|
||||
|
||||
2026-11-07에 남은 19줄을 같은 방식으로 걷어냈다. 16줄은 2026-11-06 검사 패턴을 넓힌 뒤 드러난 줄이다(9절 T4-1). 3줄(아래 표에서 「손으로 찾음」)은 그 패턴도 못 잡아 `docs-writing.md` 9절대로 grep으로 찾았고, 그 꼴을 잡는 패턴 셋을 `scripts/check-work-docs.py`에 더했다. 줄 번호는 걷어내기 전 기준 커밋 `73d39212`의 줄이다. 「1라운드」는 `1101` README 13절 「조치 현황 (개선 순서 1~3)」으로, 리뷰 직후 2026-11-01에 한 첫 수정이다(같은 날 밤 13.1절 게이트, 14절 「2라운드」가 이어졌다). 영역 문서 이름은 `docs/reviews/2026-11-01-maturity-review/` 안의 파일이다.
|
||||
|
||||
| 원래 위치 | 원래 괄호 | 지금 본문 | 근거 |
|
||||
| --- | --- | --- | --- |
|
||||
| `docs/manual/README.md:59` | "리뷰 2026-11-01 01-01·07-09" | "2026-11-01 성숙도 리뷰" | `1101/01-01`(새 기능을 어느 leaf에 두는지 세 가지 모양이 있고 고르는 기준이 없다, `01-core-and-feature-pattern.md`), `1101/07-09`(새 기능을 만들 때 따라 할 예시가 세 갈래다, `07-bootstrap-composition-config.md`) |
|
||||
| `docs/manual/README.md:68`, `:70` | 제목 "1라운드 수정으로 생긴 패턴 (리뷰 README 13절)", 본문 "리뷰 뒤 1라운드" | 제목 "리뷰 뒤 첫 수정으로 생긴 패턴", 본문 "2026-11-01 성숙도 리뷰 뒤 같은 날 한 첫 수정" | `1101` README 13절. 표의 패턴 행은 13절 각 행의 수정 내용이다 |
|
||||
| `docs/manual/03-placement.md:40` (손으로 찾음) | "리뷰 01 영역 5.2절" | 괄호를 지웠다. 다시 볼 조건 문장이 내용 전부다 | `01-core-and-feature-pattern.md` 5.2절 「새 기능의 배치」 표의 「7. 바뀔 조건」 |
|
||||
| `docs/manual/03-placement.md:54` (손으로 찾음) | "sample P30 결정과 같다" | "`sample-portfolio`도 2026-09-29에 이 배치로 옮겼다" | P30은 2026-09-25 리뷰 후속 작업 Wave 3 라운드 4의 묶음 이름이다. 그 묶음이 `S6-#10a`(sample 패키지가 종류별·기능별로 섞였다)를 고쳐 sample application을 기능별 패키지로 옮겼다(`docs/reviews/2026-09-25-review-followup-status.md` `S6-#10a` 행, 커밋 `8bbf1bf01`, 2026-09-29). `07-bootstrap-composition-config.md` 07-09 「근거」의 "P30 결정"도 같은 것이다 |
|
||||
| `docs/manual/04-persistence.md:131` | "리뷰 README 13.2, 09-02" | "2026-11-01 샘플에 포스터 제목 유일 제약을 더할 때" | `1101/09-02`(포스터 제목 중복 규칙이 동시 요청에서 깨지고 검사 쿼리가 순차 스캔이다, `09-performance-measurement.md`). 번호 선택은 `1101` README 13.2절 「09-02 마이그레이션 번호」 행 |
|
||||
| `docs/manual/05-idempotency.md:88` | "리뷰 02-01 결정" | "2026-11-01 소유자 결정" | `1101/02-01`("처리 중" 409의 클라이언트 행동이 코드·문서·짝 계약에서 서로 다르다, `02-inbound-web.md`). 고른 안은 `1101` README 5절 (A), 소유자 결정은 15절 「처리 중 409」 행 "소유자 결정(11-01)" |
|
||||
| `docs/manual/05-idempotency.md:93` (손으로 찾음) | "리뷰가 찾은 반복 원인 1번", "(05-01, 04-01, 06-01)" | "2026-11-01 성숙도 리뷰가 찾은 반복 원인 첫째", "알림 발송·DB 커밋·메시지 relay 세 경계" | `1101` README 4절 1번. `1101/05-01`(알림 attempt를 "시작 안 함(확정)"으로 저장한 채 provider를 부른다), `1101/04-01`(커밋 중 끊김을 재시도 가능으로 답한다), `1101/06-01`(재시도 가능한 거부를 즉시 DEAD로 보낸다) |
|
||||
| `docs/manual/05-idempotency.md:104` | "리뷰 05-17" | "2026-11-01 성숙도 리뷰가 Redis 연결 수립 실패에서 찾았다" | `1101/05-17`(Redis 연결 실패를 결과 불명으로 보고하고, 시간 초과된 연결을 pool에 돌려준다, `05-outbound-capabilities.md`). README 4절 1번의 "반대 방향" |
|
||||
| `docs/manual/06-errors.md:46` | "리뷰 01-04" | 괄호를 지웠다 | `1101/01-04`(`IllegalArgumentException` 하나가 입력 오류와 서버 조립 오류를 함께 뜻하고, web은 둘 다 로그 없이 400으로 바꾼다, `01-core-and-feature-pattern.md`) |
|
||||
| `docs/manual/07-authorization.md:28` | "1라운드 07-03 수정" | "2026-11-01부터. 전에는 샘플이 인증 체인 자동 설정을 빼자 권한 검사도 함께 빠졌다" | `1101/07-03`(실행 중인 샘플에서 `@RequiresPermission`이 아무 일도 하지 않았다, `07-bootstrap-composition-config.md`). 수정은 `1101` README 13절 `07-03+09-03` 행 |
|
||||
| `docs/manual/07-authorization.md:51` | "1라운드 02-03 수정" | "2026-11-01부터. 전에는 비어 있으면 검증을 건너뛰었다" | `1101/02-03`(JWT audience 검증이 기본으로 꺼져 있고 모든 client의 role을 합친다, `02-inbound-web.md`). 수정은 13절 `02-03+07-05` 행 |
|
||||
| `docs/manual/07-authorization.md:146` | "리뷰 01-06" | 괄호를 지웠다 | `1101/01-06`(`@RequiresPermission`은 application 계약인데 검사는 web leaf가 켜 주는 AOP에만 있다, `01-core-and-feature-pattern.md`) |
|
||||
| `docs/manual/08-testing.md:49` | "리뷰 01-05의 lock fake" | "2026-11-01 성숙도 리뷰가 분산 lock 포트 계약 테스트 안의 fake에서 찾았다" | `1101/01-05`(application-core 포트 절반이 fake·adapter 공유 계약 밖에 있다, `01-core-and-feature-pattern.md`). lock fake는 그 근거 칸의 `DistributedLockPortContractTest.java:46` private 클래스다 |
|
||||
| `docs/manual/08-testing.md:74` | "1라운드 08-01" | "2026-11-01부터. 전에는 어떤 workflow도 돌리지 않는 strict lane이 14개 있었다" | `1101/08-01`(CI가 실행하지 않는 strict lane 14개, `08-build-ci-test.md`). 수정은 13절 `08-01+08-04+03-12` 행 |
|
||||
| `docs/manual/09-outbox-events.md:38` | "리뷰 06-10" | 괄호를 지웠다 | `1101/06-10`(이벤트 payload 버전을 올리는 방법과 호환성 검사가 없다, `06-messaging.md`. 색인 누락을 정정하며 붙은 번호) |
|
||||
| `docs/manual/09-outbox-events.md:64` | "리뷰 06-06" | 괄호를 지웠다 | `1101/06-06`(application EventId 문법과 platform MessageId(UUID)가 다르다, `06-messaging.md`) |
|
||||
| `docs/manual/09-outbox-events.md:73` | "리뷰 06-07" | 괄호를 지웠다 | `1101/06-07`(샘플이 aggregate 순서 번호를 벽시계로 만든다, `06-messaging.md`) |
|
||||
| `docs/manual/09-outbox-events.md:86` | "1라운드 06-01·06-03" | "2026-11-01부터. 전에는 broker가 몇 분만 멈춰도 행이 대량으로 DEAD가 됐다" | `1101/06-01`(다시 시도하면 될 거부를 relay가 즉시 DEAD로 보낸다), `1101/06-03`(broker가 몇 분만 멈춰도 행이 대량으로 DEAD가 된다), 둘 다 `06-messaging.md`. 수정은 13절 `06-01+06-03` 행 |
|
||||
|
||||
- 더한 패턴 셋: 앞말 없이 나열한 발견 번호(`05-01, 04-01`, `01-01·07-09`), 리뷰 영역 번호(`리뷰 01 영역`, `01 영역 5.2절`), 리뷰 후속 묶음 번호(`P30`, `W3-P30`. P50 이상은 백분위수라 잡지 않는다). 홀로 선 `NN-NN` 하나는 보통 범위나 장 번호일 수 있어 여전히 잡지 않는다.
|
||||
|
||||
## 9. cold-read 시험 1회차 빈틈 처리 (2026-11-06)
|
||||
|
||||
2026-11-06 이력 없는 세션 6개에 이 매뉴얼만 주고 실제 일을 시켰다(기준선 1개는 옛 매뉴얼). 6개 모두 일은 끝냈지만 매뉴얼에서 답을 못 찾은 곳이 1~9건씩 나와 모두 불합격이었다. 아래는 시험 기록(design-docs `delegation-loop/trials/2026-11-06-*.md`)의 「질문」·「위반」 표와 각 세션 공유 노트(`~/.config/Claude/side-session-notes/local_fcd89c34-c754-4c5b-a38f-fa322834286f/`)의 「매뉴얼에서 답을 못 찾은 곳」을 한 줄씩 처리한 결과다. 기준 커밋 `2c8a359d`.
|
||||
|
||||
Reference in New Issue
Block a user