feat(M02): 집계 항목 복사본을 구조물마다 — templates/structures/{구조물 id} · 옛 항목 폴더 옮겨 받기 · 재적용(덮임 알림) · 개인에 저장 · 프로젝트에서 새 항목 · 지정 바꿈 · 삭제 때 고친 것은 _지난 (PLAN 26-2b)

- 같은 항목을 고른 구조물 둘도 도면 · 면적 · 재료 · 자재조합 · 일위대가 · 입력연결 · 입력값 · 고른자재 · 단가를 따로 가짐 · 폴더 = structure_id 또는 pipe@측점
- 옛 templates/items/{층}_{주인}_{키} 는 읽을 때 그 항목을 쓰는 구조물마다 복사(고친 값 유지) · 안 쓰이고 고친 것은 structures/_지난
- 길: 미리 가져오기 {structure, layer, owner, key} · POST …/{폴더}/reapply(refresh 옛 이름) · …/save-as {to, 경로, 이름} · …/items/new {structure, 경로, 이름, 단위} · 회사 없음 409
- manifest 원본에 경로(26-1 · 경로 칸 우선 · 옛 종류 · 분류는 건너뛰며 받음) · 원본이 바뀌거나 지워져도 복사본 · 계산 그대로(목록 마스터바뀜 · 원본없음)
- 채움(M02_Table_Fill)은 구조물 복사본의 열 정의를 읽음

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BU9gbNE3aWFUvE61pS2WGt

M02_MasterTemplete/M02_Project_Items_Router.py

@@ -1,12 +1,15 @@
-"""프로젝트 집계 항목 복사본 길 — `/api/projects/{id}/items…` (PLAN 25-1b · 25-2b · 25-2e).
+"""프로젝트 구조물 집계 항목 복사본 길 — `/api/projects/{id}/items…` (PLAN 25-1b · 26-1 · 26-2b).
 
