ca-tmpl — Project Hub

Layer: sibling wiki/projects/ca-tmpl/ 폴더 안 의사결정 sub-doc 의 named hub (folder-note 패턴). Clean Architecture skeleton 템플릿 프로젝트. 2026-05-27 기준 package/module blueprint slice는 Phase C2 local implementation 및 verification 완료, 나머지 운영 계약 slice는 문서/설계 또는 후속 구현 대기 상태다.

프로젝트 현황

상태: Phase A-E (canonical contract + 16 wiki/concepts/ 합성) 완료. Phase C2는 package/module blueprint slice부터 진입했고, /home/donghyeon/workspace/ca-tmpl/에서 local verification 완료.
canonical SSOT: raw/project-notes/ca-skeleton-operational-contract (29 섹션, 43 branch 결정 통합)
운영 artifact 위치: ca-tmpl repo /home/donghyeon/workspace/ca-tmpl/docs/{registries,runbooks}/ (LLM Wiki 외부)
공통 증거 등급: clean-architecture-package-layout 중 skeleton package blueprint 범위는 actually-implemented + locally-verified. 나머지 문서는 각 문서별 상태를 따른다. prod-verified는 없음.

16 의사결정 문서

Core 6 (T1-T6)

wiki/projects/ca-tmpl/clean-architecture-package-layout — T1 Gradle multi-module Clean Architecture / Hexagonal package blueprint (locally-verified)
wiki/projects/ca-tmpl/transaction-boundary-abstraction — T2 TransactionPort abstraction
wiki/projects/ca-tmpl/transactional-outbox-pattern — T3 SKIP LOCKED outbox
wiki/projects/ca-tmpl/api-error-envelope-design — T4 custom error envelope
wiki/projects/ca-tmpl/idempotency-key-design — T5 triple scope idempotency
wiki/projects/ca-tmpl/multi-tenancy-isolation-patterns — T6 opt-in Pool model

Cross-cutting 10 (G-A ~ G-J)

wiki/projects/ca-tmpl/observability-log-metric-trace-runbook — G-A Log + Metric + Trace + Runbook
wiki/projects/ca-tmpl/security-baseline-jwt-actuator-secrets — G-B JWT + Actuator + Secrets
wiki/projects/ca-tmpl/data-layer-persistence-cache-outbound — G-C Persistence + Cache + Outbound
wiki/projects/ca-tmpl/runtime-container-health-migration — G-D Container + Health + Migration
wiki/projects/ca-tmpl/devops-ci-supply-chain-dx — G-E CI + Supply chain + DX
wiki/projects/ca-tmpl/api-evolution-and-schema — G-F Compatibility + Schema
wiki/projects/ca-tmpl/skeleton-governance-registry-verification-test-scorecard — G-G Registry + Verification + Test + Scorecard
wiki/projects/ca-tmpl/sample-fixture-and-adoption — G-H Sample fixture + Adoption
wiki/projects/ca-tmpl/config-and-adapter-templates — G-I Env config + Adapter
wiki/projects/ca-tmpl/privacy-file-domain-modeling — G-J Privacy + File + Domain

Resource contract slices

wiki/projects/ca-tmpl/resource-identifier-format — ULID resource identifier 결정 + 신규 adapter-identifier 모듈 (actually-implemented + locally-verified)
wiki/projects/ca-tmpl/boundary-validation-mapping — 입력 경계 검증 + DTO↔도메인 매핑 계약 (Bean Validation @GroupSequence · Patch<T> 3-state · outbound ACL · 8개 boundary ArchUnit rule) (actually-implemented + locally-verified)
wiki/projects/ca-tmpl/streaming-response-support — 이벤트/server-push 스트리밍 미지원 결정 + ArchUnit import-ban 3개(no_sse_emitter / no_response_body_emitter / no_websocket_handler) 정적 강제 (StreamingResponseBody 다운로드는 차단 제외) (actually-implemented + locally-verified)
wiki/projects/ca-tmpl/knowledge-capture-workflow — 구현 종료 조건에 LLM Wiki branch/error/interview/blog-topic capture를 포함하는 workflow 결정 (documented-only)

면접 발화 가이드 (공통)

자신 있게: 의사결정 근거와 대안 trade-off
적당히: 마이그레이션 trigger, 표준 vs 사례 비교
답하면 안 됨: "구현했다 / 측정했다 / 운영했다" — 모두 Phase C2 진입 후에만 가능

승급 경로

각 문서는 Phase C2 구현 slice가 실제 코드와 검증으로 확인될 때 actually-implemented / locally-verified 섹션을 갱신한다. 2026-05-27 package blueprint slice는 이 승급을 완료했다. 외부 공개(published-ready)는 운영 과장 방지 검토와 파생 문서 게이트를 별도로 통과해야 한다.

자세한 단계 정의는 CLAUDE §15.

Sources

본 문서는 hub/index 성격이며 16개 sub-document를 위 목록으로 가리킵니다. 개별 의사결정의 출처는 각 sub-document의 Sources 섹션에 있습니다.

raw/project-notes/ca-skeleton-operational-contract — ca-tmpl 운영 계약 canonical SSOT (16 의사결정의 원천)
CLAUDE §15 — 문서 위계 및 파생 규칙 (documented-only → actually-implemented 승급 정의)

4.9 KiB Raw Blame History