문제: 설계서·계획서·납품 패키지·증거·학습 문서와 ADR이 기록이라는 표시 없이 지금 문서처럼 읽힌다. 상태 칸이 설계서 72개 중 40개, 계획서는 거의 없고, 있어도 Approved·확정·Accepted.처럼 값이 제각각이며 영어다. 고른 방법: docs/design, docs/history, docs/adr, docs/notification/adr의 .md 246개 맨 위에 같은 모양의 머리 블록을 단다. 칸은 상태·작성일· 요약(한국어 한 문장)·현재 정본, 대체됐으면 대체됨이다. 블록은 표시 줄 두 개로 감싸서 빼면 원문 바이트가 그대로 돌아온다(246개 모두 대조함). - 종류는 폴더가 정하고 둘째 줄에 적는다(plans/evidence는 증거). - 상태는 원래 상태 줄을 고정 어휘로 바꾼 값이다. 상태 줄이 없는 설계서와 체크 상자가 다 표시되지 않은 계획서는 「확인 안 함」. capability-status.md 제거 표로 지운 것이 확인된 설계서 다섯은 「폐기」, 2026-07-20 하네스 설계·계획과 production capability platform 설계는 「대체됨」이다. - 현재 정본은 구조 정리로 옮겨질 수 있는 src/messaging·src/grpc 대신 docs/ 쪽 문서나 옮기지 않는 leaf README를 가리킨다. docs/README.md에 「문서 수명과 언어」「기록 문서의 머리 블록」「문서와 코드를 같은 변경에서 고친다」를 더하고, 파생 서비스 안내에 머리 블록 충돌 가능성을 적었다. 버린 대안: H1 제목 아래에 블록을 두는 안은 보기에는 낫지만 빼는 규칙이 파일마다 달라져 원문 복원이 기계적이지 않다. 「종류」 칸을 따로 두는 안은 폴더와 같은 정보를 두 번 쓰게 한다. 위험·한계: 「확인 안 함」 설계서 38개, 계획서 51개는 지금 유효한지 아무도 판정하지 않았다. 요약은 제목·목표 줄을 보고 쓴 것이라 본문을 끝까지 읽지 않았다. 납품 패키지 셋의 MANIFEST.sha256는 이제 맞지 않는다 (납품 당시 바이트의 해시이고, 블록을 빼면 다시 맞는다). 리뷰 폴더에는 아직 머리 블록을 달지 않았다. 검증: 머리 블록을 뺀 내용과 HEAD 원본 246개 일치, check-work-docs.py rc=0, --links docs·README.md·CLAUDE.md·AGENTS.md 깨진 링크 0.
112 lines
5.3 KiB
Markdown
112 lines
5.3 KiB
Markdown
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||
> **기록 · 증거** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
||
|
||
- 상태: 보관
|
||
- 작성일: 2026-07-28
|
||
- 요약: Object Storage 작업 Batch D의 체크포인트 기록이다.
|
||
- 현재 정본: `src/adapter/outbound/objectstorage/README.md`
|
||
<!-- 머리 블록 끝 -->
|
||
|
||
# Object Storage Batch D Checkpoint
|
||
|
||
- Date: 2026-07-28
|
||
- Branch: `codex/objectstorage-production-capability`
|
||
- Worktree:
|
||
`/home/donghyeon/workspace/clean-architecture-backend-template-objectstorage`
|
||
- Scope: direct-transfer provider/application primitives only
|
||
- Public endpoint: none
|
||
- Readiness advanced: no; all direct cards remain R0
|
||
|
||
## Implemented scope
|
||
|
||
- Added direct single-upload session policy, durable prepared/issued transitions, bearer
|
||
redaction, exact completion verification, published-version download resolution, and an
|
||
S3-presigner lifecycle owned by the selected provider.
|
||
- Added direct multipart durable session and part-grant families, opaque acknowledgement tokens,
|
||
sharded part records, admission-close/expiry fencing, exact ledger validation, completion/abort
|
||
states, response-loss resolution, and persisted terminal exact-version replay.
|
||
- Added direct S3 initiate/discovery, exact-part presign, `ListParts` acknowledgement, conditional
|
||
complete followed by exact HEAD verification, and abort resolution.
|
||
- Registered direct single and multipart delegates only when their exact compiled capability is
|
||
selected. One presigner is constructed and closed exactly once.
|
||
- Added golden canonical envelopes for the direct session, direct multipart session, and direct
|
||
multipart grant families.
|
||
- Fixed `MultipartCompleteRequest` null validation so valid immutable `List.of(...)` input no longer
|
||
throws from `contains(null)`.
|
||
|
||
## Qualification truth
|
||
|
||
The exact MinIO release cannot prove create-only PUT or create-only multipart completion, so both
|
||
direct profiles are explicitly `UNSUPPORTED`. The direct MinIO contract/fault lanes are negative
|
||
admission tests: they prove no bearer or multipart mutation enters an unsupported profile. No test
|
||
skip is used as positive evidence.
|
||
|
||
The AWS managed/direct source sets compile, but no AWS call was made and no AWS evidence row was
|
||
published. No inbound controller, authorization surface, CORS runtime configuration, or public
|
||
direct API exists.
|
||
|
||
## Verification
|
||
|
||
Commands completed with `BUILD SUCCESSFUL`:
|
||
|
||
```bash
|
||
cd src
|
||
./gradlew :adapter:outbound:objectstorage:test \
|
||
--tests '*DirectTransferCoordinatorTest' \
|
||
--tests '*PresignedGrantRedactionTest' \
|
||
--tests '*S3DirectTransferProviderTest' \
|
||
--tests '*ObjectControlRecordCodecTest' \
|
||
--tests '*S3ProviderCompositionTest' --console=plain
|
||
./gradlew :adapter:outbound:objectstorage:test \
|
||
--tests '*DirectMultipartCoordinatorTest' \
|
||
--tests '*DirectMultipartRaceTest' \
|
||
--tests '*S3DirectMultipartProviderTest' \
|
||
--tests '*ObjectControlRecordCodecTest' \
|
||
--tests '*S3ProviderCompositionTest' --console=plain
|
||
./gradlew \
|
||
:adapter:outbound:objectstorage:objectStorageMinioContractTest \
|
||
:adapter:outbound:objectstorage:objectStorageMinioFaultTest \
|
||
--tests '*DirectTransfer*' --console=plain
|
||
./gradlew :adapter:outbound:objectstorage:test \
|
||
--tests '*DirectTransferCorsContractTest' --console=plain
|
||
./gradlew :adapter:outbound:objectstorage:objectStorageAwsQualificationTestClasses --console=plain
|
||
./gradlew :adapter:outbound:objectstorage:check --console=plain
|
||
./gradlew :adapter:outbound:objectstorage:verifyDependencyLocks \
|
||
verifyCleanArchitectureDependencies --console=plain
|
||
./gradlew \
|
||
:adapter:outbound:objectstorage:objectStorageMinioContractTest \
|
||
:adapter:outbound:objectstorage:objectStorageMinioFaultTest --console=plain
|
||
bash ../.github/scripts/verify-gate-matrix.sh
|
||
./gradlew test --console=plain
|
||
./gradlew check --console=plain
|
||
```
|
||
|
||
The module `check` includes unit tests, Checkstyle, Spotless, SpotBugs, architecture, configuration
|
||
processor, environment-key, and repository-wide policy checks. Existing test-only compiler
|
||
warnings remain non-failing. The final repository-wide test run completed 79 tasks and the final
|
||
repository-wide check completed 214 tasks.
|
||
|
||
## Deliberate limitations
|
||
|
||
- Issued bearer material is process-local. A restart fails closed instead of reconstructing or
|
||
reissuing an already-issued bearer.
|
||
- The signing clock/window is stored and bounded, but AWS SDK presigner query timing is not driven
|
||
by the injected application clock.
|
||
- The direct multipart recovery/race matrix covers its principal fences and completion response
|
||
loss but is not exhaustive enough for an R2 claim.
|
||
- Retention/Object Lock grant headers and a provider-enforced direct-single hard size ceiling are
|
||
not qualified.
|
||
- No public endpoint exists, so CORS evidence is a pure contract and no direct card may exceed R0
|
||
in the current registry.
|
||
|
||
## Approval Gate A
|
||
|
||
Tasks 20–24 remain blocked until the user explicitly approves scanner ownership, the sample's
|
||
first publication profile, the additive asynchronous API/status contract, and digest transport.
|
||
No scan/publication/sample endpoint implementation was started.
|
||
|
||
## documentation update
|
||
|
||
`/home/donghyeon/workspace/ai-tool/` do not exist in this environment. The required
|
||
be created or updated. No similarly named non-canonical clone was used.
|