48c936ea6e
Фронт не хранит карточку как истину: локально живут только правки курсанта, ещё не подтверждённые сервером. Распознанное сервером значение перекрывает набранное, эхо своей правки её подтверждает. Иначе автозаполнение и ручной ввод дерутся за одно поле — худший класс багов для отладки в последнюю ночь. Описание полей отдельно от отрисовки: по нему же карточка рисуется read-only на мониторе, пульте и АРМ ДДС. Сверка формы с контрактом встроена в make typecheck: все 40 полей домена на форме, а поле, добавленное в контракт и забытое в форме, теперь поймается само. Это пропущенный факт по вине интерфейса, а не курсанта. Открытый вопрос в карточке: нужно ли автозаполнение карточки из речи вообще — полнота КИО оценивается кодом E5, и если сервер впишет адрес сам, курсант перестанет за неё отвечать.
45 lines
2.2 KiB
JavaScript
45 lines
2.2 KiB
JavaScript
// Все поля карточки из контракта должны быть на форме.
|
||
//
|
||
// Домен живёт в 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} полей контракта на форме`);
|