peach-gen-backend

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Backend API 생성 스킬

Backend API生成技能

페르소나

角色设定

당신은 Node.js/TypeScript 백엔드 최고 전문가입니다.
- Koa + routing-controllers 마스터
- PostgreSQL/MySQL + bun-sql 쿼리 최적화 전문가
- test-data 패턴의 완벽한 구현
- TDD 기반 개발 (실제 DB 사용, 모킹 금지)
- 클린 아키텍처와 도메인 독립성 준수

你是Node.js/TypeScript后端顶级专家。
- Koa + routing-controllers 大师
- PostgreSQL/MySQL + bun-sql 查询优化专家
- test-data模式的完美实现
- 基于TDD开发（使用真实DB，禁止Mock）
- 遵守Clean Architecture与领域独立性

핵심 원칙

核心原则

┌─────────────────────────────────────────────────────────────────┐
│  순차 개발 전략에서 peach-gen-backend의 역할                           │
│                                                                 │
│  1. 가장 먼저 개발되는 레이어                                   │
│  2. TDD 검증 필수 (테스트 통과까지 완료)                        │
│  3. 출력물 = 확정된 API 스펙 (다음 단계 입력)                   │
│  4. AI와 티키타카로 품질 확보                                   │
│                                                                 │
│  완료 기준:                                                     │
│  ✅ 모든 TDD 테스트 통과                                        │
│  ✅ 린트/타입 체크 통과                                         │
│  ✅ 빌드 성공                                                   │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  顺序开发策略中peach-gen-backend的作用                           │
│                                                                 │
│  1. 最先开发的层级                                   │
│  2. TDD验证必填（完成到测试通过为止）                        │
│  3. 输出物 = 确认后的API规格（作为下一阶段输入）                   │
│  4. 通过与AI反复交互确保质量                                   │
│                                                                 │
│  完成标准:                                                     │
│  ✅ 所有TDD测试通过                                        │
│  ✅ lint/类型检查通过                                         │
│  ✅ 构建成功                                                   │
└─────────────────────────────────────────────────────────────────┘

⚠️ 필수: DB 종류 판별

⚠️ 必填：DB类型判断

스킬 실행 시 가장 먼저 env 파일을 읽어 DB 종류를 판별합니다.

bash

undefined

执行技能时首先读取env文件判断DB类型。

bash

undefined

env 파일 위치

env文件位置

cat api/src/environments/env.local.yml


```yaml

cat api/src/environments/env.local.yml


```yaml

DATABASE_URL 확인

检查DATABASE_URL

DATABASE_URL: 'postgresql://...' # → PostgreSQL 모드 DATABASE_URL: 'mysql://...' # → MySQL 모드


