---
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]]