# SAM 문서 인덱스 (Claude Code용) > 작업 유형에 맞는 문서를 먼저 읽고 시작하세요. > 최종 갱신: 2026-03-07 --- ## 작업별 필수 문서 | 작업 유형 | 필수 문서 | 용도 | |----------|----------|------| | API 개발 | `dev/standards/api-rules.md` | Service-First, FormRequest, i18n | | DB 변경 | `system/database/README.md` | 테이블 구조, 관계, 컬럼 규칙 | | 새 기능 | `system/overview.md` | 전체 아키텍처 | | 보안 | `system/security-policy.md` | 인증/인가, 보안 규칙 | | Git 커밋 | `dev/standards/git-conventions.md` | 커밋 메시지, 브랜치 전략 | | 품질 검증 | `dev/standards/quality-checklist.md` | 코드 품질 체크리스트 | | Swagger | `dev/guides/swagger-guide.md` | API 문서 작성법 | | 품목관리 | `rules/item-policy.md` | 품목 정책 | | 단가관리 | `rules/pricing-policy.md` | 원가/판매가, 리비전 | | 견적관리 | `features/quotes/README.md` | 견적 시스템, BOM 계산 | | 운영 배포 | `dev/dev_plans/production-deployment-plan.md` | 배포 계획 | | 서버 운영 | `dev/deploys/ops-manual/README.md` | 서버 운영 매뉴얼 | | 서버 접근/백업 | `system/server-access-management.md` | 계정, 권한, 백업, 리플리케이션 | | MES | `projects/mes/README.md` | MES 프로젝트 | --- ## 폴더 구조 ``` docs/ ├── [공유] │ ├── features/ # 기능별 상세 명세 │ ├── rules/ # 비즈니스 규칙·정책 │ ├── projects/ # 프로젝트별 자료 │ ├── system/ # 시스템 현황 (아키텍처, DB, 인프라) │ ├── [개발팀] │ ├── dev/standards/ # 개발 표준 │ ├── dev/guides/ # 구현 가이드 │ ├── dev/quickstart/ # 빠른 시작 │ ├── dev/changes/ # 변경 이력 │ ├── dev/deploys/ # 배포/운영 │ ├── dev/data/ # 데이터 분석 │ ├── dev/history/ # 과거 이력 │ ├── dev/dev_plans/ # 개발 계획 (임시) │ ├── [프론트엔드] │ ├── frontend/api-specs/ # API 연동 명세 │ ├── frontend/integration/ # 연동 가이드 │ ├── [기획팀] │ ├── requests/ # 기획 요청 │ ├── resources.md # 외부 자료 링크 (노션) ├── README.md # 사람용 안내 └── INDEX.md # 이 파일 (Claude Code용) ``` --- ## 폴더별 문서 목록 ### system/ — 시스템 현황 | 문서 | 설명 | |------|------| | [overview.md](system/overview.md) | 전체 시스템 아키텍처 | | [api-structure.md](system/api-structure.md) | API 서버 구조 (~1,027 엔드포인트) | | [react-structure.md](system/react-structure.md) | React 프론트엔드 구조 | | [mng-structure.md](system/mng-structure.md) | MNG 관리자 패널 구조 | | [docker-setup.md](system/docker-setup.md) | Docker 환경 + CI/CD | | [database/README.md](system/database/README.md) | DB 스키마 인덱스 | | [security-policy.md](system/security-policy.md) | 보안 정책 | | [server-access-management.md](system/server-access-management.md) | 서버 접근 권한, 백업, 리플리케이션 | | [scaling-roadmap.md](system/scaling-roadmap.md) | 스케일링 로드맵 | | [board-system-spec.md](system/board-system-spec.md) | 게시판 시스템 설계 | | [item-master-integration.md](system/item-master-integration.md) | 품목 마스터 통합 설계 | | [erp-analysis/](system/erp-analysis/) | ERP 스토리보드 분석 | DB 도메인별: | 문서 | 도메인 | |------|--------| | [database/tenants.md](system/database/tenants.md) | 테넌트, 사용자, 권한 | | [database/products.md](system/database/products.md) | 제품, 품목, 설계 | | [database/sales.md](system/database/sales.md) | 영업, 수주, 견적 | | [database/production.md](system/database/production.md) | 생산, 시공, 자재, 품질 | | [database/finance.md](system/database/finance.md) | 재무, 회계 | | [database/hr.md](system/database/hr.md) | 인사 | | [database/documents.md](system/database/documents.md) | 문서, 전자서명 | | [database/commons.md](system/database/commons.md) | 공통, 게시판, 감사 | | [database/stats.md](system/database/stats.md) | 통계 | --- ### dev/standards/ — 개발 표준 | 문서 | 설명 | |------|------| | [api-rules.md](dev/standards/api-rules.md) | API 개발 규칙 | | [git-conventions.md](dev/standards/git-conventions.md) | Git 컨벤션 | | [quality-checklist.md](dev/standards/quality-checklist.md) | 품질 체크리스트 | | [pagination-policy.md](dev/standards/pagination-policy.md) | 페이지네이션 표준 | | [options-column-policy.md](dev/standards/options-column-policy.md) | JSON options 컬럼 정책 | --- ### rules/ — 비즈니스 규칙 | 문서 | 설명 | |------|------| | [item-policy.md](rules/item-policy.md) | 품목 정책 | | [pricing-policy.md](rules/pricing-policy.md) | 단가 정책 | | [numbering-rules.md](rules/numbering-rules.md) | 채번 규칙 | | [client-policy.md](rules/client-policy.md) | 고객사 관리 정책 | | [billing-policy.md](rules/billing-policy.md) | 과금 정책 (CONFIDENTIAL) | | [customer-pricing.md](rules/customer-pricing.md) | 고객 요금표 | | [partner-commission.md](rules/partner-commission.md) | 영업파트너 수당 체계 | | [attendance-api.md](rules/attendance-api.md) | 근태 API 규칙 | | [department-tree-api.md](rules/department-tree-api.md) | 부서 트리 API | | [employee-api.md](rules/employee-api.md) | 직원 API | --- ### features/ — 기능별 문서 | 문서 | 설명 | |------|------| | [quotes/README.md](features/quotes/README.md) | 견적 시스템 | | [sales/README.md](features/sales/README.md) | 영업 관리 | | [documents/README.md](features/documents/README.md) | 문서관리 | | [finance/README.md](features/finance/README.md) | 재무 관리 | | [hr/](features/hr/) | 인사관리 | | [crm/README.md](features/crm/README.md) | CRM | | [esign/README.md](features/esign/README.md) | 전자서명 | | [equipment/README.md](features/equipment/README.md) | 설비관리 | | [boards/README.md](features/boards/README.md) | 게시판 | | [ai/README.md](features/ai/README.md) | AI 분석 | | [card-vehicle/README.md](features/card-vehicle/README.md) | 법인카드·차량 | | [settlement/README.md](features/settlement/README.md) | 정산 | | [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 | --- ### dev/guides/ — 구현 가이드 | 문서 | 설명 | |------|------| | [swagger-guide.md](dev/guides/swagger-guide.md) | Swagger 작성법 | | [file-storage-guide.md](dev/guides/file-storage-guide.md) | 파일 업로드/다운로드 | | [item-management-migration.md](dev/guides/item-management-migration.md) | Item 전환 가이드 | | [server-how-it-works.md](dev/guides/server-how-it-works.md) | 서버 동작 원리 | | [jenkins-setup-guide.md](dev/guides/jenkins-setup-guide.md) | Jenkins CI/CD | | [erp-api-list.md](dev/guides/erp-api-list.md) | ERP API 목록 | | [erp-api-detail.md](dev/guides/erp-api-detail.md) | ERP API 상세 | | [item-master-guide.md](dev/guides/item-master-guide.md) | 품목기준관리 구조 | --- ### projects/ — 프로젝트 자료 | 프로젝트 | 문서 | 설명 | |---------|------|------| | MES | [projects/mes/README.md](projects/mes/README.md) | MES 개요 | | 5130 이관 | [projects/5130-migration/](projects/5130-migration/) | 레거시 이관 | | API 연동 | [projects/api-integration/](projects/api-integration/) | React↔API | | 견적 | [projects/quotation/](projects/quotation/) | 견적 프로젝트 | | 전자서명 | [projects/e-sign/](projects/e-sign/) | 전자서명 | --- ### dev/deploys/ — 배포/운영 | 문서 | 설명 | |------|------| | [ops-manual/README.md](dev/deploys/ops-manual/README.md) | 서버 운영 매뉴얼 | --- ### dev/quickstart/ — 빠른 시작 | 문서 | 설명 | |------|------| | [quick-start.md](dev/quickstart/quick-start.md) | 핵심 규칙 요약 | | [dev-commands.md](dev/quickstart/dev-commands.md) | 개발 명령어 모음 | --- ### 서브프로젝트 문서 | 프로젝트 | 경로 | |---------|------| | API | [api/docs/](../api/docs/) | | MNG | [mng/docs/](../mng/docs/) | | React | [react/docs/](../react/docs/) | --- ## 폴더 선택 기준 | 질문 | 폴더 | |------|------| | 시스템 현재 상태? | `system/` | | 코드 작성 규칙? | `dev/standards/` | | 비즈니스 규칙? | `rules/` | | 기능 동작 방식? | `features/` | | 구현 방법? | `dev/guides/` | | 개발 계획? | `dev/dev_plans/` | | 프로젝트 자료? | `projects/` | | 변경 이력? | `dev/changes/` |