260715_0

docs/wiki/pages/B05_wf2_Route/B05_db.md

@@ -0,0 +1,36 @@
+---
+type: page-db
+status: stable
+page_id: B05_wf2_Route
+related_pages: ["[[B05_wf2_Route/B05_backend]]", "[[B05_wf2_Route/B05_api]]"]
+last_updated: 2026-07-12
+source: 상위 프로젝트 B05_wf2_Route_Repository.py 실 코드 직접 확인 (2026-07-12)
+---
+
+# B05_wf2_Route — DB 사용 관계
+
+테이블 정의는 [[db_schema/route_profile]]에서 1차 관리한다.
+
+| 항목 | 위치 | 역할 |
+|---|---|---|
+| `routes` | `B05_wf2_Route_Repository.py:27` | surface model·제어점·옵션·GeoJSON 경로 저장 |
+| `route_points` | `B05_wf2_Route_Repository.py:75` | chainage·고도·경사별 렌더링 포인트 저장 |
+| `route_statistics` | `B05_wf2_Route_Repository.py:109` | 총연장·경사·절성토량·비용 통계 저장 |
+
+## Repository 함수
+| 항목 | 위치 | 역할 |
+|---|---|---|
+| `_validate_stage_path()` | `B05_wf2_Route_Repository.py:18` | B05 route 상대경로 이탈 방지 |
+| `create_route()` | `B05_wf2_Route_Repository.py:27` | 계산 결과 route 레코드 생성 |
+| `insert_route_points()` | `B05_wf2_Route_Repository.py:75` | 샘플 포인트 일괄 저장 |
+| `create_route_statistics()` | `B05_wf2_Route_Repository.py:109` | 경로 통계 저장 |
+| `get_latest_route()` | `B05_wf2_Route_Repository.py:148` | 프로젝트 최신 경로 조회 |
+| `confirm_route()` | `B05_wf2_Route_Repository.py:175` | 경로 상태 CONFIRMED 전환 |
+
+## 저장 경로
+| 항목 | 역할 |
+|---|---|
+| `routes.route_data_path` | 프로젝트 루트 기준 `B05_wf2_Route/route/` 내 GeoJSON 상대경로 |
+| `route_points` | DB에 렌더링용 샘플 좌표 저장 |
+
+상세 경로 규칙: [[storage_paths]].