Files
sam-docs/sam/docs/projects/index_projects.md
김보곤 95b9efbcc5 docs: [planning-design] v1.2 작업 영역 극대화 기능 문서 업데이트
- 사이드바/Description 패널 접기/펼치기 기능 추가
- 캔버스 폭 자동 확장 (1100→1400px) 반영
- 이미지 블록 더블클릭 업로드 변경 반영
- 파일 줄 수 4,300→4,430줄 갱신
- 버전 v1.1 → v1.2 갱신
2026-03-08 09:30:14 +09:00

11 KiB

프로젝트 문서 인덱스

SAM 시스템 개발 프로젝트별 문서 모음 최종 업데이트: 2026-03-08


프로젝트 현황 요약

프로젝트 상태 설명
mes 🟡 진행중 차세대 MES/ERP 기능 개발
quotation 🟢 Phase 3 완료 5130 견적 → SAM 이관
api-integration 🟡 진행중 React ↔ API 연동
5130-migration 🟡 Phase 1 진행중 5130 품목 데이터 마이그레이션
legacy-5130 📚 참조용 5130 레거시 모듈 분석
mng-mobile-responsive 🟡 진행중 mng 모바일 반응형 개선
auto-login 대기 자동 로그인 기능
migration-5130-mng 🟡 진행중 5130 → mng 통합 마이그레이션
e-sign 🟢 v1.0 구현 완료 전자계약 서명 솔루션 (SAM E-Sign)
org-chart 🟢 v1.0 구현 완료 트리형 조직도 관리 (드래그앤드롭, 숨기기)
planning-design 🟢 v1.2 운영 중 브라우저 블록 에디터 (Notion/Figma 스타일)

프로젝트 상세

mes - MES/ERP 프로젝트

경로: docs/projects/mes/ 상태: 🟡 Phase 0 (베이스라인 분석) 30% 완료 목표: SAM 시스템의 차세대 MES/ERP 기능 개발

핵심 문서:

분석 결과:

v2 분석:

  • v2-analysis/ - MES v2 화면 분석
    • quote-analysis/ - 견적 분석
    • order-analysis/ - 주문 분석
    • production-analysis/ - 생산 분석
    • customer-analysis/ - 거래처 분석
    • site-analysis/ - 현장 분석
    • price-analysis/ - 단가 분석
    • master-data-analysis/ - 기준정보 분석
    • production-userflow/ - 생산 유저플로우

quotation - 견적 기능

경로: docs/projects/quotation/ 상태: 🟢 Phase 3 완료 (2025-12-19) 목표: 5130 레거시 견적 기능을 SAM 시스템으로 이관

핵심 문서:

Phase 문서:

Phase 상태 경로
1. 5130 분석 완료 phase-1-5130-analysis/
2. mng 분석 완료 phase-2-mng-analysis/
3. 구현 완료 phase-3-implementation/
4. API 개발 대기 phase-4-api/

참조 자료:

  • screenshots/ - MES 프로토타입 화면 캡쳐 (7개)

api-integration - React ↔ API 연동

경로: docs/projects/api-integration/ 상태: 🟡 Phase 4 진행중 목표: React(dev.sam.kr)와 API(api.sam.kr) 완벽 연동

핵심 문서:

Phase 문서:

Phase 상태 경로
1. 테이블 통합 🟢 완료(스킵) phase-1-table-migration/
2. 메뉴 추출 🟡 진행중 phase-2-menu-extraction/
3. API 매핑 🟡 진행중 phase-3-api-mapping/
4. 연동+검증 🟡 진행중 phase-4-integration/

TC 파일: phase-4-integration/tc/ - 기능별 테스트 케이스 JSON (17개)


5130-migration - 품목 마이그레이션

경로: docs/projects/5130-migration/ 상태: 🟡 Phase 1 진행중 목표: 5130 품목(부품, 자재, BOM) 데이터를 SAM DB로 이전

핵심 문서:

Phase 문서:

Phase 상태 경로
1. 소스 분석 🟡 진행중 phase-1-source-analysis/
2. 타겟 분석 대기 phase-2-target-analysis/
3. 매핑 설계 대기 phase-3-mapping/

legacy-5130 - 레거시 분석

경로: docs/projects/legacy-5130/ 상태: 📚 참조용 문서 용도: 5130 레거시 시스템 모듈별 분석

모듈별 분석 문서:

문서 내용
00_OVERVIEW.md 시스템 개요
01_MATERIAL.md 자재 관리
02_PRODUCT.md 제품 관리
03_ESTIMATE.md 견적 관리
04_PRODUCTION.md 생산 관리
05_SHIPPING.md 출하 관리
06_QUALITY.md 품질 관리
07_ACCOUNTING.md 회계 관리
08_SAM_COMPARISON.md SAM 비교 분석
draw-module.md 도면 모듈

