timsquad 3.6.0 → 3.7.1

package/templates/base/timsquad/ssot/audit-trail-spec.template.md

@@ -0,0 +1,155 @@
+---
+title: "감사 추적 명세서 (Audit Trail Specification)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-security
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 감사 추적 명세서 (Audit Trail Specification)
+
+> 시스템 내 모든 주요 활동의 감사 추적(Audit Trail)을 설계합니다.
+> 보안 사고 대응, 분쟁 해결, 규제 준수를 위한 추적성을 보장합니다.
+
+---
+
+## 1. 감사 대상
+
+### 1.1 이벤트 분류
+
+| 분류 | 이벤트 | 보존 기간 | 필수 |
+|-----|--------|:--------:|:----:|
+| 인증 | 로그인, 로그아웃, MFA | 5년 | ✅ |
+| 인가 | 권한 변경, 역할 부여/회수 | 영구 | ✅ |
+| 데이터 접근 | 민감 데이터 조회 | 5년 | ✅ |
+| 데이터 변경 | 생성, 수정, 삭제 | 영구 | ✅ |
+| 거래 | 주문, 결제, 환불, 정산 | 5년 | ✅ |
+| 시스템 | 배포, 설정 변경, 장애 | 3년 | ✅ |
+| 관리자 | 관리자 패널 모든 작업 | 영구 | ✅ |
+
+### 1.2 감사 레벨
+
+| 레벨 | 설명 | 적용 |
+|-----|------|------|
+| L1 | 이벤트 발생 기록 (who, when, what) | 모든 이벤트 |
+| L2 | 변경 전/후 데이터 (before/after) | 데이터 변경 |
+| L3 | 전체 요청/응답 페이로드 | 금융 거래 |
+
+---
+
+## 2. 감사 로그 스키마
+
+### 2.1 기본 필드
+
+```json
+{
+  "id": "audit_abc123",
+  "timestamp": "2026-01-01T00:00:00.000Z",
+  "event_type": "ORDER_CREATED",
+  "category": "transaction",
+  "level": "L2",
+  "actor": {
+    "user_id": "user_123",
+    "ip_address": "1.2.3.4",
+    "user_agent": "Mozilla/5.0...",
+    "session_id": "sess_456"
+  },
+  "target": {
+    "entity_type": "order",
+    "entity_id": "order_789",
+    "path": "/api/orders"
+  },
+  "changes": {
+    "before": null,
+    "after": { "status": "created", "amount": 50000 }
+  },
+  "metadata": {
+    "trace_id": "trace_xyz",
+    "service": "order-service",
+    "version": "1.2.3"
+  },
+  "result": "success"
+}
+```
+
+### 2.2 이벤트 타입
+
+| 카테고리 | 이벤트 타입 | 레벨 | 설명 |
+|---------|-----------|:----:|------|
+| auth | `LOGIN_SUCCESS` | L1 | 로그인 성공 |
+| auth | `LOGIN_FAILURE` | L1 | 로그인 실패 (사유 포함) |
+| auth | `TOKEN_REFRESH` | L1 | 토큰 갱신 |
+| auth | `MFA_VERIFIED` | L1 | MFA 인증 |
+| authz | `ROLE_ASSIGNED` | L2 | 역할 부여 |
+| authz | `PERMISSION_CHANGED` | L2 | 권한 변경 |
+| data | `RECORD_CREATED` | L2 | 데이터 생성 |
+| data | `RECORD_UPDATED` | L2 | 데이터 수정 (before/after) |
+| data | `RECORD_DELETED` | L2 | 데이터 삭제 (before 포함) |
+| data | `SENSITIVE_DATA_ACCESS` | L1 | 민감 데이터 조회 |
+| txn | `ORDER_CREATED` | L3 | 주문 생성 |
+| txn | `PAYMENT_PROCESSED` | L3 | 결제 처리 |
+| txn | `REFUND_ISSUED` | L3 | 환불 처리 |
+| system | `CONFIG_CHANGED` | L2 | 시스템 설정 변경 |
+| system | `DEPLOYMENT` | L1 | 서비스 배포 |
+
+---
+
+## 3. 저장 아키텍처
+
+### 3.1 저장소 구성
+
+| 저장소 | 용도 | 보존 | 접근 |
+|-------|------|------|------|
+| Hot (DB) | 최근 로그 조회 | 30일 | 실시간 검색 |
+| Warm (Object Storage) | 중기 보관 | 1년 | 일괄 검색 |
+| Cold (Archive) | 장기 보관 | 5년+ | 복원 후 검색 |
+
+### 3.2 무결성 보장
+
+| 방법 | 설명 |
+|-----|------|
+| 쓰기 전용 | 감사 로그는 수정/삭제 불가 (append-only) |
+| 해시 체인 | 각 로그에 이전 해시 포함 → 변조 감지 |
+| 타임스탬프 | 신뢰할 수 있는 시간 소스 (NTP) |
+| 접근 제어 | 쓰기: 시스템만 / 읽기: 감사 권한 필요 |
+
+---
+
+## 4. 검색 및 조회
+
+### 4.1 검색 필드
+
+| 필드 | 인덱스 | 검색 예시 |
+|-----|:------:|----------|
+| actor.user_id | ✅ | 특정 사용자의 모든 활동 |
+| event_type | ✅ | 모든 로그인 실패 |
+| target.entity_id | ✅ | 특정 주문의 모든 변경 |
+| timestamp | ✅ | 기간별 조회 |
+| result | ✅ | 실패한 작업만 |
+
+### 4.2 조회 API
+
+| 엔드포인트 | 용도 | 권한 |
+|-----------|------|------|
+| `GET /api/audit/search` | 조건부 검색 | AUDITOR+ |
+| `GET /api/audit/:id` | 단건 상세 | AUDITOR+ |
+| `GET /api/audit/entity/:type/:id` | 엔티티 이력 | AUDITOR+ |
+| `GET /api/audit/user/:id` | 사용자 활동 | AUDITOR+ |
+| `POST /api/audit/export` | CSV/JSON 내보내기 | ADMIN |
+
+---
+
+## 5. 관련 문서
+
+- [컴플라이언스 매트릭스](./compliance-matrix.md) — 규제 요구사항
+- [보안 명세](./security-spec.md) — 접근 제어 정책
+- [데이터 설계](./data-design.md) — 감사 테이블 스키마
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-security | 초기 작성 |

