Files
sam-docs/dev/guides/project-launch-roadmap.md
권혁성 db63fcff85 refactor: [docs] 팀별 폴더 구조 재편 (공유/개발/프론트/기획)
- 개발팀 전용 폴더 dev/ 생성 (standards, guides, quickstart, changes, deploys, data, history, dev_plans 이동)
- 프론트엔드 전용 폴더 frontend/ 생성 (api/ → frontend/api-specs/)
- 기획팀 폴더 requests/ 생성
- plans/ → dev/dev_plans/ 이름 변경
- README.md 신규 (사람용 안내), INDEX.md 재작성 (Claude Code용)
- resources.md 신규 (노션 링크용, assets/brochure 이관 예정)
- CURRENT_WORKS.md 삭제, TODO.md → dev/ 이동
- 전체 참조 경로 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 16:46:03 +09:00

22 KiB

SAM 프로젝트 런칭 로드맵

작성일: 2025-11-24 최종 수정: 2025-12-02 목적: 프로젝트 전체 방향성 관리 및 런칭 준비 현황 추적 대상: 프로젝트 관리 및 의사결정용


1. 프로젝트 현황 개요

전체 시스템 구성

SAM (Smart Application Management)
├── api/        - Laravel 12 REST API (독립 모델)
├── mng/        - Plain Laravel 관리자 패널 (독립 모델, 운영 주력)
├── react/      - Next.js 15 사용자 프론트엔드
├── docs/       - 기술 문서
├── design/     - 디자인 시스템 (Storybook)
├── planning/   - 기획 문서
└── docker/     - Docker 개발 환경

프로젝트 구분

구분 대상 설명 담당
MES (경동기업) 경동기업 메인 프로젝트, 디자인 시스템 기준 디자이너 (기획+디자인)
MES (주일기업) 주일기업 경동기업 디자인 기반 커스터마이징 기획자
ERP SAM 공통 공통 모듈 (인사, 회계, 결재 등) 기획자

MVP 범위 정의

구분 범위 설명
코어 MVP MES 핵심 기능 견적 → 수주 → 생산 → 출하 흐름
1차 MVP 코어 MVP + 추가 기능 품질, 자재, 단가, 회계 등 확장

각 시스템 역할

  • api: 모든 비즈니스 로직과 데이터 처리의 중심
  • mng: Pure Blade + Tailwind 관리자 패널 (운영 환경 주력)
  • react: 최종 사용자용 인터페이스
  • design: 디자인 시스템 및 컴포넌트 문서

현재 개발 완료율

  • 백엔드 (API): 약 70% 완료

    • 인증/권한, 멀티테넌트, 기준정보
    • 제품/BOM, 견적/수주, 자재입고/검사
    • 🔄 공정/생산, 단가/원가, 재고관리
  • 프론트엔드: 약 50% 완료

    • Admin 패널 27개 Resources
    • 🔄 React 사용자 포털 개발 중

2. 팀 구성 및 역할

팀 역할 분담

역할 담당자 주요 업무 비고
디자이너 재웅 정 MES(경동기업) 기획 + 디자인 디자인 시스템 기준
기획자 이태화 ERP 스토리보드, MES(주일기업) 기획, 운영, QA 기획 완료 시 MES 합류
Frontend - React 개발 MES(경동) 우선
Backend hso be API 서포트, mng 개발, 인프라, 정책/운영 전체 기술 지원

작업 우선순위

Frontend 우선순위:

  1. MES (경동기업) - 디자이너 결과물 즉시 개발
  2. ERP + MES (주일기업) - MES 짬/대기 시 병행

Backend 역할:

  • Frontend API 서포트
  • mng (운영 관리자 패널) 개발
  • 인프라 셋팅
  • 정책/운영 관련 일정 체크

3. 주요 마일스톤 개요

📅 마일스톤 타임라인

2025년 12월           2026년 1월           2026년 2월           2026년 3월
    |                     |                     |                     |
   MS1                   MS2                   MS3                   MS4
코어 MVP 완료        1차 MVP + 베타        정식 런칭            안정화 완료
(단위테스트)         (통합테스트)

마일스톤 요약

마일스톤 목표 기한 주요 내용
MS1 코어 MVP 개발 완료 2025-12-31 MES 핵심 기능 + 단위테스트
MS2 1차 MVP + 베타 오픈 2026-01-31 통합테스트 + 베타 서비스 오픈
MS3 정식 런칭 2026-02-28 운영 서버 오픈
MS4 안정화 완료 2026-03-31 고객 성공 사례 확보

