Files

hskwon 08a8259313 docs: 5130 레거시 분석 문서 및 기존 문서 초기 커밋

- 5130 레거시 시스템 분석 (00_OVERVIEW ~ 08_SAM_COMPARISON)
- MES 프로젝트 문서
- API/프론트엔드 스펙 문서
- 가이드 및 레퍼런스 문서

2025-12-04 18:47:19 +09:00

12 KiB

Raw Blame History

SAM 12월 완료 로드맵

작성일: 2025-11-18 목표: 2025년 12월 31일까지 SAM 백엔드 핵심 기능 개발 완료 기간: 6주 (2025-11-18 ~ 2025-12-31)

📊 현재 진행 상황 (2025-11-18 기준)

✅ 완료된 항목 (약 70%)

1. API 공통 기반 ✅

Exception Handler (Handler.php)
Swagger 설정 (l5-swagger v1)
API Key 인증 (ApiKeyMiddleware)
Rate Limit (ApiRateLimiter)
CORS 처리 (CorsMiddleware)
권한 체크 (CheckPermission)

2. 인증/보안 ✅

API Key 모델 및 인증
Role-Permission 시스템
멀티테넌트 권한 구조
권한 오버라이드 시스템

3. 테넌트 관리 ✅

BelongsToTenant 글로벌 스코프
TenantBootstrap 서비스
테넌트 컨텍스트 주입
테넌트 옵션/설정 관리

4. 기준정보/코드 관리 ✅

Category (3단계 트리)
CategoryField (동적 필드)
CategoryTemplate (템플릿)
Classification (공통 코드)
CommonCode 관리

5. 제품/부품/자재 도메인 ✅

Product 모델 (67개 모델)
Part 관리
Material 관리
ProductComponent (BOM 연결)
PriceHistory (단가 이력)

6. BOM (Bill of Materials) ✅

BomTemplate 관리
BomTemplateItem CRUD
BomCalculationService (가격 계산)
ModelVersion (버전 관리)
재귀 BOM 구조

7. 영업 흐름 ✅

Estimate (견적) - 기본 CRUD
EstimateItem (견적 라인)
Order (수주) - 5개 모델
OrderItem, OrderHistory
OrderItemComponent

8. 자재입고/수입검사 ✅

MaterialReceipt (자재입고)
MaterialInspection (수입검사)
MaterialInspectionItem (검사 항목)

9. 파일/로그 시스템 ✅

FileService, FileStorageService
AuditLogger, AuditLogService
File 모델 (Polymorphic)

10. Admin 패널 (Filament) ✅

27개 Resources 구현
Product, BOM, Material
Category, Role, Permission
Department, User, Tenant
Client, File 관리

11. Services 계층 ✅

56개 Service 클래스
Service-First 아키텍처
Design, Estimate, Pricing
Authz, Audit, Calculation

12. Controllers ✅

42개 API Controllers
RESTful 구조
FormRequest 검증
ApiResponse 표준 응답

❌ 미완료 항목 (약 30%)

1. 공정/생산 계획 (Priority: HIGH)

Process Routing (공정 라우팅)
Work Order (작업지시)
Production Record (생산실적)
Process Checksheet (공정 체크시트)

2. 단가/원가 체계 (Priority: HIGH)

단가 정책 로직 (공장별/중량/치수 기반)
원가 계산 서비스 (제품별, BOM 기반)
견적-수주 단가 연결 테이블
PricingEngine 고도화

3. 견적서 출력 (Priority: MEDIUM)

견적서 HTML 템플릿
PDF 생성 (DomPDF/Snappy)
견적서 미리보기 API
견적서 다운로드

4. 재고/자재 관리 (Priority: HIGH)

입출고 트랜잭션 설계
재고 집계 API (제품/부품/자재별)
LOT 관리 확장
시리얼 관리

5. 창고/위치 관리 (Priority: MEDIUM)

Warehouse (창고) 모델
Location (위치) 모델
창고-위치 계층 구조
재고-위치 연결

6. 파일 시스템 완성 (Priority: MEDIUM)

파일 Upload API 개발
썸네일/리사이징 서비스
파일 접근 권한 (Security Layer)
파일 삭제 정책 구현

7. 알림 시스템 (Priority: LOW)

이메일 발송 서비스
카카오 메시지 연동
시스템 이벤트 기반 알림 규칙
알림 템플릿 관리

8. 테넌트 초기화 (Priority: MEDIUM)

테넌트 초기 데이터 생성 API
샘플 데이터 생성 스크립트
온보딩 자동화

9. 배포/운영 (Priority: HIGH)

배포 스크립트 (Docker Compose)
staging/production 서버 구성
백업 정책
로그/모니터링 대시보드

10. 프론트엔드 (React) (Priority: MEDIUM)

Admin 공통 레이아웃 최종 정리
기준정보 관리 UI
제품/부품/BOM 트리 UI
견적/수주 화면
재고관리 UI

📅 주차별 로드맵

Week 1: 2025-11-18 ~ 2025-11-24 (공정/단가 체계)