package/templates/base/timsquad/ssot/compliance-matrix.template.md

@@ -0,0 +1,105 @@
+---
+title: "컴플라이언스 매트릭스 (Compliance Matrix)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-security
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 컴플라이언스 매트릭스 (Compliance Matrix)
+
+> 프로젝트에 적용되는 법규, 산업 표준, 내부 정책의 준수 현황을 추적합니다.
+> 프로젝트 특성에 맞는 규제 항목을 선택하여 사용하세요.
+
+---
+
+## 1. 적용 규제
+
+### 1.1 법률/규정
+
+| 규제 | 관할 | 적용 범위 | 필수 여부 | 상태 |
+|-----|------|----------|:--------:|:----:|
+| 개인정보보호법 | 대한민국 | 개인정보 처리 | ✅ | ⏳ |
+| 정보통신망법 | 대한민국 | 정보통신 서비스 | 조건부 | - |
+| GDPR | EU | EU 사용자 대상 | 조건부 | - |
+<!-- 금융: 전자금융거래법, 신용정보법 → fintech override 참조 -->
+<!-- 의료: 의료법, 개인정보보호법 특례 → 해당 시 추가 -->
+
+### 1.2 산업 표준
+
+| 표준 | 적용 범위 | 인증 필요 | 상태 |
+|-----|----------|:--------:|:----:|
+| ISO 27001 | 정보보안 관리 | 권장 | - |
+| SOC 2 Type II | 서비스 신뢰성 | 권장 | - |
+<!-- 금융: PCI DSS, ISMS-P → fintech override 참조 -->
+
+---
+
+## 2. 요구사항 매트릭스
+
+### 2.1 데이터 보호
+
+| 요구사항 | 근거 규제 | 구현 방법 | 담당 | 상태 |
+|---------|----------|----------|------|:----:|
+| 개인정보 암호화 (저장) | 개인정보보호법 §29 | AES-256 | 개발팀 | ⏳ |
+| 개인정보 암호화 (전송) | 개인정보보호법 §29 | TLS 1.3 | 인프라 | ⏳ |
+| 개인정보 수집 동의 | 개인정보보호법 §15 | 동의 UI + 로그 | 개발팀 | ⏳ |
+| 개인정보 파기 | 개인정보보호법 §21 | 자동 파기 배치 | 개발팀 | ⏳ |
+| 접근 권한 관리 | 개인정보보호법 §29 | RBAC | 개발팀 | ⏳ |
+
+### 2.2 인프라/보안
+
+| 요구사항 | 근거 규제 | 구현 방법 | 담당 | 상태 |
+|---------|----------|----------|------|:----:|
+| 취약점 점검 | ISO 27001 | 정기 스캔 | 보안팀 | ⏳ |
+| 접근 로그 보관 | 개인정보보호법 | 중앙 로그 시스템 | 인프라 | ⏳ |
+| 네트워크 분리 | 보안 기준 | VPC 분리 | 인프라 | ⏳ |
+<!-- 금융 특화(FDS, PCI DSS 등)는 fintech override에서 추가 -->
+
+---
+
+## 3. 인증/심사 일정
+
+| 인증 | 심사 유형 | 예정일 | 담당 | 상태 |
+|-----|---------|-------|------|:----:|
+| ISO 27001 | 최초 인증 | TBD | 보안팀 | 계획 |
+<!-- 금융: PCI DSS, ISMS-P → fintech override 참조 -->
+
+---
+
+## 4. 준수 체크리스트
+
+### 4.1 출시 전 필수
+
+- [ ] 개인정보 처리방침 작성 및 게시
+- [ ] 이용약관 법률 검토 완료
+- [ ] 개인정보 영향평가 (해당 시)
+- [ ] 보안 취약점 점검 완료
+- [ ] 암호화 적용 확인 (저장 + 전송)
+- [ ] 접근 로그 보관 정책 적용
+
+### 4.2 운영 중 정기
+
+| 주기 | 점검 항목 |
+|-----|----------|
+| 월간 | 접근 권한 리뷰 |
+| 분기 | 취약점 점검 |
+| 반기 | 개인정보 처리 현황 점검 |
+| 연간 | 침투 테스트, 인증 갱신 |
+
+---
+
+## 5. 관련 문서
+
+- [보안 명세](./security-spec.md) — 보안 정책 상세
+- [감사 추적 명세](./audit-trail-spec.md) — 감사 로그 설계
+- [데이터 설계](./data-design.md) — 암호화 필드
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-security | 초기 작성 |

