# SAM 문서 인덱스 (Claude Code용)

> 작업 유형에 맞는 문서를 먼저 읽고 시작하세요.
> 최종 갱신: 2026-03-13 (프로젝트 규모 현황 추가)

---

## 작업별 필수 문서

| 작업 유형 | 필수 문서 | 용도 |
|----------|----------|------|
| 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` | 멀티테넌시 이메일 발송 아키텍처 |
| Blade+React | `dev/standards/blade-react-policy.md` | Blade JSX 이중 중괄호 충돌 방지 |
| 이메일 연동 | `dev/guides/tenant-email-integration-guide.md` | 테넌트 메일 연동, SMTP 프리셋, MNG 관리 |
| 품목관리 | `rules/item-policy.md` | 품목 정책 |
| 단가관리 | `rules/pricing-policy.md` | 6 Depth 단가 체계, 흐름도, 계산공식, 버전관리 개선방향 |
| 단가 버전관리 기획 | `dev/dev_plans/price-version-management-plan.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개 엔드포인트) |
| 바로빌 시스템 | `features/barobill/README.md` | SOAP 연동, 테스트/운영 모드, 과금, 멀티테넌트 (API 구축 완료) |
| 바로빌 API SOAP | `features/barobill/api-soap-reference.md` | API SOAP 49+7 메서드, 동기화 서비스, 스케줄러, MNG 대응표 |
| 바로빌 출시 계획 | `dev/dev_plans/barobill-service-launch-plan.md` | 4단계 출시 로드맵 (SOAP 이관→UI→베타→출시) |
| 바로빌 온보딩 가이드 | `guides/barobill-onboarding-guide.md` | 신규 고객 바로빌 연동 실행 절차 (7단계, API 예시, 트러블슈팅) |
| 재공품 생산 정책 | `rules/wip-production-policy.md` | 재공품(WIP) 개념, 제조업 공통 패턴, SAM 처리 방식 |
| 재고생산관리 API | `frontend/api-specs/stock-production-api.md` | 재고생산 API 명세 (기존 수주 API + STOCK 타입) |
| 절곡품 LOT API | `frontend/api-specs/bending-lot-api.md` | 절곡품 코드맵/품목매핑/LOT 채번 API (프론트엔드 구현 가이드 포함) |
| 결재관리 | `dev/dev_plans/approval-system-unification-plan.md` | MNG→API 결재 통합 계획 |
| 결재 모듈 통합 | `dev/guides/approval-module-integration-guide.md` | 다른 기능에 결재선/참조선 붙이기 (참조 문서 맵, 구현 절차) |
| API 품질 | `system/api-code-quality-audit.md` | 정석 패턴 R1~R6, 안티패턴, 보안, 체크리스트 |
| API 학습 | `dev/guides/api-request-lifecycle.md` | Client API로 배우는 요청 생명주기 8단계 |
| API 개선 | `dev/dev_plans/api-route-improvement-plan.md` | API 라우트 구조 개선 계획 (1,099개 분석) |
| 재고생산 개편 | `dev/dev_plans/stock-production-lot-form-plan.md` | 절곡품 LOT 방식 도입 (캐스케이딩 드롭다운, LOT 자동 생성) |
| 입고×수입검사 연동 | `dev/dev_plans/receiving-inspection-integration-plan.md` | 입고등록 수입검사 27종 매핑, Phase 1~3 계획 |
| 운영 배포 | `dev/dev_plans/production-deployment-plan.md` | 배포 계획 |
| QMS 점검표 | `dev/dev_plans/qms-checklist-template-plan.md` | 점검표 템플릿 관리 기능 |
| 부적합관리 | `dev/dev_plans/nonconforming-management-plan.md` | 자재관리 부적합관리 기획 (불량내역/처리방법/자재비용) |
| 계정별원장·손익계산서 | `dev/dev_plans/account-ledger-income-statement-plan.md` | 계정별원장 + 손익계산서 신규 메뉴 기획 (더존 참고) |
| 경조사비 서비스 이관 | `dev/dev_plans/condolence-expense-service-plan.md` | MNG 경조사비 → API+React 서비스 이관 기획 |
| 계정별원장 서비스 이관 | `dev/dev_plans/account-ledger-service-migration-plan.md` | MNG 계정별원장 → API+React 서비스 이관 기획 (API 완료) |
| 손익계산서 서비스 이관 | `dev/dev_plans/income-statement-service-migration-plan.md` | MNG 손익계산서 → API+React 서비스 이관 기획 (API 완료) |
| 조직도 서비스 이관 | `dev/dev_plans/org-chart-service-migration-plan.md` | MNG 조직도 → API+React 서비스 이관 기획 (API 완료) |
| 조직도 FE 가이드 | `frontend/v1/org-chart-fe-guide.md` | 조직도 React 구현 가이드 (API 스펙, UI 설계, 드래그앤드롭) |
| 서버 운영 | `dev/deploys/ops-manual/README.md` | 서버 운영 매뉴얼 |
| 서버 접근/백업 | `system/server-access-management.md` | 계정, 권한, 백업, 리플리케이션 |
| 이관 작업 | `system/migration-status.md` | MNG→API+React 이관 현황, 우선순위, 로드맵 |
| API 개선 로드맵 | `system/api-analysis-report.md` | API 구조 분석, 기술 부채 8건, P1~P3 개선 계획 |
| 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/        # 기획 요청
│
├── [영업/파트너]
│   ├── guides/          # 영업파트너 가이드
│
├── patent-candidate-summary.md  # 특허 후보 기술 요약서
├── patent-method-patent-briefing.md  # 방법특허 브리핑 자료
├── patent-attorney-meeting-20260319.md  # 변리사 미팅 결과 + 액션아이템 (2026-03-19)
├── patent-doc-01-automation-flowchart.md  # [변리사 제출] 온보딩 자동화 5단계 흐름도 + 청구항 초안
├── patent-doc-02-asis-tobe-comparison.md  # [변리사 제출] As-Is/To-Be 수치 대조표 (진보성 입증)
├── patent-doc-03-prompt-engineering-architecture.md  # [변리사 제출] AI 프롬프트 엔진 핵심 골격
├── patent-briefing.pptx         # 특허 브리핑 PPT
├── 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 프론트엔드 구조 |
| [react-component-architecture.md](system/react-component-architecture.md) | React 컴포넌트 아키텍처 (Atomic Design 적용 현황, UI 스택, 테마) |
| [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) | 스케일링 로드맵 |
| [untitled-ui-evaluation.md](system/untitled-ui-evaluation.md) | Untitled UI 도입 검토 (Figma/React UI Kit 평가) |
| [board-system-spec.md](system/board-system-spec.md) | 게시판 시스템 설계 |
| [migration-status.md](system/migration-status.md) | MNG→API+React 이관 현황 및 로드맵 (Phase 1~4) |
| [project-scale.md](system/project-scale.md) | 프로젝트 규모 현황 (코드 행 수, 파일 수) |
| [item-master-integration.md](system/item-master-integration.md) | 품목 마스터 통합 설계 |
| [erp-analysis/](system/erp-analysis/) | ERP 스토리보드 분석 |
| [api-analysis-report.md](system/api-analysis-report.md) | API 구조 분석 및 개선 로드맵 (기술 부채 8건, P1~P3) |
| [api-code-quality-audit.md](system/api-code-quality-audit.md) | API 코드 품질 감사 — 정석 패턴 6가지 + 보안 감사 + 개발 체크리스트 |

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 컬럼 정책 |
| [pdf-font-policy.md](dev/standards/pdf-font-policy.md) | PDF 생성 시 폰트 정책 (DomPDF) |
| [pdf-troubleshooting-guide.md](dev/guides/pdf-troubleshooting-guide.md) | PDF 생성 트러블슈팅 (Puppeteer + DomPDF) |
| [email-policy.md](dev/standards/email-policy.md) | 멀티테넌시 이메일 발송 정책 |
| [blade-react-policy.md](dev/standards/blade-react-policy.md) | Blade + React(JSX) 혼용 시 이중 중괄호 충돌 방지 정책 |
| [bending-item-code-policy.md](standards/bending-item-code-policy.md) | 절곡 재공품 품목코드 체계 (BD-XX-nn, 2계층 구조) |

