diff --git a/JH_ERP/04_ERP_개발단계_목차.md b/JH_ERP/04_ERP_개발단계_목차.md new file mode 100644 index 0000000..f6927f3 --- /dev/null +++ b/JH_ERP/04_ERP_개발단계_목차.md @@ -0,0 +1,115 @@ +# ERP 고도화 개발 로드맵 - 단계별 개발 목차 Report + +본 보고서는 장헌공장 ERP 고도화 프로젝트의 개발 진행을 위한 핵심 단계 및 세부 단계를 목차 형태로 구조화한 개발 로드맵 가이드라인입니다. +*모든 설계 요소는 영문 모델명과 한글명을 병기하여 통일성을 유지하고, 외부 솔루션 규격 등 정책 미확정 사항은 "확인 필요"로 명시하였습니다.* + +--- + +## [Phase 1] 1단계: 공장 운영 ERP Core 구축 (생산/출하/기성/원가) +공장의 일상 운영 흐름을 유기적으로 연계하고 핵심 데이터를 확보하기 위한 필수 선행 구축 단계입니다. + +### 1. 기준정보 및 조직·권한 체계 구축 +* **1.1. 조직 및 사용자 마스터 구현** + * `Company(법인)`-`Factory(공장)`-`Department(부서)`-`Team(팀)`-`Member(사용자)` 테이블 및 관계 DDL 수립 + * 다중 공장(Multi-Factory) 자원 관리 구조 설계 +* **1.2. 비즈니스 파운데이션 계층 구조 모델링** + * `Project(프로젝트)`-`Bridge(교량)`-`BridgeAlias(교량별칭)` 마스터 데이터베이스 구축 + * 견적교량코드(임시)와 공식사업코드(실제)의 이원화 구조 매핑 +* **1.3. 작업 제약 룰 설계** + * `WorkTask(업무마스터)` 및 `FormType(형식마스터)` 테이블 생성 + * 팀별로 입력 가능한 업무와 형식을 제한하는 `TeamWorkFormRule(팀별 입력규칙)` 검증 엔진 구현 +* **1.4. 권한 및 접근 제어 설계** + * `Role(역할)`-`Permission(권한)`-`RolePermission(역할권한매핑)` 테이블 및 기능 권한 스키마 설계 + * 사용자별 데이터 조회 권한 제어를 위한 `data_scope(데이터조회범위)` 속성 정의 + +### 2. 생산계획 및 터치스크린 작업일보 구현 +* **2.1. 생산계획 및 엑셀 업로드 아키텍처** + * `ProductionPlan(생산계획헤더)` 및 `ProductionPlanLine(생산계획상세라인)` 구조 설계 + * `UploadTemplate(업로드양식)` 및 `UploadTemplateField(업로드필드)` 기반의 동적 엑셀 업로드 파서 개발 +* **2.2. 터치스크린용 작업일보 입력 UI** + * 대형 터치스크린 단말기 대응 반응형 프론트엔드 레이아웃 설계 + * 팀 선택 -> 작업자 카드 선택 -> 상세 입력(교량, 업무, 형식, 시간(분)) 흐름 구현 +* **2.3. 작업 복사 및 일용직 관리 로직** + * 작업추가(`NEW`), 작업복사(`COPY`), 전일작업복사(`PREV_WORK`, 가장 가까운 날짜 기준) 기능 개발 + * `DailyWorker(일용직작업자)` 동적 생성 및 일용직 복사/전일복사(복수선택) 팝업 처리 +* **2.4. 생산실적 확정 및 검증** + * `DailyWorkProduction(작업일보생산량)` 입력 팝업 및 설계수량 대비 초과생산 방지(`BR-013`) 로직 구현 + * `ProductionResult(생산실적)` 및 `ProductionUnit(생산품단위)` 데이터 생성 로직 구현 (물리 삭제 금지, `status` 관리) + * *BOM 기반 자재 소모 자동 차감은 제외 (1단계 범위 제외)* + +### 3. QR코드/LOT 발행 및 야적·출하 연계 +* **3.1. QR Master 및 생산 일련번호 생성** + * `QRMaster(QR마스터)` (교량+생산항목+차수 기준) 및 `ProductionUnit` (QR마스터+SerialNumber) 분리 채번 로직 개발 + * QR 출력 이력 및 출력 횟수(`print_count`) 관리 +* **3.2. 야적재고 관리** + * `YardStock(야적재고)` 테이블 및 구역(`yard_zone`), 좌표(`coordinate_x`, `coordinate_y`) 데이터 구조화 + * 생산품단위(`ProductionUnit`)의 상태 변경(`PROD` -> `YARD`)과 야적 위치 매핑 +* **3.3. 출하 실행 연계** + * `Shipment(출하)` 및 `ShipmentItem(출하상세)` 설계 + * 발주처 출하 요청 수신 시, 생산품단위 상태 전이(`YARD` -> `SHIP`) 및 출하이력(`ShipmentHistory`) 기록 + +### 4. 생산 손익 및 원가 배분 Rule Engine 구축 +* **4.1. 기성청구 및 세금계산서 이중 도메인 설계** + * `ProgressClaim(기성청구)` 및 `ProgressClaimItem(기성청구상세)` 설계 (생산완료 기성 청구금액 기준) + * `TaxInvoice(세금계산서)` 테이블 설계 (회계 매출 기준) + * N:M 관계를 처리하기 위한 `ClaimInvoiceMapping(기성계산서매핑)` 매커니즘 구현 +* **4.2. 원가배분 Rule Engine(룰 배분 엔진) 구현** + * `ExpenseCategory(원가대분류)` (노무비, 자재비, 외주비 등) 및 `CostAccount(세부계정)` 관리 + * 팀별 배분 기준(제작팀: 생산량/시간, 철근팀: TON, 공무팀: 시수)을 가변 적용하는 Rule Engine 구현 +* **4.3. 임시/실비정산 처리** + * 계약 체결 전 긴급 요청 및 납품 처리를 위한 `TemporarySettlement(임시정산)` 구현 + * 추후 정식 계약 확정 시, 기존 임시 정산 건을 신규 교량 계약 및 기성 내역으로 자동 전환하는 Link(연결) 로직 개발 +* **4.4. 순차 마감 제어 아키텍처** + * `ClosingPeriod(마감기간)` 테이블 설계 + * 생산마감 -> 원가마감 -> 기성마감 -> 매출마감 -> 손익마감 체인 흐름 검증 규칙 및 마감 락(Lock) 구현 +* **4.5. 경영 Dashboard 및 스냅샷 집계** + * `ProfitSummary(손익집계)` 및 `DashboardSnapshot(대시보드스냅샷)` 테이블 스키마 설계 + * 월별/프로젝트별/교량별/형식별 생산 손익 및 회계 매출 KPI 집계 배치(`BATCH_DAILY_KPI`) 구축 + +--- + +## [Phase 2] 2단계: 플랫폼 고도화 및 인프라 연동 (전자결재/회계/API) +시스템의 안정성을 높이고 부가 기능을 확장하며 외부 시스템과의 데이터 연동을 강화하는 단계입니다. + +### 5. ERP 내재형 전자결재(Approval) 구현 +* **5.1. 결재 프로세스 엔진** + * `ApprovalRequest(결재요청)`, `ApprovalLine(결재선)` 테이블 구현 + * 승인, 반려, 재상신 기능 및 결재 프로세스 상태값 추적 +* **5.2. 비즈니스 상태 Machine(상태 머신) 연동** + * 최종 결재 승인(`APPROVED`) 시, 대상 비즈니스 테이블(출하, 기성, 마감해제 등)의 상태를 자동으로 업데이트하는 트리거 연동 + * *전결 규정에 따른 자동 결재선 추천 로직 구체화 (추후 의사결정 필요)* + +### 6. 외부 상용 회계 솔루션 연동 (더존 등) +* **6.1. 비동기 인터페이스 설계** + * `IntegrationQueue(연동큐)` 테이블 및 연동 처리 상태(`QUEUE_STATUS`: READY/PROCESSING/SUCCESS/FAILED) 구현 + * 전송 실패 시 자동 재시도(`BATCH_QUEUE_RETRY`) 및 알림 발송 아키텍처 수립 +* **6.2. 전표 수준 실시간 연동 인터페이스 개발** + * 기성 확정 및 세금계산서 발행 시, 분개 처리 정보를 수집하여 상용 회계 시스템 API 규격에 맞춰 전송하는 커넥터 개발 + * *연동 대상 상용 ERP 솔루션의 API 스펙 확보 및 접속 권한 획득 여부 (확인 필요)* + +### 7. API 오픈플랫폼 및 모니터링 체계 구축 +* **7.1. API Gateway 및 JWT 보안 강화** + * API Gateway 라우팅 설정 및 JWT 토큰 기반 인증/인가 세부 튜닝 + * 암호화 통신(HTTPS) 및 API 토큰 만료 주기 정책 구현 +* **7.2. 시스템 감시 및 헬스 체크** + * `MonitoringEvent(모니터링이벤트)` 수집기 및 서버/DB 상태 감시 데몬 구동 + * 배치 수행 및 API 에러 감지 시 관리자 Slack/SMS 알림 발송 구현 + +--- + +## [Phase 3] 3단계: 장기 고도화 및 확장 (AI/자체회계) +장기적인 플랫폼 독립성 확보 및 데이터 지능화를 추진하는 최종 고도화 단계입니다. + +### 8. 자체 회계 핵심엔진(Accounting Core) 개발 (장기 프로젝트) +* **8.1. 계정 마스터 및 전표 자체 관리** + * `GeneralLedger(총계정원장)` 및 전표 자체 입력/관리 기능 개발 + * 지급 처리, 수금 관리 등의 자금 흐름 ERP 내재화 +* **8.2. 결산 및 재무제표 자체 출력** + * 대차대조표, 손익계산서, 시산표 자동 계산 및 리포팅 엔진 탑재 + * *장기 자체화 프로젝트 전환 승인 및 리소스 확보 여부 (확인 필요)* + +### 9. AI 예측 분석 및 스마트 팩토리 확장 +* **9.1. AI 분석 모델 탑재** + * 생산 실적 및 투입 원가 이력 데이터를 학습하여 생산 지연 예측, 적정 출하 가능량 예측, 원가 초과 리스크 예측 모델 적용 +* **9.2. IoT/MES 설비 연동** + * 공장 내 생산 설비(철근 절단기 등) 및 RFID 리더기와의 API 연동을 통한 실적 자동 수집 체계 구축