목표: 공정 관리 및 단가 계산 로직 완성

API 개발

Process Routing 모델 및 마이그레이션
WorkOrder 모델 및 마이그레이션
ProductionRecord 모델
ProcessRoutingService 구현
WorkOrderService 구현
단가 정책 로직 구현 (PricingEngine)
원가 계산 서비스 (CostCalculationService)

Admin 패널

ProcessRoutingResource
WorkOrderResource
ProductionRecordResource

Swagger

Process API 문서
WorkOrder API 문서
Pricing API 문서

완료 기준:

공정 라우팅 CRUD 완료
작업지시 생성/조회 완료
단가 계산 로직 테스트 통과

Week 2: 2025-11-25 ~ 2025-12-01 (견적서 출력 + 재고)

목표: 견적서 PDF 생성 및 재고 트랜잭션 구현

API 개발

EstimateTemplate 모델
EstimatePrintService (PDF 생성)
InventoryTransaction 모델
StockMovement 모델
InventoryService 구현
재고 집계 API

Admin 패널

견적서 미리보기 UI
견적서 PDF 다운로드
재고 현황 대시보드

Swagger

Estimate Print API 문서
Inventory API 문서

완료 기준:

견적서 PDF 생성 성공
입출고 트랜잭션 기록 완료
재고 집계 조회 API 완료

Week 3: 2025-12-02 ~ 2025-12-08 (창고/파일/알림)

목표: 창고 관리, 파일 시스템, 알림 시스템 완성

API 개발

Warehouse 모델
Location 모델
WarehouseService 구현
FileUploadService 고도화
FileThumbnailService (이미지 리사이징)
NotificationService 구현
EmailService 구현
KakaoMessageService 연동

Admin 패널

WarehouseResource
LocationResource
파일 업로드 UI 개선
알림 설정 UI

Swagger

Warehouse API 문서
File Upload API 문서
Notification API 문서

완료 기준:

창고/위치 CRUD 완료
파일 업로드 및 썸네일 생성 완료
이메일/카카오 알림 발송 성공

Week 4: 2025-12-09 ~ 2025-12-15 (Admin UI + 테스트)

목표: Admin 패널 UI 완성 및 API 테스트

Admin 패널

공통 레이아웃 최종 정리
대시보드 위젯 구현
제품/BOM 트리 뷰 개선
견적/수주 화면 완성
재고관리 UI 완성
작업지시 UI 완성

테스트

PHPUnit 테스트 케이스 작성
API 통합 테스트
Postman 컬렉션 업데이트
Swagger 문서 최종 검토

품질 체크

Pint 코드 포맷팅 전체 적용
코드 리뷰 (Service-First, FormRequest)
i18n 메시지 키 정리

완료 기준:

Admin 패널 모든 화면 완성
핵심 API 테스트 통과율 80% 이상
Swagger 문서 100% 완성

Week 5: 2025-12-16 ~ 2025-12-22 (통합 테스트 + 버그 수정)

목표: 전체 시스템 통합 테스트 및 버그 수정

통합 테스트

견적 → 수주 → 생산 → 재고 흐름 테스트
멀티테넌트 격리 검증
권한 시스템 전체 테스트
파일 업로드/다운로드 테스트
알림 발송 테스트

버그 수정

Critical 버그 0건
High 버그 수정
Medium 버그 트리아지

성능 최적화

느린 쿼리 최적화 (N+1 문제)
API 응답 속도 개선
인덱스 최적화

완료 기준:

전체 시나리오 테스트 통과
Critical/High 버그 0건
API 평균 응답 속도 < 500ms

Week 6: 2025-12-23 ~ 2025-12-31 (배포 준비 + 문서화)

목표: 프로덕션 배포 준비 및 문서화 완성

배포 준비

Docker Compose 최종 검증
환경변수 설정 가이드
데이터베이스 마이그레이션 순서 확정
백업/복구 절차 수립
로그/모니터링 대시보드 구축

문서화

API 문서 최종 검토 (Swagger)
관리자 매뉴얼 작성
개발자 가이드 업데이트
배포 가이드 작성
트러블슈팅 가이드

보안 점검

OWASP Top 10 체크
API Key 보안 검토
SQL Injection 방어 확인
XSS 방어 확인
CSRF 토큰 검증

런칭 준비

테넌트 온보딩 자동화
샘플 데이터 생성 스크립트
데모 시나리오 (PPT + 녹화)
SLA/장애 대응 문서

완료 기준:

프로덕션 배포 체크리스트 100% 완료
모든 문서 작성 완료
보안 점검 통과

🎯 핵심 성공 지표 (KPI)

기술 지표

API 엔드포인트 100개 이상
Swagger 문서 100% 완성
테스트 커버리지 60% 이상
API 평균 응답 속도 < 500ms
Critical/High 버그 0건

기능 지표

견적 → 수주 → 생산 → 재고 흐름 완성
Admin 패널 30개 이상 Resources
멀티테넌트 격리 100% 검증
파일 업로드/다운로드 안정성 99%
알림 발송 성공률 95% 이상

