Files
Aislo/M02_MasterTemplete/M02_Hopyo_Store.py
T
eomsangdonandClaude Opus 5.5 9c67cdac64 chore(853-3): 옛 별칭 장부 함수 열둘 · 맞춤 기억 걷음 — 묶음 ②
- Hopyo_Ledger: key · hopyo_key · _loose · _plain_of · upgrade · read · chain · books · recall · check · write · put + HOPYO · mm 지움(비시험 부름 0 — 장부 화면 · 길은 815-2 에 걷음) · Hopyo_Build 가 쓰는 _known · doc_id · check_pair · times_of · KINDS(+ input_names · _check_pick) 남김
- Hopyo_Store.memory · remember · MEMORY 지움(부르는 곳 = 위 죽은 장부 함수뿐 · storage 맞춤.json 0)
- 시험: test_m02_hopyo_ledger = 장부 읽기 · 쓰기 넷 지우고 살아 있는 짝 재검사(check_pair · times_of)만 남김 · test_707_4 B09 내역 기억 = M02 맞춤 저장 거치지 않고 기억 그대로 다음 공사 찾기에 넘김(결과 그대로) · test_718_1 장부 줄 두 줄 뺌 · test_815_2 ledger.write 글자 확인 줄 뺌(함수 없음)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 15:10:28 +09:00

176 lines
6.9 KiB
Python