package/templates/base/timsquad/ssot/component-map.template.md

@@ -0,0 +1,181 @@
+---
+title: "컴포넌트 맵 (Component Map)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-designer
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 컴포넌트 맵 (Component Map)
+
+> UI 컴포넌트의 계층 구조, 재사용 정책, Props 인터페이스를 정의합니다.
+> 디자인 시스템과 개발 구현 사이의 일관성을 보장합니다.
+
+---
+
+## 1. 컴포넌트 계층
+
+### 1.1 분류 체계
+
+| 계층 | 설명 | 예시 | 의존성 |
+|-----|------|------|--------|
+| Primitives | 최소 단위, 스타일만 | Button, Input, Text | 없음 |
+| Components | 단일 기능 조합 | SearchBar, Card, Modal | Primitives |
+| Composites | 비즈니스 로직 포함 | UserCard, OrderList | Components + 상태 |
+| Layouts | 페이지 레이아웃 | AppShell, SidebarLayout | Composites |
+| Pages | 라우트 대응 화면 | HomePage, DetailPage | Layouts + 데이터 |
+
+### 1.2 디렉토리 구조
+
+```
+src/components/
+├── primitives/
+│   ├── Button/
+│   │   ├── Button.tsx
+│   │   ├── Button.test.tsx
+│   │   └── index.ts
+│   ├── Input/
+│   ├── Text/
+│   └── Icon/
+├── components/
+│   ├── SearchBar/
+│   ├── Card/
+│   ├── Modal/
+│   └── Toast/
+├── composites/
+│   ├── UserCard/
+│   ├── OrderList/
+│   └── NotificationBell/
+└── layouts/
+    ├── AppShell/
+    ├── AuthLayout/
+    └── DashboardLayout/
+```
+
+---
+
+## 2. Primitives
+
+### 2.1 Button
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| variant | `'primary' \| 'secondary' \| 'ghost' \| 'danger'` | `'primary'` | 스타일 변형 |
+| size | `'sm' \| 'md' \| 'lg'` | `'md'` | 크기 |
+| disabled | `boolean` | `false` | 비활성화 |
+| loading | `boolean` | `false` | 로딩 상태 |
+| fullWidth | `boolean` | `false` | 전체 너비 |
+| children | `ReactNode` | - | 버튼 내용 |
+| onPress | `() => void` | - | 클릭 핸들러 |
+
+### 2.2 Input
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| type | `'text' \| 'email' \| 'password' \| 'number'` | `'text'` | 입력 타입 |
+| label | `string` | - | 라벨 |
+| placeholder | `string` | - | 플레이스홀더 |
+| error | `string` | - | 에러 메시지 |
+| disabled | `boolean` | `false` | 비활성화 |
+
+### 2.3 Text
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| variant | `'h1' \| 'h2' \| 'h3' \| 'body' \| 'caption'` | `'body'` | 타이포그래피 |
+| color | `string` | `'text.primary'` | 색상 토큰 |
+| align | `'left' \| 'center' \| 'right'` | `'left'` | 정렬 |
+
+---
+
+## 3. Components
+
+### 3.1 Card
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| variant | `'elevated' \| 'outlined' \| 'filled'` | `'elevated'` | 스타일 |
+| padding | `'none' \| 'sm' \| 'md' \| 'lg'` | `'md'` | 내부 여백 |
+| onPress | `() => void` | - | 클릭 가능 여부 |
+| children | `ReactNode` | - | 카드 내용 |
+
+### 3.2 Modal
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| open | `boolean` | `false` | 표시 여부 |
+| onClose | `() => void` | - | 닫기 핸들러 |
+| title | `string` | - | 제목 |
+| size | `'sm' \| 'md' \| 'lg' \| 'full'` | `'md'` | 크기 |
+| closeOnOverlay | `boolean` | `true` | 오버레이 클릭 닫기 |
+
+### 3.3 Toast
+
+| Prop | 타입 | 기본값 | 설명 |
+|------|------|--------|------|
+| type | `'success' \| 'error' \| 'warning' \| 'info'` | `'info'` | 토스트 타입 |
+| message | `string` | - | 메시지 |
+| duration | `number` | `3000` | 표시 시간 (ms) |
+| action | `{ label: string; onPress: () => void }` | - | 액션 버튼 |
+
+---
+
+## 4. 재사용 정책
+
+### 4.1 규칙
+
+| 규칙 | 설명 |
+|-----|------|
+| 단방향 의존 | 상위 계층만 하위 계층을 import |
+| Props 전용 통신 | 컴포넌트 간 데이터는 Props로만 전달 |
+| 비즈니스 로직 분리 | Primitives/Components에 비즈니스 로직 금지 |
+| 스타일 토큰 사용 | 하드코딩 색상/크기 금지, 디자인 토큰만 사용 |
+
+### 4.2 신규 컴포넌트 기준
+
+| 기준 | 임계값 |
+|-----|--------|
+| 재사용 횟수 | 3회 이상 사용 시 컴포넌트화 |
+| Props 수 | 10개 초과 시 분리 검토 |
+| 중첩 깊이 | 3단계 초과 시 Composite로 승격 |
+
+---
+
+## 5. 디자인 토큰
+
+### 5.1 색상
+
+| 토큰 | Light | Dark | 용도 |
+|-----|-------|------|------|
+| `colors.primary` | #3B82F6 | #60A5FA | 주요 액션 |
+| `colors.secondary` | #6B7280 | #9CA3AF | 보조 액션 |
+| `colors.danger` | #EF4444 | #F87171 | 위험/삭제 |
+| `colors.text.primary` | #111827 | #F9FAFB | 본문 텍스트 |
+| `colors.bg.primary` | #FFFFFF | #111827 | 배경 |
+
+### 5.2 간격
+
+| 토큰 | 값 | 용도 |
+|-----|-----|------|
+| `spacing.xs` | 4px | 아이콘 간격 |
+| `spacing.sm` | 8px | 요소 내부 |
+| `spacing.md` | 16px | 섹션 내부 |
+| `spacing.lg` | 24px | 섹션 간 |
+| `spacing.xl` | 32px | 페이지 여백 |
+
+---
+
+## 6. 관련 문서
+
+- [UI/UX 명세](./ui-ux-spec.md) — 화면 디자인 상세
+- [네비게이션 맵](./navigation-map.md) — 화면 구조
+- [성능 예산](./performance-budget.md) — 번들 크기 제약
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-designer | 초기 작성 |

