timsquad 2.0.0

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

@@ -0,0 +1,114 @@
+# {PROJECT_NAME} 에러 코드
+
+**Version**: 1.0
+**Created**: {DATE}
+
+---
+
+## 1. 에러 응답 형식
+
+```json
+{
+  "success": false,
+  "data": null,
+  "error": {
+    "code": "AUTH_001",
+    "message": "Invalid credentials"
+  }
+}
+```
+
+---
+
+## 2. HTTP 상태 코드 가이드
+
+| HTTP | 용도 |
+|------|-----|
+| 400 | Bad Request - 잘못된 요청 파라미터 |
+| 401 | Unauthorized - 인증 필요 또는 실패 |
+| 403 | Forbidden - 권한 없음 |
+| 404 | Not Found - 리소스 없음 |
+| 409 | Conflict - 충돌 (중복 등) |
+| 422 | Unprocessable Entity - 유효성 검증 실패 |
+| 429 | Too Many Requests - Rate Limit |
+| 500 | Internal Server Error - 서버 오류 |
+
+---
+
+## 3. 에러 코드 목록
+
+### 3.1 AUTH (인증)
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| AUTH_001 | 401 | Invalid credentials | 잘못된 이메일 또는 비밀번호 |
+| AUTH_002 | 403 | Account disabled | 비활성화된 계정 |
+| AUTH_003 | 401 | Invalid token | 유효하지 않은 토큰 |
+| AUTH_004 | 401 | Token expired | 만료된 토큰 |
+| AUTH_005 | 401 | Token required | 토큰 누락 |
+
+### 3.2 USER (사용자)
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| USER_001 | 404 | User not found | 사용자를 찾을 수 없음 |
+| USER_002 | 409 | Email already exists | 이미 등록된 이메일 |
+| USER_003 | 403 | Permission denied | 권한 없음 |
+
+### 3.3 VALIDATION (유효성)
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| VAL_001 | 400 | Required field missing | 필수 필드 누락 |
+| VAL_002 | 400 | Invalid email format | 잘못된 이메일 형식 |
+| VAL_003 | 400 | Password too weak | 비밀번호 강도 부족 |
+| VAL_004 | 400 | Invalid date format | 잘못된 날짜 형식 |
+
+### 3.4 RESOURCE (리소스)
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| RES_001 | 404 | Resource not found | 리소스를 찾을 수 없음 |
+| RES_002 | 409 | Resource already exists | 리소스가 이미 존재함 |
+| RES_003 | 409 | Resource in use | 사용 중인 리소스 |
+
+### 3.5 SYSTEM (시스템)
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| SYS_001 | 500 | Internal server error | 내부 서버 오류 |
+| SYS_002 | 503 | Service unavailable | 서비스 이용 불가 |
+| SYS_003 | 429 | Rate limit exceeded | 요청 한도 초과 |
+
+---
+
+## 4. 도메인별 에러 코드
+
+### 4.1 [DOMAIN]
+
+| Code | HTTP | Message | Description |
+|------|------|---------|-------------|
+| | | | |
+
+---
+
+## 5. 에러 코드 네이밍 규칙
+
+```
+{DOMAIN}_{NUMBER}
+
+- DOMAIN: 대문자, 2-6자
+- NUMBER: 3자리 숫자, 001부터 시작
+```
+
+**예시:**
+- `AUTH_001` - 인증 도메인 첫 번째 에러
+- `ORDER_005` - 주문 도메인 다섯 번째 에러
+
+---
+
+## 6. 변경 이력
+
+| 버전 | 날짜 | 변경 내용 | 작성자 |
+|-----|-----|----------|-------|
+| 1.0 | {DATE} | 최초 작성 | |

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