4. 기획 및 디자인 일정

4.1 MES (경동기업) - 디자이너 일정

기간: 2025-11-26 ~ 2025-12-26 (약 21일)

Phase 1: 견적 (11/27 ~ 11/28)

화면ID 화면명 유형 공수 시작일 종료일
S2 견적 리스트 LIST 0.25 11-27(목) 11-27(목)
S2-1 견적 등록 FORM 0.5 11-27(목) 11-27(목)
S2-2 견적 수정 FORM 0.25 11-27(목) 11-28(금)
S2-3 견적 상세+탭 DETAIL 0.5 11-28(금) 11-28(금)
S2-4 견적서 출력 PRINT 0.25 11-28(금) 11-28(금)

Phase 2: 기준-수식 (11/28 ~ 12/01)

화면ID 화면명 유형 공수 시작일 종료일
M12 견적수식 리스트 LIST 0.1 11-28(금) 11-28(금)
M12-1 견적수식 등록 FORM 0.2 12-01(월) 12-01(월)

Phase 3: 수주 (12/01 ~ 12/04)

화면ID 화면명 유형 공수 시작일 종료일
S3-1 수주 리스트 LIST 0.25 12-01(월) 12-01(월)
S3-2 수주 등록 FORM 0.5 12-01(월) 12-02(화)
S4-3 수주 수정 FORM 1 12-02(화) 12-03(수)
S4-4 수주 상세+탭 DETAIL 1 12-03(수) 12-04(목)
S4-5 수주서 발송 PRINT 0.5 12-04(목) 12-04(목)

Phase 4: 생산 (12/04 ~ 12/08)

화면ID 화면명 유형 공수 시작일 종료일
P1-3-3 작업지시 리스트 LIST 0.25 12-04(목) 12-05(금)
P1-3-4 작업지시 등록 FORM 0.5 12-05(금) 12-05(금)
P1-3-5 작업지시 수정 FORM 0.2 12-05(금) 12-05(금)
P1-3-6 작업지시 상세 DETAIL 0.25 12-05(금) 12-08(월)
P1-3-7 작업실적 입력 FORM 0.5 12-08(월) 12-08(월)
P1-3-8 작업실적 조회 DETAIL 0.25 12-08(월) 12-08(월)

Phase 5: 기준-공정 (12/08 ~ 12/10)

화면ID 화면명 유형 공수 시작일 종료일
M5 공정 리스트 LIST 0.25 12-08(월) 12-08(월)
M5-1 공정 등록 FORM 0.5 12-09(화) 12-09(화)
M5-2 공정 수정 FORM 0.2 12-09(화) 12-09(화)
M5-3 공정 상세 DETAIL 0.5 12-10(수) 12-10(수)

Phase 6: 출하 (12/10 ~ 12/12)

화면ID 화면명 유형 공수 시작일 종료일
S4 출하 리스트 LIST 0.25 12-10(수) 12-10(수)
S4-1 출하 등록 FORM 0.5 12-10(수) 12-11(목)
S4-2 배송 조율/관리 FORM 0.5 12-11(목) 12-11(목)
S4-3 상차 체크리스트 FORM 0.5 12-11(목) 12-12(금)
S4-4 출하 수정+탭 FORM 0.5 12-12(금) 12-12(금)

Phase 7: 거래처 (12/15 ~ 12/16)

화면ID 화면명 유형 공수 시작일 종료일
S1-1 거래처 리스트 LIST 0.25 12-15(월) 12-15(월)
S1-1 거래처 등록 FORM 0.5 12-15(월) 12-15(월)
S1-2 거래처 수정 FORM 0.1 12-15(월) 12-16(화)
S1-3 거래처 상세+탭 DETAIL 0.25 12-16(화) 12-16(화)

Phase 8: 품질 (12/16 ~ 12/19)

화면ID 화면명 유형 공수 시작일 종료일
M9 검사기준 리스트 LIST 0.5 12-16(화) 12-16(화)
M9-1 검사기준 등록 FORM 1 12-17(수) 12-17(수)
Q1 검사관리 리스트 LIST 0.5 12-18(목) 12-18(목)
Q1-1 검사관리 등록 FORM 1 12-18(목) 12-19(금)
Q1-2 검사관리 상세 DETAIL 0.5 12-19(금) 12-19(금)

Phase 9: 자재 (12/19 ~ 12/24)