package/templates/base/timsquad/ssot/data-design.template.md

@@ -1,7 +1,7 @@
-# {PROJECT_NAME} 데이터 설계서
+# {{PROJECT_NAME}} 데이터 설계서
 
 **Version**: 1.0
-**Created**: {DATE}
+**Created**: {{DATE}}
 **Database**: PostgreSQL / MySQL / MongoDB
 
 ---
@@ -104,7 +104,7 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
 
 | Version | Date | Description |
 |---------|------|-------------|
-| 001 | {DATE} | 초기 스키마 생성 |
+| 001 | {{DATE}} | 초기 스키마 생성 |
 
 ---
 
@@ -129,4 +129,4 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
 
 | 버전 | 날짜 | 변경 내용 | 작성자 |
 |-----|-----|----------|-------|
-| 1.0 | {DATE} | 최초 작성 | |
+| 1.0 | {{DATE}} | 최초 작성 | |

package/templates/base/timsquad/ssot/deployment-spec.template.md

@@ -2,7 +2,7 @@
 title: "배포 명세서 (Deployment Specification)"
 version: 1.0.0
 last_updated: {{DATE}}
-author: tsq-planner
+author: tsq-architect
 status: draft
 project: {{PROJECT_NAME}}
 required_level: 3
@@ -21,13 +21,11 @@ required_level: 3
 
 ```
                     ┌─────────────┐
-                    │   CDN       │
-                    │ (CloudFront)│
+                    │     CDN     │
                     └──────┬──────┘
                            │
                     ┌──────▼──────┐
                     │ Load Balancer│
-                    │    (ALB)     │
                     └──────┬──────┘
                            │
          ┌─────────────────┼─────────────────┐
@@ -42,9 +40,10 @@ required_level: 3
               ┌────────────┼────────────┐
               │            │            │
          ┌────▼────┐  ┌───▼────┐  ┌───▼────┐
-         │  DB     │  │ Redis  │  │  S3    │
-         │ (RDS)   │  │(Cache) │  │(Storage)│
+         │   DB    │  │ Cache  │  │Storage │
          └─────────┘  └────────┘  └────────┘
+
+> 클라우드 예시: AWS (CloudFront, ALB, ECS, RDS), GCP (Cloud CDN, Cloud Run, Cloud SQL), Azure (Front Door, App Service, Azure DB)
 ```
 
 ### 1.2 환경 구성
