SamProject/sam-docs
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
sam-docs/INDEX.md
권혁성 03850fefdd docs: 서버 접근 권한 관리 문서 업데이트 
- 운영 관리자 정보 추가 (hskwon/권혁성, pro/김보곤)
- 서버 시간대 설정 정리 (OS, PHP CLI/FPM, Laravel)
- develop 그룹 + setgid 공동 관리 구조 추가
- DB 리플리케이션 현황 (sam, sam_stat, codebridge)
- DB 백업 설정 (/data/ 경로, codebridge 포함)
- sam-dev 서버 정보 추가
- INDEX.md에 서버 접근/백업 문서 등록

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-07 01:28:08 +09:00

212 lines
8.6 KiB
Markdown
Raw Permalink Blame History

# 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/` |
Reference in New Issue View Git Blame Copy Permalink