pub/lct-hack
Watch
1
0
Fork
You've already forked lct-hack
 0
Code Releases Packages 5 Activity

lct-10: карточка КИО — форма, слияние правок, read-only

Browse source 
Фронт не хранит карточку как истину: локально живут только правки
курсанта, ещё не подтверждённые сервером. Распознанное сервером значение
перекрывает набранное, эхо своей правки её подтверждает. Иначе
автозаполнение и ручной ввод дерутся за одно поле — худший класс багов
для отладки в последнюю ночь.

Описание полей отдельно от отрисовки: по нему же карточка рисуется
read-only на мониторе, пульте и АРМ ДДС.

Сверка формы с контрактом встроена в make typecheck: все 40 полей
домена на форме, а поле, добавленное в контракт и забытое в форме,
теперь поймается само. Это пропущенный факт по вине интерфейса,
а не курсанта.

Открытый вопрос в карточке: нужно ли автозаполнение карточки из речи
вообще — полнота КИО оценивается кодом E5, и если сервер впишет адрес
сам, курсант перестанет за неё отвечать.
This commit is contained in:
Ivan Gerasimov 2026-09-17 21:16:51 +03:00
commit 48c936ea6e
8 changed files with 454 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

45
frontend/scripts/check-kio-fields.mjs Normal file
View file

@ -0,0 +1,45 @@
// Все поля карточки из контракта должны быть на форме.
//
// Домен живёт в 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} полей контракта на форме`);