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>
1.1 KiB
1.1 KiB
System1(system1-factory) 새 API 엔드포인트를 생성합니다.
인자: $ARGUMENTS (예: "consumable-stock 소모품 재고" 또는 리소스명)
절차:
-
기존 패턴 확인:
- system1-factory/api/ 아래 기존 model, controller, route 파일 하나씩 읽어 패턴 파악
-
Model 생성 (
api/models/<리소스>.js):- Knex 기반 DB 쿼리 패턴
- CRUD 기본 메서드: getAll, getById, create, update, delete
-
Controller 생성 (
api/controllers/<리소스>Controller.js):- responseFormatter (res.success, res.error, res.paginated) 사용
- try/catch + 에러 핸들링 패턴
- 페이지네이션 지원 (GET list)
-
Route 생성 (
api/routes/<리소스>Routes.js):- Express Router
- auth 미들웨어 적용
- RESTful 패턴: GET /, GET /:id, POST /, PUT /:id, DELETE /:id
-
라우트 등록:
api/config/routes.js(또는 app.js/server.js)에 새 라우트 추가
-
생성된 파일 목록 + API 엔드포인트 정리 보고
주의:
- 다른 서비스(system2, tkpurchase 등)의 API 추가 시 해당 서비스의 패턴을 먼저 확인
- System3, tkeg는 FastAPI 패턴 (Python)