- Store_Logic: WRITE · CALC · mirror · _ordered · _headed_row · _picks · _write 지움(로직 JSON 쓰는 곳 0) - Machine.register 의 mirror 줄 · Store_Save._logic_file · Store_Cache 「!= 로직」 표지 걷음 · labor_errors = 있는 기초 키(수식 문서)만(whole.logic 갈래 지움) - M01 Doc: _row · sync_tags · ensure · built · of_row · make 지움 · 읽기 「층바탕」(빌더 문서) 뺌 · 손고침 = 셈 칸을 고친 적 있는 기초(저장 전 문서와 다르면 붙음 · 한 번 붙으면 남음 · 브레인 정함) - M02 Doc_Sk.base_doc · Doc_Sk_Path 층바탕의 빌더 문서 갈래 지움(그 자리 = 지금 문서) - 화면 LogicRow 셈 칸 · [신규] 빈 셈 칸 · 안 쓰는 꼴 셋 지움 - 시험: 855_l3_doc_only = 옛 로직 파일 놓여도 안 읽고 안 씀 · 848_1 손고침 표지 · 848_10 빌더 층 시험 지움 · 파일만 복사한 프로젝트 층(바탕문서 없음) = 지금 문서를 따라감 · 854_2 복사 = 원본 문서 금액(옛 엔진 대조 뺌) · 848_5 · 855_l1 로직 줄 대조 뺌 · labor_errors 손님 셋 = 있는 키 묶음 - 서버 답 243 건 다름 0 · typecheck 0 · 관련 105 파일(717_2a 원래 실패 · 792_3 엔진 몸 일감 몫 빼고) 통과 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
291 lines
9.6 KiB
Python
291 lines
9.6 KiB
Python
"""M01 마스터 데이터 관리자 API — 계약 `resources/master_data/_화면_계약.md`.
|
|
|
|
⚠ 권한은 등록하는 쪽(`main.py`)이 `system_admin_only` 로 붙임.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from decimal import Decimal
|
|
from typing import Any, Literal
|
|
|
|
from fastapi import APIRouter, HTTPException
|
|
from pydantic import BaseModel
|
|
|
|
from M01_MasterData import M01_MasterData_Doc as doc_screen
|
|
from M01_MasterData import M01_MasterData_Machine as machine
|
|
from M01_MasterData import M01_MasterData_Machine_Impact as machine_impact
|
|
from M01_MasterData import M01_MasterData_Machine_Uses as machine_uses
|
|
from M01_MasterData import M01_MasterData_Parts as parts
|
|
from M01_MasterData import M01_MasterData_Store as store
|
|
from M01_MasterData import M01_MasterData_Store_List as store_list
|
|
from M01_MasterData import M01_MasterData_RateSheet as rate_sheet
|
|
from M01_MasterData import M01_MasterData_Store_Make as make
|
|
|
|
import master_basis as mbs # noqa: E402 (`store` 가 scripts 를 길에 둠)
|
|
|
|
router = APIRouter(prefix="/api/m01", tags=["M01 MasterData"])
|
|
|
|
if "pytest" not in sys.modules: # 시험은 사본 폴더를 써서 정본을 미리 읽을 까닭이 없음
|
|
store.warm() # 서버가 뜰 때 뒤에서 마스터를 한 번 읽어 둠 — 첫 목록을 기다리지 않게
|
|
|
|
|
|
class Change(BaseModel):
|
|
op: Literal["edit", "add", "delete"]
|
|
key: str | None = None
|
|
row: dict[str, Any] | None = None
|
|
|
|
|
|
class FileChanges(BaseModel):
|
|
file: str
|
|
version: str
|
|
changes: list[Change]
|
|
|
|
|
|
class SaveBody(BaseModel):
|
|
files: list[FileChanges]
|
|
개정확인: bool = False # 로직 정본 줄 고침 = 「원문 개정 반영」 확인(713-1) · 없으면 409
|
|
|
|
|
|
class CopyLogic(BaseModel):
|
|
"""[복사/생성](본떠 만들기) — 원본 문서를 새 자체 기초로 · 빈 글 = 원본 그대로."""
|
|
|
|
key: str
|
|
이름: str = ""
|
|
owner: str = make.OWNERS[0]
|
|
원문번호: str = ""
|
|
결과단위: str = ""
|
|
출처: str = ""
|
|
|
|
|
|
def _num(v):
|
|
"""Decimal → JSON 수(그냥 두면 글자로 나감)."""
|
|
if isinstance(v, Decimal):
|
|
return int(v) if v == v.to_integral_value() else float(v)
|
|
if isinstance(v, list):
|
|
return [_num(x) for x in v]
|
|
if isinstance(v, dict):
|
|
return {k: _num(x) for k, x in v.items()}
|
|
return v
|
|
|
|
|
|
def _call(fn, *args):
|
|
try:
|
|
return _num(fn(*args))
|
|
except store.StoreError as e:
|
|
raise HTTPException(status_code=e.status, detail=e.detail) from e
|
|
|
|
|
|
@router.get("/groups/{group}/files")
|
|
def get_files(group: str) -> dict:
|
|
"""`판정규` = 머리 판의 해(「2026-01-01」 · 「2026」 → 「2026」) · 읽을 때 파생(파일 안 씀)."""
|
|
files = _call(store.files_of, group)
|
|
return {"files": [{**f, "판정규": mbs.edition(f["edition"])} for f in files]}
|
|
|
|
|
|
@router.get("/rate-sheet")
|
|
def get_rate_sheet() -> dict:
|
|
"""요율 화면 위쪽 내장 엑셀(조달청 제비율) — 읽기만(798-1)."""
|
|
return _call(rate_sheet.load)
|
|
|
|
|
|
@router.get("/subs")
|
|
def get_subs(file: str = "", group: str = "") -> dict:
|
|
return _call(store.subs, file, group)
|
|
|
|
|
|
@router.get("/rows")
|
|
def get_rows(
|
|
file: str,
|
|
page: int = 1,
|
|
size: int = 50,
|
|
q: str = "",
|
|
unlinked: bool = False,
|
|
sub: str = "",
|
|
detail: str = "",
|
|
state: str = "",
|
|
) -> dict:
|
|
return _call(store.rows, file, page, size, q, unlinked, sub, detail, state)
|
|
|
|
|
|
@router.get("/tables")
|
|
def get_tables(
|
|
file: str = "",
|
|
group: str = "",
|
|
sub: str = "",
|
|
detail: str = "",
|
|
q: str = "",
|
|
page: int = 1,
|
|
size: int = 30,
|
|
usage: str = "",
|
|
section: str = "",
|
|
) -> dict:
|
|
out = _call(store.tables, file, group, sub, detail, q, page, size, usage, section)
|
|
for t in out["tables"]: # 기준배 · 기준단위 — 읽을 때 파생(정본 표에 안 씀 · 712-3)
|
|
t["기준파생"] = _num(mbs.basis(t))
|
|
return out
|
|
|
|
|
|
@router.get("/table")
|
|
def get_table(file: str, key: str) -> dict:
|
|
"""`기준파생` 은 표 밖 칸 — 표 줄째 되돌려 저장해도 정본에 안 섞임."""
|
|
out = _call(store.table, file, key)
|
|
return {**out, "기준파생": _num(mbs.basis(out["table"]))}
|
|
|
|
|
|
@router.get("/logics")
|
|
def get_logics(
|
|
sub: str = "", detail: str = "", q: str = "", blocked: int | None = None, owner: str = ""
|
|
) -> dict:
|
|
"""줄마다 덧칸(묶음 · 작업량 · 부르는/불리는 수 · 관련 · 713-3) — 읽기만."""
|
|
rows = parts.strip(_call(store.logics, sub, detail, q, blocked, owner)) # 부품 문서 뺌(813-2)
|
|
return {"logics": store_list.attach(rows)}
|
|
|
|
|
|
@router.get("/parts")
|
|
def get_parts(group: str, detail: str = "") -> dict:
|
|
"""부품 문서(813-2) — 계수식 · 기계 상세구분의 기계경비식 · 작업량 틀."""
|
|
return _call(parts.of_kind, group, detail)
|
|
|
|
|
|
@router.get("/logic")
|
|
def get_logic(key: str) -> dict:
|
|
"""`지문` = 수식 문서 셈 칸 지문(`M02_Doc_Copy.doc_fp` · 855 L2 ⓐ) — 이름표 · 비고 고침은 안 바꿈."""
|
|
from M02_MasterTemplete import M02_Doc_Copy as doc_copy # M02 가 M01 을 부름 — 늦게
|
|
|
|
out = _call(store.logic, key)
|
|
return {**out, "지문": doc_copy.doc_fp(doc_screen.docs().get(key))}
|
|
|
|
|
|
@router.get("/logic/source")
|
|
def get_logic_source(src: str) -> dict:
|
|
"""로직 원문 — 출처 글로 찾은 품셈 본문 절(읽기만)."""
|
|
return _call(make.source, src)
|
|
|
|
|
|
@router.get("/elements")
|
|
def get_elements(group: str, q: str = "", limit: int = 50) -> dict:
|
|
return _call(store.elements, group, q, limit)
|
|
|
|
|
|
@router.get("/pick")
|
|
def get_pick(kind: str, q: str = "", limit: int = 50) -> dict:
|
|
return _call(store.pick, kind, q, limit)
|
|
|
|
|
|
@router.get("/materials")
|
|
def get_materials(
|
|
sub: str,
|
|
detail: str = "",
|
|
spec: str = "",
|
|
region: str = "",
|
|
unit: str = "",
|
|
limit: int = 50,
|
|
) -> dict:
|
|
"""재료 고르기 조건 안 후보 — sub = 구분 · detail = 상세구분 · spec = 규격 · region = 자재지역
|
|
· unit = 호표 줄 단위(주면 그 단위 줄만)."""
|
|
return _call(store.materials, sub, detail, spec, region, unit, limit)
|
|
|
|
|
|
@router.get("/machine/lists")
|
|
def get_machine_lists() -> dict:
|
|
"""기계 양식 고르기 — 연료 · 직종 · 단가 · 원문 · 구분(821-2)."""
|
|
return _call(machine.lists)
|
|
|
|
|
|
@router.get("/machine/hourly")
|
|
def get_machine_hourly(keys: str) -> dict:
|
|
"""기계 키(쉼표) → 시간당 경비(서버 기계경비식 · 전국평균)."""
|
|
return _call(machine.hourly, [k for k in keys.split(",") if k])
|
|
|
|
|
|
@router.get("/machine/uses")
|
|
def get_machine_uses(key: str) -> dict:
|
|
"""쓰는 곳 — 수식 문서 기준 직접 · 기본 · 부름 사슬 · 고침 · 단가산출 층별 수(848-5)."""
|
|
return _call(machine_uses.uses, key)
|
|
|
|
|
|
@router.post("/machine/impact")
|
|
def post_machine_impact(body: SaveBody) -> dict:
|
|
"""[저장] 전 영향 목록 — 몸 = /save 묶음 · 쓰기 없음(848-5)."""
|
|
return _call(machine_impact.impact, [f.model_dump() for f in body.files])
|
|
|
|
|
|
@router.get("/machine/find")
|
|
def get_machine_find(q: str = "") -> dict:
|
|
"""비슷한 기계에서 시작 — 이름 · 규격 · 별칭 찾기(값 묶음 같이)."""
|
|
return {"rows": _call(machine.find, q)}
|
|
|
|
|
|
@router.get("/machine/row")
|
|
def get_machine_row(key: str) -> dict:
|
|
return _call(machine.row, key)
|
|
|
|
|
|
@router.post("/machine/formula")
|
|
def post_machine_formula(row: dict[str, Any]) -> dict:
|
|
"""기계 줄(저장 전 고친 값도) → 쓰는 계산식 {키 · 이름 · 방법 · 까닭}(822-2)."""
|
|
return _call(machine.formula, row)
|
|
|
|
|
|
@router.post("/save")
|
|
def post_save(body: SaveBody) -> dict:
|
|
"""로직 정본 줄 고침 = 개정 확인 · 새 줄(키 없음)은 자체 GX — {files, added, warnings}."""
|
|
return _call(make.save, [f.model_dump() for f in body.files], body.개정확인)
|
|
|
|
|
|
@router.post("/logic/copy")
|
|
def post_logic_copy(body: CopyLogic) -> dict:
|
|
more = {"원문번호": body.원문번호, "결과단위": body.결과단위, "출처": body.출처}
|
|
return _call(make.logic_copy, body.key, body.이름, body.owner, more)
|
|
|
|
|
|
# ── 수식 문서(802-3) — 단가산출 기초 정본 · 화면은 같은 계산기로 즉시 셈 ──
|
|
class DocBody(BaseModel):
|
|
문서: dict[str, Any]
|
|
입력: dict[str, Any] = {}
|
|
판: str | None = None # 저장 — 읽을 때 받은 판(다르면 409 · 없으면 대조 안 함)
|
|
|
|
|
|
@router.get("/logic/doc")
|
|
def get_logic_doc(key: str) -> dict:
|
|
"""수식 문서 {문서, 셈, 연결, 파일, 새} — 없는 키 = 404(쓰기 없음)."""
|
|
return _call(doc_screen.read, key)
|
|
|
|
|
|
@router.post("/logic/doc/preview")
|
|
def post_logic_doc_preview(body: DocBody) -> dict:
|
|
"""미리 셈 {셈, 연결} — 화면 캐시에 없는 연결을 채움 · 쓰기 없음."""
|
|
return _call(doc_screen.preview, body.문서, body.입력)
|
|
|
|
|
|
@router.post("/logic/doc/save")
|
|
def post_logic_doc_save(body: DocBody) -> dict:
|
|
"""저장 — 서버가 정본으로 다시 셈 · 문서 파일에 씀 → {문서, 셈, 연결, 파일}."""
|
|
return _call(doc_screen.save, body.문서, body.판)
|
|
|
|
|
|
class RemoveBody(BaseModel):
|
|
key: str
|
|
file: str
|
|
version: str
|
|
개정확인: bool = False
|
|
|
|
|
|
@router.get("/logic/users")
|
|
def get_logic_users(key: str) -> dict:
|
|
"""로직을 부르는 곳(지우기 전 확인 · 읽기만) — {쓰는곳}."""
|
|
return {"쓰는곳": doc_screen.users(key)}
|
|
|
|
|
|
@router.post("/logic/remove")
|
|
def post_logic_remove(body: RemoveBody) -> dict:
|
|
"""로직 지우기(804-7) — 수식 문서 · 부르는 곳 있으면 409 {쓰는곳}."""
|
|
return _call(doc_screen.remove, body.key, body.file, body.version, body.개정확인)
|
|
|
|
|
|
@router.get("/logic/doc/table")
|
|
def get_logic_doc_table(key: str) -> dict:
|
|
"""표 하나 — 조건 · 칸 고르기(읽기만)."""
|
|
return _call(doc_screen.table, key)
|