docs(work): 소유자 결정 네 건을 결정 색인에 적는다
round7 확인 리뷰와 멱등 저장소 수정(t5)이 소유자 결정 네 건을 남겼고, 소유자가 2026-11-06 모두 권하는 안으로 정했다. 다음 수정 묶음이 다시 묻지 않도록 결정 색인의 해당 절에 내용과 출처를 적는다. - 계약·오류: 네 전송이 원인 사슬의 첫 carrier를 본다 - 멱등성: 넘겨받기 전 핸들의 재전송은 적용한 핸들에게만 확인한다, 해제된 핸들의 start는 ABSENT와 NOT_OWNER를 둘 다 받는다 - 영속성: 실패한 동시 인덱스 마이그레이션은 그 버전의 실패 이력 행만 지우고 다시 배포한다 - 빌드·게이트: paths 필터 trigger만 있는 workflow는 단계 실행으로 세지 않는다 검증: scripts/check-work-docs.py rc=0.
This commit is contained in:
@@ -82,6 +82,7 @@
|
||||
| Draft-12 offset 불일치 | problem 문서는 프로토콜 예외로 유지 | 소유자 | 결정 12 |
|
||||
| 알림 category 생략 | 거부(400), 판정은 유스케이스 | 소유자 | 결정 13 |
|
||||
| 오류 코드 로그 레벨 | `error-codes.yaml`에 `log_level` 칸을 두지 않는다. 레벨은 실패 종류·경로가 정한다(`ServerFailureLog`, 보안 필터 `AuthErrorResponseWriter`). 칸이 다시 생기면 `OperationalErrorRegistryContractTest`가 실패한다. 보안 필터는 5xx(`AUTH_JWKS_UNAVAILABLE`·`INTERNAL_AUTH_MISCONFIGURATION`)를 ERROR, 4xx를 WARN으로 남긴다. 401 서명·issuer·audience 불일치는 WARN | 소유자 | 2026-11-06, `docs/superpowers/specs/2026-11-06-error-code-log-level-design.md` 10절 |
|
||||
| 감싼 carrier를 전송이 읽는 법 | web·GraphQL·STOMP·gRPC 네 전송 모두 원인 사슬의 첫 carrier를 본다. 감싼 carrier의 응답이 500 `INTERNAL_ERROR` 대신 그 carrier의 코드가 된다 | 소유자 | `1103` 18.4절(RR7-01-05), 2026-11-06 |
|
||||
|
||||
### 2.4 멱등성
|
||||
|
||||
@@ -100,6 +101,8 @@
|
||||
| complete 재생 판정 | 완료 확인은 같은 owner token에만 준다. 같은 operation id를 쓴 다른 attempt의 늦은 complete는 `NOT_OWNER` | 기본값(2026-11-06) | Redis TRANSITION에 맞춤, `IdempotencyStoreContract` |
|
||||
| 기록 없는 release | 저장소 셋 다 `ABSENT`로 답한다(확인할 수 없는 해제를 확인하지 않는다). Redis release도 핸들 revision을 본다. release한 기록을 지울지 남길지는 저장소가 정하므로 release 재시도 답은 `ABSENT`(Redis·fake)와 `ALREADY_RELEASED_SAME_OPERATION`(PostgreSQL)으로 갈린다 | 기본값(2026-11-06) | JPA 설계 22.2 "affected row가 0이면 성공으로 간주하지 않는다", `IdempotencyStoreContract` |
|
||||
| Redis 연결 예산 | 캐시 조건부 쓰기는 멱등성·lease와 다른 연결 예산(SCRIPT lane) | 위임 | `1103` 4절(RR-04-02) |
|
||||
| 넘겨받기 전 핸들의 재전송 | 같은 attempt를 넘겨받기 전의 핸들이 이미 일어난 complete·markFailed를 다시 보내면, 그 전이를 실제로 적용한 핸들에게만 "이미 처리됨"으로 확인하고 그 밖의 핸들은 거절한다. Redis TRANSITION 주석의 원래 의도를 뒤집는다 | 소유자 | t5 보고 「남은 문제」, 2026-11-06 |
|
||||
| 해제된 핸들로 start | 계약은 `ABSENT`와 `NOT_OWNER`를 둘 다 받는다. 포트 Javadoc에 그렇게 적는다 | 소유자 | t5 보고 「남은 문제」, 2026-11-06 |
|
||||
|
||||
### 2.5 영속성
|
||||
|
||||
@@ -114,6 +117,7 @@
|
||||
| Flyway PostgreSQL 잠금 | 세션 수준(`transactional-lock: false`). 전제: Hikari 직접 연결. transaction-mode PgBouncer 뒤에서는 깨진다 | 기본값 | `1103` 17절 r10-03(RR6-03-01) |
|
||||
| persistence-jpa 설정 prefix | 플랫폼 자체는 `app.persistence-jpa.*`, 공유 기능은 기능 트리(`app.outbox`·`app.lock`·`app.realtime.replay`) | 소유자 | 결정 36 |
|
||||
| 분산 lock·lease | 둘 다 capability로 유지, 공통 계약 테스트 | 소유자 | 결정 8 |
|
||||
| 실패한 동시 인덱스 마이그레이션 복구 | runbook에 예외 하나를 둔다: 그 버전의 실패 이력 행(`success = false`)만 지우고 다시 배포한다. `flyway repair`는 계속 쓰지 않는다 | 소유자 | `1103` 18.4절(RR7-03-03), 2026-11-06 |
|
||||
|
||||
### 2.6 샘플·메시징·보안·설정
|
||||
|
||||
@@ -170,6 +174,7 @@
|
||||
| objectstorage | provider type 하나 추가 | 위임 | `1101` 15절(05-16) |
|
||||
| 에이전트가 원칙에서 바로 정한 것 | Kafka 주소 키 하나, composition이 persistence-jpa를 함께 가져옴 등 7건 | 기본값 | `docs/reviews/2026-09-25-review-followup-status.md` 「소유자 결정」 끝 목록 |
|
||||
| 묶음별 기본값 | 각 라운드 처리 표의 「결정」 칸(예: SES replay 창 1h, Retry-After 30) | 기본값 | `1101` 13·14·16절, `1103` 6·10·12·15·16·17절 표 |
|
||||
| 경로 필터 workflow와 단계 검사 | `paths:`·`paths-ignore:` trigger만 있는 workflow는 strict lane 단계 실행으로 세지 않는다 | 소유자 | `1103` 18.4절(RR7-05-01), 2026-11-06 |
|
||||
|
||||
## 3. 새 결정을 기록하는 법
|
||||
|
||||
|
||||
Reference in New Issue
Block a user