feat(z01): 덮개에 넷째 낱말 meaning_changed — 고칠 때 그 줄의 값 아닌 글자 칸(이름·규격·단위·인도조건)을 함께 적고 갱신 뒤 달라지면 「줄의 뜻이 바뀜」(같은 코드에 다른 기준 — 노임 국가유산직종 개편 · 자재 KS 개정) · was/now 는 서버가 한 줄로 합쳐 냄(이름 칸이 여럿인 자료가 있어 화면이 합치면 판정 두 벌) · 모아 보기 차례 맨 위 · 판·공표 날짜는 뜻 칸에서 뺌(브레인)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BW6Jdsh18WPtYUR6THZJqn

Z01_MasterData/Z01_MasterData_Overrides.py

@@ -25,7 +25,10 @@ from common_util.common_util_json import atomic_write_json
 
 OVERRIDE_DIR = Path(__file__).resolve().parent.parent / "resources" / "data_master_override"
 EDITED, SOURCE_CHANGED, ORPHAN = "edited", "source_changed", "orphan"
-STATE_ORDER = (SOURCE_CHANGED, ORPHAN, EDITED)  # 모아 보기 차례 — 확인할 것이 맨 위
+#: ⚠ 넷째 — 값이 아니라 **줄의 뜻**이 바뀜(같은 코드에 다른 기준: 노임 문화재→국가유산 · 자재 KS 개정 규격).
+#: 값이 틀린 것보다 **다른 물건에 값이 붙은 것**이 더 나쁨 → 맨 위(브레인 2026-09-16).
+MEANING_CHANGED = "meaning_changed"
+STATE_ORDER = (MEANING_CHANGED, SOURCE_CHANGED, ORPHAN, EDITED)  # 모아 보기 차례 — 센 것이 맨 위
 _LOCK = threading.Lock()  # ponytail: 한 프로세스 잠금 — 서버를 여럿 띄우면 파일 잠금이 필요
 
 
@@ -61,9 +64,33 @@ def check_value(value: Any) -> str | None:
     return None
 
 
-def mark(original: Any, value: Any, current: Any) -> dict[str, Any]:
-    state = EDITED if same(original, current) else SOURCE_CHANGED
-    return {"original": original, "value": value, "state": state, "current": current}
+#: 이름 칸이 여럿인 자료가 있어(자재 품명·규격·단위·인도조건) **서버가 한 줄로 합침** — 화면이 합치면 판정이 두 벌.
+_JOIN = " · "
+
+
+def meaning_line(entry: dict[str, Any], row: dict[str, Any] | None) -> tuple[str, str]:
+    """(고칠 때 그 줄 · 지금 그 줄) 한 줄씩 — 달라진 데가 없으면 빈 둘."""
+    stored = entry.get("meaning") or {}
+    keys = [k for k in stored if row is not None and k in row]
+    if not keys or all(row[k] == stored[k] for k in keys):
+        return "", ""
+    return (
+        _JOIN.join(str(stored[k]) for k in keys),
+        _JOIN.join(str(row[k]) for k in keys),
+    )
+
+
+def mark(entry: dict[str, Any], current: Any, row: dict[str, Any] | None = None) -> dict[str, Any]:
+    original, value = entry.get("original"), entry.get("value")
+    was, now = meaning_line(entry, row)
+    if was:
+        state = MEANING_CHANGED
+    else:
+        state = EDITED if same(original, current) else SOURCE_CHANGED
+    out = {"original": original, "value": value, "state": state, "current": current}
+    if was:  # ⚠ meaning_changed 인데 비어 오면 서버 버그 — 늘 함께 나감
+        out["was"], out["now"] = was, now
+    return out
 
 
 def overlay(kind: str, rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
@@ -80,7 +107,7 @@ def overlay(kind: str, rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
         for column, entry in entries.items():
             if column not in row:
                 continue  # 주인 없는 칸 — 모아 보기에만
-            marks[column] = mark(entry.get("original"), entry.get("value"), row[column])
+            marks[column] = mark(entry, row[column], row)
             row[column] = entry.get("value")
         if marks:
             row["@overrides"] = marks
@@ -88,7 +115,13 @@ def overlay(kind: str, rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
     return out
 
 
-def write(kind: str, base_row: dict[str, Any], values: dict[str, Any], by: Any) -> None:
+def write(
+    kind: str,
+    base_row: dict[str, Any],
+    values: dict[str, Any],
+    by: Any,
+    meaning: dict[str, Any] | None = None,
+) -> None:
     """고친 값을 덮개에 씀 — null 이거나 지금 원본과 같으면 그 칸을 뺌. 원본은 안 건드림."""
     row_id = base_row["@id"]
     with _LOCK:
@@ -103,6 +136,8 @@ def write(kind: str, base_row: dict[str, Any], values: dict[str, Any], by: Any)
                 "value": value,
                 "original": current,  # 이 값을 보고 고침 — 갱신 뒤 원본과 달라지면 source_changed
                 "source": base_row.get("@source", ""),
+                # 값이 아닌 글자 칸 — 갱신으로 **줄의 뜻**이 바뀌면 이것으로 잡음
+                "meaning": meaning or {},
                 "at": datetime.now().astimezone().isoformat(timespec="seconds"),
                 "by": by,
             }
@@ -148,10 +183,10 @@ def items(kind: str, base_rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
         row = by_id.get(row_id)
         for column, entry in entries.items():
             if row is None or column not in row:
-                current, state = None, ORPHAN
+                current, marked = None, {"state": ORPHAN}
             else:
                 current = row[column]
-                state = mark(entry.get("original"), entry.get("value"), current)["state"]
+                marked = mark(entry, current, row)
             out.append(
                 {
                     "kind": kind,
@@ -160,7 +195,8 @@ def items(kind: str, base_rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
                     "original": entry.get("original"),
                     "current": current,
                     "value": entry.get("value"),
-                    "state": state,
+                    "state": marked["state"],
+                    **({"was": marked["was"], "now": marked["now"]} if "was" in marked else {}),
                 }
             )
     return out