mng-mobile-responsive - 모바일 반응형

경로: docs/projects/mng-mobile-responsive/ 상태: 🟡 진행중 목표: mng 관리자 패널 모바일 반응형 개선

문서:


auto-login - 자동 로그인

경로: docs/projects/auto-login/ 상태: 대기 목표: 자동 로그인 기능 구현

문서:


migration-5130-mng - 5130 → mng 마이그레이션

경로: docs/projects/migration-5130-mng/ 상태: 🟡 진행중 목표: 5130 기능을 mng로 통합 마이그레이션

문서:


e-sign - 전자계약 서명

경로: docs/projects/e-sign/ 상태: 🟢 v1.0 구현 완료 (2026-02-12) 목표: 모두싸인과 유사한 간편 전자계약 서명 솔루션 자체 구축

핵심 문서:

구현 범위:

영역 수량
DB 마이그레이션 4개 (esign_contracts, esign_signers, esign_sign_fields, esign_audit_logs)
API 모델 4개
API 서비스 4개
API 컨트롤러 2개 (16 엔드포인트)
MNG 컨트롤러 2개 (8 화면)
MNG 뷰 8개 (React 하이브리드)

기술 스택: Laravel 11 + React 18 + SignaturePad + PDF.js

참고 자료:

  • esign-storyboard.pptx - 화면 스토리보드
  • storyboard-config.json - 스토리보드 설정

org-chart - 조직도 관리

경로: docs/projects/org-chart/ 상태: 🟢 v1.0 구현 완료 (2026-03-06) 목표: 테넌트별 조직 구조를 시각적으로 관리하는 트리형 조직도

핵심 문서:

  • README.md - 기술 문서 (아키텍처, API, DB, 프론트엔드 상세)

구현 범위:

영역 수량
MNG 컨트롤러 메서드 7개 (RdController)
API 엔드포인트 6개 (조회, 배치, 해제, 순서변경, 숨기기)
DB 마이그레이션 1개 (departments.options JSON 추가)
1개 (Alpine.js + SortableJS)

기술 스택: Alpine.js + SortableJS + 수동 DOM 렌더링 (x-for 미사용)


planning-design - 기획디자인 스토리보드 에디터

경로: docs/projects/planning-design/ 상태: 🟢 v1.2 운영 중 (고도화 진행중) 목표: 브라우저 내 Notion/Figma 스타일 블록 에디터로 ERP 화면 기획서 작성

핵심 문서:

  • README.md - 프로젝트 개요 및 구현 이력

구현 범위:

영역 수량
블록 유형 15종 (텍스트/레이아웃/UI모형/미디어/체크리스트)
편집 기능 올가미 선택, Undo/Redo, 복사/잘라내기, 서식
서식 시스템 글자색/배경색/크기/굵기/기울임/정렬/z-index
작업 영역 사이드바/Description 접기/펼치기, 캔버스 폭 자동 확장
출력 HTML 내보내기 + A4 인쇄 (좌표 기반 WYSIWYG)

기술 스택: Alpine.js + localStorage (서버 API 없음)

기술 스펙: features/rd/planning-design.md


디렉토리 구조

docs/projects/
├── INDEX.md                    # 이 파일
├── mes/                        # MES/ERP 프로젝트 (핵심)
│   ├── 00_baseline/            # Phase 0 분석
│   ├── v1-analysis/            # v1 분석
│   ├── v2-analysis/            # v2 화면 분석
│   └── phases/                 # Phase별 진행
├── quotation/                  # 견적 기능
│   ├── phase-1-5130-analysis/
│   ├── phase-2-mng-analysis/
│   ├── phase-3-implementation/
│   └── screenshots/
├── api-integration/            # React ↔ API 연동
│   ├── phase-1-table-migration/
│   ├── phase-2-menu-extraction/
│   ├── phase-3-api-mapping/
│   └── phase-4-integration/tc/
├── 5130-migration/             # 품목 마이그레이션
│   ├── phase-1-source-analysis/
│   ├── phase-2-target-analysis/
│   └── phase-3-mapping/
├── legacy-5130/                # 레거시 분석 (참조용)
├── mng-mobile-responsive/      # 모바일 반응형
├── auto-login/                 # 자동 로그인
├── migration-5130-mng/         # 5130→mng 마이그레이션
├── e-sign/                     # 전자계약 서명 (SAM E-Sign)
├── org-chart/                  # 조직도 관리
└── planning-design/            # 기획디자인 스토리보드 에디터

관련 문서


범례:

  • 🟢 완료
  • 🟡 진행중
  • 대기
  • 📚 참조용