eomsangdonandClaude Opus 5
eb30b774f8
- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록) - `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록 — 창끼리 공유하되 저장소에는 안 올리는 장부 - 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠) - graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
3.2 KiB
3.2 KiB
type, status, page_id, related_pages, last_updated, source
| type | status | page_id | related_pages | last_updated | source | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| page-api | stable | B05_Profile |
|
2026-08-23 |
|
B05_Profile — API
이 API는 B05_Profile/B05_frontend의 경로·종단 편집을 B05_Profile/B05_backend에 연결하고 workflow_state stage 2를 변경한다.
기본 prefix: /api/v1/projects (B05_Profile_Router.py:40). 배수유역 설계 및 관 편집 API는 B04의 공용 API를 호출하므로 B05 전용 배수 API 엔드포인트는 전량 404 폐기되었습니다.
엔드포인트
| 엔드포인트 / 항목 | 세분화 위키 명세 | 역할 |
|---|---|---|
POST /{project_id}/route/solve |
[[B05_Profile/backend/B05_Profile_Router]] |
최적 경로 계산 및 DRAFT 결과 DB 저장 |
PUT /{project_id}/route/contour-interval |
[[B05_Profile/backend/B05_Profile_Router]] |
등고선 간격 변경값 영속화 |
PUT /{project_id}/route/profile-alignment |
[[B05_Profile/backend/B05_Profile_Router]] |
측점별 편집 offset 및 R 오버라이드 맵 저장 |
POST /{project_id}/route/confirm |
[[B05_Profile/backend/B05_Profile_Router]] |
최신 DRAFT 경로를 CONFIRMED 상태로 변경 (배수 및 비정규 측점 정보 일원화 병합) |
GET /{project_id}/route/latest |
[[B05_Profile/backend/B05_Profile_Router]] |
최신 경로 메타 + 정밀 3D 좌표 + 사용 파라미터 반환 |
GET /api/projects/structure-types |
[[B05_Profile/B05_structures]] |
구조물 타입 레지스트리 반환 |
GET /api/projects/{project_id}/route/structures |
[[B05_Profile/B05_structures]] |
일반 구조물 목록과 revision 조회 |
PUT /api/projects/{project_id}/route/structures |
[[B05_Profile/B05_structures]] |
전체 목록 저장, 409 충돌·검증·후속 STALE 결과 반환 |
GET /api/projects/{project_id}/routes/{route_id}/corridor |
[[B05_Profile/B05_corridor_surface]] |
저장된 코리도 JSON 조회 |
PUT /api/projects/{project_id}/routes/{route_id}/corridor |
[[B05_Profile/B05_corridor_surface]] |
코리도 JSON 원자 저장, 64MB 제한 |
API 스키마 및 반환 필드
POST /{project_id}/route/confirm 요청 (RouteConfirmRequest)
filter: 지표 분석 필터 키method: 보간 기법smooth: 평활화 유무model: DTM 방식irregular_stations: 비정규 측점 목록 (IrregularStationInput객체의 배열)station_num: 규칙 측점 번호 (integer)rem_distance_m: 잔여 거리 (float)structure_name: 구조물 명칭 (string)
오류는 표준 {"status":"error","message":...} 형식으로 반환한다.