lct-hack/frontend/scripts/check-kio-fields.mjs

45 lines
2.2 KiB
JavaScript
Raw Normal View History

lct-10: карточка КИО — форма, слияние правок, read-only Фронт не хранит карточку как истину: локально живут только правки курсанта, ещё не подтверждённые сервером. Распознанное сервером значение перекрывает набранное, эхо своей правки её подтверждает. Иначе автозаполнение и ручной ввод дерутся за одно поле — худший класс багов для отладки в последнюю ночь. Описание полей отдельно от отрисовки: по нему же карточка рисуется read-only на мониторе, пульте и АРМ ДДС. Сверка формы с контрактом встроена в make typecheck: все 40 полей домена на форме, а поле, добавленное в контракт и забытое в форме, теперь поймается само. Это пропущенный факт по вине интерфейса, а не курсанта. Открытый вопрос в карточке: нужно ли автозаполнение карточки из речи вообще — полнота КИО оценивается кодом E5, и если сервер впишет адрес сам, курсант перестанет за неё отвечать.
2026-09-17 21:16:51 +03:00
// Все поля карточки из контракта должны быть на форме.
//
// Домен живёт в backend/app/domain/kio.py и меняется: поле, добавленное в контракт
// и забытое в форме, — это пропущенный факт по вине интерфейса, а не курсанта.
// Проверка сверяет пути в features/kio-card/fields.ts с типами из generated.ts.
import { readFileSync } from "node:fs";
const types = readFileSync(new URL("../src/shared/types/generated.ts", import.meta.url), "utf8");
const spec = readFileSync(new URL("../src/features/kio-card/fields.ts", import.meta.url), "utf8");
// Поля, которых на форме нет намеренно.
const SKIP = new Map([
["card_id", "служебный идентификатор, человеку не нужен"],
["coords", "координаты приходят от ЭРА-ГЛОНАСС, отдельным экраном"],
]);
const NESTED = { fire: "FireDetails", police: "PoliceDetails", medical: "MedicalDetails", utility: "UtilityDetails" };
function fieldsOf(name) {
const body = types.match(new RegExp(`export interface ${name} \\{([\\s\\S]*?)\\n\\}`))?.[1];
if (!body) throw new Error(`в generated.ts нет интерфейса ${name}`);
return [...body.matchAll(/^\s{2}(\w+)\??:/gm)].map((m) => m[1]);
}
const expected = [];
for (const field of fieldsOf("KIO")) {
if (SKIP.has(field)) continue;
if (field in NESTED) {
for (const nested of fieldsOf(NESTED[field])) expected.push(`${field}.${nested}`);
} else {
expected.push(field);
}
}
const shown = new Set([...spec.matchAll(/path:\s*"([^"]+)"/g)].map((m) => m[1]));
const missing = expected.filter((path) => !shown.has(path));
const extra = [...shown].filter((path) => !expected.includes(path));
if (missing.length || extra.length) {
if (missing.length) console.error("нет на форме КИО:", missing.join(", "));
if (extra.length) console.error("на форме есть, а в контракте нет:", extra.join(", "));
process.exit(1);
}
console.log(`карточка КИО: все ${expected.length} полей контракта на форме`);