sam-docs/INDEX.md

SAM 문서 인덱스 (Claude Code용)

작업 유형에 맞는 문서를 먼저 읽고 시작하세요. 최종 갱신: 2026-03-12

---

작업별 필수 문서

작업 유형	필수 문서	용도
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 문서 작성법
이메일 정책	dev/standards/email-policy.md	멀티테넌시 이메일 발송 아키텍처
이메일 연동	dev/guides/tenant-email-integration-guide.md	테넌트 메일 연동, SMTP 프리셋, MNG 관리
품목관리	rules/item-policy.md	품목 정책
단가관리	rules/pricing-policy.md	원가/판매가, 리비전
견적관리	features/quotes/README.md	견적 시스템, BOM 계산
급여관리 API	frontend/api-specs/payroll-api.md	급여관리 API 전체 명세 (18개 엔드포인트)
바로빌 회계 API	frontend/api-specs/barobill-api.md	카드/은행/홈택스 REST API (42개 엔드포인트)
결재관리	dev/dev_plans/approval-system-unification-plan.md	MNG→API 결재 통합 계획
운영 배포	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 프론트엔드 구조
react-component-architecture.md	React 컴포넌트 아키텍처 (Atomic Design 적용 현황, UI 스택, 테마)
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 컬럼 정책
pdf-font-policy.md	PDF 생성 시 폰트 정책 (DomPDF)
email-policy.md	멀티테넌시 이메일 발송 정책

---

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	재무 관리
finance/payroll.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	바로빌 카카오톡
quality-management/README.md	품질관리 (제품검사, 실적신고)
approvals/README.md	결재관리 시스템
approvals/mng-api-comparison.md	결재관리 MNG↔API 비교 분석 및 React 구현 가이드
email/README.md	이메일 시스템 (테넌트별 SMTP 설정, 프리셋, 연결 테스트)

---

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	품목기준관리 구조
claude-code-to-slack.md	Claude Code → 슬랙 붙여넣기 가이드
tenant-email-integration-guide.md	테넌트 이메일 연동 (SMTP 프리셋, MNG 관리 화면, 연결 테스트)

---

projects/ — 프로젝트 자료

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

---

dev/changes/ — 변경 이력

문서	설명
20260311_daily_fund_sync_and_account_codes_fix.md	자금일보 바로빌 자동동기화 + 계정과목 데이터 정리
20260311_esign_journal_barobill_fixes.md	전자서명 체크박스, 전표 적요 동기화, 거래처 드롭다운, 바로빌 중복 키 수정
20260311_salary_history_delete.md	연봉이력 삭제 기능 추가 (사원관리 연봉정보)

---

dev/deploys/ — 배포/운영

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

---

dev/quickstart/ — 빠른 시작

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

---

frontend/api-specs/ — 프론트엔드 API 연동 명세

문서	설명
approval-api.md	결재관리 API 전체 명세 (28개 엔드포인트)
document-api-integration.md	문서 API 연동 명세
payroll-api.md	급여관리 API 전체 명세 (18개 엔드포인트)
barobill-api.md	바로빌 회계 데이터 API 명세 (42개 엔드포인트)

frontend/integration/ — 프론트엔드 개발 가이드

문서	설명
payroll-guide.md	급여관리 프론트엔드 개발 가이드 (화면 구성, 구현 유의사항)

---

서브프로젝트 문서

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

---

폴더 선택 기준

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