Merge remote-tracking branch 'origin/claude/d1-docs-system-fd4a0f' into claude/i1-layout-docs-merge-217f1e
# Conflicts: # docs/ci-cd/template-vs-consumer.md # src/platforms/grpc/CLAUDE.md
This commit is contained in:
@@ -0,0 +1,28 @@
|
||||
name: docs-check
|
||||
|
||||
# Document language, record head blocks, references and copied numbers (scripts/check-docs.py).
|
||||
# It runs on every pull request, not on a docs/** path filter: deleting a file or a Gradle project
|
||||
# in code is exactly what makes a living document point at nothing, and that change touches no
|
||||
# document. The checker is plain Python outside Gradle, because the build does not parse documents.
|
||||
on:
|
||||
pull_request:
|
||||
push:
|
||||
branches: ["main"]
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
concurrency:
|
||||
group: ${{ github.workflow }}-${{ github.ref }}
|
||||
cancel-in-progress: true
|
||||
|
||||
jobs:
|
||||
docs:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
||||
- name: Test the document checker
|
||||
run: python3 -m unittest discover -s scripts/tests
|
||||
- name: Check documents
|
||||
run: python3 scripts/check-docs.py
|
||||
@@ -18,3 +18,7 @@ src/.env.lane
|
||||
graphify-out/
|
||||
src/graphify-out/
|
||||
.playwright-mcp/
|
||||
|
||||
# Python bytecode from running scripts/ checks; never committed.
|
||||
__pycache__/
|
||||
*.pyc
|
||||
|
||||
@@ -169,8 +169,8 @@ Gradle 의존성 검증도 같은 registry를 읽는다. root 문서나 기억
|
||||
|
||||
1. 요구사항을 읽고 소유 계층을 판단한다.
|
||||
2. 구조나 동작이 바뀌면 `superpowers:brainstorming`으로 설계를 먼저 확정한다.
|
||||
3. 여러 단계의 작업이면 `docs/superpowers/specs/`에 설계 문서를 남긴다.
|
||||
4. 구현 전 `docs/superpowers/plans/`에 실행 계획을 작성한다.
|
||||
3. 여러 단계의 작업이면 `docs/design/`에 설계 문서를 남긴다. 맨 위에 머리 블록(상태·작성일·요약·현재 정본)을 단다.
|
||||
4. 실행 계획이 필요하면 구현 전 `docs/history/plans/`에 둔다. 계획서도 머리 블록을 단다. 머리 블록 형식은 `docs/README.md`다.
|
||||
5. 동작 변경은 테스트를 먼저 작성한다.
|
||||
6. 새 비즈니스 개념은 `domain-core`에 먼저 둔다.
|
||||
7. 유스케이스는 `application-core` command와 use case/service method로 표현한다.
|
||||
@@ -246,7 +246,7 @@ leaf의 `check`는 그 leaf만 검사한다. 저장소 전체 질문은 이름
|
||||
|
||||
Redis, Kafka, JPA 같은 부가 기능은 "의존성을 붙이면 켜지고, 떼면 사라지는 모듈"로 제공한다.
|
||||
각 서비스는 `app-bootstrap/build.gradle`에 필요한 모듈만 `runtimeOnly` 한 줄로 고른다.
|
||||
설계 근거는 `docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md`.
|
||||
설계 근거는 `docs/design/2026-09-25-capability-module-packaging-design.md`.
|
||||
|
||||
템플릿 기본 조립은 web에서 쓰는 부분뿐이다: `adapter:inbound:web`, 운영 관측(actuator·metrics·
|
||||
tracing·로그), `domain-core`·`application-core`·`shared-contract`, `adapter:outbound:support`·
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## 1. 이 repo
|
||||
|
||||
- Java 21 + Spring Boot 4.0.8 Gradle 멀티모듈 Clean Architecture 백엔드 템플릿이다. 서비스는 이 repo를 받아 도메인을 채운다.
|
||||
- Java 21 + Spring Boot Gradle 멀티모듈(버전은 `src/gradle/libs.versions.toml`) Clean Architecture 백엔드 템플릿이다. 서비스는 이 repo를 받아 도메인을 채운다.
|
||||
- Gradle 루트는 `src/`다. Gradle 명령은 `src/`에서 실행한다.
|
||||
- 규칙의 정본은 `AGENTS.md`다. leaf 목록·경로·허용 의존의 정본은 `src/config/architecture/modules.json`(registry)이다. 각 leaf의 지역 규칙은 가장 가까운 `src/**/CLAUDE.md`가 정한다.
|
||||
|
||||
@@ -51,6 +51,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이
|
||||
- 공개 경로 검사와 env 키 검사는 그 표면이 바뀌었을 때 돌린다. 전체 `test`·`check`·`ci`는 brief가 시킬 때 돌린다.
|
||||
- 게이트 목록(`ci`, `mainCheck`, `integrationCheck`, `performanceCheck`, `releaseCheck` 등)과 바꾼 것에 맞는 게이트는 [docs/work/reference/gates.md](docs/work/reference/gates.md)다.
|
||||
- `docs/work/`, 이 파일, `AGENTS.md`, `src/**/CLAUDE.md`를 고쳤으면 `python3 scripts/check-work-docs.py`를 돌린다(분량, 본문 이력 ID 0, 상대 링크).
|
||||
- 문서(`.md`)나 문서가 가리키는 경로·Gradle 프로젝트를 바꿨으면 `python3 scripts/check-docs.py`를 돌린다(언어, 기록의 머리 블록, 참조, 복사한 숫자). PR마다 `docs-check` workflow가 같은 검사를 돈다. 규칙은 [docs/README.md](docs/README.md)다.
|
||||
|
||||
## 5. 코드만 보고는 헷갈리는 곳
|
||||
|
||||
@@ -64,7 +65,7 @@ brief(작업 지시문)가 있으면 brief의 범위·크기·완료 기준이
|
||||
- **성능 lane에는 단언을 끄는 스위치가 없다.** convention이 상한을 매번 단언하고, `performance.assertions.enabled`에 `true` 아닌 값이 들어오거나 skip이 있으면 테스트 전에 실패한다. 손으로 돌리든 workflow든 같다(`AGENTS.md` 「Gradle 정책 권위」).
|
||||
- **저장소 파일을 읽는 테스트는 태그가 있다.** 문서와 대조하는 테스트는 `document-contract`(main 단계 `mainCheck`), 빌드 스크립트·workflow를 읽는 테스트는 `repository-contract`(PR)다. 문서를 고치면 그 문서를 읽는 테스트를 찾는다.
|
||||
- **커밋 정책은 `human-only`다.** brief가 허용한 것만 자기 브랜치에 한다. 커밋과 push는 따로 허용된다. 자세한 것은 [docs/work/README.md](docs/work/README.md) 4절이다.
|
||||
- **문서 위치 규칙은 [docs/README.md](docs/README.md)다.** 설계서는 `docs/superpowers/specs/`, 결정 기록은 `docs/adr/`, 리뷰는 `docs/reviews/`, 파생 서비스용 변경 안내는 `docs/upgrade/`다.
|
||||
- **문서 위치 규칙은 [docs/README.md](docs/README.md)다.** 설계서는 `docs/design/`, 결정 기록은 `docs/adr/`, 리뷰는 `docs/reviews/`, 고치지 않는 기록(계획서·납품 패키지·증거·학습)은 `docs/history/`, 파생 서비스용 변경 안내는 `docs/upgrade/`다. 기록은 맨 위 머리 블록만 고친다.
|
||||
|
||||
## 6. 소유자 환경
|
||||
|
||||
|
||||
+100
-9
@@ -1,7 +1,8 @@
|
||||
# docs
|
||||
|
||||
저장소의 모든 문서는 이 디렉터리 아래에 있다. 어떤 문서를 어디에 두는지가 유일한 규칙이고,
|
||||
파일 목록은 디렉터리를 직접 읽는다. 개수를 여기에 적으면 다음 문서가 추가되는 순간 틀린 글이 된다.
|
||||
저장소의 모든 문서는 이 디렉터리 아래에 있다. 규칙은 둘이다: 어떤 문서를 어디에 두는지(아래 표),
|
||||
문서의 수명에 따라 무엇을 어떤 언어로 고치는지(「문서 수명과 언어」). 파일 목록은 디렉터리를 직접 읽는다.
|
||||
개수를 여기에 적으면 다음 문서가 추가되는 순간 틀린 글이 된다.
|
||||
|
||||
## 어댑터별 운영 문서
|
||||
|
||||
@@ -26,29 +27,119 @@
|
||||
| `architecture/` | 공개 API 표면 스냅숏 |
|
||||
| `work/` | 작업 매뉴얼: 이 repo에서 하는 일(새 기능, 개선, 조사·설계, 문서 작성, 운영, 총괄)의 절차서. 루트 `CLAUDE.md` 다음에 읽는다 |
|
||||
| `manual/` | 개발 매뉴얼: 새 기능을 만드는 순서와 판단 지점, 생성 명령(`scripts/new-feature.sh`). 입구는 `work/new-feature.md` |
|
||||
| `evidence/` | 작업 단계별 증거·체크포인트 |
|
||||
| `registries/` | env 키·에러 코드·메트릭·헤더 등 레지스트리 SSOT |
|
||||
| `reviews/` | 모듈 코드 리뷰 결과 |
|
||||
| `runbooks/` | 장애 코드별 대응 런북 (`template.md` 기준) |
|
||||
| `security/` | 공개 경로 스냅숏 |
|
||||
|
||||
## 설계와 계획
|
||||
## 설계와 기록
|
||||
|
||||
설계서와 기록은 쓴 때의 글이다. 지금 동작을 설명하지 않는다. 그래서 살아 있는 문서와 다른 폴더에 둔다.
|
||||
|
||||
| 디렉터리 | 대상 |
|
||||
| --- | --- |
|
||||
| `superpowers/specs/` | 설계서. `YYYY-MM-DD-<주제>-design.md` |
|
||||
| `superpowers/plans/` | 구현·확장 계획서. `YYYY-MM-DD-<주제>-plan.md` |
|
||||
| `superpowers/packages/` | 외부에서 납품된 설계 패키지의 README와 정적 검증 결과 |
|
||||
| `design/` | 설계서. `YYYY-MM-DD-<주제>-design.md` |
|
||||
| `history/plans/` | 구현·확장 계획서. `YYYY-MM-DD-<주제>-plan.md` |
|
||||
| `history/packages/` | 외부에서 납품된 설계 패키지의 README와 정적 검증 결과 |
|
||||
| `history/evidence/` | 작업 단계별 증거·체크포인트 |
|
||||
| `history/study/` | 학습 문서. 쓴 때의 코드를 따라 읽은 기록이다 |
|
||||
|
||||
`superpowers/packages/<어댑터>/` 는 설계서가 처음 전달됐을 때의 안내와 `VALIDATION.md` 검증 이력을
|
||||
남긴 기록 보관소다. 설계서·계획서 본문은 전부 `specs/` 와 `plans/` 에 있으므로 이 디렉터리에서
|
||||
`history/packages/<어댑터>/` 는 설계서가 처음 전달됐을 때의 안내와 `VALIDATION.md` 검증 이력을
|
||||
남긴 기록 보관소다. 설계서·계획서 본문은 전부 `design/` 과 `history/plans/` 에 있으므로 이 디렉터리에서
|
||||
문서를 찾을 필요는 없다. 각 README 상단의 보존 안내가 무엇이 옮겨졌고 무엇이 제거됐는지 밝힌다.
|
||||
`history/packages/*-superpowers-package/` 셋은 납품된 묶음 그대로이고, 그 안의 `MANIFEST.sha256` 은
|
||||
납품 당시 바이트의 해시다.
|
||||
|
||||
계획서 본문에는 당시 계획한 경로와 명령이 그대로 남아 있다. 그중 일부는 실제 구현에서 다른 위치로
|
||||
조정됐고, 저장소에 어떻게 대응시켰는지는 각 어댑터의 `repository-adaptation.md` 또는
|
||||
`module-mapping.md` 가 기록한다. 계획서를 사후에 고치지 않는 이유는 그렇게 하면 계획의 기록이 아니라
|
||||
결과를 계획처럼 보이게 만든 글이 되기 때문이다.
|
||||
|
||||
## 문서 수명과 언어
|
||||
|
||||
규칙의 정본은 design-docs `conventions/docs-system.md`다. 이 절은 이 repo에 적용한 내용이고,
|
||||
이 템플릿을 받은 파생 서비스도 이 절을 따른다.
|
||||
|
||||
| 수명 | 문서 | 위치 | 언어 | 고치는 법 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 살아 있음 | README, `CLAUDE.md`, `AGENTS.md`, 매뉴얼(`manual/`, `work/`), 영역 운영 문서, `registries/`, `runbooks/`, `upgrade/` | 제자리 | 한국어 | 코드와 같은 변경에서 고친다 |
|
||||
| 결정 | 결정 기록(ADR) | `adr/`, `notification/adr/` | 한국어 | 본문은 고치지 않는다. 일부가 바뀌면 상태를 「채택(보완)」으로 하고 보완 절을 덧붙인다. 크게 바뀌면 새 ADR을 쓰고 옛 ADR을 「대체됨」으로 한다 |
|
||||
| 기록 | 설계서, 계획서, 납품 패키지, 증거, 학습 문서, 리뷰 | `design/`, `history/`, `reviews/` | 머리 블록은 한국어, 본문은 쓴 때의 원문 | 머리 블록의 칸만 고친다 |
|
||||
|
||||
- 코드 식별자, 명령, 경로, 설정 키, 오류 코드, 로그·출력 인용, 제품 이름은 원문으로 둔다.
|
||||
- 문체는 「~한다」다. 한 문서 안에서 「~합니다」와 섞지 않는다.
|
||||
- 아직 한국어로 옮기지 않은 살아 있는 문서와 ADR은 문서 검사의 예외 목록에 있다(「문서 검사」).
|
||||
|
||||
## 기록 문서의 머리 블록
|
||||
|
||||
`design/`, `history/`, `adr/`, `notification/adr/`의 `.md` 파일은 맨 위에 이 블록을 둔다.
|
||||
블록을 빼면 원문 그대로다(옮길 때 깨진 상대 링크의 대상만 고쳤다).
|
||||
|
||||
```text
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 구현됨
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 한국어 한 문장
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
- 대체됨: `docs/design/<대체한 문서>.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
```
|
||||
|
||||
- 종류는 폴더가 정하고 둘째 줄에 굵게 적는다: `design/` 설계서, `history/plans/` 계획서,
|
||||
`history/evidence/`·`history/plans/evidence/` 증거, `history/packages/` 납품 패키지,
|
||||
`history/study/` 학습 문서. ADR의 둘째 줄은
|
||||
`> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.`다.
|
||||
- 상태는 종류마다 고정 어휘다.
|
||||
|
||||
| 종류 | 상태 |
|
||||
| --- | --- |
|
||||
| 설계서 | 제안 · 채택 · 구현됨 · 보류 · 폐기 · 대체됨 · 확인 안 함 |
|
||||
| 결정 기록 | 제안 · 채택 · 채택(보완) · 폐기 · 대체됨 |
|
||||
| 계획서 | 실행 중 · 끝남 · 중단 · 대체됨 · 확인 안 함 |
|
||||
| 납품 패키지 · 증거 · 학습 문서 | 보관 |
|
||||
|
||||
- 「현재 정본」은 지금 동작을 설명하는 살아 있는 문서의 경로다. 여럿이면 쉼표로 잇고, 없으면 「없음 — 이유」로 쓴다.
|
||||
- 「대체됨」은 상태가 대체됨일 때 대체한 문서의 경로다. 이 문서가 다른 문서를 대체했으면 「대체」 칸에 그 경로를 쓴다.
|
||||
- 상태는 그 결정을 바꾼 변경이 같이 바꾼다. 기능을 지우는 커밋이 그 기능의 설계서를 「폐기」나 「대체됨」으로 바꾼다.
|
||||
- 2026-11-07에 처음 단 상태는 문서의 원래 상태 줄을 바꾼 값이다: Accepted·Approved·확정·승인 → 채택,
|
||||
Superseded → 대체됨, Proposed → 제안, implemented → 구현됨, 보완 메모가 있는 ADR → 채택(보완).
|
||||
상태 줄이 없던 설계서와 체크 상자가 모두 표시되지 않은 계획서는 「확인 안 함」이다.
|
||||
`capability-status.md` 「제거된 코드」로 지운 것이 확인된 설계서 다섯은 「폐기」다.
|
||||
- 리뷰(`reviews/`)는 아직 머리 블록을 요구하지 않는다.
|
||||
|
||||
## 문서와 코드를 같은 변경에서 고친다
|
||||
|
||||
- 코드나 규칙을 바꾸는 변경이 그것을 설명하는 살아 있는 문서도 고친다. 찾는 법:
|
||||
`grep -rn '<바꾼 이름>' docs src --include=*.md`.
|
||||
- 살아 있는 문서는 지금 있는 것만 쓴다. 지운 타입·경로·태스크는 `capability-status.md` 「제거된 코드」나
|
||||
`upgrade/`에 쓴다. 살아 있는 문서 안에서 꼭 써야 하면 `> 이력` 으로 시작하는 인용 블록 안에 쓴다.
|
||||
- 숫자·버전을 복사하지 않는다. Spring Boot 버전은 `src/gradle/libs.versions.toml`, leaf 목록과 개수는
|
||||
registry(`src/config/architecture/modules.json`)를 가리킨다.
|
||||
- 루트 README는 「프로젝트 구조」(최상위 폴더와 `src/` 폴더가 하는 일)와 「문서 지도」(매뉴얼·계약·운영·결정·기록이
|
||||
어디 있나) 절을 반드시 둔다. 전체 절 목록과 순서는 design-docs `conventions/docs-system.md` 6절이다.
|
||||
|
||||
## 문서 검사
|
||||
|
||||
`python3 scripts/check-docs.py`가 위 규칙 중 기계로 볼 수 있는 넷을 본다. PR마다 workflow `docs-check`가
|
||||
돌리고, 하나라도 걸리면 실패한다. 경로 필터가 없다: 코드에서 파일이나 Gradle 프로젝트를 지우는 변경이
|
||||
문서를 낡게 만든다.
|
||||
|
||||
| 검사 | 보는 것 |
|
||||
| --- | --- |
|
||||
| `language` | 살아 있는 문서와 ADR 본문이 한국어인가(코드·명령·경로·인용은 세지 않는다) |
|
||||
| `head` | 기록과 ADR 맨 위의 머리 블록: 칸, 상태 어휘, 날짜, 한국어 요약, 현재 정본·대체됨 경로가 있는지 |
|
||||
| `reference` | 살아 있는 문서의 인라인 코드 안 경로(`src/`, `docs/`, `scripts/`, `infra/`, `.github/`로 시작)와 Gradle 경로가 지금 트리·registry에 있는가. 코드 블록, `> 이력` 인용 블록, 제거 표, `upgrade/`는 보지 않는다 |
|
||||
| `number` | 살아 있는 문서가 Spring Boot 버전이나 leaf 개수를 복사했는가 |
|
||||
|
||||
- 하나만 돌리기: `python3 scripts/check-docs.py --only head`.
|
||||
- 예외 목록 `scripts/check-docs-exceptions.txt`는 2026-11-07의 기준선이고 줄기만 한다. 문서를 번역하거나 고쳐서
|
||||
더는 걸리지 않으면 그 줄을 지운다(남겨 두면 실패한다). 목록에 새 줄을 더하면 실패한다. 기준선을 늘리는 것은
|
||||
규칙을 바꾸는 일이라 소유자 결정이 필요하다.
|
||||
- 검사 자신의 시험: `python3 -m unittest discover -s scripts/tests`.
|
||||
- 마크다운 상대 링크는 이 검사가 아니라 lychee(`link-check` workflow)와 `scripts/check-work-docs.py --links`가 본다.
|
||||
|
||||
## 여기에 없는 것
|
||||
|
||||
- 실행되는 검증 스크립트는 문서가 아니다. `scripts/` 와 `.github/scripts/` 에 있다.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-09-07
|
||||
- 요약: 공유 테스트 코드는 java-test-fixtures 한 가지 방식으로 둔다는 결정이다.
|
||||
- 현재 정본: `src/build-logic/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-BUILD-001: `java-test-fixtures` is the standard for shared test code
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-24
|
||||
- 요약: GraphQL context는 inbound에 두고 객체 권한 판단은 application-core로 옮긴다는 결정이다.
|
||||
- 현재 정본: `src/adapter/inbound/graphql/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GQL-001 — GraphQL context stays inbound; object authorization moves to application-core; the persisted-operation store stays an inbound SPI
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: gRPC 플랫폼을 adapter leaf 하나가 아니라 registry에 등록한 family로 낸다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-001: The gRPC platform ships as a registered family, not as one adapter leaf
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: protoc와 Buf CLI 없이 스키마를 관리하려던 결정이다. 2026-09-28 Gradle protobuf plugin과 buf로 바뀌었다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
- 대체됨: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-002: Schema governance runs without protoc and without the Buf CLI
|
||||
|
||||
- Status: **superseded (2026-09-28)** by owner decision 18 of the 2026-09-25 review follow-up
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: 전송·업무·스트림 증거를 서로 대신하지 않는 세 축으로 본다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-003: Transport, business and stream evidence are three axes, and none implies another
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: 재시도 주인은 하나이고 키가 있는 변경은 영속 원장이 필요하다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-004: One retry owner, and keyed mutations need a durable ledger
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: 서버 스트림은 writer 하나, 제한된 큐, 추측하지 않는 resume로 다룬다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-005: One writer per stream, a bounded queue, and resume that refuses to guess
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-31
|
||||
- 요약: Stable discovery는 DNS와 정적 목록이고 Kubernetes에서는 누가 부하를 나누는지 profile이 정한다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-006: Stable discovery is DNS and static, and a Kubernetes profile names who balances
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: gRPC 고급 기능마다 따로 플래그·등급·승격 기준을 둔다는 결정이다.
|
||||
- 현재 정본: `docs/compatibility/grpc-advanced-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-GRPC-ADV-001: Each advanced capability has its own flag, its own grade and its own promotion
|
||||
|
||||
- Status: accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 영속성 모델은 도메인이 소유한다는 결정이다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-001 — The domain owns the persistence model
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 재시도는 유스케이스 전체를 다시 돌린다는 결정이다. 그 재시도 엔진은 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/jpa/transaction-guide.md`
|
||||
- 대체됨: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-002 — Retry re-runs the whole use case
|
||||
|
||||
- Status: Superseded (2026-09-25) — the retry engine this ADR describes
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: commit 결과를 모르는 실패는 재시도하지 않는다는 결정이다. 2026-09-25 보완이 있다.
|
||||
- 현재 정본: `docs/jpa/transaction-guide.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-003 — Completion unknown is never retried
|
||||
|
||||
- Status: Accepted; amended 2026-09-25 — `TransactionCompletionResolver`, `CommitFailureClassifier`
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 스키마의 정본은 Flyway라는 결정이다.
|
||||
- 현재 정본: `docs/jpa/migration-guide.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-004 — Flyway is the schema source of truth
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 영속성 계약은 실제 PostgreSQL에서 돌린다는 결정이다.
|
||||
- 현재 정본: `docs/jpa/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-005 — Contracts run against real PostgreSQL
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-24
|
||||
- 요약: 기술 감사 모델은 audit 하나뿐이라는 결정이다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-JPA-006 — `audit` is the sole technical audit model
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: MongoDB 플랫폼의 경계를 정한 결정이다.
|
||||
- 현재 정본: `docs/mongodb/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-MONGO-001 — MongoDB platform boundary
|
||||
|
||||
- **Status:** Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: BSON 표현을 고정한 목록으로 관리한다는 결정이다.
|
||||
- 현재 정본: `docs/mongodb/bson-mapping-guide.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-MONGO-002 — BSON representation is a pinned manifest
|
||||
|
||||
- **Status:** Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: 트랜잭션 본문 재시도와 commit 재시도를 다른 반복으로 둔다는 결정이다.
|
||||
- 현재 정본: `docs/mongodb/consistency-transaction-guide.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-MONGO-003 — Transaction body retry and commit retry are separate loops
|
||||
|
||||
- **Status:** Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: 인덱스와 스키마 변경은 관리 평면이 맡는다는 결정이다.
|
||||
- 현재 정본: `docs/mongodb/schema-index-migration-guide.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-MONGO-004 — Index and schema changes belong to the admin plane
|
||||
|
||||
- **Status:** Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 2026-08-13
|
||||
- 요약: MongoDB 고급 기능의 승격 기준을 정한 결정이다. 2026-09-25 보완이 있다.
|
||||
- 현재 정본: `docs/mongodb/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-MONGO-ADV-001 — Advanced capability promotion
|
||||
|
||||
- **Status:** Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: 스트리밍은 실시간 전달이고 web 모듈은 이력을 저장하지 않는다는 결정이다.
|
||||
- 현재 정본: `docs/web/streaming-contract.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WEB-ADV-001: Streaming is live delivery, and the web module stores no history
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: 가상 스레드는 스케줄링을 바꿀 뿐 동시성 예산을 없애지 않는다는 결정이다.
|
||||
- 현재 정본: `docs/web/virtual-thread-profile.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WEB-ADV-002: Virtual threads change scheduling, not the concurrency budget
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: OpenAPI 3.2 문서는 나란히 만들고 실험 등급으로 둔다는 결정이다.
|
||||
- 현재 정본: `docs/web/openapi-32-compatibility.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WEB-ADV-003: OpenAPI 3.2 is generated in parallel and stays experimental
|
||||
|
||||
- Status: Accepted
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: WebSocket 플랫폼을 leaf 하나의 패키지들로 내고 경계를 기계로 검사한다는 결정이다. 2026-09-25 플랫폼을 줄이면서 바뀌었다.
|
||||
- 현재 정본: `src/adapter/inbound/websocket/README.md`
|
||||
- 대체됨: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WS-001: The WebSocket platform ships as packages in one leaf, with machine-checked boundaries
|
||||
|
||||
- Status: Superseded 2026-09-25 — the eighteen-package platform was cut to the parts a Spring
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: resume·cluster 상태는 캐시로 다룬다는 결정이다. 그 기능은 2026-09-25에 지웠다.
|
||||
- 현재 정본: `src/adapter/inbound/websocket/README.md`
|
||||
- 대체됨: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WS-002: Resume and cluster state are caches, and are treated as caches
|
||||
|
||||
- Status: Superseded 2026-09-25 — `advanced.resume`, `advanced.cluster` and `advanced.presence`
|
||||
|
||||
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-08-25
|
||||
- 요약: STOMP를 목적지 목록이 있는 고급 어댑터로 둔다는 결정이다. 그 고급 STOMP는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `src/adapter/inbound/websocket/README.md`
|
||||
- 대체됨: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# ADR-WS-003: STOMP is an Advanced adapter with a declared destination catalog
|
||||
|
||||
- Status: Superseded 2026-09-25 — `advanced.stomp` and `advanced.stomp.rabbit` were removed; the
|
||||
|
||||
@@ -71,7 +71,7 @@ web 경로의 `W/`는 `src/adapter/inbound/web/src/main/java/dev/caskeleton/adap
|
||||
|
||||
복구가 필요하면 표의 커밋에서 경로를 꺼낸다(`git show <커밋>:<경로>`).
|
||||
|
||||
리뷰 후속 작업(2026-09-25~28, `docs/superpowers/plans/2026-09-25-review-followup.md`)에서 지운 것은 마지막으로 존재한 커밋이 `6d27356e`인 행으로 표 끝에 이어 붙였다.
|
||||
리뷰 후속 작업(2026-09-25~28, `docs/history/plans/2026-09-25-review-followup.md`)에서 지운 것은 마지막으로 존재한 커밋이 `6d27356e`인 행으로 표 끝에 이어 붙였다.
|
||||
|
||||
| 대상 | 경로 | 마지막으로 존재한 커밋 | 이유 |
|
||||
| --- | --- | --- | --- |
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
| 대상 | 무엇을 지키는가 |
|
||||
| --- | --- |
|
||||
| `docs/superpowers/**` | 이 템플릿을 만든 과정의 설계/계획 기록 |
|
||||
| `docs/design/**`, `docs/history/**` | 이 템플릿을 만든 과정의 설계서·계획서·납품 패키지·증거·학습 기록 |
|
||||
| `gradle/qualification/**` | 이 템플릿이 벤더링한 플랫폼(JPA, messaging)의 인증 체계 |
|
||||
| `*-certification.yml`, `*-qualification.yml`, `jpa-next-*.yml` | 템플릿이 광고하는 지원 매트릭스의 근거 |
|
||||
|
||||
|
||||
+10
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-07-20
|
||||
- 요약: 중복된 하네스 규칙을 레지스트리 기반 정책 엔진으로 바꾸려던 설계다.
|
||||
- 현재 정본: `src/config/architecture/modules.json`
|
||||
- 대체됨: `docs/design/2026-07-25-harness-free-mode-b-amendment.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
> **SUPERSEDED — HISTORICAL PROVENANCE ONLY (2026-07-25):** The user-approved harness-free
|
||||
> Mode B amendment supersedes this design. Retain the body as historical provenance; it is not
|
||||
> executable instruction.
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: application-core에서 Spring·로깅 의존을 걷어내고 확정된 outbox 실패를 보고하는 방식을 정한 설계다.
|
||||
- 현재 정본: `src/composition/outbox-relay/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Application Outbox Failure Reporting Refactoring Design
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: 하네스 없이 application-core를 프레임워크·로깅 없이 두면서 outbox 실패를 구조화된 ERROR 한 줄로 남기는 설계다.
|
||||
- 현재 정본: `src/composition/outbox-relay/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Application Outbox Failure Reporting — Harness-Free Design
|
||||
|
||||
## Context
|
||||
+10
-1
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: 숨어 있던 CI 제어면을 저장소 안으로 되살려 Gradle·Docker 빌드와 의존성 자동화를 맞추는 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# CI Control Plane Recovery Design
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
@@ -114,7 +123,7 @@ native provenance.
|
||||
**Mode B — controlled reconstruction.** The original source is unavailable or incomplete. The
|
||||
human records that fact and explicitly authorizes reconstruction from the approved
|
||||
[`2026-07-20-harness-policy-engine-design.md`](2026-07-20-harness-policy-engine-design.md),
|
||||
[`2026-07-20-harness-policy-engine.md`](../plans/2026-07-20-harness-policy-engine.md), the tracked
|
||||
[`2026-07-20-harness-policy-engine.md`](../history/plans/2026-07-20-harness-policy-engine.md), the tracked
|
||||
Gradle/module sources, and this design. Reconstructed artifacts receive new hashes and a
|
||||
`controlled-reconstruction` provenance record. Schema, renderer parity, mutation coverage, Gradle
|
||||
project discovery, and architecture dependency checks must pass before the new artifacts can act as
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: 하네스를 되살리지 않고 Gradle 부트스트랩과 의존 방향 검사를 복구하며 registry JSON을 정본으로 정한 범위 수정이다.
|
||||
- 현재 정본: `src/config/architecture/modules.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Harness-Free Mode B Amendment
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: 하네스 없이 품질·의존성 보안 CI를 저장소 안에서 다시 세우는 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Harness-Free Quality and Security CI Design
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: leaf Gradle 의존 그래프를 Clean Architecture를 지키는 최소 모양으로 줄이는 정리 설계다.
|
||||
- 현재 정본: `src/config/architecture/modules.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Module and Gradle Hygiene Refactoring Design
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-25
|
||||
- 요약: 같은 모듈·Gradle 정리를 하네스 없이 적용하는 설계다.
|
||||
- 현재 정본: `src/config/architecture/modules.json`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Harness-Free Module and Gradle Hygiene Design
|
||||
|
||||
- **Date:** 2026-07-25
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 폐기
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 파일 서버를 단계별로 운영 가능한 capability로 올리는 상세 설계다. 이 설계의 publication R1/R2 어댑터는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/fileserver/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Fileserver Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-26
|
||||
+11
-1
@@ -1,3 +1,13 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 대체됨
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: 통합 지점 모음을 opt-in 운영 capability 플랫폼으로 키우는 전체 설계다. 스위치로 끄던 방식은 2026-09-25 capability 모듈 포장으로 바뀌었다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
- 대체됨: `docs/design/2026-09-25-capability-module-packaging-design.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Production Capability Platform Design
|
||||
|
||||
- Date: 2026-07-26
|
||||
@@ -952,7 +962,7 @@ and durable interfaces are explicit.
|
||||
The authoritative implementation-level design for this capability is
|
||||
[Object Storage Production Capability Deep Design](2026-07-28-objectstorage-production-capability-design.md).
|
||||
Its ordered RED–GREEN execution batches and promotion gates are in the
|
||||
[Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md).
|
||||
[Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md).
|
||||
This subsection is only the cross-capability baseline; the dedicated design governs when details
|
||||
differ.
|
||||
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-26
|
||||
- 요약: Redis를 운영 가능한 capability로 올리는 단계별 상세 설계다.
|
||||
- 현재 정본: `docs/redis/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Redis Production Capability Deep Design
|
||||
|
||||
- Date: 2026-07-26
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-27
|
||||
- 요약: HTTP client를 운영 가능한 capability로 올리는 단계별 상세 설계다.
|
||||
- 현재 정본: `docs/httpclient/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# HTTP Client Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-27
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 폐기
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 파일 서버 R2 제어면과 provider 선택을 정한 설계다. 이 R2 어댑터는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/fileserver/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Fileserver R2 Control Plane and Provider Selection Design
|
||||
|
||||
- Date: 2026-07-28
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: JPA·PostgreSQL을 운영 가능한 capability로 올리는 상세 설계다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# JPA/PostgreSQL Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-28
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 메시징을 운영 가능한 capability로 올리는 상세 설계다.
|
||||
- 현재 정본: `docs/messaging/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Messaging Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-28
|
||||
+11
-2
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 알림을 운영 가능한 capability로 올리는 상세 설계다.
|
||||
- 현재 정본: `docs/notification/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Notification Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-28
|
||||
@@ -15,7 +24,7 @@
|
||||
|
||||
이 문서는 Notification capability의 승인된 상세 설계다. 2026-07-28에 §36의 다섯 gate를
|
||||
사용자가 승인했으며, 실제 구현 순서는
|
||||
[Notification Production Capability Implementation Plan](../plans/2026-07-28-notification-production-capability.md)을
|
||||
[Notification Production Capability Implementation Plan](../history/plans/2026-07-28-notification-production-capability.md)을
|
||||
정본으로 사용한다. 구현 및 production readiness는 아직 주장하지 않는다.
|
||||
|
||||
2026-07-28 현재 구현된 범위:
|
||||
@@ -4793,7 +4802,7 @@ COMPLETE 뒤 reverse가 필요하다면 canonical in-flight/intent backlog/provi
|
||||
inbound messaging/inbox architecture로 설계를 수정해야 한다.
|
||||
|
||||
사용자는 2026-07-28에 위 다섯 결정을 승인했다. 구현은
|
||||
[Notification Production Capability Implementation Plan](../plans/2026-07-28-notification-production-capability.md)의
|
||||
[Notification Production Capability Implementation Plan](../history/plans/2026-07-28-notification-production-capability.md)의
|
||||
작은 TDD task, owner leaf, registry-derived Gradle path, focused test, architecture gate,
|
||||
real-provider evidence와 rollback point를 따른다.
|
||||
|
||||
+16
-7
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: object storage를 운영 가능한 capability로 올리는 상세 설계와 batch 진행 기록이다.
|
||||
- 현재 정본: `src/adapter/outbound/objectstorage/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Object Storage Production Capability Deep Design
|
||||
|
||||
- 작성일: 2026-07-28
|
||||
@@ -12,7 +21,7 @@
|
||||
- 상위 문서:
|
||||
[Production Capability Platform Design](2026-07-26-production-capability-platform-design.md)
|
||||
- 구현 계획:
|
||||
[Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md)
|
||||
[Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md)
|
||||
- 참고 설계:
|
||||
[Redis Production Capability Deep Design](2026-07-26-redis-production-capability-design.md),
|
||||
[Fileserver Production Capability Deep Design](2026-07-26-fileserver-production-capability-design.md),
|
||||
@@ -78,11 +87,11 @@
|
||||
create-only PUT/complete 조건을 무시하므로 managed/direct mutation profile을
|
||||
`UNSUPPORTED`로 유지하며 readiness를 올리지 않는다.
|
||||
|
||||
증거는 [Batch A checkpoint](../../evidence/object-storage/batch-a-checkpoint.md),
|
||||
[Batch B checkpoint](../../evidence/object-storage/batch-b-checkpoint.md),
|
||||
[Batch C checkpoint](../../evidence/object-storage/batch-c-progress.md),
|
||||
[Batch D checkpoint](../../evidence/object-storage/batch-d-checkpoint.md),
|
||||
[Batch E pause checkpoint](../../evidence/object-storage/batch-e-pause-checkpoint.md)에 기록했다.
|
||||
증거는 [Batch A checkpoint](../history/evidence/object-storage/batch-a-checkpoint.md),
|
||||
[Batch B checkpoint](../history/evidence/object-storage/batch-b-checkpoint.md),
|
||||
[Batch C checkpoint](../history/evidence/object-storage/batch-c-progress.md),
|
||||
[Batch D checkpoint](../history/evidence/object-storage/batch-d-checkpoint.md),
|
||||
[Batch E pause checkpoint](../history/evidence/object-storage/batch-e-pause-checkpoint.md)에 기록했다.
|
||||
|
||||
격리 브랜치에서는 private vault 경로를 잘못 선택해 capture가 차단됐지만, main 통합 작업은
|
||||
사용자가 지정한 public vault의
|
||||
@@ -4015,7 +4024,7 @@ authorization endpoint의 ephemeral response이며 stored object DTO에 영구
|
||||
## 37. 구현 계획 작성 전 확정 항목
|
||||
|
||||
정본 구현 순서와 아래 결정의 현재 freeze/approval gate는
|
||||
[Object Storage Production Capability Implementation Plan](../plans/2026-07-28-objectstorage-production-capability.md)에
|
||||
[Object Storage Production Capability Implementation Plan](../history/plans/2026-07-28-objectstorage-production-capability.md)에
|
||||
기록한다. Tasks 1–24의 구현은 Batch E pause checkpoint까지 진행됐지만 Batch E 전체
|
||||
combined/root gate는 아직 통과하지 않았다. Tasks 25–30은 미착수다. 이 구현 진행이나
|
||||
계획 승인이 public API, scanner provider 또는 AWS/IaC 외부 변경 권한을 자동으로 부여하지
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 제안
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: 운영 수준 테스트 구조와 테스트 환경(서비스 준비, 데이터 격리, CI·릴리스 환경)을 정하는 제안이다.
|
||||
- 현재 정본: `docs/testing/TESTING_STRATEGY.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Production-grade test architecture and environment design
|
||||
|
||||
- Status: proposed design; implementation not started
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: Redis 캐시에 cache-aside, 원본 보호, soft/hard TTL을 더하는 증분 설계다.
|
||||
- 현재 정본: `docs/redis/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Redis Cache Resilience Increment Design
|
||||
|
||||
**Status:** approved for implementation
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 구현됨
|
||||
- 작성일: 2026-07-28
|
||||
- 요약: Redis로 고를 수 있는 분산 rate-limit 알고리즘 셋을 제공하는 증분 설계다.
|
||||
- 현재 정본: `docs/redis/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Redis Distributed Rate-Limit Increment Design
|
||||
|
||||
**Status:** implemented as standalone R1
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-01
|
||||
- 요약: 릴리스 위생 경로(sample-off 게이트, wrapper 검증, Docker 캐시, SpotBugs)를 사실대로 맞추는 리팩터링 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Release Hygiene Refactoring Design
|
||||
|
||||
**Date:** 2026-08-01
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 공개 HTTP 오류 응답에 허용한 문구와 안전한 값만 담게 하는 경계 설계다.
|
||||
- 현재 정본: `docs/web/http-contract.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Client-Safe Error Boundary Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: GraphQL·gRPC·WebSocket 전송을 고를 때만 켜고 위험한 활성화는 실패시키는 경계 설계다.
|
||||
- 현재 정본: `docs/web/http-contract.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Conditional Inbound Transport Boundary Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 동작을 바꾸지 않고 남은 fail-open 검증 경로를 없애는 리팩터링 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# P2 Verification Governance Refactoring Design
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: Redis 세션과 HTTP 경계에서 브라우저 세션 보안이 유지되고 실패 시 닫히는지 증명하는 설계다.
|
||||
- 현재 정본: `docs/redis/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Redis Session HTTP Boundary Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 파일을 고치던 검증 경로(stale JAR, 공개 경로)를 읽기 전용으로 바꾸는 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Verification Purity Refactoring Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: 컴파일러·정적 분석·테스트 출력 경고를 0으로 만드는 빌드 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Warning-Zero Build Refactoring Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-02
|
||||
- 요약: JWT·JWKS와 CORS 필터 경계를 밀봉된 테스트와 릴리스 차단 검사로 고정하는 설계다.
|
||||
- 현재 정본: `docs/web/http-contract.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Web Security Boundary Design
|
||||
|
||||
**Date:** 2026-08-02
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-07
|
||||
- 요약: 업로드·다운로드를 넘어 저장·게시·전송을 나눈 공통 파일 서비스 플랫폼 설계다.
|
||||
- 현재 정본: `docs/fileserver/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Fileserver Platform 설계서
|
||||
|
||||
**문서 상태:** 설계 확정안
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-07
|
||||
- 요약: Redis 자료구조와 명령을 위험도에 따라 Typed API와 통제된 Raw Gateway로 나눠 제공하는 설계다.
|
||||
- 현재 정본: `docs/redis/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Redis Wrapper 및 Typed API 설계서
|
||||
|
||||
- **상태:** 구현 기준선 확정
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-08
|
||||
- 요약: 외부 HTTP 호출의 대상, 연결 자원, 시간 예산, 재시도 증거를 다루는 HTTP client 플랫폼 설계다.
|
||||
- 현재 정본: `docs/httpclient/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# HTTP Client Platform 설계서
|
||||
|
||||
**문서 상태:** 구현 기준선 확정
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-08-10
|
||||
- 요약: 메시지 생성부터 브로커 수락, 소비자 정산까지 증거로 다루는 메시징 플랫폼 설계다.
|
||||
- 현재 정본: `docs/messaging/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Messaging Platform 설계서
|
||||
|
||||
- **상태:** 구현 승인용 기준 설계
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-10
|
||||
- 요약: 요청·수신자·시도 수명주기와 provider 결과를 다루는 알림 전달 플랫폼 설계다.
|
||||
- 현재 정본: `docs/notification/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Notification Delivery Platform 설계서
|
||||
|
||||
> 상태: 구현 기준 설계(Implementation-ready)
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: JPA 관계형 영속성 플랫폼의 공개 계약, 모듈 경계, 트랜잭션 의미론을 정한 설계다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# JPA 관계형 영속성 플랫폼 설계서
|
||||
|
||||
- 문서 상태: 구현 기준 설계
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-11
|
||||
- 요약: 도메인이 MongoDB 문서와 repository를 소유하게 하는 문서 영속성 플랫폼 설계다.
|
||||
- 현재 정본: `docs/mongodb/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# MongoDB 문서 영속성 플랫폼 설계서
|
||||
|
||||
- 문서 상태: 구현 기준 설계
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-12
|
||||
- 요약: SDL 계약이 인증·제한·실행·오류 계약을 거쳐 유스케이스에 닿게 하는 GraphQL 실행 플랫폼 설계다.
|
||||
- 현재 정본: `src/adapter/inbound/graphql/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# GraphQL API 실행 플랫폼 설계서
|
||||
|
||||
- **문서 상태:** 구현 기준선 확정
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-15
|
||||
- 요약: 다섯 어댑터를 한 bootJar에서 켜고 끌 수 있게 고치는 통합 리뷰와 개선 설계다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 다섯 Adapter 최종 통합 리뷰 및 개선 설계
|
||||
|
||||
- 기준 일자: 2026-08-15
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-08-30
|
||||
- 요약: 타입 안전 gRPC 실행 플랫폼 계획을 이 저장소의 구조와 게이트에 맞춘 설계다.
|
||||
- 현재 정본: `docs/compatibility/grpc-support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 타입 안전 gRPC 실행 플랫폼 — 이 저장소 규약으로의 어댑팅 설계
|
||||
|
||||
두 계획 문서를 이 저장소(`ca-skeleton`)의 실제 구조·정책·빌드 게이트에 맞춰 실행 가능한 형태로
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-16
|
||||
- 요약: 스켈레톤을 qualification framework에서 되돌려 검증 표면을 줄이는 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# 검증 표면 축소 설계 — 스켈레톤을 qualification framework에서 되돌리기
|
||||
|
||||
날짜: 2026-09-16
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-17
|
||||
- 요약: JPA 증거 생성이 실행 시점에 Gradle 모델을 읽지 않게 떼어 내는 설계다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# JPA Evidence Gradle Model Decoupling Design
|
||||
|
||||
## Context
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: app-bootstrap 경고 로그를 구조화된 필드로 모으는 작은 설계다.
|
||||
- 현재 정본: `docs/observability/log-fields.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Bootstrap Structured Log Fields
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: app-bootstrap에 남은 비구조 운영 로그를 구조화하는 작은 설계다.
|
||||
- 현재 정본: `docs/observability/log-fields.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Bootstrap Structured Runtime Logging
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 설정 이름공간을 어디에 둘지 정리한 처분 기록이다.
|
||||
- 현재 정본: `docs/registries/env-keys.yaml`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
BOOT-001 disposition
|
||||
====================
|
||||
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 배포 조립에서 닿지 않던 구성 요소를 고치는 설계다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Deployment Composition Reachability Remediation
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: HTTP client 조립을 app-bootstrap에서 그 capability leaf로 옮기는 설계다.
|
||||
- 현재 정본: `docs/httpclient/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# HTTP Client Capability Composition Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 관계형 영속성 조립을 app-bootstrap에서 persistence-jpa로 옮기는 설계다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# JPA Capability Composition Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: JPA 조립 후보 둘이 같은 스위치를 따르게 하는 설계다.
|
||||
- 현재 정본: `docs/jpa/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# JPA Runtime Master Switch
|
||||
|
||||
## Problem
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 애플리케이션 전용 브로커 이음매를 메시징 플랫폼으로 가는 bridge 하나로 바꾸는 설계다.
|
||||
- 현재 정본: `docs/messaging/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Messaging Platform Bridge Design
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: Mongo health 조립을 persistence-mongo leaf로 옮기는 설계다.
|
||||
- 현재 정본: `docs/mongodb/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Mongo Health Composition Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 알림 provider·런타임 조립을 app-bootstrap에서 알림 capability로 옮기는 설계다.
|
||||
- 현재 정본: `docs/notification/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Notification Capability Composition Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 기존 outbox 저장소는 두고 발행 전송만 메시징 플랫폼으로 넘기는 설계다.
|
||||
- 현재 정본: `src/composition/outbox-relay/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Outbox Transport-Only Cutover Design
|
||||
|
||||
## Status
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 폐기
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: outbox V2 저장소를 canonical 이벤트에 맞추는 설계다. V2 세대는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Outbox V2 Canonical Storage Alignment
|
||||
|
||||
## Status
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 폐기
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: outbox V2에서 기록 하나를 한 번 발행하는 정책 설계다. V2 세대는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Outbox V2 One-Record Publication Policy
|
||||
|
||||
## Status
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: PostgreSQL 멱등성 저장소 조립을 app-bootstrap에서 persistence-jpa로 옮기는 설계다.
|
||||
- 현재 정본: `src/composition/idempotency/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# PostgreSQL Idempotency Composition Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: tracing과 capability 검증이 런타임 profile 어휘 하나를 쓰게 하는 설계다.
|
||||
- 현재 정본: `src/app-bootstrap/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Runtime Environment and Tracing SSOT
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 시크릿 출처 포트를 application이 소유하고 구현을 adapter로 옮기는 설계다.
|
||||
- 현재 정본: `docs/registries/env-keys.yaml`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Secret Source Port Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 기동 실패 로그 상태를 프로세스 전역이 아닌 logger context에 두는 설계다.
|
||||
- 현재 정본: `docs/observability/log-fields.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Startup Failure Log Context State
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: provider 증거 테스트의 소유 leaf를 정리하는 테스트 구조 2단계 설계다.
|
||||
- 현재 정본: `docs/testing/TESTING_STRATEGY.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Test Architecture Phase 2 — Provider Ownership
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-18
|
||||
- 요약: 테스트 전략 문서를 테스트 분류 정본에 맞추는 설계다.
|
||||
- 현재 정본: `docs/testing/TESTING_STRATEGY.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Test Taxonomy SSOT Alignment
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: 빌드·CI 리뷰가 찾은 조립 결함을 고치는 설계다.
|
||||
- 현재 정본: `docs/work/reference/gates.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Build / Release Review Remediation Design
|
||||
|
||||
## Source
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 폐기
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: capability 의존 검증을 StartupValidationContext로 옮기는 설계다. capability 의존 검증기는 2026-09-25에 지웠다.
|
||||
- 현재 정본: `docs/capability-status.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Capability Dependency Validation Context
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: env 키 검사가 선언과 실제 사용을 구분하게 하는 설계다.
|
||||
- 현재 정본: `docs/registries/env-keys.yaml`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Env Contract Verifier Truth Surface
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: 파일 서버 조립을 관심사별 설정 다섯 개로 나누는 설계다.
|
||||
- 현재 정본: `docs/fileserver/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Fileserver Composition Decomposition
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: 파일 검증이 읽기 실패를 빈 내용으로 오인하지 않게 고치는 설계다.
|
||||
- 현재 정본: `docs/fileserver/support-matrix.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Fileserver Verification Read Failure Remediation
|
||||
|
||||
## Source
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: Mongo client 런타임 리뷰의 Critical 둘을 고치는 설계다.
|
||||
- 현재 정본: `docs/mongodb/repository-adaptation.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Mongo Client Runtime Review Remediation
|
||||
|
||||
## Source
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: 가짜 조정 bean 없이 다중 인스턴스 런타임 계약을 세우는 설계다.
|
||||
- 현재 정본: `src/app-bootstrap/README.md`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Multi-instance Runtime Contract
|
||||
|
||||
## Goal
|
||||
+9
@@ -1,3 +1,12 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 확인 안 함
|
||||
- 작성일: 2026-09-19
|
||||
- 요약: 운영 기동이 실제로 쓰는 시크릿만 요구하게 맞추는 설계다.
|
||||
- 현재 정본: `docs/registries/env-keys.yaml`
|
||||
<!-- 머리 블록 끝 -->
|
||||
|
||||
# Prod Secret Consumer Alignment
|
||||
|
||||
## Goal
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user