Claude Code 협업 효율화를 위한 문서 체계 구축: - CLAUDE.md: 서비스 맵·코드 규칙·배포 정보 (매 세션 자동 로드) - 슬래시 커맨드 5개: deploy, check-deploy, cache-bust, add-page, add-api - WORKFLOW-GUIDE.md: Plan 모드·서브에이전트·검증 루프 활용 가이드 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
System1(system1-factory) 새 API 엔드포인트를 생성합니다.
|
|
|
|
인자: $ARGUMENTS (예: "consumable-stock 소모품 재고" 또는 리소스명)
|
|
|
|
절차:
|
|
1. 기존 패턴 확인:
|
|
- system1-factory/api/ 아래 기존 model, controller, route 파일 하나씩 읽어 패턴 파악
|
|
|
|
2. Model 생성 (`api/models/<리소스>.js`):
|
|
- Knex 기반 DB 쿼리 패턴
|
|
- CRUD 기본 메서드: getAll, getById, create, update, delete
|
|
|
|
3. Controller 생성 (`api/controllers/<리소스>Controller.js`):
|
|
- responseFormatter (res.success, res.error, res.paginated) 사용
|
|
- try/catch + 에러 핸들링 패턴
|
|
- 페이지네이션 지원 (GET list)
|
|
|
|
4. Route 생성 (`api/routes/<리소스>Routes.js`):
|
|
- Express Router
|
|
- auth 미들웨어 적용
|
|
- RESTful 패턴: GET /, GET /:id, POST /, PUT /:id, DELETE /:id
|
|
|
|
5. 라우트 등록:
|
|
- `api/config/routes.js` (또는 app.js/server.js)에 새 라우트 추가
|
|
|
|
6. 생성된 파일 목록 + API 엔드포인트 정리 보고
|
|
|
|
주의:
|
|
- 다른 서비스(system2, tkpurchase 등)의 API 추가 시 해당 서비스의 패턴을 먼저 확인
|
|
- System3, tkeg는 FastAPI 패턴 (Python)
|