---
title: ca-tmpl
source_type: project
status: reviewed
confidence: high
tags: [ca-skeleton, project-hub, locally-verified]
related_projects: [ca-skeleton]
last_reviewed: 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` 승급 정의)