@@ -63,34 +62,38 @@ required_level: 3
 
 | 리소스 | 서비스 | 사양 | 환경별 수량 |
 |-------|-------|------|-----------|
-| 애플리케이션 | ECS Fargate | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
-| 배치 작업 | Lambda | 256MB | 필요 시 |
+| 애플리케이션 | 컨테이너 서비스 | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
+| 배치 작업 | 서버리스 함수 | 256MB | 필요 시 |
+
+> 클라우드별: AWS(ECS Fargate, Lambda), GCP(Cloud Run, Cloud Functions), Azure(Container Apps, Azure Functions)
 
 ### 2.2 데이터베이스
 
 | 리소스 | 서비스 | 사양 | 백업 |
 |-------|-------|------|------|
-| Primary DB | RDS PostgreSQL | db.t3.medium | 7일 |
-| Read Replica | RDS (Prod만) | db.t3.medium | - |
-| Cache | ElastiCache Redis | cache.t3.micro | - |
+| Primary DB | Managed PostgreSQL | Medium | 7일 |
+| Read Replica | (Prod만) | Medium | - |
+| Cache | Managed Redis | Small | - |
+
+> 클라우드별: AWS(RDS, ElastiCache), GCP(Cloud SQL, Memorystore), Azure(Azure DB, Azure Cache)
 
 ### 2.3 스토리지
 
 | 리소스 | 서비스 | 용도 |
 |-------|-------|------|
