4f90c0e869
- README.md: 전체 개요, 5개 하위 메뉴 구조, 아키텍처 - construction-photos.md: 공사현장 사진대지 (GCS, 행 구조, 음성입력) - meeting-minutes.md: 회의록 (STT 화자분리, Gemini AI 요약, 오디오 녹음) - planning-views.md: 견적/프로젝트/워크플로우 화면 명세 - INDEX.md: 문서 인덱스에 planning 등록
223 lines
6.3 KiB
Markdown
223 lines
6.3 KiB
Markdown
# 견적/프로젝트/워크플로우 화면 명세
|
|
|
|
> **작성일**: 2026-03-06
|
|
> **상태**: 뷰 구현 완료 (목데이터 기반, API 미연동)
|
|
> **라우트**: `/juil/estimate`, `/juil/project`, `/juil/workflow`
|
|
> **관련**: [README.md](README.md) | [사진대지](construction-photos.md) | [회의록](meeting-minutes.md)
|
|
|
|
---
|
|
|
|
## 1. 개요
|
|
|
|
3개 화면 모두 **React 인라인 컴포넌트**(Babel 브라우저 트랜스파일)로 구현. 현재는 정적/목데이터 기반이며, 향후 API 연동 예정. PlanningController에서 뷰만 반환한다.
|
|
|
|
---
|
|
|
|
## 2. 견적/입찰/공사관리 (/juil/estimate)
|
|
|
|
### 2.1 개요
|
|
|
|
블라인드/스크린 설치 프로젝트의 견적서 작성, 입찰 관리, 공사 진행 현황을 한 화면에서 관리.
|
|
|
|
### 2.2 데이터 구조 (initialEstimates)
|
|
|
|
```javascript
|
|
{
|
|
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)
|
|
|
|
```javascript
|
|
{
|
|
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)
|
|
|
|
```javascript
|
|
{
|
|
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 금액 포맷 함수
|
|
|
|
```javascript
|
|
fmt(amount) // 1,234,567 (쉼표 포맷)
|
|
fmtBillion(amount) // 12.3억 (억 단위 축약)
|
|
```
|
|
|
|
---
|
|
|
|
## 4. 업무 Workflow (/juil/workflow)
|
|
|
|
### 4.1 개요
|
|
|
|
블라인드/스크린 사업의 전체 업무 프로세스를 단계별로 시각화. 각 프로세스에 담당 부서, 산출물, 서브스텝을 정의.
|
|
|
|
### 4.2 프로세스 데이터 구조
|
|
|
|
```javascript
|
|
{
|
|
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 연계 포인트
|
|
|
|
```javascript
|
|
// 견적서 작성 Phase에서 SAM 견적 화면으로 연결
|
|
{ samLink: '/juil/estimate', label: '견적서 작성 바로가기' }
|
|
```
|
|
|
|
---
|
|
|
|
## 5. 공통 특징
|
|
|
|
### 5.1 HTMX 전체 페이지 로드
|
|
|
|
3개 화면 모두 React 컴포넌트 사용하므로 HTMX 부분 로드 불가:
|
|
|
|
```php
|
|
// 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](README.md) — 기획 메뉴 전체 개요
|
|
- [공사현장 사진대지](construction-photos.md) — GCS 파일 관리, 음성 입력
|
|
- [회의록 작성](meeting-minutes.md) — STT/AI 통합 회의 기록
|
|
- [견적 시스템](../quotes/README.md) — SAM 견적 관리 (BOM, 10단계 로직)
|
|
|
|
---
|
|
|
|
**최종 업데이트**: 2026-03-06
|