화면ID 화면명 유형 공수 시작일 종료일
I1 재고현황 리스트 LIST 0.5 12-19(금) 12-22(월)
I1-1 재고 상세+탭 DETAIL 1 12-22(월) 12-23(화)
I2 입고 리스트 LIST 0.5 12-23(화) 12-23(화)
I2-1 입고 등록 FORM 0.8 12-23(화) 12-24(수)
I2-3 입고 상세+탭 DETAIL 0.5 12-24(수) 12-24(수)

Phase 10: 단가 (12/24)

화면ID 화면명 유형 공수 시작일 종료일
S6 단가 리스트 LIST 0.25 12-24(수) 12-24(수)
S6-1 단가 등록 FORM 0.25 12-24(수) 12-24(수)
S6-2 단가 수정 FORM 0.25 12-24(수) 12-24(수)
S6-3 단가 상세+탭 DETAIL 0.25 12-24(수) 12-24(수)

Phase 11: 회계 (12/26)

화면ID 화면명 유형 공수 시작일 종료일
A1 판매조회 리스트 LIST 0.5 12-26(금) 12-26(금)
A4 수금 리스트 3탭 LIST 0.25 12-26(금) 12-26(금)
A4-1 수금 등록 FORM 0.25 12-26(금) 12-26(금)

4.2 기획자 일정 (ERP + 운영)

기획 (이태화)

구분 업무 기간 일수 대상
스토리보드 공통, ERP 11/26 ~ 12/12 13 SAM
가입 및 로그인 스토리보드 11/27 1 SAM
인사관리, 전자결재 스토리보드 11/28 ~ 12/01 4 SAM
회계, 보고서 스토리보드 12/02 ~ 12/09 6 SAM
고객센터, 게시판 스토리보드 12/10 ~ 12/12 3 SAM
주일기업 요구사항 정리 요구사항 12/02 ~ 12/12 9 주일기업
스토리보드 - 주일기업 MES 기획 12/15 ~ 12/30 12 주일기업
스토리보드 - ERP 2차 기획 12/31 ~ 01/13 12 SAM
스토리보드 - MES 2차 기획 01/14 ~ 01/27 12 SAM

운영 (hso be)

구분 업무 기간 일수 대상
보고서 지표 검토 운영 11/27 ~ 11/28 2 SAM
주일기업 자료 정리 및 취합 운영 11/26 ~ 11/28 3 주일기업
주일기업 업무 프로세스 인터뷰 운영 12/01 ~ 12/05 5 주일기업
법률 및 정책 검토 운영 12/08 ~ 12/19 10 SAM

5. MS1: 코어 MVP 개발 완료 (2025-12-31)

목표: MES 핵심 기능 개발 완료 + 단위테스트 통과

코어 MVP 범위

  • 핵심 흐름: 견적 → 수주 → 생산(작업지시/실적) → 출하
  • 기준정보: 거래처, 공정, 견적수식
  • 단위테스트: 커버리지 60% 이상

완료 기준

  • 코어 MVP 기능 100% 구현
  • 단위테스트 커버리지 60% 이상
  • Swagger 문서화 (코어 MVP 범위)
  • Critical/High 버그 0건
  • API 평균 응답 속도 < 500ms

주요 산출물

  • 코어 MVP 소스코드 (api, react)
  • API 문서 (Swagger)
  • 단위테스트 보고서

Week별 작업

Week 1 (12/02-12/08)

작업 내용
📋 기획 회계/보고서 스토리보드
📋 운영 주일기업 업무 프로세스 인터뷰
🎨 디자인 생산, 기준-공정 화면
🔧 Backend 공정/단가 체계 완성
💻 Frontend React 개발 시작 (12/08~)

Week 2 (12/09-12/15)

작업 내용
📋 기획 고객센터/게시판 스토리보드, 주일기업 MES 스토리보드 시작
📋 운영 법률 및 정책 검토 시작
🎨 디자인 출하, 거래처 화면
🔧 Backend 견적서 PDF, 재고 트랜잭션
💻 Frontend 견적/수주 화면 개발
🧪 QA 단위테스트 시작 (12/10~)

Week 3 (12/16-12/22)

작업 내용
📋 기획 주일기업 MES 스토리보드 진행
🎨 디자인 품질, 자재 화면
🔧 Backend API 안정화, 버그 수정
💻 Frontend 생산/출하 화면 개발
🧪 QA 단위테스트 진행

Week 4 (12/23-12/31)

작업 내용
🎨 디자인 단가, 회계 화면 (완료)
🔧 Backend 코어 MVP 마무리
💻 Frontend 코어 MVP 화면 완료
🧪 QA 단위테스트 완료

