Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/result-and-failure-algebra/concept/concept-messaging-transport-spi-c07.md
T
DongHyeonkaandClaude Fable 5.1 b25357c48a docs(clean-architecture-backend-template): fold analysis into final and re-select one topic
- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다
- 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5
  (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를
  techviz 로 만들었다
- 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs
  돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다.
  Concept 이 인용한 코드가 SSOT 에 없어 뺐다
- candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00

2.8 KiB

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, evidenceCapturedOn, assets, evidence, source, module
kind slug title topic project status sourceRevision rootTreeNode evidenceCapturedOn assets evidence source module
CONCEPT messaging-transport-spi-c07 오래 돌 때만 드러나는 수명주기 결함 네 개 result-and-failure-algebra clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 concept:messaging-transport-spi-c07 2026-09-01
key file
messaging-transport-spi-c07 ../../../final/evidence/rendered/messaging-transport-spi-c07.svg
../../../final/evidence/raw/messaging-transport-spi-c07.txt
원본 분석 절은 final/document.md#a19-messaging-transport-spi#L579 이다.
messaging-transport-spi

오래 돌 때만 드러나는 수명주기 결함 네 개

코드 주석이 네 결함을 보존한다. 전부 장기 실행에서만 드러나는 종류다 — 세대 회전이 겹칠 때, 닫힌 세대가 목록에 남을 때, 회전 없이 종료할 때, 이중 해제가 계수를 음수로 만들 때.

관계

  • 멱등 종료를 보장하는 컴포넌트는 종료 이후의 등록도 정의한다 같은 분석 리프에서 끌어낸 규칙이다.
  • 같은 개념의 sentinel은 계층을 넘어 하나로 정한다 같은 분석 리프에서 끌어낸 규칙이다.

본문

코드 주석이 네 결함을 보존한다. 전부 장기 실행에서만 드러나는 종류다.

위치 이전 상태 그것이 만든 실패
Generation.retiredAt javadoc 호출자가 넘긴 하나의 retiredAt을 전체 draining 목록에 적용 드레인 중 회전이 겹치면, 방금 은퇴한 세대를 강제 종료하거나 오래된 세대에 새 마감을 주거나 — 호출자가 우연히 넘긴 타임스탬프에 좌우
closeExpiredDraining 주석 이미 닫힌 세대가 목록에 잔류 drainingCount()가 끝난 작업을 영원히 보고
close() javadoc 회전이 은퇴시킨 것만 닫음 회전 없이 종료한 프로세스가 브로커 연결을 JVM 종료에 맡김 → 미전송 producer 배치 소실, consumer 세션이 그룹을 떠나지 않고 브로커에서 타임아웃
endWork javadoc clamp 없음 이중 해제가 계수를 음수로 → 작업이 도는 중에 드레인 완료로 보고

0번 해제와 2번 해제가 같은 등급인 이유

네 번째와 LeakTrackingRuntime.closeCount() javadoc("Closing twice is as much a defect as never closing")이 같은 주제를 반대편에서 말한다 — 해제는 정확히 한 번이어야 하고, 0번도 2번도 결함이다.

이 기록이 다루는 파일 범위

:::evidence key="messaging-transport-spi-c07" alt="코드베이스에서 파일 목록을 만든 출력 13줄. 이 기록이 다루는 범위가 그 목록이다." caption="코드베이스 파일 목록 — 13줄 · exit 0" zoom="true" :::