Commit Graph
15 Commits
Author SHA1 Message Date
donghyeon.kang 76436f8b21 Merge branch 'main' into claude/w2-be-flaky-ledger
pr / done (pull_request) Successful in 2m20s
2026-11-18 13:13:53 +00:00
DongHyeonka 5f0bf17bd2 docs(ledger): PR 단계 Jetty attempt deadline 시험의 흔들림을 더한다
pr / done (pull_request) Successful in 13m24s
desktop에서 main c7a18ec7의 prCheck를 돌렸을 때(시작 부하 11~15)
JettyAttemptDeadlineTest#aSlowDripExchangeIsAbortedAtTheAttemptDeadline이
1.68초로, 상한 1.5초를 넘어 실패했다. #34가 고친 벽시계 시험 범위 밖에 남은
것이다. 고치는 일은 벽시계 시험을 맡은 쪽에 넘겼다.

검증: python3 -m unittest scripts/tests/test_ledger.py 통과.
2026-11-13 20:42:21 +09:00
DongHyeonka 88d35f7936 docs(ledger): 흔들린 시험을 장부에 남기고 시간·순서 단언 규칙을 리뷰 기준에 건다
pr / done (pull_request) Canceled after 0s
2026-11-12~13 백엔드 runner에서 흔들린 시험은 넷이다. 그런데 기록이 공유
노트와 세션 메시지에 흩어져 있다. 같은 모양(벽시계 상한, 스레드 시작
순서)이 다시 들어와도 리뷰 기준에는 「스레드 없음」 단언만 적혀 있어서
막을 근거가 없다.

- `docs/ledger/flaky-tests.jsonl`: 흔들림 하나가 한 줄이다. 칸과 범주의
  정본은 design-docs `ci/manual.md` 8.5절이다. 첫 네 줄:
  - compose 기동 경쟁(run 100, #13으로 고침)
  - gRPC 서버 deadline(run 221, #34)
  - HTTP client slow drip JDK(run 228, #34)
  - JPA 동시 writer replay 순서(run 260, #39 열림)
  `.gitattributes`에 `merge=union`을 준다. `scripts/tests/test_ledger.py`가
  칸·범주·날짜 형식을 본다.
- review-criteria.md 「타이밍에 기대지 않나」: 벽시계 상한 단언과 스레드
  시작 순서 단언을 더하고, 매뉴얼 8.4절을 가리킨다.
- gates.md 「원래 있던 실패 가리기」: 반복마다 시작 부하를 적게 한다.
  runner 실패면 그 시각에 잠금 아래 돈 desktop 실행도 적는다(runner는
  잠금 밖이다). 흔들림이면 장부에 한 줄을 더하고, 상한을 늘리거나 재시도를
  붙이지 않고 8.4절대로 고친다.

PR #12가 실패했다는 HTTP/2 흔들림은 넣지 않았다. 그 PR의 runner run은
모두 cancelled라 어느 시험인지 특정할 수 없다.

검증: scripts/verify.sh docs(노트북) rc=0. test_ledger의 새 시험이 잘못된
범주를 잡는지 한 줄을 바꿔 실패를 확인하고 되돌렸다.

Refs: design-docs ci/03-time-reduction-plan.md FLAKY-1
2026-11-13 19:46:21 +09:00
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