-    GET  …/items                      목록(이름 · 원본 · 가져온날 · 마스터 바뀜)
-    POST …/items {layer, owner, key}   미리 가져오기(구조물에 안 이은 항목) → {폴더, 만듦, 가져온날}
-    GET  …/items/{폴더}/{종류}         {종류, 판, 내용}
-    PUT  …/items/{폴더}/{종류}         {판, 내용} — 판이 다르면 409 · 면적 · 재료는 서버 계산값
-    POST …/items/{폴더}/refresh        새로 가져오기(입력값 · 고른자재는 같은 키면 살림)
-    POST …/items/{폴더}/calc           복사본만으로 계산(세 비목 · 계 · 빠진 입력)
-종류 = 도면 · 면적 · 재료 · 자재조합 · 입력연결 · 입력값 · 고른자재.
+폴더 = 구조물 id(`structure_id` · 관 지점은 `pipe@측점`) — 같은 항목을 고른 구조물도 복사본은 따로.
+    GET  …/items                           목록(원본 · 가져온날 · 마스터바뀜 · 원본없음)
+    POST …/items {structure, layer, owner, key}  미리 가져오기 → {폴더, 만듦, 가져온날}
+    POST …/items/new {structure, 경로, 이름, 단위}  새 항목(개인 층에도) · 회사 없음 409
+    GET  …/items/{폴더}/{종류}              {종류, 판, 내용}
+    PUT  …/items/{폴더}/{종류}              {판, 내용} — 판이 다르면 409 · 면적 · 재료는 서버 계산값
+    POST …/items/{폴더}/reapply             재적용(입력값 · 고른자재는 같은 키면 살림 · `덮임` 알림)
+    POST …/items/{폴더}/save-as {to, 경로, 이름}  개인 층에 새 항목으로(단가 묶음은 안 가져감)
+    POST …/items/{폴더}/calc                복사본만으로 계산(세 비목 · 계 · 빠진 입력)
+종류 = 도면 · 면적 · 재료 · 자재조합 · 입력연결 · 입력값 · 고른자재 · `refresh` = 옛 이름(재적용).
 ⚠ 등록은 `main.py`(로그인만) — 프로젝트 권한(같은 회사)은 여기서 `_project` 로 봄(403 · 404).
 """
 
@@ -23,6 +26,7 @@ from common_util.common_util_auth import verify_session
 from common_util.common_util_summary_item import parse_summary_item
 from M02_MasterTemplete import M02_Item_Copy as copies
 from M02_MasterTemplete import M02_MasterTemplete_Router_Layers as layer_routes
+from M02_MasterTemplete import M02_MasterTemplete_Store as store
 from M02_MasterTemplete.M02_Item_Source import item_name
 
 router = APIRouter(prefix="/api/projects", tags=["M02 Project Items"])
@@ -36,8 +40,9 @@ class WriteBody(BaseModel):
 
 
 class PrefetchBody(BaseModel):
-    """`{layer, owner, key}`(이름은 층 SS 줄에서) — 옛 모양 `{summary_item}` 도 받음."""
+    """`{structure, layer, owner, key}`(이름은 층 SS 줄에서) — 옛 모양 `{summary_item}` 도 받음."""
 
+    structure: str | None = None
     layer: str | None = None
     owner: str | None = None
     key: str | None = None
@@ -45,6 +50,28 @@ class PrefetchBody(BaseModel):
     summary_item: dict[str, Any] | None = None
 
 
+class SaveAsBody(BaseModel):
+    to: Literal["personal"] = "personal"
+    경로: list[str] = []
+    이름: str | None = None
+
+
+class NewBody(BaseModel):
+    structure: str
+    경로: list[str] = []
+    이름: str | None = None
+    단위: str | None = None
+
+
+def _me(session: dict[str, Any]) -> tuple[int, int]:
+    """개인 층 주인(회사 · 사용자) — 회사 없는 사용자는 409."""
+    if session.get("company_id") is None:
+        raise HTTPException(
+            status_code=409, detail="회사부터 등록 — 개인 층은 회사 연결이 필요합니다."
+        )
+    return int(session["company_id"]), int(session["user_id"])
+
+
 async def _root(session: dict[str, Any], project_id: str):
     return (await layer_routes._project(session, project_id))["root"]
 
@@ -52,6 +79,8 @@ async def _root(session: dict[str, Any], project_id: str):
 async def _run(fn, *args):
     try:
         return await asyncio.to_thread(fn, *args)
+    except store.StoreError as error:
+        raise HTTPException(status_code=error.status, detail=error.detail) from error
     except copies.Stale as error:
         raise HTTPException(
             status_code=409, detail={"message": str(error), "판": error.current}
@@ -73,6 +102,8 @@ async def list_items(
 async def prefetch_item(
     project_id: str, body: PrefetchBody, session: dict[str, Any] = Depends(verify_session)
 ) -> dict[str, Any]:
+    if not body.structure:
+        raise HTTPException(status_code=400, detail="미리 가져올 구조물(structure)이 필요합니다.")
     raw = body.summary_item or {"layer": body.layer, "owner": body.owner, "key": body.key}
     try:  # 모양 먼저(이름은 자리만) — 그다음 층 SS 줄에서 이름
         item = parse_summary_item({**raw, "name": raw.get("name") or body.name or "-"})
@@ -83,7 +114,19 @@ async def prefetch_item(
             item["name"] = item_name(item)
         except LookupError as error:
             raise HTTPException(status_code=404, detail=str(error)) from error
-    return await _run(copies.prefetch, await _root(session, project_id), item)
+    root = await _root(session, project_id)
+    return await _run(copies.prefetch, root, body.structure, item)
+
+
+@router.post("/{project_id}/items/new")
+async def new_item(
+    project_id: str, body: NewBody, session: dict[str, Any] = Depends(verify_session)
+) -> dict[str, Any]:
+    root = await _root(session, project_id)
+    company, user = _me(session)
+    return await _run(
+        copies.new_item, root, body.structure, company, user, body.경로, body.이름, body.단위
+    )
 
 
 @router.get("/{project_id}/items/{folder}/{kind}")
@@ -112,11 +155,24 @@ async def write_item_file(
     return await _run(copies.write_file, root, folder, kind, body.판, body.내용, _recalc)
 
 
+@router.post("/{project_id}/items/{folder}/reapply")
 @router.post("/{project_id}/items/{folder}/refresh")
-async def refresh_item(
+async def reapply_item(
     project_id: str, folder: str, session: dict[str, Any] = Depends(verify_session)
 ) -> dict[str, Any]:
-    return await _run(copies.refresh, await _root(session, project_id), folder)
+    return await _run(copies.reapply, await _root(session, project_id), folder)
+
+
+@router.post("/{project_id}/items/{folder}/save-as")
+async def save_item_as(
+    project_id: str,
+    folder: str,
+    body: SaveAsBody,
+    session: dict[str, Any] = Depends(verify_session),
+) -> dict[str, Any]:
+    root = await _root(session, project_id)
+    company, user = _me(session)
+    return await _run(copies.save_as, root, folder, company, user, body.경로, body.이름)
 
 
 @router.post("/{project_id}/items/{folder}/calc")