-| 정적 파일 | S3 | 이미지, 파일 업로드 |
-| 로그 | S3 + CloudWatch | 애플리케이션 로그 |
-| 백업 | S3 Glacier | DB 백업 장기 보관 |
+| 정적 파일 | 오브젝트 스토리지 | 이미지, 파일 업로드 |
+| 로그 | 오브젝트 스토리지 + 로그 서비스 | 애플리케이션 로그 |
+| 백업 | 아카이브 스토리지 | DB 백업 장기 보관 |
 
 ### 2.4 네트워크
 
-| 리소스 | 서비스 | 설정 |
-|-------|-------|------|
-| VPC | VPC | 10.0.0.0/16 |
-| Public Subnet | 2개 AZ | 10.0.1.0/24, 10.0.2.0/24 |
-| Private Subnet | 2개 AZ | 10.0.10.0/24, 10.0.20.0/24 |
-| NAT Gateway | 각 AZ | 아웃바운드 트래픽 |
-| Security Group | 서비스별 | 최소 권한 |
+| 리소스 | 설정 |
+|-------|------|
+| VPC/VNet | 10.0.0.0/16 |
+| Public Subnet | 2개 AZ, 10.0.1.0/24, 10.0.2.0/24 |
+| Private Subnet | 2개 AZ, 10.0.10.0/24, 10.0.20.0/24 |
+| NAT Gateway | 아웃바운드 트래픽 |
+| Security Group | 서비스별 최소 권한 |
 
 ---
 
@@ -137,6 +140,7 @@ jobs:
           docker push $IMAGE_NAME
 
   test:
+    runs-on: ubuntu-latest
     needs: build
     steps:
       - name: Unit Tests
@@ -149,6 +153,7 @@ jobs:
         run: npm audit
 
   deploy-staging:
+    runs-on: ubuntu-latest
     needs: test
     if: github.ref == 'refs/heads/develop'
     steps:
@@ -156,6 +161,7 @@ jobs:
         run: ./deploy.sh staging
 
   deploy-production:
+    runs-on: ubuntu-latest
     needs: test
     if: github.ref == 'refs/heads/main'
     environment: production  # 승인 필요