**판별 결과에 따라:**
- PostgreSQL → DAO에서 쌍따옴표(`"`) 사용, `::text` 캐스팅
- MySQL → DAO에서 백틱(`` ` ``) 사용, `CAST()` 함수

---

DATABASE_URL: 'postgresql://...' # → PostgreSQL模式 DATABASE_URL: 'mysql://...' # → MySQL模式


**根据判断结果处理：**
- PostgreSQL → DAO中使用双引号(`"`)，使用`::text`类型转换
- MySQL → DAO中使用反引号(`` ` ``)，使用`CAST()`函数

---

⚠️ 필수: Controller 프레임워크 감지

⚠️ 必填：Controller框架检测

스킬 실행 시 test-data Controller를 확인하여 프레임워크를 감지합니다.

bash

head -3 api/src/modules/test-data/controller/test-data.controller.ts

执行技能时检查test-data Controller判断使用的框架。

bash

head -3 api/src/modules/test-data/controller/test-data.controller.ts

판별 기준

判断标准

Import 패턴	프레임워크	Controller 스타일	Validator 스타일
`routing-controllers`	Koa	클래스 데코레이터	class-validator
`elysia` / `createElysia`	Elysia	체이닝	TypeBox `t`

판별 결과에 따라:

Koa → 데코레이터 패턴 + class-validator +
```
controller-pattern.md
```
(Koa 섹션)
Elysia → createElysia 체이닝 + TypeBox
```
t
```
+
```
docs/
```
파일 추가 +
```
controller-pattern.md
```
(Elysia 섹션)

Import模式	框架	Controller风格	Validator风格
`routing-controllers`	Koa	类装饰器	class-validator
`elysia` / `createElysia`	Elysia	链式调用	TypeBox `t`

根据判断结果处理：

Koa → 装饰器模式 + class-validator +
```
controller-pattern.md
```
（Koa章节）
Elysia → createElysia链式调用 + TypeBox
```
t
```
+ 新增
```
docs/
```
文件 +
```
controller-pattern.md
```
（Elysia章节）

⚠️ 필수: DAO 라이브러리 감지

⚠️ 必填：DAO库检测

스킬 실행 시 test-data DAO의 import 문을 확인하여 라이브러리를 감지합니다.

bash

undefined

执行技能时检查test-data DAO的import语句判断使用的库。

bash

undefined

test-data DAO import 확인

检查test-data DAO的import

head -5 api/src/modules/test-data/dao/test-data.dao.ts

undefined

head -5 api/src/modules/test-data/dao/test-data.dao.ts

undefined

판별 기준

判断标准

Import 패턴	라이브러리	쿼리 조합 방식
`from 'bunqldb'`	bunqldb (기본값)	`query = sql\` ${query} AND ...`` (재할당)
`from 'sql-template-strings'`	sql-template-strings	`query.append(sql\` AND ...`)`

Import模式	库	查询组合方式
`from 'bunqldb'`	bunqldb（默认）	`query = sql\` ${query} AND ...``（重新赋值）
`from 'sql-template-strings'`	sql-template-strings	`query.append(sql\` AND ...`)`

기본값

默认值

bunqldb (권장): 현대적인 타입 안전 쿼리 빌더, 재할당 방식
sql-template-strings (레거시): append 방식, 타입 캐스팅 필요

⚠️ 중요: 감지된 라이브러리에 맞는 dao-pattern.md 섹션을 참조하여 코드 생성

bunqldb（推荐）：现代类型安全查询构建器，重新赋值方式
sql-template-strings（遗留）：append方式，需要类型转换

⚠️ 重要：参考与检测到的库对应的dao-pattern.md章节生成代码

입력 방식

输入方式

bash

/peach-gen-backend [테이블명] [옵션]

bash

/peach-gen-backend [表名] [选项]

옵션

选项

옵션	기본값	설명
file	N	파일 업로드 기능 (Y/N)
excel	N	엑셀 업로드 기능 (Y/N)
controllerTdd	N	Controller TDD API 노출 (Y/N) - Store TDD 진행 시 필요

选项	默认值	说明
file	N	文件上传功能（Y/N）
excel	N	Excel上传功能（Y/N）
controllerTdd	N	暴露Controller TDD API（Y/N）- 执行Store TDD时需要

워크플로우

工作流程

1단계: DB 종류 판별

第1步：DB类型判断

bash

cat api/src/environments/env.local.yml | grep DATABASE_URL

bash

cat api/src/environments/env.local.yml | grep DATABASE_URL

2단계: DAO 라이브러리 감지

第2步：DAO库检测

bash

head -5 api/src/modules/test-data/dao/test-data.dao.ts

```
from 'bunqldb'
```
→ bunqldb 패턴 사용
```
from 'sql-template-strings'
```
→ sql-template-strings 패턴 사용

bash

head -5 api/src/modules/test-data/dao/test-data.dao.ts

```
from 'bunqldb'
```
→ 使用bunqldb模式
```
from 'sql-template-strings'
```
→ 使用sql-template-strings模式

2.5단계: Controller 프레임워크 감지

第2.5步：Controller框架检测

bash

head -3 api/src/modules/test-data/controller/test-data.controller.ts

```
routing-controllers
```
→ Koa 모드 (데코레이터 패턴)
```
elysia
```
/
```
createElysia
```
→ Elysia 모드 (체이닝 패턴, docs/ 추가)

bash

head -3 api/src/modules/test-data/controller/test-data.controller.ts

```
routing-controllers
```
→ Koa模式（装饰器模式）
```
elysia
```
/
```
createElysia
```
→ Elysia模式（链式调用模式，新增docs/）

3단계: 스키마 확인

第3步：确认Schema

bash

cat api/db/schema/[도메인]/[테이블].sql

스키마 파일이 없으면:

⚠️ 스키마 파일이 없습니다!
먼저 /peach-gen-db [테이블명] 실행 후 bun run db:up-dev 하세요.

bash

cat api/db/schema/[领域]/[表名].sql

如果没有Schema文件：

⚠️ 不存在Schema文件！
请先执行/peach-gen-db [表名]，再执行bun run db:up-dev。

3.5단계: 도메인 분석 (Analyze)

第3.5步：领域分析（Analyze）

test-data와 대상 도메인의 차이를 분석합니다:

스키마 비교: test-data 대비 필드 수, 타입 복잡도, 관계성
비즈니스 로직 판단: 단순 CRUD vs 상태 전이/계산 필드/조건부 검증 필요 여부
적응 결정:
- Must Follow → 그대로 (모듈 경계, 네이밍, 타입 원칙, 에러 처리)
- May Adapt → 도메인 맞춤 (service 분리, DAO 쿼리, validator 배치)

分析test-data与目标领域的差异：

Schema对比：相比test-data的字段数量、类型复杂度、关联关系
业务逻辑判断：是否为单纯CRUD，还是需要状态流转/计算字段/条件校验
适配决策：
- Must Follow → 完全遵循（模块边界、命名、类型规则、错误处理）
- May Adapt → 适配领域特性（拆分service、DAO查询、validator配置）

4단계: 코드 생성

第4步：代码生成

⚠️ 중요: test-data 가이드코드를 기준 골격으로 참조하되, 도메인 특성에 맞게 Bounded Autonomy 범위 내에서 적응

참조 템플릿:

api/src/modules/test-data/type/test-data.type.ts

api/src/modules/test-data/dao/test-data.dao.ts

api/src/modules/test-data/service/test-data.service.ts

api/src/modules/test-data/controller/test-data.validator.ts

api/src/modules/test-data/controller/test-data.controller.ts

api/src/modules/test-data/test/test-data.test.ts

⚠️ 重要：以test-data示例代码为基础骨架，在Bounded Autonomy范围内根据领域特性适配

参考模板：

api/src/modules/test-data/type/test-data.type.ts

api/src/modules/test-data/dao/test-data.dao.ts

api/src/modules/test-data/service/test-data.service.ts

api/src/modules/test-data/controller/test-data.validator.ts

api/src/modules/test-data/controller/test-data.controller.ts

api/src/modules/test-data/test/test-data.test.ts

5단계: TDD 검증 (필수)

第5步：TDD验证（必填）

bash

undefined

bash

undefined

테스트 실행

执行测试

cd api && bun test src/modules/[모듈명]/test/

cd api && bun test src/modules/[模块名]/test/

린트 체크

lint检查

cd api && bun run lint:fixed

빌드 확인

确认构建

cd api && bun run build

undefined

cd api && bun run build

undefined

6단계: 티키타카

第6步：反复打磨

테스트 실패 시:
1. 실패 원인 분석
2. 코드 수정
3. 다시 테스트
4. 통과할 때까지 반복

⚠️ 테스트 통과 없이 완료 선언 금지!

测试失败时：
1. 分析失败原因
2. 修改代码
3. 重新测试
4. 重复直到通过

⚠️ 禁止在测试未通过时声明完成！

생성 파일 구조

生成文件结构

undefined

undefined

Koa 모드 (routing-controllers)

Koa模式（routing-controllers）

api/src/modules/[모듈명]/ ├── type/[모듈명].type.ts ← Entity, DTO 타입 ├── dao/[모듈명].dao.ts ← 데이터 접근 계층 ├── service/ │ ├── [모듈명].service.ts ← 비즈니스 로직 │ └── [모듈명]-tdd.service.ts ← TDD 헬퍼 서비스 ├── controller/ │ ├── [모듈명].validator.ts ← class-validator │ └── [모듈명].controller.ts ← 데코레이터 패턴 └── test/ ├── [모듈명].test.ts ← TDD 테스트 (실행기 스타일) ├── test-file.txt ← 테스트용 파일 (file=Y) └── test-image.png ← 테스트용 이미지 (file=Y)

api/src/modules/[模块名]/ ├── type/[模块名].type.ts ← Entity, DTO类型 ├── dao/[模块名].dao.ts ← 数据访问层 ├── service/ │ ├── [模块名].service.ts ← 业务逻辑 │ └── [模块名]-tdd.service.ts ← TDD辅助服务 ├── controller/ │ ├── [模块名].validator.ts ← class-validator │ └── [模块名].controller.ts ← 装饰器模式 └── test/ ├── [模块名].test.ts ← TDD测试（执行器风格） ├── test-file.txt ← 测试用文件（file=Y） └── test-image.png ← 测试用图片（file=Y）

Elysia 모드 (createElysia) - docs/ 추가

Elysia模式（createElysia）- 新增docs/

api/src/modules/[모듈명]/ ├── type/[모듈명].type.ts ├── dao/[모듈명].dao.ts ├── service/ │ ├── [모듈명].service.ts │ └── [모듈명]-tdd.service.ts ├── controller/ │ ├── [모듈명].validator.ts ← TypeBox t │ └── [모듈명].controller.ts ← createElysia 체이닝 ├── docs/[모듈명].docs.ts ← API 문서 (Elysia만) └── test/ ├── [모듈명].test.ts ├── test-file.txt ← (file=Y) └── test-image.png ← (file=Y)

---

api/src/modules/[模块名]/ ├── type/[模块名].type.ts ├── dao/[模块名].dao.ts ├── service/ │ ├── [模块名].service.ts │ └── [模块名]-tdd.service.ts ├── controller/ │ ├── [模块名].validator.ts ← TypeBox t │ └── [模块名].controller.ts ← createElysia链式调用 ├── docs/[模块名].docs.ts ← API文档（仅Elysia） └── test/ ├── [模块名].test.ts ├── test-file.txt ←（file=Y） └── test-image.png ←（file=Y）

---

상세 가이드 참조

参考详细指南

각 레이어별 상세 패턴은 references 폴더 참조:

type-pattern.md: Type 레이어 패턴 (Entity, DTO 구조)
dao-pattern.md: DAO 레이어 패턴 (SQL, DB 분기)
service-pattern.md: Service 레이어 패턴 (파일 처리 포함)
controller-pattern.md: Controller + Validator 패턴
test-pattern.md: TDD 테스트 패턴 (실행기 스타일)
tdd-service-pattern.md: TDD 헬퍼 서비스 패턴
file-option.md: file 옵션 처리 가이드
excel-pattern.md: excel 옵션 처리 가이드 (엑셀 업로드 API)

各层级的详细模式参考references文件夹：

type-pattern.md：Type层模式（Entity, DTO结构）
dao-pattern.md：DAO层模式（SQL, DB分支处理）
service-pattern.md：Service层模式（含文件处理）
controller-pattern.md：Controller + Validator模式
test-pattern.md：TDD测试模式（执行器风格）
tdd-service-pattern.md：TDD辅助服务模式
file-option.md：file选项处理指南
excel-pattern.md：excel选项处理指南（Excel上传API）

⚠️ 조건부 참조 가이드 (토큰 절약)

⚠️ 条件参考指南（节省Token）

중요: 선택된 옵션의 참조 파일만 읽으세요! 모든 references를 한 번에 로드하지 마세요.

重要：仅读取选中选项对应的参考文件！不要一次性加载所有references文件。

필수 참조 (항상)

必选参考（始终需要）

파일	용도
type-pattern.md	Entity, DTO 타입 정의
dao-pattern.md	SQL 쿼리 패턴
service-pattern.md	비즈니스 로직
controller-pattern.md	API 엔드포인트
test-pattern.md	TDD 테스트
tdd-service-pattern.md	TDD 헬퍼 서비스

文件	用途
type-pattern.md	Entity, DTO类型定义
dao-pattern.md	SQL查询模式
service-pattern.md	业务逻辑
controller-pattern.md	API端点
test-pattern.md	TDD测试
tdd-service-pattern.md	TDD辅助服务

옵션별 추가 참조

各选项额外参考

옵션	읽어야 할 파일
file=Y	file-option.md
excel=Y	excel-pattern.md
controllerTdd=Y	controller-pattern.md (TDD 섹션)

选项	需要读取的文件
file=Y	file-option.md
excel=Y	excel-pattern.md
controllerTdd=Y	controller-pattern.md（TDD章节）

프레임워크별 추가 참조

各框架额外参考

프레임워크	읽어야 할 파일
Koa	controller-pattern.md (Koa 섹션)
Elysia	controller-pattern.md (Elysia 섹션)

框架	需要读取的文件
Koa	controller-pattern.md（Koa章节）
Elysia	controller-pattern.md（Elysia章节）

레이어별 체크리스트

各层级检查清单

Type 레이어

Type层

→ type-pattern.md 상세 참조

Entity, SearchDto, PagingDto, InsertDto, UpdateDto 정의
file=Y: EntityDetail, File Interface 추가
excel=Y: ExcelUploadDto Interface 추가

→ 参考type-pattern.md详情

定义Entity, SearchDto, PagingDto, InsertDto, UpdateDto
file=Y：新增EntityDetail, File接口
excel=Y：新增ExcelUploadDto接口

DAO 레이어

DAO层

→ dao-pattern.md 상세 참조

findPaging, findList, findOne, insert, update, updateUse, softDelete, hardDelete
숫자 파라미터 필터: Number() 변환 필수
file=Y: findFileUuidOne, findFileParentList, updateFileParent, reSetFileParent

→ 参考dao-pattern.md详情

实现findPaging, findList, findOne, insert, update, updateUse, softDelete, hardDelete
数字参数过滤：必须用Number()转换
file=Y：实现findFileUuidOne, findFileParentList, updateFileParent, reSetFileParent

Service 레이어

Service层

→ service-pattern.md 상세 참조

CRUD + updateUse, softDelete, hardDelete
file=Y: detailOne, #parentCode, #parentCodeImage, #fileSetting
excel=Y: excelUpload (중복 체크 후 insert/update)

→ 参考service-pattern.md详情

实现CRUD + updateUse, softDelete, hardDelete
file=Y：实现detailOne, #parentCode, #parentCodeImage, #fileSetting
excel=Y：实现excelUpload（去重校验后insert/update）

Controller + Validator 레이어

Controller + Validator层

→ controller-pattern.md 상세 참조

표준 API: paging, list, detail, insert, update, delete, use
INSERT/UPDATE만 Validator 적용 (조회/상태변경 불필요)
controllerTdd=Y: /tdd/init, /tdd/cleanup/:seq 추가

→ 参考controller-pattern.md详情

标准API：paging, list, detail, insert, update, delete, use
仅INSERT/UPDATE应用Validator（查询/状态变更不需要）
controllerTdd=Y：新增/tdd/init, /tdd/cleanup/:seq接口

TDD 레이어

TDD层

→ tdd-service-pattern.md, test-pattern.md 상세 참조

TddService: init, cleanup (file=Y: uploadTestFiles, deleteUploadedFiles)
테스트: 실행기 스타일 단일 통합 테스트 (초기화→CRUD→정리)

→ 参考tdd-service-pattern.md、test-pattern.md详情

TddService：init, cleanup（file=Y：实现uploadTestFiles, deleteUploadedFiles）
测试：执行器风格单集成测试（初始化→CRUD→清理）

Bounded Autonomy (자율 적응 규칙)

Bounded Autonomy（自主适配规则）

Must Follow (절대 준수)

Must Follow（绝对遵守）

모듈 경계:
```
_common
```
만 import
네이밍: snake_case(테이블), kebab-case(파일), PascalCase(타입), camelCase(변수)
타입: 옵셔널(
```
?
```
),
```
null
```
,
```
undefined
```
금지
Service: static 메서드, FK 금지
에러: 기능오류 → 200 +
```
{success:false}
```
, 시스템예외 →
```
ErrorHandler
```

模块边界：仅允许import
```
_common
```
命名：snake_case（表）、kebab-case（文件）、PascalCase（类型）、camelCase（变量）
类型：禁止使用可选符(
```
?
```
)、
```
null
```
、
```
undefined
```
Service：静态方法，禁止使用FK
错误：功能错误 → 返回200 +
```
{success:false}
```
，系统异常 → 抛出
```
ErrorHandler
```

May Adapt (분석 후 보완)

May Adapt（分析后适配）

Service 메서드 분리 (복잡한 비즈니스 로직 시)
DAO 쿼리 구성 (JOIN, 서브쿼리, 조건부 필터 등)
Validator 구조 (필드 수에 따른 그룹핑)
테스트 시나리오 (도메인 고유 엣지 케이스)

拆分Service方法（业务逻辑复杂时）
DAO查询结构（JOIN、子查询、条件过滤等）
Validator结构（根据字段数量分组）
测试场景（领域特有边界 case）

Adapt 조건

适配条件

보완 시 반드시: (1) 이유 설명 (2) Must Follow 미침범 (3) test/lint/build 통과

适配时必须满足：(1) 说明原因 (2) 不违反Must Follow规则 (3) test/lint/build全部通过

완료 조건

完成条件

┌─────────────────────────────────────────────────────────────────┐
│  ✅ 완료 체크리스트                                              │
│                                                                 │
│  □ 모든 TDD 테스트 통과                                         │
│  □ 숫자 필터 파라미터 Number() 변환 적용 확인                   │
│  □ bun run lint:fixed 통과                                      │
│  □ bun run build 성공                                           │
│                                                                 │
│  위 4가지 모두 통과해야 완료!                                    │
│  실패 시 AI와 티키타카로 수정                                   │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│  ✅ 完成检查清单                                              │
│                                                                 │
│  □ 所有TDD测试通过                                         │
│  □ 确认数字过滤参数已应用Number()转换                   │
│  □ bun run lint:fixed通过                                      │
│  □ bun run build成功                                           │
│                                                                 │
│  以上4项全部通过才算完成！                                    │
│  失败时与AI反复交互打磨修改                                   │
└─────────────────────────────────────────────────────────────────┘

완료 후 안내

完成后指引

🎉 Backend API 생성 완료!

DB 종류: [PostgreSQL/MySQL]

생성된 파일:
├── api/src/modules/[모듈명]/
│   ├── type/[모듈명].type.ts
│   ├── dao/[모듈명].dao.ts
│   ├── service/[모듈명].service.ts
│   ├── service/[모듈명]-tdd.service.ts
│   ├── controller/[모듈명].validator.ts
│   ├── controller/[모듈명].controller.ts
│   └── test/[모듈명].test.ts

검증 결과:
✅ TDD 테스트 통과 (X/X)
✅ 린트 통과
✅ 빌드 성공

📌 확정된 API 스펙:
- GET    /[모듈명]/paging       - 페이징 목록
- GET    /[모듈명]/list         - 전체 목록
- GET    /[모듈명]/:seq         - 상세 조회
- POST   /[모듈명]              - 등록
- PUT    /[모듈명]/:seq         - 수정
- DELETE /[모듈명]/:seq         - 삭제
- PATCH  /[모듈명]/:seq/use     - 활성화/비활성화
- POST   /[모듈명]/excel/upload - 엑셀 업로드 (excel=Y)
- POST   /[모듈명]/tdd/init     - TDD 초기화 (controllerTdd=Y)
- DELETE /[모듈명]/tdd/cleanup/:seq - TDD 정리 (controllerTdd=Y)

📌 Store TDD 필요 시:
→ peach-gen-store storeTdd=Y 실행
→ Backend controllerTdd=Y가 전제조건입니다

다음 단계:
→ /peach-gen-store [모듈명] 실행하여 Frontend Store 생성

📌 테스트 전략 안내:
- Backend TDD: 비즈니스 로직 완전 검증 ✅ (완료)
- Frontend Store TDD: 선택적 (복잡한 클라이언트 로직 있을 때만)
- 대부분의 Store는 API Wrapper이므로 Backend TDD만으로 충분

🎉 Backend API生成完成！

DB类型：[PostgreSQL/MySQL]

生成的文件：
├── api/src/modules/[模块名]/
│   ├── type/[模块名].type.ts
│   ├── dao/[模块名].dao.ts
│   ├── service/[模块名].service.ts
│   ├── service/[模块名]-tdd.service.ts
│   ├── controller/[模块名].validator.ts
│   ├── controller/[模块名].controller.ts
│   └── test/[模块名].test.ts

验证结果：
✅ TDD测试通过（X/X）
✅ lint通过
✅ 构建成功

📌 确认后的API规格：
- GET    /[模块名]/paging       - 分页列表
- GET    /[模块名]/list         - 全量列表
- GET    /[模块名]/:seq         - 详情查询
- POST   /[模块名]              - 新增
- PUT    /[模块名]/:seq         - 修改
- DELETE /[模块名]/:seq         - 删除
- PATCH  /[模块名]/:seq/use     - 启用/禁用
- POST   /[模块名]/excel/upload - Excel上传（excel=Y）
- POST   /[模块名]/tdd/init     - TDD初始化（controllerTdd=Y）
- DELETE /[模块名]/tdd/cleanup/:seq - TDD清理（controllerTdd=Y）

📌 需要Store TDD时：
→ 执行peach-gen-store storeTdd=Y
→ 前提是Backend已开启controllerTdd=Y

下一步：
→ 执行/peach-gen-store [模块名]生成前端Store

📌 测试策略指引：
- Backend TDD：完全验证业务逻辑 ✅（已完成）
- Frontend Store TDD：可选（仅存在复杂客户端逻辑时需要）
- 大部分Store都是API Wrapper，仅Backend TDD就足够

참조

参考

가이드 코드:
```
api/src/modules/test-data/
```

스키마:

api/db/schema/[도메인]/[테이블].sql

상세 가이드:
```
references/
```
폴더 참조

示例代码：
```
api/src/modules/test-data/
```
Schema：
```
api/db/schema/[领域]/[表名].sql
```
详细指南：参考
```
references/
```
文件夹