---

### 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) | 고객사 관리 정책 |
| [wip-production-policy.md](rules/wip-production-policy.md) | 재공품(WIP) 생산 정책 (개념, MTS/MTO/ATO, 제조업 공통 패턴) |
| [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 |
| [bending-lot-numbering-policy.md](rules/bending-lot-numbering-policy.md) | 재공품(절곡품) LOT 번호 채번 규칙 (경동기업 기준, 향후 MNG 채번 규칙으로 전환) |
| [leave-promotion-policy.md](rules/leave-promotion-policy.md) | 연차촉진 관리 정책 (근로기준법 제61조, 1년 이상/미만 계산 공식) |

---

### 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) | 재무 관리 |
| [finance/payroll.md](features/finance/payroll.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) | 설비관리 (API Phase 1 완료 + DB 스키마) |
| [boards/README.md](features/boards/README.md) | 게시판 |
| [ai/README.md](features/ai/README.md) | AI 기능 (리포트, 토큰사용량, 단가설정, R2 비용추적) |
| [card-vehicle/README.md](features/card-vehicle/README.md) | 법인카드·차량 |
| [settlement/README.md](features/settlement/README.md) | 정산 |
| [sales/stock-production.md](features/sales/stock-production.md) | 재고생산관리 (내부 오더 방식, 수주 테이블 공유) |
| [sales/demo-tenant-policy.md](features/sales/demo-tenant-policy.md) | 영업파트너 데모 테넌트 정책 (3-Tier 전략) |
| [sales/demo-tenant-usage-guide.md](features/sales/demo-tenant-usage-guide.md) | 데모 테넌트 사용 가이드 (영업파트너/관리자용) |
| [barobill/README.md](features/barobill/README.md) | 바로빌 연동 시스템 (SOAP API, 테스트/운영 모드, 과금, 이관 계획) |
| [barobill/tenant-onboarding.md](features/barobill/tenant-onboarding.md) | 바로빌 테넌트 온보딩 (개념 정의, 6단계 프로세스, 베타테스트와의 차이) |
| [barobill/api-soap-reference.md](features/barobill/api-soap-reference.md) | API SOAP 서비스 기술 참조 (49+7 메서드, 동기화, 스케줄러, MNG 대응표) |
| [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 |
| [quality-management/README.md](features/quality-management/README.md) | 품질관리 (제품검사, 실적신고) |
| [approvals/README.md](features/approvals/README.md) | 결재관리 시스템 |
| [approvals/mng-api-comparison.md](features/approvals/mng-api-comparison.md) | 결재관리 MNG↔API 비교 분석 및 React 구현 가이드 |
| [bending/README.md](features/bending/README.md) | 절곡 바라시 기초자료 (2계층 구조, 품목코드 BD-XX.nnn, 재공품 매핑) |
| [email/README.md](features/email/README.md) | 이메일 시스템 (테넌트별 SMTP 설정, 프리셋, 연결 테스트) |
| [construction-pmis/bim-viewer.md](features/construction-pmis/bim-viewer.md) | BIM 뷰어 (Three.js 기반 웹 3D 건물 모델 뷰어) |
| [rd/README.md](features/rd/README.md) | R&D 메뉴 전체 개요 |
| [rd/fire-shutter-drawing-guide-rail.md](features/rd/fire-shutter-drawing-guide-rail.md) | 방화셔터 가이드레일 SVG/3D 렌더링 기술 명세 |
| [notification-settings/README.md](features/notification-settings/README.md) | 서비스 알림설정 (5개 테이블, API 엔드포인트, 알림음 시스템, Gap 분석) |

---

### guides/ — 영업파트너 가이드

| 문서 | 설명 |
|------|------|
| [sam-pricing-simple-guide.md](guides/sam-pricing-simple-guide.md) | SAM 가격정책 쉬운 안내서 (영업파트너용) |
| [price-simulator-partner-guide.md](guides/price-simulator-partner-guide.md) | 가격 시뮬레이터 상세 가이드 (영업파트너용) |
| [ai-management.md](guides/ai-management.md) | AI 관리 가이드 |
| [pptx-generation-guide.md](guides/pptx-generation-guide.md) | PPTX 생성 가이드 |
| [project-launch-roadmap.md](guides/project-launch-roadmap.md) | 프로젝트 런칭 로드맵 |
| [table-design-guide.md](guides/table-design-guide.md) | 테이블 설계 가이드 |
| [barobill-onboarding-guide.md](guides/barobill-onboarding-guide.md) | 바로빌 온보딩 실행 가이드 (7단계 절차, API 예시, 트러블슈팅, 고객 안내 자료) |
| [pricing-modification-guide.md](guides/pricing-modification-guide.md) | 단가 수정 가이드 (수정 절차, 신규 등록, 견적 내 조정, 고객그룹 차등가) |

---

### dev/guides/ — 구현 가이드

| 문서 | 설명 |
|------|------|
| [api-request-lifecycle.md](dev/guides/api-request-lifecycle.md) | API 요청 생명주기 — Client API로 배우는 8단계 전체 흐름 |
| [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) | 품목기준관리 구조 |
| [claude-code-to-slack.md](dev/guides/claude-code-to-slack.md) | Claude Code → 슬랙 붙여넣기 가이드 |
| [r2-image-proxy-guide.md](dev/guides/r2-image-proxy-guide.md) | R2 이미지 프록시 가이드 (redirect/streaming/API 프록시, 트러블슈팅) |
| [claude-code-btw-guide.md](dev/guides/claude-code-btw-guide.md) | Claude Code /btw 사이드 질문 기능 가이드 |
| [tenant-email-integration-guide.md](dev/guides/tenant-email-integration-guide.md) | 테넌트 이메일 연동 (SMTP 프리셋, MNG 관리 화면, 연결 테스트) |
| [performance-report-excel-export.md](dev/guides/performance-report-excel-export.md) | 실적신고 확정건 엑셀 Export (건기원 양식, PhpSpreadsheet, 셀 병합) |
| [sam-hotkey-manager.md](dev/guides/sam-hotkey-manager.md) | SAM Hotkey Manager — Claude Code CLI 프롬프트 단축키 자동화 (AHK v2) |
| [approval-module-integration-guide.md](dev/guides/approval-module-integration-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/changes/ — 변경 이력

| 문서 | 설명 |
|------|------|
| [20260311_daily_fund_sync_and_account_codes_fix.md](dev/changes/20260311_daily_fund_sync_and_account_codes_fix.md) | 자금일보 바로빌 자동동기화 + 계정과목 데이터 정리 |
| [20260311_esign_journal_barobill_fixes.md](dev/changes/20260311_esign_journal_barobill_fixes.md) | 전자서명 체크박스, 전표 적요 동기화, 거래처 드롭다운, 바로빌 중복 키 수정 |
| [20260311_salary_history_delete.md](dev/changes/20260311_salary_history_delete.md) | 연봉이력 삭제 기능 추가 (사원관리 연봉정보) |
| [20260314_api_test_infrastructure_and_order_tests.md](dev/changes/20260314_api_test_infrastructure_and_order_tests.md) | API 테스트 인프라 정비 + 수주 테스트 12개 추가 |
| [20260314_api_quality_improvement_deploy.md](dev/changes/20260314_api_quality_improvement_deploy.md) | API 품질 개선 배포 — 테스트 56개 + N+1 최적화 3건 (근거 문서 포함) |
| [20260315_eval_removal_safe_math_evaluator.md](dev/changes/20260315_eval_removal_safe_math_evaluator.md) | API 보안 개선 — eval() 3건 제거, SafeMathEvaluator 도입 |
| [20260316_sales_policy_changes.md](changes/20260316_sales_policy_changes.md) | 영업 정책 변경 — 수당 구조 개편 및 무료 체험 폐지 |
| [20260316_stock_production_order.md](dev/changes/20260316_stock_production_order.md) | 재고생산관리 기능 추가 (STOCK 타입, 절곡 공정 자동, 생산지시 연동) |
| [20260317_account_code_migration_mapping.md](changes/20260317_account_code_migration_mapping.md) | 계정과목 코드 변경 매핑 (더존 3자리 → KIS 5자리) |
| [20260317_account_code_change_notice.md](changes/20260317_account_code_change_notice.md) | 계정과목 코드 변경 안내 (경리 전달용) |
| [20260318_notification_settings_soundtype.md](dev/changes/20260318_notification_settings_soundtype.md) | 알림설정 soundType API 연동 + 음원 파일 서빙 (React 미구현 항목 포함) |
| [20260318_receiving_item_search_fix.md](dev/changes/20260318_receiving_item_search_fix.md) | 입고등록 품목검색 필터/페이징 수정 (per_page/itemType 파라미터 호환성) |
| [20260318_item_fields_htmx_redirect_fix.md](changes/20260318_item_fields_htmx_redirect_fix.md) | 품목기준 필드관리 HTMX 네비게이션 switchTab 오류 수정 |
| [20260318_item_management_delete_scope_fix.md](changes/20260318_item_management_delete_scope_fix.md) | 품목관리 삭제 시 loadItemList 스코프 오류 수정 |
| [20260318_item-management-bom-tree.md](changes/20260318_item-management-bom-tree.md) | 품목관리 BOM 트리 3단계 구조 + 수식 산출 BOM 저장 기능 |
| [20260318_receiving_create_ux_improvement.md](changes/20260318_receiving_create_ux_improvement.md) | 입고등록 UX 개선 (초기값 설정, 상세 이동, 413 수정, Dialog 접근성) |
| [20260318_nginx_file_upload_413_fix.md](changes/20260318_nginx_file_upload_413_fix.md) | 서비스 파일 업로드 413 오류 수정 (Nginx client_max_body_size 설정) |
| [20260318_receiving_inspection_attachment_bug.md](changes/20260318_receiving_inspection_attachment_bug.md) | 입고상세 수입검사 첨부파일 삭제 후 미갱신 버그 (React 수정 필요) |
| [20260318_bending_lot_codemap_update.md](changes/20260318_bending_lot_codemap_update.md) | 절곡품 LOT 코드맵 최신화 + 품목 222건 등록 + 일련번호 제거 |
| [20260318_stock_production_auto_confirm.md](changes/20260318_stock_production_auto_confirm.md) | 재고생산 자동 확정+생산지시 (3단계→1단계, 확정 버튼 제거) |
| [20260318_api_response_extra_fields.md](changes/20260318_api_response_extra_fields.md) | ApiResponse 에러 신호 배열 추가 필드 전달 (expected_code 등) |
| [20260318_stock_production_item_add_removal.md](changes/20260318_stock_production_item_add_removal.md) | 재고생산 수정 화면 레이아웃 통일 (등록과 동일 BendingLotForm 사용) |
| [20260318_rm_spec_field_restructure.md](changes/20260318_rm_spec_field_restructure.md) | 원자재(RM) 규격 필드 구조 개선 (라벨 분리, 섹션 그룹핑, 테스트 데이터 정리) |
| [20260319_item_master_field_search.md](changes/20260319_item_master_field_search.md) | 서비스 품목기준관리 항목 탭 검색 기능 추가 |
| [20260319_nonconforming_management_api.md](changes/20260319_nonconforming_management_api.md) | 부적합관리 API 구현 (8개 엔드포인트 + 결재 연동) |
| [20260319_statcards_grid_layout_fix.md](changes/20260319_statcards_grid_layout_fix.md) | StatCards 카드 6개 한 행 표시 개선 |
| [20260319_item_master_field_validation_fix.md](changes/20260319_item_master_field_validation_fix.md) | 품목기준관리 필드 수정 422 유효성 검증 오류 수정 |
| [20260319_account_code_migration_and_income_statement.md](changes/20260319_account_code_migration_and_income_statement.md) | 계정코드 3→5자리 마이그레이션 + 손익계산서 월별/토글 개선 |
| [20260319_account_ledger_keyboard_navigation.md](changes/20260319_account_ledger_keyboard_navigation.md) | 계정별원장 계정과목 검색 키보드 방향키 네비게이션 추가 |
| [20260319_condolence_dashboard_integration.md](changes/20260319_condolence_dashboard_integration.md) | 경조사비 대시보드 연동 (condolence_summary 필드 추가) |
| [20260319_esign_salary_year_regex_fix.md](changes/20260319_esign_salary_year_regex_fix.md) | 전자계약 근로계약서 연봉계약종료연도 정규식 버그 수정 (두음법칙 불일치) |
| [20260319_barobill_card_auto_sync.md](changes/20260319_barobill_card_auto_sync.md) | 바로빌 카드 사용내역 자동 동기화 스케줄러 추가 (2시간마다, 서버 crontab 필요) |
| [20260319_db_codebridge_migration_and_fixes.md](changes/20260319_db_codebridge_migration_and_fixes.md) | MNG 전용 테이블 codebridge DB 이관 + 손익계산서 매출액/월별 세부내역 수정 |
| [20260319_attendance_leave_sync_fix.md](changes/20260319_attendance_leave_sync_fix.md) | 근태현황 승인된 휴가 누락 attendance 레코드 자동 보정 |
| [20260319_card_transaction_display_unification.md](changes/20260319_card_transaction_display_unification.md) | 카드거래 표시 포맷 3개 화면 통일 (계정별원장·일반전표·카드사용내역) |
| [20260319_split_card_journal_matching_fix.md](changes/20260319_split_card_journal_matching_fix.md) | 분리 카드거래 분개 매칭 + 개별 행 확장 표시 수정 |
| [20260320_income_statement_monthly_total_and_items.md](changes/20260320_income_statement_monthly_total_and_items.md) | 손익계산서 월별보기 합계 열 추가 및 세부계정과목 표시 개선 |
| [20260320_attendance_manual_absent.md](changes/20260320_attendance_manual_absent.md) | 근태현황 자동 결근 처리 → 수동 트리거 전환 (스케줄러 비활성화, 버튼 추가) |
| [20260320_attendance_calendar_exclude_fix.md](changes/20260320_attendance_calendar_exclude_fix.md) | 근태 캘린더 영업팀 제외 필터 누락 수정 + 운영DB 오류 데이터 삭제 |
| [20260320_leave_list_sort_by_period.md](changes/20260320_leave_list_sort_by_period.md) | 휴가관리 목록 정렬 기준 변경 (created_at → start_date 최신순) |
| [20260320_bank_transaction_trans_office_override.md](changes/20260320_bank_transaction_trans_office_override.md) | 계좌내역 취급점(trans_office) override 수정 기능 추가 |
| [20260320_bank_balance_recalc_all_transactions.md](changes/20260320_bank_balance_recalc_all_transactions.md) | 계좌내역 잔액 재계산을 전체 거래에 적용 (표시 시점 계산) |
| [20260320_sales_to_mng_rd_migration.md](dev/changes/20260320_sales_to_mng_rd_migration.md) | Sales → MNG 연구개발 메뉴 통합 이관 (11개 페이지) |
| [20260320_daily_work_logs_codebridge_migration_fix.md](changes/20260320_daily_work_logs_codebridge_migration_fix.md) | 일일업무일지 codebridge DB 이관 누락 수정 (sam→codebridge 데이터 복구) |
| [20260321_process_duplicate_feature.md](changes/20260321_process_duplicate_feature.md) | 공정관리 공정 복제(복사) 기능 추가 (API+React) |
| [20260321_bending_api_internal_url_fix.md](changes/20260321_bending_api_internal_url_fix.md) | Docker 환경 MNG→API 호출 internal_url 미적용 500 에러 수정 |
| [20260321_process_parent_id_tree.md](changes/20260321_process_parent_id_tree.md) | 공정관리 parent_id 트리 구조 도입 (2depth, 작업자 화면 그룹 탭) |
| [20260321_wip_inspection_report_fix.md](changes/20260321_wip_inspection_report_fix.md) | 재공품 검사성적서 검사부위 공백/도면치수/테스트입력 수정 |
| [20260322_wip_worker_screen_improvements.md](changes/20260322_wip_worker_screen_improvements.md) | 재공품 작업자화면 종합 개선 (검사판정/작업일지/자재투입/재고유형) |

---

### 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) | 개발 명령어 모음 |

---

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

| 문서 | 설명 |
|------|------|
| [approval-api.md](frontend/api-specs/approval-api.md) | 결재관리 API 전체 명세 (28개 엔드포인트) |
| [document-api-integration.md](frontend/api-specs/document-api-integration.md) | 문서 API 연동 명세 |
| [payroll-api.md](frontend/api-specs/payroll-api.md) | 급여관리 API 전체 명세 (18개 엔드포인트) |
| [barobill-api.md](frontend/api-specs/barobill-api.md) | 바로빌 회계 데이터 API 명세 (42개 엔드포인트) |
| [equipment-api.md](requests/equipment-frontend-request.md) | 설비관리 React 프론트엔드 구현 요청 (26개 엔드포인트 + 화면 가이드) |
| [vehicle-api.md](frontend/api-specs/vehicle-api.md) | 차량관리 API 명세 (20개 엔드포인트: 차량목록, 차량일지, 정비이력, 사진) |
| [stock-production-api.md](frontend/api-specs/stock-production-api.md) | 재고생산관리 API 명세 (기존 수주 API + STOCK 타입) |
| [stock-receiving-changes-20260317.md](frontend/api-specs/stock-receiving-changes-20260317.md) | 입고관리/재고현황 변경사항 (로트번호 자동채번, 재고 조정 이동, API 스펙) |
| [receiving-item-search-fix-20260318.md](frontend/api-specs/receiving-item-search-fix-20260318.md) | 입고등록 품목검색 버그 수정 (per_page/itemType 파라미터, 프론트엔드 전달용) |
| [receiving-create-ux-20260318.md](frontend/api-specs/receiving-create-ux-20260318.md) | 입고등록 UX 개선 요청 (초기값, 상세이동, 413 수정, Dialog 접근성) |
| [ai-token-usage-api.md](frontend/api-specs/ai-token-usage-api.md) | AI 토큰사용량 API 명세 (2개 엔드포인트 + 화면 가이드 + 타입 정의) |
| [usage-subscription-api.md](frontend/api-specs/usage-subscription-api.md) | 이용현황(구독관리 통합) API 명세 (API 완료, 화면 가이드, 타입 정의, 피드백 반영) |
| [nonconforming-api.md](frontend/api-specs/nonconforming-api.md) | 부적합관리 API 명세 (7개 엔드포인트 + 화면 가이드 + Server Actions 예시) |
| [account-ledger-income-statement-api.md](frontend/api-specs/account-ledger-income-statement-api.md) | 계정별원장·손익계산서 API 명세 (초기 버전) |
| [account-ledger-service-api.md](frontend/api-specs/account-ledger-service-api.md) | 계정별원장 서비스 이관 API 명세 (카드거래+분리전표 보강, 최신) |
| [income-statement-service-api.md](frontend/api-specs/income-statement-service-api.md) | 손익계산서 서비스 이관 API 명세 (기간별+월별 조회, TypeScript 타입, 화면 가이드) |
| [condolence-expense-api.md](frontend/api-specs/condolence-expense-api.md) | 경조사비 관리 API 명세 (6개 엔드포인트 + TypeScript 타입 + 화면 가이드) |
| [condolence-dashboard-fe-request.md](frontend/api-specs/condolence-dashboard-fe-request.md) | 경조사비 대시보드 연동 FE 구현 요청 (condolence_summary 카드 추가) |
| [vehicle-react-implementation.md](plans/vehicle-react-implementation.md) | 차량관리 React 구현 요청서 (3개 메뉴, 컴포넌트 구조, 타입 정의) |
| [stock-production-react-request.md](plans/stock-production-react-request.md) | 재고생산관리 React 구현 요청서 (수주 화면 단순화, API 스펙 포함) |
| [bending-lot-react-request.md](plans/bending-lot-react-request.md) | 절곡품 LOT 재고생산 React 구현 요청서 (캐스케이딩 드롭다운, LOT 자동생성, 취소 복원) |
| [barobill-react-improvement-request.md](plans/barobill-react-improvement-request.md) | 바로빌 React 개선 요청서 (동기화 버튼, 인증서/잔액 표시, 계좌/카드 목록, Server Action 6개) |
| [receiving-lot-auto-generate-request.md](plans/receiving-lot-auto-generate-request.md) | 입고등록 원자재로트번호 자동채번 적용 요청 (읽기전용 변경, API 자동생성) |
| [stock-detail-inventory-adjustment-request.md](plans/stock-detail-inventory-adjustment-request.md) | 재고 조정 위치 이동 요청 (입고관리 → 재고 상세 화면) |
| [bom-tree-visualization-request.md](plans/bom-tree-visualization-request.md) | BOM Tree 시각화 React 구현 요청 (API 완료, 재귀 트리 UI) |
| [ai-token-usage-service-migration.md](plans/ai-token-usage-service-migration.md) | AI 토큰사용량 서비스 이관 기획 (MNG→API+React, GCS→R2 저장소 차이) |
| [notification-sound-react-request.md](plans/notification-sound-react-request.md) | 알림설정 soundType React 구현 요청 (음원 배치, 미리듣기 실제 재생, API 연동 완료) |
| [usage-subscription-unification.md](plans/usage-subscription-unification.md) | 이용현황+구독관리 통합 계획 (AI 토큰 사용량, 저장공간, 메뉴 통합) |
| [usage-react-request.md](plans/usage-react-request.md) | 이용현황(구독관리 통합) React 구현 요청서 (API 완료, 타입/컴포넌트/와이어프레임 포함) |
| [bom-tree-3level-react-request.md](plans/bom-tree-3level-react-request.md) | BOM 트리 3단계 그룹 표시 React 구현 요청 (API 완료, 카테고리 접힘/펼침) |
| [item-list-search-state-preservation.md](plans/item-list-search-state-preservation.md) | 품목관리 검색 상태 보존 UX 개선 요청 (router.back + URL searchParams 동기화) |
| [optimal-stock-management-plan.md](plans/optimal-stock-management-plan.md) | 적정재고 관리 기능 기획 (안전재고+최대재고 범위 기반, 상태 확장) |

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

| 문서 | 설명 |
|------|------|
| [payroll-guide.md](frontend/integration/payroll-guide.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/` |