@@ -0,0 +1,185 @@
+---
+title: "기능 명세서 (Functional Specification)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-planner
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 기능 명세서 (Functional Specification)
+
+> 사용자 관점에서 시스템이 어떻게 동작해야 하는지 정의합니다.
+> Requirements.md의 기능 요건을 구체적인 시나리오로 풀어낸 문서입니다.
+
+---
+
+## 1. 문서 개요
+
+### 1.1 목적
+이 문서는 {{PROJECT_NAME}}의 기능을 사용자 시나리오 관점에서 상세히 기술합니다.
+
+### 1.2 범위
+- [requirements.md](./requirements.md)의 기능 요건 (FR-XXX) 구체화
+- 사용자 인터랙션 흐름
+- 예외 처리 시나리오
+- 비즈니스 규칙
+
+### 1.3 용어
+→ [glossary.md](./glossary.md) 참조
+
+---
+
+## 2. 기능 목록
+
+| ID | 기능명 | 요건 참조 | 우선순위 | 상태 |
+|----|-------|----------|:--------:|:----:|
+| FS-001 | | FR-001 | Must | 초안 |
+| FS-002 | | FR-002 | Must | 초안 |
+
+---
+
+## 3. 기능 상세
+
+### FS-001: [기능명]
+
+#### 3.1.1 개요
+
+| 항목 | 내용 |
+|-----|------|
+| **요건 참조** | FR-001 |
+| **우선순위** | Must |
+| **관련 화면** | [ui-ux-spec.md#화면ID](./ui-ux-spec.md) |
+| **관련 API** | [service-spec.md#API명](./service-spec.md) |
+
+#### 3.1.2 사용자 스토리
+
+```
+As a [사용자 역할]
+I want to [원하는 것]
+So that [이유/가치]
+```
+
+#### 3.1.3 사전 조건 (Preconditions)
+
+- [ ] 조건 1
+- [ ] 조건 2
+
+#### 3.1.4 기본 흐름 (Happy Path)
+
+```
+1. 사용자가 [행동]
+2. 시스템이 [반응]
+3. 사용자가 [행동]
+4. 시스템이 [결과]
+```
+
+| 단계 | 사용자 행동 | 시스템 반응 | 비고 |
+|:---:|-----------|-----------|------|
+| 1 | | | |
+| 2 | | | |
+| 3 | | | |
+
+#### 3.1.5 대안 흐름 (Alternative Flow)
+
+**AF-001: [대안 시나리오명]**
+
+| 분기점 | 조건 | 흐름 |
+|:------:|-----|------|
+| 단계 2 | [조건] | [대안 흐름 설명] |
+
+#### 3.1.6 예외 흐름 (Exception Flow)
+
+**EF-001: [예외 시나리오명]**
+
+| 분기점 | 예외 조건 | 시스템 반응 | 에러 코드 |
+|:------:|---------|-----------|----------|
+| 단계 2 | [조건] | [에러 메시지] | ERR_XXX |
+
+→ 에러 코드 상세: [error-codes.md](./error-codes.md)
+
+#### 3.1.7 사후 조건 (Postconditions)
+
+- [ ] 결과 1
+- [ ] 결과 2
+
+#### 3.1.8 비즈니스 규칙
+
+| 규칙 ID | 규칙 | 예외 |
+|--------|------|------|
+| BR-001 | | |
+| BR-002 | | |
+
+#### 3.1.9 수용 조건 (Acceptance Criteria)
+
+```gherkin
+Feature: [기능명]
+
+  Scenario: [시나리오명]
+    Given [사전 조건]
+    When [행동]
+    Then [기대 결과]
+
+  Scenario: [예외 시나리오]
+    Given [사전 조건]
+    When [예외 행동]
+    Then [예외 결과]
+```
+
+---
+
+### FS-002: [기능명]
+
+(위와 동일한 형식으로 작성)
+
+---
+
+## 4. 기능 간 의존성
+
+```mermaid
+graph LR
+    FS-001[기능1] --> FS-002[기능2]
+    FS-002 --> FS-003[기능3]
+    FS-001 --> FS-004[기능4]
+```
+
+| 기능 | 선행 기능 | 후행 기능 |
+|-----|----------|----------|
+| FS-001 | - | FS-002, FS-004 |
+| FS-002 | FS-001 | FS-003 |
+
+---
+
+## 5. 비기능 요건 매핑
+
+| 기능 | 관련 NFR | 제약 사항 |
+|-----|---------|----------|
+| FS-001 | NFR-001 (응답시간 < 200ms) | |
+| FS-002 | NFR-002 (동시 사용자 1000명) | |
+
+→ NFR 상세: [requirements.md#비기능요건](./requirements.md)
+
+---
+
+## 6. 용어 참조
+
+이 문서에서 사용된 도메인 용어:
+→ [glossary.md](./glossary.md)
+
+---
+
+## 7. 관련 문서
+
+- [PRD](./prd.md) - 제품 요구사항
+- [요구사항](./requirements.md) - 기능/비기능 요건
+- [UI/UX 명세](./ui-ux-spec.md) - 화면 설계
+- [서비스 명세](./service-spec.md) - API 정의
+- [에러 코드](./error-codes.md) - 에러 정의
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |

package/templates/common/timsquad/ssot/glossary.template.md

@@ -0,0 +1,148 @@
+---
+title: "용어 사전 (Glossary)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-planner
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 용어 사전 (Glossary)
+
+> 프로젝트에서 사용하는 도메인 용어를 정의합니다.
+> 모든 팀원과 에이전트가 동일한 언어로 소통하기 위한 기준 문서입니다.
+
+---
+
+## 1. 비즈니스 용어
+
+| 용어 | 영문 | 정의 | 예시 | 비고 |
+|-----|------|------|------|------|
+| | | | | |
+
+<!--
+예시:
+| 회원 | Member | 서비스에 가입한 사용자 | 이메일로 가입한 사용자 | User와 구분 |
+| 고객사 | Customer | B2B 계약을 체결한 업체 | ABC 주식회사 | |
+| 구독 | Subscription | 유료 서비스 이용 계약 | 월간 플랜 | |
+-->
+
+---
+
+## 2. 기술 용어
+
+| 용어 | 영문 | 정의 | 관련 문서 |
+|-----|------|------|----------|
+| | | | |
+
+<!--
+예시:
+| 토큰 | Token | 인증에 사용되는 JWT 문자열 | service-spec.md |
+| 세션 | Session | 사용자 로그인 상태 유지 단위 | security-spec.md |
+| 트랜잭션 | Transaction | DB 작업의 원자적 단위 | data-design.md |
+-->
+
+---
+
+## 3. 도메인 모델
+
+### 3.1 핵심 엔티티
+
+| 엔티티 | 설명 | 주요 속성 | 관계 |
+|-------|------|----------|------|
+| | | | |
+
+<!--
+예시:
+| User | 시스템 사용자 | id, email, name | Order (1:N) |
+| Order | 주문 | id, status, total | User (N:1), OrderItem (1:N) |
+| Product | 상품 | id, name, price | OrderItem (1:N) |
+-->
+
+### 3.2 값 객체 (Value Objects)
+
+| 값 객체 | 설명 | 구성 요소 |
+|--------|------|----------|
+| | | |
+
+<!--
+예시:
+| Money | 금액 | amount (number), currency (string) |
+| Address | 주소 | street, city, zipCode, country |
+-->
+
+---
+
+## 4. 상태 정의
+
+### 4.1 [엔티티명] 상태
+
+```
+[상태1] → [상태2] → [상태3]
+    ↓         ↓
+[상태4]   [상태5]
+```
+
+| 상태 | 코드 | 설명 | 전이 가능 상태 |
+|-----|------|------|--------------|
+| | | | |
+
+<!--
+예시 (주문 상태):
+| 대기 | PENDING | 결제 대기 중 | PAID, CANCELLED |
+| 결제완료 | PAID | 결제 완료 | SHIPPING, REFUNDED |
+| 배송중 | SHIPPING | 배송 진행 중 | DELIVERED |
+| 배송완료 | DELIVERED | 배송 완료 | - |
+| 취소 | CANCELLED | 주문 취소 | - |
+| 환불 | REFUNDED | 환불 처리됨 | - |
+-->
+
+---
+
+## 5. 코드/열거형
+
+### 5.1 [코드명]
+
+| 코드 | 값 | 설명 |
+|-----|-----|------|
+| | | |
+
+<!--
+예시 (회원 등급):
+| GUEST | 0 | 비회원 |
+| BASIC | 1 | 일반 회원 |
+| PREMIUM | 2 | 프리미엄 회원 |
+| VIP | 3 | VIP 회원 |
+-->
+
+---
+
+## 6. 약어 목록
+
+| 약어 | 전체 표현 | 설명 |
+|-----|----------|------|
+| | | |
+
+<!--
+예시:
+| API | Application Programming Interface | |
+| JWT | JSON Web Token | 인증 토큰 |
+| CRUD | Create, Read, Update, Delete | 기본 데이터 조작 |
+| SSO | Single Sign-On | 통합 인증 |
+-->
+
+---
+
+## 7. 관련 문서
+
+- [PRD](./prd.md) - 제품 요구사항
+- [요구사항](./requirements.md) - 기능/비기능 요건
+- [데이터 설계](./data-design.md) - ERD, 테이블 정의
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |