- 규칙 한 벌 = common_util_show_digits.ts ↔ master_doc_digits.py(짝 · 거울 시험 test_859_3) 표 값 = 고른 줄의 원문 글자 자리(끝 0 살림 · 서버 표 캐시에 줄마다 `자리` 실음) · 식 값 = Q 3 · n 2 · cm 3(8-1 주①) › 원 단위 · 비목 이름 = 소수 한 자리 › 그 밖 유효숫자 3(소수 2~6) · 입력 · 요소 = 자료 그대로 · 만약으로 고른 기호 하나인 식은 그 값의 갈래를 따름 - 줄 쌓기 오른쪽(공식 줄 · 값 묶음 · 금액 줄 수량 · 단가 식 · 결과) · 왼쪽 값 · 작업량 줄 · M02 계산서 글 - test_845_2 기대 글 고침(노무비 계수 0.208333 → 0.208 — 뜻한 바뀜 · 금액 59,020.2 그대로) - 관련 시험 + 관문 256 통과 · typecheck 0 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
109 lines
4.0 KiB
TypeScript
109 lines
4.0 KiB
TypeScript
/* =============================================================================
|
|
* common_util_formula_doc_cache.ts
|
|
* 수식 문서 연결 캐시(PLAN 802-3) — 서버 기록(요소 값 · 표 · 단가산출 문서) → `DocLinks`
|
|
* 화면이 같은 계산기(`calcDoc`)로 네트워크 없이 셈 · 캐시에 없는 연결 = 빈 값(「불러오는 중」) + `missing` 표시
|
|
* → 화면이 뒤에서 미리 셈(서버 기록)을 받아 `merge` 뒤 다시 셈
|
|
* 파이썬 짝 = resources/master_data/scripts/master_doc_record.py(기록 꼴) · 화면 · DOM · fetch 없음
|
|
* ========================================================================== */
|
|
|
|
import type { FormulaDoc } from "./common_util_formula_doc";
|
|
import { Broken, Gap, plainText, type DocLinks } from "./common_util_formula_doc_calc";
|
|
import { tableValue, type DocTable } from "./common_util_formula_doc_table";
|
|
|
|
type Payload = Record<string, unknown>;
|
|
type Got = { 값?: unknown; 빈?: string; 끊김?: string };
|
|
|
|
export interface DocRecord {
|
|
요소?: (Got & { p: Payload })[];
|
|
표?: Record<string, (DocTable & { 끊김?: string }) | null>;
|
|
문서?: Record<string, FormulaDoc | null>;
|
|
이름?: Record<string, string>;
|
|
}
|
|
|
|
export const LOADING = "불러오는 중";
|
|
|
|
function canon(v: unknown): unknown {
|
|
if (typeof v === "number") return plainText(v);
|
|
if (Array.isArray(v)) return v.map(canon);
|
|
if (v && typeof v === "object") {
|
|
const out: Record<string, unknown> = {};
|
|
for (const k of Object.keys(v).sort()) out[k] = canon((v as Payload)[k]);
|
|
return out;
|
|
}
|
|
return v;
|
|
}
|
|
const keyOf = (p: Payload): string => JSON.stringify(canon(p));
|
|
|
|
export interface DocCache {
|
|
links: DocLinks;
|
|
/** 서버 기록을 더함 */
|
|
merge: (rec: DocRecord | undefined) => void;
|
|
/** 키 → 이름(연결 글) */
|
|
names: Map<string, string>;
|
|
/** 마지막 셈에서 캐시에 없던 연결이 있었나 — 읽으면 지움 */
|
|
takeMissing: () => boolean;
|
|
/** 표 하나 넣음(고르기에서 받은 것) */
|
|
putTable: (ref: string, table: DocTable) => void;
|
|
/** 표 통째(859-3 보이는 자리 — 줄마다 원문 글자 자리 `자리`) · 없으면 undefined */
|
|
tableOf: (ref: string) => (DocTable & { 끊김?: string }) | undefined;
|
|
}
|
|
|
|
export function createDocCache(): DocCache {
|
|
const elements = new Map<string, Got>();
|
|
const tables = new Map<string, (DocTable & { 끊김?: string }) | null>();
|
|
const docs = new Map<string, FormulaDoc | null>();
|
|
const names = new Map<string, string>();
|
|
let missing = false;
|
|
const miss = (): never => {
|
|
missing = true;
|
|
throw new Gap(LOADING);
|
|
};
|
|
const links: DocLinks = {
|
|
element(p) {
|
|
if (!p.키 && p.재료 === undefined) throw new Broken("요소 고르지 않음"); // 짝 master_doc_link
|
|
const got = elements.get(keyOf(p));
|
|
if (!got) return miss();
|
|
if (got.빈 !== undefined) throw new Gap(got.빈);
|
|
if (got.끊김 !== undefined) throw new Broken(got.끊김);
|
|
return got.값;
|
|
},
|
|
table(p) {
|
|
if (!p.표 || !p.칸) throw new Broken("표 · 칸 고르지 않음");
|
|
const ref = String(p.표);
|
|
if (!tables.has(ref)) return miss();
|
|
const t = tables.get(ref);
|
|
if (!t || t.끊김 !== undefined) throw new Broken(t?.끊김 ?? `「${ref}」 표 아님`);
|
|
return tableValue(t, p);
|
|
},
|
|
doc(key) {
|
|
if (!key) return null;
|
|
if (!docs.has(key)) return miss();
|
|
return docs.get(key) ?? null;
|
|
},
|
|
};
|
|
return {
|
|
links,
|
|
names,
|
|
merge(rec) {
|
|
for (const one of rec?.요소 ?? []) {
|
|
const { p, ...got } = one;
|
|
elements.set(keyOf(p), got);
|
|
}
|
|
for (const [k, t] of Object.entries(rec?.표 ?? {})) tables.set(k, t);
|
|
for (const [k, d] of Object.entries(rec?.문서 ?? {})) docs.set(k, d);
|
|
for (const [k, n] of Object.entries(rec?.이름 ?? {})) names.set(k, n);
|
|
},
|
|
takeMissing() {
|
|
const was = missing;
|
|
missing = false;
|
|
return was;
|
|
},
|
|
putTable(ref, table) {
|
|
tables.set(ref, table);
|
|
},
|
|
tableOf(ref) {
|
|
return tables.get(ref) ?? undefined;
|
|
},
|
|
};
|
|
}
|