4.9 KiB
4.9 KiB
title, source_type, status, confidence, tags, related_projects, last_reviewed
| title | source_type | status | confidence | tags | related_projects | last_reviewed | ||||
|---|---|---|---|---|---|---|---|---|---|---|
| ca-tmpl | project | reviewed | high |
|
|
2026-05-27 |
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승급 정의)