견적 기능 개발 마스터 플랜 및 공통 정책 문서 추가
- 공통 정책 문서 신규 생성 (guides/PROJECT_DEVELOPMENT_POLICY.md) - DB 테이블 정책 (Hybrid EAV, options JSON) - 코드 컨벤션 (추측 금지 원칙) - Enum 지양 정책 (common_codes 테이블 활용) - Phase 진행 방식 및 세션/커밋 정책 - 견적 기능 개발 문서 생성 (projects/quotation/) - MASTER_PLAN.md: 4단계 개발 흐름 정의 - PROGRESS.md: 진행 현황 추적용
This commit is contained in:
193
projects/quotation/MASTER_PLAN.md
Normal file
193
projects/quotation/MASTER_PLAN.md
Normal file
@@ -0,0 +1,193 @@
|
||||
# 견적(Quotation) 기능 개발 마스터 플랜
|
||||
|
||||
> **목표:** 5130 레거시 견적 기능을 SAM 시스템(mng + api)으로 이관
|
||||
> **공통 정책:** [PROJECT_DEVELOPMENT_POLICY.md](../../guides/PROJECT_DEVELOPMENT_POLICY.md) 참조
|
||||
> **최종 업데이트:** 2025-12-19
|
||||
|
||||
---
|
||||
|
||||
## 📋 프로젝트 개요
|
||||
|
||||
### 개발 흐름
|
||||
|
||||
```
|
||||
Phase 1: 5130 견적 기능 분석
|
||||
↓
|
||||
Phase 2: mng 견적 수식 관리 분석
|
||||
↓
|
||||
Phase 3: mng 견적 기능 구현 (5130 수식 적용)
|
||||
↓
|
||||
Phase 4: 견적 API 개발
|
||||
```
|
||||
|
||||
### 핵심 원칙
|
||||
|
||||
1. **기존 테이블 활용**: 새 테이블 임의 생성 금지, 기존 prices/products 등 활용
|
||||
2. **5130 수식 정확 반영**: JS 파일 분석으로 모든 수식 누락 없이 이관
|
||||
3. **품목기준관리 연동**: SAM 품목 데이터 기반으로 견적 산출
|
||||
4. **단계별 문서화**: 세션 중단 시에도 이어서 작업 가능하도록 진행 상황 기록
|
||||
|
||||
---
|
||||
|
||||
## 📁 문서 구조
|
||||
|
||||
```
|
||||
docs/projects/quotation/
|
||||
├── MASTER_PLAN.md # 이 문서
|
||||
├── PROGRESS.md # 진행 현황
|
||||
├── phase-1-5130-analysis/ # 1단계: 5130 분석
|
||||
│ ├── README.md
|
||||
│ ├── ui-analysis.md
|
||||
│ ├── js-formulas.md # ⚠️ 핵심: 수식 분석
|
||||
│ ├── db-structure.md
|
||||
│ └── business-logic.md
|
||||
├── phase-2-mng-analysis/ # 2단계: mng 분석
|
||||
│ ├── README.md
|
||||
│ ├── current-state.md
|
||||
│ └── issues.md
|
||||
├── phase-3-implementation/ # 3단계: 구현
|
||||
│ ├── README.md
|
||||
│ ├── table-mapping.md
|
||||
│ ├── formula-spec.md
|
||||
│ └── implementation.md
|
||||
└── phase-4-api/ # 4단계: API 개발
|
||||
├── README.md
|
||||
└── api-spec.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Phase 상세
|
||||
|
||||
### Phase 1: 5130 견적 기능 분석
|
||||
|
||||
**목표:** 5130 레거시 견적 시스템 완전 분석 및 문서화
|
||||
|
||||
**분석 대상:**
|
||||
- https://5130.sam.kr/estimate/list.php
|
||||
- 관련 모든 PHP 파일
|
||||
- **⚠️ 핵심: 모든 JS 파일 (수식 분석)**
|
||||
|
||||
**산출물:**
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| README.md | 체크리스트 및 요약 |
|
||||
| ui-analysis.md | 화면별 기능 분석 |
|
||||
| js-formulas.md | JS 수식 전체 분석 (핵심!) |
|
||||
| db-structure.md | 테이블/컬럼 구조 |
|
||||
| business-logic.md | 비즈니스 로직 정리 |
|
||||
|
||||
**수식 분석 체크리스트:**
|
||||
```markdown
|
||||
각 수식 분석 시 필수 기록:
|
||||
- [ ] 수식 이름/ID
|
||||
- [ ] 입력 변수 목록
|
||||
- [ ] 계산 공식 (수학적 표기)
|
||||
- [ ] 출력 값 및 단위
|
||||
- [ ] 예외 처리 조건
|
||||
- [ ] 테스트 케이스 (입력 → 예상 출력)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: mng 견적 수식 관리 분석
|
||||
|
||||
**목표:** 현재 mng 견적 기능 상태 파악 및 문제점 도출
|
||||
|
||||
**분석 대상:**
|
||||
- https://mng.sam.kr/quote-formulas
|
||||
- 관련 Filament 리소스
|
||||
- 모델 및 마이그레이션
|
||||
|
||||
**산출물:**
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| README.md | 체크리스트 및 요약 |
|
||||
| current-state.md | 현재 구현 상태 |
|
||||
| issues.md | 오류/문제점 목록 |
|
||||
|
||||
**분석 포인트:**
|
||||
- 현재 수식 관리 기능 동작 여부
|
||||
- 오류 및 버그 목록
|
||||
- 5130과의 차이점
|
||||
- 개선 필요 사항
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: mng 견적 기능 구현
|
||||
|
||||
**목표:** 5130 수식을 SAM 품목기준관리와 연동하여 구현
|
||||
|
||||
**핵심 원칙:**
|
||||
- 5130 수식 정확히 반영
|
||||
- SAM 기존 테이블 활용
|
||||
- 품목기준관리 데이터 연동
|
||||
|
||||
**참조 문서:**
|
||||
- `docs/projects/mes/v1-analysis/quotation-analysis.md`
|
||||
- Phase 1 분석 결과 (js-formulas.md)
|
||||
- Phase 2 분석 결과
|
||||
|
||||
**산출물:**
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| README.md | 체크리스트 및 요약 |
|
||||
| table-mapping.md | 테이블 매핑 (5130 → SAM) |
|
||||
| formula-spec.md | 수식 명세 (SAM 버전) |
|
||||
| implementation.md | 구현 상세 |
|
||||
|
||||
---
|
||||
|
||||
### Phase 4: 견적 API 개발
|
||||
|
||||
**목표:** React 프론트엔드 연동을 위한 REST API 개발
|
||||
|
||||
**산출물:**
|
||||
| 파일 | 설명 |
|
||||
|------|------|
|
||||
| README.md | 체크리스트 및 요약 |
|
||||
| api-spec.md | API 명세 (Swagger) |
|
||||
|
||||
**API 개발 원칙:**
|
||||
- SAM API Rules 준수
|
||||
- Swagger 문서화 필수
|
||||
- Multi-tenant 지원
|
||||
- FormRequest 검증
|
||||
|
||||
---
|
||||
|
||||
## 🔗 참조 문서
|
||||
|
||||
### 공통 정책 (필독)
|
||||
- [PROJECT_DEVELOPMENT_POLICY.md](../../guides/PROJECT_DEVELOPMENT_POLICY.md) - **DB 정책, 기술 스택, 코드 컨벤션, Phase 진행 방식**
|
||||
|
||||
### 견적 관련
|
||||
- [docs/projects/mes/v1-analysis/quotation-analysis.md](../mes/v1-analysis/quotation-analysis.md) - MES 견적 분석
|
||||
- [PROGRESS.md](./PROGRESS.md) - 진행 현황
|
||||
|
||||
---
|
||||
|
||||
## 🚀 시작 명령어 예시
|
||||
|
||||
```
|
||||
견적 기능 개발 Phase 1 시작:
|
||||
|
||||
1. 공통 정책 확인: docs/guides/PROJECT_DEVELOPMENT_POLICY.md
|
||||
2. PROGRESS.md 확인
|
||||
3. 5130 견적 페이지 분석 시작
|
||||
- https://5130.sam.kr/estimate/list.php
|
||||
- 관련 JS 파일 전체 분석
|
||||
4. phase-1-5130-analysis/ 문서 작성
|
||||
|
||||
MCP: Sequential Thinking 적용
|
||||
페르소나: root-cause-analyst (분석 단계)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 변경 이력
|
||||
|
||||
| 날짜 | 변경 내용 | 작성자 |
|
||||
|------|----------|--------|
|
||||
| 2025-12-19 | 공통 정책 분리, 견적 특화 내용만 유지 | Claude |
|
||||
| 2025-12-19 | 초기 마스터 플랜 작성 | Claude |
|
||||
129
projects/quotation/PROGRESS.md
Normal file
129
projects/quotation/PROGRESS.md
Normal file
@@ -0,0 +1,129 @@
|
||||
# 견적 기능 개발 진행 현황
|
||||
|
||||
> **마스터 플랜:** [MASTER_PLAN.md](./MASTER_PLAN.md)
|
||||
> **공통 정책:** [PROJECT_DEVELOPMENT_POLICY.md](../../guides/PROJECT_DEVELOPMENT_POLICY.md)
|
||||
> **최종 업데이트:** 2025-12-19
|
||||
|
||||
---
|
||||
|
||||
## 📊 전체 진행률
|
||||
|
||||
| Phase | 상태 | 진행률 | 시작일 | 완료일 |
|
||||
|-------|------|--------|--------|--------|
|
||||
| Phase 1: 5130 분석 | ⏳ 대기 | 0% | - | - |
|
||||
| Phase 2: mng 분석 | ⏳ 대기 | 0% | - | - |
|
||||
| Phase 3: 구현 | ⏳ 대기 | 0% | - | - |
|
||||
| Phase 4: API 개발 | ⏳ 대기 | 0% | - | - |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 현재 작업
|
||||
|
||||
**현재 Phase:** 시작 전
|
||||
**현재 작업:** 마스터 플랜 작성 완료
|
||||
|
||||
---
|
||||
|
||||
## 📋 Phase 1: 5130 견적 기능 분석
|
||||
|
||||
### 체크리스트
|
||||
- [ ] UI/화면 분석 (list.php, form.php 등)
|
||||
- [ ] JS 수식 분석 (모든 JS 파일)
|
||||
- [ ] DB 구조 분석
|
||||
- [ ] 비즈니스 로직 문서화
|
||||
- [ ] README.md 작성
|
||||
|
||||
### 산출물
|
||||
- [ ] phase-1-5130-analysis/README.md
|
||||
- [ ] phase-1-5130-analysis/ui-analysis.md
|
||||
- [ ] phase-1-5130-analysis/js-formulas.md
|
||||
- [ ] phase-1-5130-analysis/db-structure.md
|
||||
- [ ] phase-1-5130-analysis/business-logic.md
|
||||
|
||||
### 메모
|
||||
_Phase 1 진행 시 메모 기록_
|
||||
|
||||
---
|
||||
|
||||
## 📋 Phase 2: mng 견적 수식 관리 분석
|
||||
|
||||
### 체크리스트
|
||||
- [ ] 현재 구현 상태 분석
|
||||
- [ ] 오류/문제점 목록화
|
||||
- [ ] 개선 방향 도출
|
||||
- [ ] README.md 작성
|
||||
|
||||
### 산출물
|
||||
- [ ] phase-2-mng-analysis/README.md
|
||||
- [ ] phase-2-mng-analysis/current-state.md
|
||||
- [ ] phase-2-mng-analysis/issues.md
|
||||
|
||||
### 메모
|
||||
_Phase 2 진행 시 메모 기록_
|
||||
|
||||
---
|
||||
|
||||
## 📋 Phase 3: mng 견적 기능 구현
|
||||
|
||||
### 체크리스트
|
||||
- [ ] 테이블 매핑 (5130 → SAM)
|
||||
- [ ] 수식 명세 작성
|
||||
- [ ] UI 구현 (Livewire + Blade)
|
||||
- [ ] 테스트 및 검증
|
||||
- [ ] README.md 작성
|
||||
|
||||
### 산출물
|
||||
- [ ] phase-3-implementation/README.md
|
||||
- [ ] phase-3-implementation/table-mapping.md
|
||||
- [ ] phase-3-implementation/formula-spec.md
|
||||
- [ ] phase-3-implementation/implementation.md
|
||||
|
||||
### 메모
|
||||
_Phase 3 진행 시 메모 기록_
|
||||
|
||||
---
|
||||
|
||||
## 📋 Phase 4: 견적 API 개발
|
||||
|
||||
### 체크리스트
|
||||
- [ ] API 엔드포인트 설계
|
||||
- [ ] Swagger 문서화
|
||||
- [ ] React 연동 스펙
|
||||
- [ ] README.md 작성
|
||||
|
||||
### 산출물
|
||||
- [ ] phase-4-api/README.md
|
||||
- [ ] phase-4-api/api-spec.md
|
||||
|
||||
### 메모
|
||||
_Phase 4 진행 시 메모 기록_
|
||||
|
||||
---
|
||||
|
||||
## 🏷️ Git 태그
|
||||
|
||||
| 태그 | 설명 | 생성일 |
|
||||
|------|------|--------|
|
||||
| - | - | - |
|
||||
|
||||
---
|
||||
|
||||
## 📝 정책 결정 기록
|
||||
|
||||
| 날짜 | 항목 | 결정 내용 | 근거 |
|
||||
|------|------|----------|------|
|
||||
| 2025-12-19 | DB 작업 위치 | api 프로젝트에서만 | mng 마이그레이션 방지 |
|
||||
| 2025-12-19 | 신규 테이블 정책 | options JSON 적용 | Hybrid EAV 전략 |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 이슈/블로커
|
||||
|
||||
_현재 이슈 없음_
|
||||
|
||||
---
|
||||
|
||||
## 📚 참조 문서
|
||||
|
||||
- [MASTER_PLAN.md](./MASTER_PLAN.md) - 마스터 플랜
|
||||
- [docs/projects/mes/v1-analysis/quotation-analysis.md](../mes/v1-analysis/quotation-analysis.md) - MES 견적 분석
|
||||
Reference in New Issue
Block a user