Files
tk-factory-services/.claude/commands/add-api.md
Hyungi Ahn ec59efcdb6 docs: CLAUDE.md + 슬래시 커맨드 + 워크플로우 가이드 추가
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>
2026-03-16 15:13:49 +09:00

1.1 KiB

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)