feat(D 예정노선): 설계 내용 = 프로젝트 폴더 한 파일 D03_PlanAnalysis/plan_network.json — 저장 모듈 · 서버 길 옮김 · 업체 연도 = 파일 조각 (PLAN 590-1 · 요구 452 · 453)

- 저장 모듈 D03_PlanAnalysis_Store — 읽기 · 원자 쓰기 · 판 · 옛 DB 칸 읽을 때 옮김(지점 셋 꼴 · 연도 행 접기 · 옛 연도 노선) · plan_state(조각 · 연도 지문 · 확정 = 지문 같을 때만) - D03 [저장] · [초기화] · D02 지점 = 파일만 + 연도 상태 줄(지문 · 확정) · 프로젝트 잠금 · 파일 쓰기 실패 = DB 되돌림 · 빈 연도 줄 지움 - D04 요약 · 업체 지정 · 확정 메일 · 내보내기 · 대시보드 [연결] · 받은 예정노선 · 산림청 홈 · 개요 연결 = 파일에서 · 업체 줄 연도 칸 안 읽음(⑤) - 산림청 홈 「분석 전」 = 노선 안 그은 예정노선 프로젝트 수 · plan-source 지운 원본 거름 - 옛 연도 단위 지정 · 옛 연도 행 노선 길 걷음(DB 실측 0) · 연결 때 설계속도 씨앗 걷음(591-1 이음) - SQL 023 = 업체 줄 year NULL 허용(옛 칸은 590-3 에서 지움) - 시험: 새 지킴 590_1(옮김 · 원자 쓰기 · 연도 읽기 · 잠금) · 낡은 시험 고침 — 529_3 · 530_2 · 531_3 · 531_d04 · 547_2 · 563_2(DB 조각 · 연도 행 흉내 → 파일 흉내 · 옛 연도 지정 시험 · 설계속도 씨앗 시험 지움 = 그 길 걷음) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-30 09:52:51 +09:00
parent 1c0c44f9e2
commit 54e08d0d65
18 changed files with 1032 additions and 798 deletions
@@ -1,28 +1,25 @@
-"""D 예정노선 1단계 기준 지정 — 지점 목록 하나 정본 API
-(요구서 389 3장 1 · 440 1 · 445 A2 · PLAN 560-2 · 579-1 · 585-1).
+"""D 예정노선 1단계 기준 지정 — 지점 목록 API
+(요구서 389 3장 1 · 440 1 · 445 A2 · 452 · PLAN 560-2 · 579-1 · 585-1 · 590-1).

 - `GET /api/projects/{id}/plan/points` — {epsg, points: [점]} · 점 = {lon, lat, x, y}
