Commit Graph
12 Commits
Author SHA1 Message Date
DongHyeonka 141c2a4f6d merge: main(3e908c02, round9 #29~#31)을 받는다 2026-11-13 13:58:10 +09:00
DongHyeonka afdedabf2a fix(persistence)!: 넘겨받은 claim만 쓰게 fence와 조건부 쓰기를 맞춘다
lease를 넘겨받는 저장소 다섯 곳이 앞 실행의 쓰기를 막지 못한다.
durable operation은 owner만 보고 써서 같은 worker id가 다시 claim하면
앞 실행의 결과가 남는다. 알림 lease 회복은 상태를 다시 읽은 뒤 조건
없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep·전체 읽음은
기다린 행의 상태를 다시 보지 않는다. 멱등성 reaper는 앱 시계로 비교하고
한 번에 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. fileserver
recovery enqueue는 동시 삽입에서 25P02로 실패하고, cleanup은 claim
lease가 끝난 뒤에도 항목을 시작한다. 저장소가 행에서 만드는 claim·lease
record는 잘못된 값을 IllegalArgumentException으로 거절해 web이 400으로
바꾼다.

고른 방법: 모든 쓰기를 owner·fence(·상태·만료) 조건을 단 한 문장으로
바꾼다. durable operation은 V23 lease_fence를 더하고 DurableOperationClaim
을 돌려준다. 알림 회복은 requeueAbandoned 한 문장이다. 만료 sweep은
subquery가 SKIP LOCKED로 쥔 행을 건너뛰고 바깥 UPDATE가 상태·만료를 다시
본다. 전체 읽음은 바깥 UPDATE가 상태를 다시 본다. reaper는 DB now()로
1000행씩, 트랜잭션마다 30초(SpringTransaction.DEFAULT_TIMEOUT_SECONDS)이고
바깥 DELETE에도 만료를 둔다. recovery는 INSERT … ON CONFLICT, cleanup은
lease 마지막 2분에 시작하지 않고 시도를 세지 않는 release로 돌려준다.
알림 provider timeout은 lease보다 짧아야 기동한다(호출이 lease를 넘으면
lease 복구가 아직 도는 호출을 맞추기로 넘긴다). 저장소가 만드는 record
일곱은 IllegalStateException으로 거절한다. 버린 대안: 읽고 비교한 뒤
쓰기(경합이 그대로 남음), 앱 쪽 락(인스턴스 사이에서 무의미).

위험·한계: 포트 시그니처가 바뀐다(DurableOperationStorePort,
RecipientLeaseStorePort.expiredDispatching, RecipientDeliveryStorePort
.requeueAbandoned, CleanupQueuePort.release). owner가 없거나 fence가
0인 V4 전 DISPATCHING 행은 회복이 고르지 않는다(안내 4행에 고치는 SQL).
provider timeout 검사는 필요조건일 뿐이고, 호출 전체를 묶는 것은 SES다.

검증: desktop RED(고치기 전 트리 + 새 시험, pr1-red3) 새 시험 13건
실패. GREEN은 PR 본문의 verify.sh pr·PostgreSQL lane 결과.

Refs: RR9-01-02, RR9-01-04, RR9-01-06, RR9-01-12, RR9-01-13, RR9-01-23, RR9-01-24, RR9-01-29, R1 넘김 DurableOperationStoreContractTest
BREAKING CHANGE: DurableOperationStorePort의 heartbeat·reportProgress·succeed·fail이 DurableOperationClaim을 받고 claimNext가 그것을 돌려준다. RecipientLeaseStorePort.expiredDispatching이 List<RecipientLease>를 돌려주고 RecipientDeliveryStorePort.requeueAbandoned, CleanupQueuePort.release가 새로 생긴다. IdempotencyReaper 생성자에서 Clock이 빠진다. 알림 provider timeout이 lease 이상이면 기동이 실패한다. 저장소가 만드는 claim·lease record가 IllegalStateException을 던진다. docs/upgrade/2026-11-round9-claim-fence.md
2026-11-13 13:17:33 +09:00
DongHyeonka 2f0aefadee fix(security)!: 모든 전송이 같은 호출자로 권한을 판정하고 JWT·tenant 빈틈을 막는다
@RequiresPermission이 web 밖에서 늘 거부한다. gRPC·STOMP는 인증한
호출자를 SecurityContext에 넣지 않아 권한 있는 호출자도 거부되고, 거부는
web 403, gRPC INTERNAL+ERROR, GraphQL 가린 INTERNAL_ERROR+ERROR로 갈린다.
GraphQL 정책은 하위 좌표(User.salary) 규칙을 받고 판정하지 않는다. 배포
jar가 SPRING_PROFILES_ACTIVE=test로 떠 prod 검사가 꺼진다. JWT 변환은
최상위 roles claim을 권한으로 읽고, sub 없는 token을 통과시켜 뒤에서 500이
되고, 틀린 tenant claim을 AUTH_TOKEN_MALFORMED로 본다. 모르는 profile의
알림 callback은 500+ERROR이고 공격자 문자열을 감사 WARN에 남긴다. patch
거부는 요청이 쓴 이름을 제한 없이 되풀이한다. tenant 입력 이름 거부가
web·GraphQL에서 갈리고, 익명 GraphQL tenant 출처가 SYSTEM이다. STOMP
거부는 자기 로그가 없고 설정 주석이 순서를 틀리게 적는다.

- AuthorizationDeniedException을 AUTHZ_INSUFFICIENT_PERMISSION carrier로
  만들고 method security가 그것을 그대로 던진다. 전송마다 이미 있는
  carrier 대응이 같은 코드로 답한다(gRPC PERMISSION_DENIED, GraphQL
  FORBIDDEN). 버린 안: 전송마다 AccessDeniedException 대응 추가(네 곳에
  같은 표를 둔다).
- gRPC listener callback과 STOMP frame 처리 동안 호출자를 SecurityContext에
  둔다(spring-security-core 의존, lockfile 갱신). Authentication이면
  그대로, 아니면 권한 없는 인증 token이다. 역할은 AuthenticatedPrincipal
  에서만 읽는다.
- GraphQL 실행 전 판정이 fragment를 한 번씩 펼치며 typed parent로 좌표를
  모은다. root는 늘, 하위 좌표는 규칙이 있을 때 판정하고 interface·구현
  좌표의 규칙도 본다.
- 배포 산출물은 test profile을 기동 실패로 거부한다.
- JWT: 최상위 roles를 버리고, sub 없음·틀린 tenant는 401
  AUTH_CLAIM_MAPPING_FAILED다.
- callback은 profile을 먼저 찾고 없으면 감사 없이 400이다
  (ProviderCallbackAdapterRegistry.require → find).
- patch 거부는 이름을 16개·128자·안전 문자만 되풀이한다.
- tenant 입력 이름 어휘를 TenantId.namesATenant 하나로 모으고, 익명
  GraphQL 출처를 ANONYMOUS로 둔다(값 public, 거부는 하지 않는다 — 공개
  DataLoader가 그 tenant로 돈다).
- STOMP 거부는 사유·command만 담은 WARN 한 줄을 남긴다(session id는
  SockJS가 client URL에서 받아 뺀다).
- 고치며 찾음: decoder를 만든 뒤 JWKS 재조회를 IdP가 받지 않으면 라이브러리
  문구("…decode the Jwt: <HTTP 오류>") 때문에 401 AUTH_TOKEN_MALFORMED로
  분류됐다. 원인 사슬의 HTTP·I/O 실패를 먼저 보고 503
  AUTH_JWKS_UNAVAILABLE로 답한다.

위험: 응답이 바뀐다(gRPC·GraphQL 거부 코드, sub 없음 401, JWKS 재조회
실패 503, 모르는 callback 400, test profile 기동 실패). 할 일은
docs/upgrade/2026-11-round9-authz.md 1~11행이다. registry 구현은 find를
구현해야 컴파일된다.

검증: desktop에서 바뀐 leaf check·systemTest, :app-bootstrap:test·
architectureTest·documentContractTest, verifyDependencyLocks rc=0. 새
시험은 고치기 전 트리에서 실패했다(RED).

Refs: RR9-02-02, RR9-02-16, RR9-02-17, RR9-02-18, RR9-02-20, RR9-02-23,
  RR9-02-25, RR9-02-28, RR9-02-29
BREAKING CHANGE: gRPC·GraphQL 권한 거부 코드, JWT sub 없음·틀린 tenant
  응답, 모르는 알림 callback 응답, test profile 기동, registry require→find
  가 바뀐다. 옮기는 법은 docs/upgrade/2026-11-round9-authz.md 1~11행.
2026-11-13 12:24:54 +09:00
DongHyeonka 738fe7004e docs(ledger): CI 건강·성능 첫 라운드 실측을 고치고 둘째 라운드 예측을 남긴다
pr / done (pull_request) Canceled after 0s
첫 라운드 actual 정정 줄은 PR #13 병합 직전에 적었지만, 커밋하면 초록 run이
새 head로 밀려서 공유 노트에 두었던 것이다(작업 중 555분, 결과 partial).
둘째 라운드 예측은 p50 240분이고 근거는 줄의 basis 칸에 있다.
2026-11-12 19:38:04 +09:00
DongHyeonka 335fc9679d docs(ledger): CI 건강·성능 작업의 예측과 실측을 남긴다
pr / done (pull_request) Canceled after 0s
예측은 2026-11-11 착수 때(p50 144분), 실측은 작업 중 417분·호출 464.
p80을 넘은 이유와 결과(partial)는 줄의 why 칸에 있다.
2026-11-12 08:34:10 +09:00
DongHyeonka 97798b5a35 docs(ledger): Gradle 루트 재배치 작업의 실측을 남긴다
pr / gradle (pull_request) Successful in 11m45s
pr / vulnerabilities (pull_request) Successful in 1m1s
pr / done (pull_request) Successful in 4s
2026-11-12 00:39:58 +09:00
DongHyeonka 123fc0bfae docs(ledger): Gradle 루트 재배치 작업의 착수 예측을 남긴다
pr / gradle (pull_request) Successful in 11m25s
pr / vulnerabilities (pull_request) Successful in 1m3s
pr / done (pull_request) Successful in 3s
2026-11-11 22:15:42 +09:00
DongHyeonka 78cbc865f3 docs(ledger): CI 재편 작업의 예측·실측과 하네스 회고 줄을 남긴다
pr / gradle (pull_request) Failing after 10m21s
pr / vulnerabilities (pull_request) Successful in 37s
pr / done (pull_request) Failing after 1s
t2a-backend-ci의 착수 예측(p30·p50·p80)과 실측(작업 중 132분, 호출 374,
출력 37.5만, 벽시계 849분)을 더한다. 하네스 회고(claude-harness
docs/retro/2026-11-08.md 7절)가 정한 retro 줄 셋(h3·x2·x3)을 ledger.py
append로 더한다. 이미 있던 줄은 고치지 않았다.
2026-11-09 06:56:44 +09:00
DongHyeonka 96836a64b6 docs(ledger): 메시징 라이브러리 분리 작업의 예측과 실측을 남긴다
build-logic / included-builds (pull_request) Failing after 7s
ci-quality-gates / quality-gates (pull_request) Failing after 3s
dependency-vulnerability / dependency-review (pull_request) Skipped
dependency-vulnerability / dependency-submission (pull_request) Skipped
dependency-vulnerability / trivy-fs (pull_request) Successful in 34s
docs-check / docs (pull_request) Successful in 9s
fileserver-pr / fileserver-unit-and-architecture (pull_request) Failing after 5s
fileserver-pr / fileserver-local-ext4-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-http-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-security-suite (pull_request) Failing after 3s
fileserver-pr / fileserver-bounded-memory (pull_request) Failing after 5s
link-check / lychee (pull_request) Failing after 6s
notification-platform / contract (Java 21, no external provider) (pull_request) Failing after 4s
notification-platform / chaos (ambiguity, restart recovery, callback burst) (pull_request) Skipped
object-storage-qualification / minio-managed-contract (pull_request) Failing after 3s
object-storage-qualification / minio-managed-fault (pull_request) Skipped
pr-adapters / changes (pull_request) Successful in 5s
pr-adapters / web-servlet-containers (pull_request) Skipped
pr-adapters / websocket-container-matrix (pull_request) Skipped
pr-adapters / websocket-nginx-contract (pull_request) Skipped
pr-adapters / httpclient-stable-contract (apache) (pull_request) Skipped
pr-adapters / httpclient-stable-contract (jdk) (pull_request) Skipped
pr-adapters / httpclient-security-and-compatibility (pull_request) Skipped
object-storage-qualification / aws-managed-common-subset (pull_request) Skipped
ci-quality-gates / release-gate (pull_request) Failing after 1s
pr-adapters / jpa-postgresql-contract (16) (pull_request) Failing after 5s
pr-adapters / jpa-postgresql-contract (18) (pull_request) Failing after 5s
pr-adapters / jpa-migration-smoke (pull_request) Failing after 5s
착수 때 공유 노트에 쓴 예측(p30·p50·p80)과 끝날 때 세션 기록에서
뽑은 실측(작업 중 110분, 호출 346, 출력 27.2만)을 한 줄씩 더한다.
모든 값이 p30 안이었고, 틀린 이유와 다음 예측에 더할 몫을 why에 적었다.
2026-11-08 21:56:59 +09:00
DongHyeonka e1dd8e745f docs(ledger): gRPC 라이브러리 분리 작업의 예측과 실측을 남긴다
착수할 때(10:50) 공유 노트에 쓴 예측과 끝의 실측 두 줄이다. 모든 값이
p30 안이었고, 틀린 이유(desktop 대기를 작업 중 시간에 넣음)는 실측 줄
`why`에 적었다.
2026-11-08 14:02:09 +09:00
DongHyeonka a0a7757548 docs(ledger): 하네스 적용 작업의 실측과 틀린 이유를 적는다
착수 예측(21:46, p30 150분·호출 450·출력 45만) 뒤 끝 보고 직전의 실측을
세션 기록에서 뽑아 같은 task로 한 줄 더한다: 벽시계 94분, 작업 중 68분, 호출
270, 출력 34.6만 토큰, 다시 읽은 입력 1.33억 토큰, 최대 컨텍스트 80.5만. 모두
p30 안이다. 틀린 이유와 다음에 바꿀 근거는 줄의 why 칸에 있다.

작업 중 시간의 정의를 선례(design-docs harness 설계 14절)가 잰 방식과 같게
「빈틈을 5분까지만 더한 시간」으로 README에 적었다.

검증: test_ledger(예측보다 뒤의 실측, 구간 판정), check-docs, check-work-docs rc=0.
2026-11-07 23:12:49 +09:00
DongHyeonka 37c88fedd4 docs(ledger): 작업마다 예측과 실측을 쌓는 repo 장부를 둔다
작업 시간을 예측해도 실제와 비교해 기록하는 곳이 없어서, 틀린 예측에서
하네스를 고칠 단서를 얻지 못한다. 소유자가 2026-11-07에 자료의 방식대로
repo마다 docs/ledger/estimates.jsonl을 두기로 정했다(design-docs
harness/01-harness-design.md 10절, 13절 Q11).

- docs/ledger/README.md: 줄 셋(estimate·actual·retro)과 칸, p30·p50·p80의
  뜻, 시간 기준은 작업 중 시간이라는 것, 더하기만 한다는 것.
- 첫 줄은 이 작업의 착수 예측이다(21:46, 공유 노트 착수 보고와 같은 값).
  실측 줄은 끝 보고 직전에 더한다.
- 여러 브랜치가 파일 끝에 줄을 더해도 병합이 멈추지 않게 .gitattributes에
  merge=union을 줬다(설계가 걱정한 병합 충돌).
- docs/work/README.md 6절(보고)과 delegate.md 4.1절에 착수 보고와 장부를
  더했고, docs/README.md 지도에 ledger/ 행을 더했다.
- scripts/tests/test_ledger.py: 줄마다 공통 칸, 예측의 p30 ≤ p50 ≤ p80과
  근거, 실측이 앞선 예측을 가지며 들어간 구간이 맞는지 본다.

버린 대안: design-docs 위임 장부를 schema 2로 넓히기(설계 권함, 소유자가
repo 장부로 정함). 위임 장부는 대조용으로 그대로 두고 task로 이 줄을 가리킨다.

위험: Gitea 서버 쪽 병합이 .gitattributes의 merge=union을 쓰는지는 확인하지
못했다. 충돌이 나면 두 쪽 줄을 다 남기면 된다.

검증: unittest, check-docs(지도 검사 포함), check-work-docs,
check-repo-layout rc=0. git check-attr로 merge: union을 확인했다.
2026-11-07 22:11:27 +09:00