260715_0

docs/wiki/pages/B05_wf2_Route/B05_api.md

@@ -0,0 +1,28 @@
+---
+type: page-api
+status: stable
+page_id: B05_wf2_Route
+related_pages: ["[[B05_wf2_Route/B05_frontend]]", "[[B05_wf2_Route/B05_backend]]", "[[B05_wf2_Route/B05_db]]"]
+last_updated: 2026-07-12
+source: 상위 프로젝트 B05_wf2_Route_Router.py 실 코드 직접 확인 (2026-07-12)
+---
+
+# B05_wf2_Route — API
+
+기본 prefix: `/api/projects` (`B05_wf2_Route_Router.py:30`). 공통 세션·오류 형식은 [[../../concepts/auth_rbac]], [[../../concepts/api_common]]을 참조한다.
+
+| 항목 | 위치 | 역할 |
+|---|---|---|
+| `POST /{project_id}/route/solve` | `B05_wf2_Route_Router.py:33` | RouteSolveRequest 검증, 경로 계산, 결과 3종 DB 저장 |
+| `POST /{project_id}/route/confirm` | `B05_wf2_Route_Router.py:136` | 최신 DRAFT 경로를 CONFIRMED로 변경 |
+
+## solve 처리 결과
+| 항목 | 역할 |
+|---|---|
+| `route_id` | 새 경로 식별자 |
+| `total_length_m` | 계산 경로 총연장 |
+| `metrics` | 경사·절성토량·비용 등 통계 |
+| `required_points_ok` | BP/EP/CP 조건 충족 여부 |
+| `route_data_path` | GeoJSON LineString 상대경로 |
+
+오류는 표준 `{"status":"error","message":...}` 형식으로 반환한다.