- `PUT …/plan/points` — {points: [{lon, lat}]} → TM 셈 → `projects.plan_base_json`
-  (`{"epsg", "points": [{"x", "y"}]}` · 좌표계 = 저장된 값 · 없으면 점 평균 경도의 TM 띠)
- 시점 · 종점 구분 없음 — 옛 꼴(`starts` + `ends` 목록 · 더 옛 `start` · `end` 한 점)은 읽을 때
-  이어 붙임(옮김 없음 · 쓰기는 새 꼴).
- 칸이 비면(옛 프로젝트) [첫 연도 시점, 마지막 연도 종점]으로 접어 보임 · 연도 행은 D03 [저장] 몫.
+- `PUT …/plan/points` — {points: [{lon, lat}]} → TM 셈 → 설계 내용 파일 `points`
+  (`D03_PlanAnalysis_Store` · 좌표계 = 파일 머리 · 없으면 점 평균 경도의 TM 띠)
+- 시점 · 종점 구분 없음 — 옛 꼴(DB `plan_base_json` · 연도 행 접기)은 저장 모듈의 옮김 몫.
 - 고침 = 산림청만(지정 회사 GET 은 공용 판정 `require_project_access` 몫).
 """

 from __future__ import annotations

-import json
 from typing import Any
 from uuid import UUID

-import aiomysql
 from fastapi import APIRouter, Depends, HTTPException
 from pydantic import BaseModel, Field

 from common_util.common_util_auth import is_forest_service, require_company
 from common_util.common_util_crs import lonlat_to_tm, tm_epsg_for_lon, tm_to_lonlat
-from config.config_db import get_db_pool
+from common_util.common_util_save_guard import project_lock
+from D03_PlanAnalysis import D03_PlanAnalysis_Store as store

 router = APIRouter(prefix="/api/projects", tags=["D02 Plan Base"])

@@ -38,31 +35,6 @@ class BaseRequest(BaseModel):
    points: list[LonLat] = Field(default_factory=list, max_length=MAX_POINTS)


-async def _load(project_id: UUID) -> tuple[dict[str, Any], dict[int, dict[str, Any]]]:
-    """(예정노선 프로젝트 칸, 연도 → 지금 행)."""
-    async with (
-        get_db_pool().acquire() as connection,
-        connection.cursor(aiomysql.DictCursor) as cursor,
-    ):
-        await cursor.execute(
-            "SELECT project_kind, project_year, project_year_end, plan_base_json FROM projects"
-            " WHERE id = %s AND deleted_at IS NULL",
-            (str(project_id),),
-        )
-        project = await cursor.fetchone()
-        await cursor.execute(
-            "SELECT year, start_x, start_y, end_x, end_y, epsg FROM plan_route_years"
-            " WHERE project_id = %s",
-            (str(project_id),),
-        )
-        rows = await cursor.fetchall()
-    if not project:
-        raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.")
-    if project["project_kind"] != "PLAN" or project["project_year"] is None:
-        raise HTTPException(status_code=400, detail="예정노선 프로젝트가 아닙니다.")
-    return project, {int(row["year"]): row for row in rows}
-
-
 def _point(x: Any, y: Any, epsg: Any) -> dict[str, float] | None:
    if x is None or y is None or epsg is None:
        return None
@@ -70,43 +42,21 @@ def _point(x: Any, y: Any, epsg: Any) -> dict[str, float] | None:
    return {"lon": lon, "lat": lat, "x": float(x), "y": float(y)}


-def _stored(project: dict[str, Any]) -> dict[str, Any] | None:
-    stored = project.get("plan_base_json")
-    return json.loads(stored) if isinstance(stored, str) else stored
-
-
-def base_view(project: dict[str, Any], rows: dict[int, dict[str, Any]]) -> dict[str, Any]:
-    """{epsg, points} — 정본 칸(옛 시점 · 종점 꼴은 이어 붙임) ·
-    비면 [첫 연도 시점, 마지막 연도 종점]으로 접음."""
-    stored = _stored(project)
-    if stored:
-        epsg = stored.get("epsg")
-        items = stored.get("points")
-        if items is None:
-            starts = stored.get("starts", [stored["start"]] if stored.get("start") else [])
-            ends = stored.get("ends", [stored["end"]] if stored.get("end") else [])
-            items = [*starts, *ends]
-    elif rows:
-        first, last = rows[min(rows)], rows[max(rows)]
-        epsg = first.get("epsg")
-        items = [
-            {"x": first.get("start_x"), "y": first.get("start_y")},
-            {"x": last.get("end_x"), "y": last.get("end_y")},
-        ]
-    else:
-        epsg, items = None, []
-    points = [p for p in (_point(i.get("x"), i.get("y"), epsg) for i in items) if p]
-    return {"epsg": epsg, "points": points}
+def base_view(plan: dict[str, Any]) -> dict[str, Any]:
+    """{epsg, points} — 설계 내용의 지점(TM) + 경위도 · 지점이 없으면 epsg None."""
+    epsg = plan.get("epsg")
+    points = [p for p in (_point(i.get("x"), i.get("y"), epsg) for i in plan["points"]) if p]
+    return {"epsg": epsg if points else None, "points": points}


 async def load_base(project_id: UUID) -> dict[str, Any]:
    """지점 목록 — D03 이 읽는 길."""
-    project, rows = await _load(project_id)
-    return base_view(project, rows)
+    _, plan = await store.load_plan(project_id)
+    return base_view(plan)


 def stored_base(payload: BaseRequest, epsg: int | None = None) -> dict[str, Any]:
-    """PUT 몸 → 정본 칸 꼴(TM m) — 좌표계 = `epsg`(저장된 값) · 없으면 점 평균 경도의 TM 띠."""
+    """PUT 몸 → 파일 꼴(TM m) — 좌표계 = `epsg`(저장된 값) · 없으면 점 평균 경도의 TM 띠."""
    given = payload.points
    if not given:
        epsg = None
@@ -116,14 +66,6 @@ def stored_base(payload: BaseRequest, epsg: int | None = None) -> dict[str, Any]
    return {"epsg": epsg, "points": points}


-async def _store_base(project_id: UUID, base: dict[str, Any]) -> None:
-    async with get_db_pool().acquire() as connection, connection.cursor() as cursor:
-        await cursor.execute(
-            "UPDATE projects SET plan_base_json = %s WHERE id = %s",
-            (json.dumps(base), str(project_id)),
-        )
-
-
@router.get("/{project_id}/plan/points", response_model=None)
 async def get_plan_points(project_id: UUID) -> dict[str, Any]:
    return {"status": "success", **await load_base(project_id)}
@@ -137,7 +79,10 @@ async def put_plan_points(
 ) -> dict[str, Any]:
    if not is_forest_service(session):
        raise HTTPException(status_code=403, detail="예정노선 지점은 산림청만 고칠 수 있습니다.")
-    project, _ = await _load(project_id)  # 없음 · 예정노선 아님 거절
-    epsg = (_stored(project) or {}).get("epsg")
-    await _store_base(project_id, stored_base(payload, int(epsg) if epsg else None))
-    return {"status": "success", **await load_base(project_id)}
+    async with project_lock(str(project_id)):
+        root, plan = await store.load_plan(project_id)  # 없음 · 예정노선 아님 거절
+        base = stored_base(payload, plan["epsg"])
+        epsg = plan["epsg"] if plan["lines"] else base["epsg"]  # 선이 있으면 좌표계 그대로
+        plan = {**plan, "epsg": epsg, "points": base["points"]}
+        store.save_plan(root, plan)
+    return {"status": "success", **base_view(plan)}