체크포인트

  • 12/15: 개발 70% 완료, 단위테스트 시작
  • 12/22: 개발 90% 완료
  • 12/29: 코어 MVP 개발 완료
  • 12/31: MS1 완료 - 단위테스트 통과

6. MS2: 1차 MVP + 베타 오픈 (2026-01-31)

목표: 통합테스트 완료 + 1차 MVP 완료 + 베타 서비스 오픈

1차 MVP 범위 (추가 예정)

  • 확장 기능: 품질, 자재, 단가, 회계
  • 추가 기능: (1차 MVP 일정에서 별도 정의)

완료 기준

  • 통합테스트 통과
  • 베타 서버 구축 완료
  • 파일럿 고객 온보딩 완료
  • 주요 시나리오 실전 테스트 완료

주요 산출물

  • 1차 MVP 소스코드
  • 통합테스트 보고서
  • 베타 서버 환경

Week별 작업

Week 1 (01/01-01/05)

작업 내용
🧪 QA 통합테스트 시작
🔧 Backend 베타 서버 구축, 도메인/SSL 설정
📋 기획 ERP 2차 스토리보드 진행

Week 2 (01/06-01/12)

작업 내용
🧪 QA 통합테스트 진행
🔧 Backend 파일럿 고객 데이터 준비
💻 Frontend 버그 수정, UI 개선
📋 기획 ERP 2차 스토리보드 완료 (01/13)

Week 3 (01/13-01/19)

작업 내용
🧪 QA 통합테스트 완료
운영 파일럿 고객 온보딩 (1차)
📋 기획 MES 2차 스토리보드 시작 (01/14)

Week 4 (01/20-01/31)

작업 내용
전체 실전 테스트, 피드백 수집
🔧 Backend 긴급 버그 수정
📋 기획 MES 2차 스토리보드 진행

베타 고객 프로필

고객사 업종 주요 사용 기능 기대 효과
경동기업 제조 견적/수주/BOM/생산 MES 전체 검증
주일기업 제조 MES 커스터마이징 확장성 검증

체크포인트

  • 01/05: 베타 서버 오픈
  • 01/13: 통합테스트 완료
  • 01/20: 파일럿 고객 온보딩 완료
  • 01/31: MS2 완료 - 베타 서비스 오픈

7. MS3: 정식 런칭 (2026-02-28)

목표: 운영 서버 오픈 및 본격적인 서비스 시작

완료 기준

  • 운영 서버 구축 완료 (이중화)
  • 베타 피드백 반영 완료
  • 보안 감사 통과
  • 법적 문서 완비

주요 산출물

  • 운영 서버 환경
  • 보안 감사 보고서
  • 마케팅 자료

Week별 작업

Week 1-2 (02/01-02/14): 운영 준비

작업 내용
베타 피드백 반영 UI/UX 개선, 성능 최적화
운영 서버 구축 이중화, 모니터링, 백업
보안 감사 취약점 점검 및 수정
📋 기획 MES 2차 스토리보드 완료 (01/27)

Week 3-4 (02/15-02/28): 런칭

작업 내용
정식 오픈 운영 서버 오픈
고객 온보딩 초기 고객 온보딩 시작

체크포인트

  • 02/14: 운영 준비 완료
  • 02/28: MS3 완료 - 정식 런칭

8. MS4: 안정화 완료 (2026-03-31)

목표: 서비스 안정화 및 초기 고객 성공 사례 확보

완료 기준

  • 시스템 가용성 99.5% 이상
  • 고객 만족도 4.0/5.0 이상
  • 성공 사례 3건 이상 확보

주요 작업

  • 런칭 후 긴급 이슈 대응
  • 모니터링 강화
  • 고객 피드백 수집 및 반영
  • 성능 최적화
  • 고객 성공 사례 수집
  • Q2 로드맵 수립

체크포인트

  • 03/15: 초기 안정화 완료
  • 03/31: MS4 완료 - 안정화 완료

9. 개발 방향성

기술 아키텍처 방향

  • Backend: Laravel 12 + PHP 8.4+
  • Frontend: Next.js 15 + React 18
  • Database: MySQL 8.0 (멀티테넌트 구조)
  • Auth: Laravel Sanctum
  • API: RESTful + Swagger 문서화
  • Deployment: Docker + Docker Compose

핵심 개발 원칙

  1. Service-First: 모든 비즈니스 로직은 Service 클래스에
  2. Multi-tenancy: BelongsToTenant 스코프 필수 적용
  3. FormRequest: Controller에서 직접 검증 금지
  4. API-First: Backend 완성 후 Frontend 연동
  5. 문서화: Swagger 100% 완성 목표