"""M02 일위대가 실무자료 저장(PLAN 324-1) — 층 폴더 `실무자료/<키>.json` ·
엑셀꼴 격자 `실무자료/격자/<키>.json`(329-1 · 파일과 같이 지움).
파일 = 읽은 결과만(원본 엑셀 안 둠) `{키, 파일, 올린때, 올린이, 시트, 호표, 검산}` · 키 `HP-######`
(층마다 다음 번호) · 옛 맞춤 기억(`맞춤.json` · 별칭 장부)은 853-3 에서 지움.
층 종류(`layers.KINDS`) 밖 폴더 — 양식 목록 · 복사 · 프로젝트 씨앗에 안 섞임 · 권한은 길 몫.
한시 불러오기(718-1 · 743-1) — 파일에 `지문`(올린 엑셀 sha256) · 목록 = 지문 있고 하루 안 지난 것
(작업 중)만 · 옛 HP · 하루 지난 HP 는 목록에서 숨김(지움 = `M02_Hopyo_Forget`) ·
`실무자료/불러옴.json` `{번}` = 낸 키 가장 큰 번(지운 뒤에도 키를 다시 안 씀 · 옛 `지문` 안 읽음).
판(776-2) = 읽기 꼴(Book) 판 `BOOK` 을 HP 에 찍음 · 다른 판 = 지난 것(목록에서 숨김 ·
다음 올림 때 끝냄 · 작업 중 열기 = 409 「다시 올림」 · 옛 꼴 읽기 갈래 없음).
"""
from __future__ import annotations
import hashlib
import json
import re
import threading
from datetime import datetime, timedelta, timezone
from pathlib import Path
from typing import Any
from common_util.common_util_json import atomic_write_json
from common_util.common_util_time import utc_now_text
from M02_MasterTemplete import M02_MasterTemplete_Store as store
DIRNAME = "실무자료"
GRID = "격자"
DONE = "불러옴"
NO_GRID = "격자 없음 — 다시 올리면 보임"
RELOAD = "읽기 꼴이 바뀐 옛 불러오기 — 엑셀을 다시 올림"
EXPIRE = timedelta(days=1) # 작업 중 HP 보관 — 올린 뒤 하루
BOOK = 3 # 읽기 꼴(Book) 판 — 읽기 · 정규화 출력 꼴을 바꾸면 올림
_KEY = re.compile(r"^HP-(\d{6})$")
# ponytail: 프로세스 안 잠금 — 서버를 여럿 띄우면 파일 잠금으로
_LOCK = threading.Lock()
def _dir(folder: str | Path) -> Path:
return Path(folder) / DIRNAME
def _path(folder: str | Path, key: str) -> Path:
if not _KEY.match(str(key)):
raise store.StoreError(404, f"없는 실무자료 「{key}」")
return _dir(folder) / f"{key}.json"
def _load(path: Path) -> Any:
try:
return json.loads(path.read_bytes())
except (OSError, ValueError):
return None
def _grid_path(folder: str | Path, key: str) -> Path:
return _dir(folder) / GRID / _path(folder, key).name
def brief(doc: dict[str, Any]) -> dict[str, Any]:
"""목록 한 줄 — `{키, 파일, 올린때, 올린이, 시트, 호표수, 어긋남}`."""
keep = ("키", "파일", "올린때", "올린이", "시트")
return {
**{k: doc.get(k) for k in keep},
"호표수": len(doc.get("호표") or []),
"어긋남": len((doc.get("검산") or {}).get("어긋남") or []),
}
def fingerprint(data: bytes) -> str:
"""올린 엑셀 지문 — 같은 파일 다시 올림을 알아봄."""
return hashlib.sha256(data).hexdigest()
def stale(doc: dict[str, Any], now: datetime | None = None) -> bool:
"""하루 지난 HP · 다른 판 HP — 올린때 기준 · 못 읽는 때 = 지난 것."""
if doc.get("판") != BOOK:
return True
try:
when = datetime.fromisoformat(str(doc.get("올린때") or "").replace("Z", "+00:00"))
except ValueError:
return True
return (now or datetime.now(timezone.utc)) - when > EXPIRE
def rows(folder: str | Path) -> list[dict[str, Any]]:
"""층 실무자료 목록(키 차례) — 작업 중(지문 있음 · 하루 안)만 · 옛 HP · 지난 HP 는 숨김."""
out = []
for path in sorted(_dir(folder).glob("HP-*.json")):
doc = _load(path)
if isinstance(doc, dict) and _KEY.match(path.stem) and doc.get("지문") and not stale(doc):
out.append({**brief(doc), "지문": doc["지문"]})
return out
def done(folder: str | Path) -> dict[str, Any]:
"""키 번 기록 `{번, 지문}`(지문 = 743 전 끝낸 기록 · 안 읽음 · 정리 `Forget.tidy`)."""
doc = _load(_dir(folder) / f"{DONE}.json")
doc = doc if isinstance(doc, dict) else {}
marks = doc.get("지문")
return {"번": int(doc.get("번") or 0), "지문": marks if isinstance(marks, dict) else {}}
def _put_done(folder: str | Path, got: dict[str, Any]) -> None:
atomic_write_json(_dir(folder) / f"{DONE}.json", got)
def read(folder: str | Path, key: str, old: bool = False) -> dict[str, Any]:
"""HP — 다른 판 = 409 「다시 올림」(`old` = 끝내기 · 정리만 옛 판도 읽음)."""
doc = _load(_path(folder, key))
if not isinstance(doc, dict):
raise store.StoreError(404, f"없는 실무자료 「{key}」")
if not old and doc.get("판") != BOOK:
raise store.StoreError(409, RELOAD)
return doc
def save(
folder: str | Path,
name: str,
parsed: dict[str, Any],
who: Any,
grid: dict[str, Any] | None = None,
mark: str | None = None,
first: Any = None,
) -> dict[str, Any]:
"""읽은 결과(+ 격자) → 새 키로 씀 → 목록 한 줄 · `mark` = 올린 엑셀 지문 ·
`first(키)` = HP 를 목록에 보이기 전에 할 일(산근 보관 — 올린 직후 409 막음 · 814-1) · 돌려준 값 = 답 `읽기불가`."""
with _LOCK:
have = [
int(m.group(1)) for p in _dir(folder).glob("HP-*.json") if (m := _KEY.match(p.stem))
]
log = done(folder)
log["번"] = max(*have, log["번"], 0) + 1
key = f"HP-{log['번']:06d}"
doc = {
"키": key,
"파일": name,
"올린때": utc_now_text(),
"올린이": who,
**({"지문": mark} if mark else {}),
**parsed,
"판": BOOK,
}
if grid is not None:
book = {**grid["책"], "열": key}
atomic_write_json(_grid_path(folder, key), {**grid, "책": book})
cannot = first(key) if first else None
atomic_write_json(_path(folder, key), doc)
_put_done(folder, log)
return {
**brief(doc),
**({"지문": mark} if mark else {}),
**({"읽기불가": cannot} if cannot else {}),
}
def grid(folder: str | Path, key: str) -> dict[str, Any]:
"""엑셀꼴 격자 `{책, 호표, 단산}` — 없으면(옛 파일) 404."""
doc = _load(_grid_path(folder, key))
if not isinstance(doc, dict):
raise store.StoreError(404, NO_GRID)
return doc
def delete(folder: str | Path, key: str) -> None:
"""HP · 격자 지움(끝낸 기록 없음 · 같은 엑셀 다시 올림 됨 · 743-1)."""
path = _path(folder, key)
with _LOCK:
if not isinstance(_load(path), dict):
raise store.StoreError(404, f"없는 실무자료 「{key}」")
path.unlink()
_grid_path(folder, key).unlink(missing_ok=True)
(_dir(folder) / "산근" / f"{key}.json").unlink(missing_ok=True) # 793-3b 산근 시트