sam-docs/INDEX.md

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	전체 시스템 아키텍처
api-structure.md	API 서버 구조 (~1,027 엔드포인트)
react-structure.md	React 프론트엔드 구조
mng-structure.md	MNG 관리자 패널 구조
docker-setup.md	Docker 환경 + CI/CD
database/README.md	DB 스키마 인덱스
security-policy.md	보안 정책
server-access-management.md	서버 접근 권한, 백업, 리플리케이션
scaling-roadmap.md	스케일링 로드맵
board-system-spec.md	게시판 시스템 설계
item-master-integration.md	품목 마스터 통합 설계
erp-analysis/	ERP 스토리보드 분석

DB 도메인별:

문서	도메인
database/tenants.md	테넌트, 사용자, 권한
database/products.md	제품, 품목, 설계
database/sales.md	영업, 수주, 견적
database/production.md	생산, 시공, 자재, 품질
database/finance.md	재무, 회계
database/hr.md	인사
database/documents.md	문서, 전자서명
database/commons.md	공통, 게시판, 감사
database/stats.md	통계

---

dev/standards/ — 개발 표준

문서	설명
api-rules.md	API 개발 규칙
git-conventions.md	Git 컨벤션
quality-checklist.md	품질 체크리스트
pagination-policy.md	페이지네이션 표준
options-column-policy.md	JSON options 컬럼 정책

---

rules/ — 비즈니스 규칙

문서	설명
item-policy.md	품목 정책
pricing-policy.md	단가 정책
numbering-rules.md	채번 규칙
client-policy.md	고객사 관리 정책
billing-policy.md	과금 정책 (CONFIDENTIAL)
customer-pricing.md	고객 요금표
partner-commission.md	영업파트너 수당 체계
attendance-api.md	근태 API 규칙
department-tree-api.md	부서 트리 API
employee-api.md	직원 API

---

features/ — 기능별 문서

문서	설명
quotes/README.md	견적 시스템
sales/README.md	영업 관리
documents/README.md	문서관리
finance/README.md	재무 관리
hr/	인사관리
crm/README.md	CRM
esign/README.md	전자서명
equipment/README.md	설비관리
boards/README.md	게시판
ai/README.md	AI 분석
card-vehicle/README.md	법인카드·차량
settlement/README.md	정산
barobill-kakaotalk/README.md	바로빌 카카오톡

---

dev/guides/ — 구현 가이드

문서	설명
swagger-guide.md	Swagger 작성법
file-storage-guide.md	파일 업로드/다운로드
item-management-migration.md	Item 전환 가이드
server-how-it-works.md	서버 동작 원리
jenkins-setup-guide.md	Jenkins CI/CD
erp-api-list.md	ERP API 목록
erp-api-detail.md	ERP API 상세
item-master-guide.md	품목기준관리 구조

---

projects/ — 프로젝트 자료

프로젝트	문서	설명
MES	projects/mes/README.md	MES 개요
5130 이관	projects/5130-migration/	레거시 이관
API 연동	projects/api-integration/	React↔API
견적	projects/quotation/	견적 프로젝트
전자서명	projects/e-sign/	전자서명

---

dev/deploys/ — 배포/운영

문서	설명
ops-manual/README.md	서버 운영 매뉴얼

---

dev/quickstart/ — 빠른 시작

문서	설명
quick-start.md	핵심 규칙 요약
dev-commands.md	개발 명령어 모음

---

서브프로젝트 문서

프로젝트	경로
API	api/docs/
MNG	mng/docs/
React	react/docs/

---

폴더 선택 기준

질문	폴더
시스템 현재 상태?	system/
코드 작성 규칙?	dev/standards/
비즈니스 규칙?	rules/
기능 동작 방식?	features/
구현 방법?	dev/guides/
개발 계획?	dev/dev_plans/
프로젝트 자료?	projects/
변경 이력?	dev/changes/