sam-docs/sam/docs/features/planning/planning-views.md

견적/프로젝트/워크플로우 화면 명세

작성일: 2026-03-06 상태: 뷰 구현 완료 (목데이터 기반, API 미연동) 라우트: /juil/estimate, /juil/project, /juil/workflow 관련: README.md | 사진대지 | 회의록

---

1. 개요

3개 화면 모두 React 인라인 컴포넌트(Babel 브라우저 트랜스파일)로 구현. 현재는 정적/목데이터 기반이며, 향후 API 연동 예정. PlanningController에서 뷰만 반환한다.

---

2. 견적/입찰/공사관리 (/juil/estimate)

2.1 개요

블라인드/스크린 설치 프로젝트의 견적서 작성, 입찰 관리, 공사 진행 현황을 한 화면에서 관리.

2.2 데이터 구조 (initialEstimates)

{
    id: "string",
    name: "프로젝트명",
    client: "고객사명",
    status: "견적중|입찰|계약|공사중|준공",
    amount: number,                   // 금액
    startDate: "YYYY-MM-DD",
    endDate: "YYYY-MM-DD",
    manager: "담당자명",
    items: [                          // 품목 내역
        { name: "품목명", quantity: number, unitPrice: number }
    ]
}

2.3 공사관리 정보 (initialConstructionData)

{
    id: "string",
    estimateId: "string",             // 연결 견적
    siteName: "현장명",
    address: "현장 주소",
    progress: number,                 // 진행률 (0~100)
    workers: number,                  // 투입 인원
    safetyChecks: [                   // 안전점검
        { date: "YYYY-MM-DD", result: "합격|불합격", inspector: "점검자" }
    ]
}

2.4 상태별 배지 색상

상태	색상
견적중	파랑
입찰	보라
계약	초록
공사중	주황
준공	회색

2.5 SAM 연계

• 견적서 작성 시 SAM 견적 시스템(features/quotes/) 데이터 활용 가능
• 향후 /juil/estimate ↔ SAM 견적 API 연동 계획

---

3. 프로젝트관리/기성청구 (/juil/project)

3.1 개요

계약된 프로젝트의 현장 관리, 발주/청구/인건비 상태 추적, 기성 청구 관리.

3.2 데이터 구조 (initialProjects)

{
    id: "string",
    name: "프로젝트명",
    client: "발주처",
    contractAmount: number,           // 계약금액
    status: "진행중|완료|보류",
    sites: [                          // 현장 목록
        {
            name: "현장명",
            address: "주소",
            progress: number          // 진행률
        }
    ],
    orders: [                         // 발주 내역
        {
            vendor: "거래처",
            amount: number,
            status: "발주|납품|정산"
        }
    ],
    claims: [                         // 기성 청구
        {
            round: number,            // 차수
            amount: number,           // 청구금액
            claimDate: "YYYY-MM-DD",
            status: "청구|승인|입금"
        }
    ],
    laborCosts: [                     // 인건비
        {
            month: "YYYY-MM",
            amount: number,
            workers: number
        }
    ]
}

3.3 금액 포맷 함수

fmt(amount)        // 1,234,567 (쉼표 포맷)
fmtBillion(amount) // 12.3억 (억 단위 축약)

---

4. 업무 Workflow (/juil/workflow)

4.1 개요

블라인드/스크린 사업의 전체 업무 프로세스를 단계별로 시각화. 각 프로세스에 담당 부서, 산출물, 서브스텝을 정의.

4.2 프로세스 데이터 구조

{
    id: "S1-1",                       // 프로세스 ID
    phase: "영업",                     // Phase 명
    name: "정보 수집",                 // 프로세스 이름
    icon: "icon-name",               // 아이콘
    dept: "영업팀",                    // 담당 부서
    color: "#3B82F6",                // 테마 색상
    description: "프로세스 설명",
    documents: [                      // 산출물 목록
        "현장조사서", "고객요구사항서"
    ],
    subSteps: [                       // 상세 서브스텝
        {
            name: "서브스텝명",
            description: "상세 설명",
            responsible: "담당자/팀",
            output: "산출물"
        }
    ]
}

4.3 업무 Phase 목록

Phase	ID 범위	설명
영업	S1-1 ~ S1-4	정보 수집 → 현장 실측 → 고객 미팅 → 프로젝트 검토
견적서 작성	S2-1 ~ S2-4	물량 산출 → 단가 산정 → 견적가 산출 → 견적서 작성/검토
입찰	S3-*	입찰 준비 → 제출 → 결과 확인
계약	S4-*	계약 협상 → 계약 체결
공사	S5-*	자재 발주 → 시공 → 현장 관리
준공	S6-*	검수 → 하자보수 → 준공 정산

4.4 SAM 연계 포인트

// 견적서 작성 Phase에서 SAM 견적 화면으로 연결
{ samLink: '/juil/estimate', label: '견적서 작성 바로가기' }

---

5. 공통 특징

5.1 HTMX 전체 페이지 로드

3개 화면 모두 React 컴포넌트 사용하므로 HTMX 부분 로드 불가:

// PlanningController의 모든 메서드
if ($request->header('HX-Request')) {
    return response('', 200)->header('HX-Redirect', route('juil.xxx'));
}
return view('juil.xxx');

5.2 현재 구현 상태

항목	상태
UI 화면	구현 완료 (React 인라인)
목데이터	블레이드에 하드코딩
API 연동	미연동 (향후 계획)
DB 테이블	미생성 (향후 계획)
CRUD 기능	뷰 조회만 (생성/수정/삭제 미구현)

5.3 향후 개발 방향

1. 견적/프로젝트 DB 테이블 설계 (API 프로젝트)
2. API 엔드포인트 구현
3. React 컴포넌트 API 연동
4. SAM 견적 시스템과 데이터 동기화

---

관련 문서

• README.md — 기획 메뉴 전체 개요
• 공사현장 사진대지 — GCS 파일 관리, 음성 입력
• 회의록 작성 — STT/AI 통합 회의 기록
• 견적 시스템 — SAM 견적 관리 (BOM, 10단계 로직)

---

최종 업데이트: 2026-03-06