260715_0

docs/wiki/pages/B04_wf1_Surface/B04_db.md

@@ -0,0 +1,34 @@
+---
+status: stable
+page_id: B04_wf1_Surface
+related_pages: ["[[B04_wf1_Surface/B04_backend]]", "[[B04_wf1_Surface/B04_api]]", "[[B04_wf1_Surface/B04_dependencies]]", "[[db_schema/files_surface]]"]
+last_updated: 2026-07-12
+---
+
+# B04_wf1_Surface — DB
+
+이 페이지가 쓰는 테이블 (정의는 concepts에, 여기선 용도만).
+
+## 쓰는 테이블
+
+| 테이블 | 이 페이지의 용도 | 정의 |
+|---|---|---|
+| `processed_point_cloud` | 필터/변환된 포인트클라우드 저장(input_files 참조) | [[db_schema/files_surface]] |
+| `surface_models` | TIN/DTM/NURBS/implicit/meshfree 모델 메타데이터 | [[db_schema/files_surface]] |
+| `terrain_layers` | 등고선 등 파생 레이어 | [[db_schema/files_surface]] |
+| `project_workflow_stages` | WF1(stage 1) 상태 전이·조회 | [[workflow_state]] |
+| `input_files` | 분석 대상 LAS/LAZ 조회 | [[db_schema/files_surface]] |
+| `projects` | (레거시 폴백) status 조회 | [[db_schema/projects]] |
+
+## Repository 함수
+
+| 함수 | 위치 | 역할 |
+|---|---|---|
+| `create_processed_point_cloud()` | `B04_wf1_Surface_Repository.py` | processed_point_cloud INSERT |
+| (surface_models INSERT) | `B04_wf1_Surface_Repository.py` | 모델별 메타데이터 저장 |
+| `get_input_file()` | `B04_wf1_Surface_Repository.py` | 입력 LAS 단건 조회 |
+
+## 참고
+
+- `save_surface_analysis_to_db()`([[B04_wf1_Surface/B04_backend]])가 processed_point_cloud + surface_models를 한 트랜잭션으로 저장(호출자가 begin/commit)
+- WF1 단계 판정 SSOT는 `project_workflow_stages`. `projects.status`는 레거시 폴백 경로에서만 참조 → [[workflow_state]]