260706_0_회사싱크 후 커밋

.agent/test/05_Workflow_and_Storage.md

@@ -0,0 +1,31 @@
+---
+document_type: workflow
+priority: HIGH
+---
+# 워크플로우 및 데이터 저장소 명세
+
+## 🔄 6단계 워크플로우 (6-Stage Workflow)
+설계의 순차적 흐름을 정의하며, DB 및 폴더 구조와 1:1 맵핑됩니다.
+
+- **WF0 (B03): 파일 입력** - 사용자 원본 파일 (LAS, TIF, DXF 등) 업로드
+- **WF1 (B04): 지표면 분석** - 포인트클라우드 포맷 변환 및 지표면 모델(DEM/TIN) 생성
+- **WF2 (B05): 경로 설계** - 제약조건 반영 최적 선형 도출 (GeoJSON)
+- **WF3 (B06): 종횡단 생성** - 종단면도, 횡단면도 지형/설계 데이터 생성
+- **WF4 (B07): 상세 설계** - 횡단면별 구조물(옹벽, 수로 등) 배치
+- **WF5 (B08): 수량 산출** - 구조물 수량 및 토공량 집계
+- **WF6 (B09): 견적·문서** - Excel, PDF, DXF 등 최종 산출물 패키지 생성
+
+## 📁 영구 저장소 구조 (파일시스템)
+중간 산출물(LAS, TIF, GeoJSON 등) 및 대용량 파일은 DB가 아닌 파일시스템에 저장되며, DB(MariaDB)에는 저장된 파일의 **상대 경로**만 기록합니다. 임의의 위치에 파일을 쓰거나 사용자 입력을 경로에 그대로 결합하지 않습니다.
+
+**저장 규칙 기반 디렉토리 구조:**
+`storage/{company_slug}/{user_slug}/{project_id}/` 내부
+- `B03_FileInput/input/` : 원본 업로드 파일
+- `B04_wf1_Surface/processed/` : 변환 완료된 파일 (ply, 필터링 las 등)
+- `B04_wf1_Surface/models/` : 생성된 DEM, TIN 모델
+- `B05_wf2_Route/route/` : 주요 경로선 (GeoJSON) 및 제약 정보
+- `B06_wf3_ProfileCross/longitudinal/` : 종단면 데이터셋
+- `B06_wf3_ProfileCross/cross_sections/` : 구간별 횡단면 데이터셋
+- `B07_wf4_DesignDetail/structures/` : 배치된 구조물 메타데이터
+- `B08_wf5_Quantity/quantities/` : 산출 물량표 내역
+- `B09_wf6_Estimation/v1/` : 완료 버전별 패키징 결과물 (엑셀, 도면)