품질 지표

Service-First 아키텍처 100% 준수
FormRequest 검증 100% 적용
i18n 메시지 키 100% 적용
BelongsToTenant 스코프 100% 적용
Pint 코드 포맷팅 100% 통과

⚠️ 리스크 관리

High Risk

리스크	영향도	완화 방안
단가 계산 로직 복잡도	High	Week 1에 집중, 전문가 리뷰
재고 트랜잭션 동시성	High	Lock 전략 수립, 테스트 강화
PDF 생성 성능	Medium	비동기 큐 처리, 캐싱

Medium Risk

리스크	영향도	완화 방안
Admin UI 완성도	Medium	Week 4 전담, 우선순위 선정
알림 시스템 안정성	Medium	외부 API 장애 처리
통합 테스트 시간 부족	Medium	자동화 테스트 확대

Low Risk

리스크	영향도	완화 방안
문서화 누락	Low	주차별 문서 작성 병행
코드 품질 저하	Low	Pint + Code Review

🚀 다음 단계 (2026년 1월~)

Phase 2: 프론트엔드 고도화

React Admin 패널 완전 재구축
사용자 포털 (고객 견적 요청)
모바일 대응
실시간 대시보드

Phase 3: 고급 기능

실시간 생산 모니터링
IoT 센서 연동
AI 기반 수요 예측
재고 최적화 알고리즘

Phase 4: 확장

다국어 지원 확대
글로벌 테넌트 지원
API 버전 2.0
마이크로서비스 전환 검토

📝 작업 추적

진행 상황 업데이트

매일: CURRENT_WORKS.md 업데이트
매주: 주차별 로드맵 진행률 체크
매 2주: 전체 로드맵 리뷰 및 조정

커밋 규칙

feat: 새로운 기능 추가
fix: 버그 수정
chore: 빌드, 설정 변경
refactor: 코드 리팩토링
docs: 문서 업데이트
test: 테스트 추가/수정

📞 담당자 및 연락처

역할	담당자	비고
프로젝트 리드	-	-
백엔드 개발	Claude Code	API/Admin
프론트엔드 개발	-	React
QA	-	테스트
DevOps	-	배포/운영

작성: Claude Code 최종 업데이트: 2025-11-18 다음 리뷰: 2025-11-25 (Week 2 시작 전)

12 KiB Raw Blame History

SAM 12월 완료 로드맵

📊 현재 진행 상황 (2025-11-18 기준)

✅ 완료된 항목 (약 70%)

1. API 공통 기반 ✅

2. 인증/보안 ✅

3. 테넌트 관리 ✅

4. 기준정보/코드 관리 ✅

5. 제품/부품/자재 도메인 ✅

6. BOM (Bill of Materials) ✅

7. 영업 흐름 ✅

8. 자재입고/수입검사 ✅

9. 파일/로그 시스템 ✅

10. Admin 패널 (Filament) ✅

11. Services 계층 ✅

12. Controllers ✅

❌ 미완료 항목 (약 30%)

1. 공정/생산 계획 (Priority: HIGH)

2. 단가/원가 체계 (Priority: HIGH)

3. 견적서 출력 (Priority: MEDIUM)

4. 재고/자재 관리 (Priority: HIGH)

5. 창고/위치 관리 (Priority: MEDIUM)

6. 파일 시스템 완성 (Priority: MEDIUM)

7. 알림 시스템 (Priority: LOW)

8. 테넌트 초기화 (Priority: MEDIUM)

9. 배포/운영 (Priority: HIGH)

10. 프론트엔드 (React) (Priority: MEDIUM)

📅 주차별 로드맵

Week 1: 2025-11-18 ~ 2025-11-24 (공정/단가 체계)

API 개발

Admin 패널

Swagger

Week 2: 2025-11-25 ~ 2025-12-01 (견적서 출력 + 재고)

API 개발

Admin 패널

Swagger

Week 3: 2025-12-02 ~ 2025-12-08 (창고/파일/알림)

API 개발

Admin 패널

Swagger

Week 4: 2025-12-09 ~ 2025-12-15 (Admin UI + 테스트)

Admin 패널

테스트

품질 체크

Week 5: 2025-12-16 ~ 2025-12-22 (통합 테스트 + 버그 수정)

통합 테스트

버그 수정

성능 최적화

Week 6: 2025-12-23 ~ 2025-12-31 (배포 준비 + 문서화)

배포 준비

문서화

보안 점검

런칭 준비

🎯 핵심 성공 지표 (KPI)

기술 지표

기능 지표

품질 지표

⚠️ 리스크 관리

High Risk

Medium Risk

Low Risk

🚀 다음 단계 (2026년 1월~)

Phase 2: 프론트엔드 고도화

Phase 3: 고급 기능

Phase 4: 확장

📝 작업 추적

진행 상황 업데이트

커밋 규칙

📞 담당자 및 연락처

12 KiB

Raw Blame History