DongHyeonkaandClaude Fable 5.1
b25357c48a
- 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>
2.1 KiB
2.1 KiB
kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, verifiedOn, source
| kind | slug | title | topic | project | status | sourceRevision | rootTreeNode | verifiedOn | source | |
|---|---|---|---|---|---|---|---|---|---|---|
| REFERENCE | messaging-schema-avro-f05 | 안정 코드는 판단 단위로 정하고 구현 단위로 정하지 않는다 | schema-and-data-contracts | clean-architecture-backend-template | 게시 전 | 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 | reference:messaging-schema-avro-f05 |
|
안정 코드는 판단 단위로 정하고 구현 단위로 정하지 않는다
관계
- 진화 판단이 두 곳에 있고 형태가 반대다 이 규칙의 근거는 같은 분석 리프의 판정이 소유한다.
- CI에서 돈다고 선언한 게이트를 부르는 CI가 없다 이 규칙의 근거는 같은 분석 리프의 판정이 소유한다.
목적
FailureDescriptor.code 는 "stable, machine-readable code" 이고 대시보드와 재시도 정책이 그것으로 집계한다. 같은 판단이 두 어휘로 나뉘면 Avro 만 별도 계열이 되고, 집계는 포맷 수만큼 갈라진다.
규칙
-
같은 판단에 형제 구현들이 어떤 코드를 쓰는지 모은다 미등록 타입과 미등록 버전이라는 같은 판단에 JSON 과 Protobuf 는 UNKNOWN_MESSAGE_TYPE 과 SCHEMA_VERSION_NOT_REGISTERED 를, Avro 는 AVRO_TYPE_NOT_REGISTERED 와 AVRO_VERSION_NOT_REGISTERED 를 쓴다.
-
코드가 갈라진 이유가 판단인지 구현인지 묻는다 포맷 이름이 접두로 붙은 것은 구현 단위다.
-
포맷 구분은 코드가 아니라 메시지로 옮긴다 공통 코드를 쓰고 sanitizedMessage 로 포맷을 구분한다.
적용 조건
여러 구현이 같은 port 를 구현하면서 각자 실패 코드를 정하는 모든 가족.
예외
판단 자체가 그 구현에만 존재하는 경우는 고유 코드가 맞다. 여기 두 판단은 세 codec 모두에 있다.
예시
세 codec 의 requireRegistered 와 schemaFor. 확인 방법은 git grep -n 'NOT_REGISTERED' -- 'src/messaging/**/*.java' 다.