디자인 시스템 전략

  • MES (경동기업) 기준으로 디자인 시스템 구성
  • ERP는 경동기업 디자인 시스템 기반으로 Frontend가 직접 개발
  • **MES (주일기업)**은 경동기업 디자인 기반 커스터마이징

품질 기준

  • API Rules 100% 준수
  • Swagger 문서화 완성도 100%
  • 테스트 커버리지 60% 이상
  • Pint 코드 포맷팅 통과
  • i18n 메시지 키 사용

10. 개발 작업 현황

백엔드 완료 항목

API 공통 기반

  • Exception Handler
  • Swagger 설정 (l5-swagger v1)
  • API Key 인증
  • Rate Limit, CORS
  • 권한 체크 미들웨어

인증/보안

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

테넌트 관리

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

기준정보/코드 관리

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

제품/부품/자재 도메인

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

BOM (Bill of Materials)

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

영업 흐름

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

자재입고/수입검사

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

파일/로그 시스템

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

🔄 백엔드 진행 중 (코어 MVP)

공정/생산 계획

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

견적서 출력

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

백엔드 예정 (1차 MVP)

품질/자재/단가/회계

  • 검사기준, 검사관리
  • 재고현황, 입고 관리
  • 단가 정책 로직
  • 회계 조회/수금

프론트엔드 완료 항목

MNG 패널 (Pure Blade + Tailwind)

  • 주요 관리 화면 구현
  • Product, BOM, Material
  • Category, Role, Permission
  • Department, User, Tenant
  • Client, File 관리

🔄 프론트엔드 진행 중

React 사용자 포털

  • 공통 레이아웃 최종 정리
  • 견적/수주 화면
  • 생산/출하 화면
  • 기준정보 관리 UI

11. 리스크 관리

High Risk

리스크 영향도 완화 방안 담당
개발 일정 지연 High 주간 진행률 체크, 우선순위 조정 PM
디자인-개발 병목 High Frontend 버퍼 확보, ERP 병행 Frontend
단가 계산 로직 복잡도 High 전문가 리뷰, Week 1 집중 Backend

Medium Risk

리스크 영향도 완화 방안 담당
기획-개발 동기화 Medium 주간 싱크업, 스토리보드 우선 리뷰 PM
통합 테스트 시간 부족 Medium 자동화 테스트 확대 QA

12. 핵심 성공 지표 (KPI)

기술 지표

  • 코어 MVP API 엔드포인트 구현
  • Swagger 문서 100% 완성 (MVP 범위)
  • 테스트 커버리지 60% 이상
  • API 평균 응답 속도 < 500ms
  • Critical/High 버그 0건

품질 지표

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

비즈니스 지표

  • 베타 고객 2개사 확보
  • 정식 고객 확보 (런칭 후)
  • 고객 만족도 4.0/5.0 이상

13. 담당자 및 연락처

역할 담당자 주요 업무 비고
프로젝트 관리 - 전체 일정 및 방향성 관리 PM
디자이너 재웅 정 MES(경동기업) 기획 + 디자인 디자인 시스템 기준
기획자 이태화 ERP/MES 스토리보드, 운영, QA 기획 완료 시 MES 합류
백엔드 개발 hso be API/mng/인프라/정책 기술 총괄
프론트엔드 개발 - React 개발 MES(경동) 우선
QA - 테스트 단위/통합 테스트

14. 작업 추적 및 관리

진행 상황 업데이트

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

관련 문서

  • 개발 세부 계획: /claudedocs/SAM_DECEMBER_ROADMAP.md
  • MES 프로젝트: /claudedocs/mes/MES_PROJECT_ROADMAP.md
  • 프로젝트 가이드: /CLAUDE.md
  • 빠른 참조: /SAM_QUICK_REFERENCE.md

15. 다음 단계 (1차 MVP 이후)

1차 MVP 추가 기능 (별도 일정)

  • 품질 관리 (검사기준/검사관리)
  • 자재 관리 (재고현황/입고)
  • 단가 관리
  • 회계 (판매조회/수금)

Phase 2: 프론트엔드 고도화

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

Phase 3: 고급 기능

  • 실시간 생산 모니터링
  • IoT 센서 연동
  • AI 기반 수요 예측

작성: Claude Code 최종 업데이트: 2025-12-02 다음 리뷰: 2025-12-09 (주간 체크)