@@ -164,6 +170,7 @@ jobs:
         run: ./deploy.sh production
 
   verify:
+    runs-on: ubuntu-latest
     needs: [deploy-staging, deploy-production]
     steps:
       - name: Smoke Test
@@ -381,4 +388,4 @@ CMD ["node", "dist/main.js"]
 
 | 버전 | 날짜 | 작성자 | 변경 내용 |
 |------|------|--------|----------|
-| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
+| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |

package/templates/base/timsquad/ssot/env-config.template.md

@@ -2,7 +2,7 @@
 title: "환경 설정 (Environment Configuration)"
 version: 1.0.0
 last_updated: {{DATE}}
-author: tsq-planner
+author: tsq-architect
 status: draft
 project: {{PROJECT_NAME}}
 ---
@@ -118,6 +118,8 @@ DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev
 REDIS_URL=redis://localhost:6379
 
 # Auth
+# ⚠️ 아래는 로컬 개발 전용. 절대 프로덕션에서 사용 금지.
+# 프로덕션은 반드시 시크릿 매니저(Vault, AWS Secrets Manager 등)에서 주입.
 JWT_SECRET=local-dev-secret-change-in-production
 JWT_EXPIRES_IN=1d
 SESSION_SECRET=local-session-secret
@@ -343,4 +345,4 @@ if (await featureService.isEnabled('NEW_UI', userId)) {
 
 | 버전 | 날짜 | 작성자 | 변경 내용 |
 |------|------|--------|----------|
-| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
+| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |

package/templates/base/timsquad/ssot/error-codes.template.md

@@ -1,7 +1,7 @@
-# {PROJECT_NAME} 에러 코드
+# {{PROJECT_NAME}} 에러 코드
 
 **Version**: 1.0
-**Created**: {DATE}
+**Created**: {{DATE}}
 
 ---
 
@@ -111,4 +111,4 @@
 
 | 버전 | 날짜 | 변경 내용 | 작성자 |
 |-----|-----|----------|-------|
-| 1.0 | {DATE} | 최초 작성 | |
+| 1.0 | {{DATE}} | 최초 작성 | |

package/templates/base/timsquad/ssot/functional-spec.template.md

@@ -2,7 +2,7 @@
 title: "기능 명세서 (Functional Specification)"
 version: 1.0.0
 last_updated: {{DATE}}
-author: tsq-planner
+author: tsq-architect
 status: draft
 project: {{PROJECT_NAME}}
 ---
@@ -130,7 +130,44 @@ Feature: [기능명]
 
 ### FS-002: [기능명]
 
-(위와 동일한 형식으로 작성)
+#### 3.2.1 개요
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | FS-002 |
+| **기능명** | |
+| **우선순위** | P0 / P1 / P2 |
+| **관련 PRD** | [prd/xxx](./prd/xxx.md) |
+| **관련 요건** | FR-XXX-001 |
+| **관련 화면** | [SCR-002](./ui-ux-spec.md#SCR-002) |
+| **관련 API** | [service-spec](./service-spec.md) |
+
+#### 3.2.2 사전 조건 (Preconditions)
+-
+
+#### 3.2.3 주요 흐름 (Main Flow)
+
+| 단계 | Actor | Action | System Response |
+|:----:|-------|--------|----------------|
+| 1 | | | |
+| 2 | | | |
+
+#### 3.2.4 대안 흐름 / 예외 흐름
+-
+
+#### 3.2.5 사후 조건 (Postconditions)
+- [ ]
+
+#### 3.2.6 수용 조건 (Acceptance Criteria)
+
+```gherkin
+Feature: [기능명]
+
+  Scenario: [시나리오명]
+    Given [사전 조건]
+    When [행동]
+    Then [기대 결과]
+```
 
 ---
 
@@ -182,4 +219,4 @@ graph LR
 
 | 버전 | 날짜 | 작성자 | 변경 내용 |
 |------|------|--------|----------|
-| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |
+| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |