каркас: домен, генерация типов фронта, стенд и карточки задач
Контракт в коде: КИО по нормативу, 43 события WS по шести союзам направлений,
таймеры ГОСТ, таксономия E1–E6, шесть компетенций радара. make types гоняет
их через JSON Schema в generated.ts, тест ловит забытую регенерацию.
Стенд: docker compose postgres + backend, health отвечает, база досягаема
из контейнера бэкенда. Makefile не врёт — нереализованные цели падают
и называют карточку, которая их закроет.
frontend/.npmrc: под WSL2 npm install зависает на дефолтных 15 сокетах.
2026-09-15 19:35:03 +03:00
|
|
|
|
/* Казённая база: системный шрифт, плотная сетка, три состояния норматива.
|
|
|
|
|
|
Продуктовой эстетики здесь быть не должно (docs/arch/FRONTEND.md). */
|
|
|
|
|
|
:root {
|
|
|
|
|
|
--bg: #f2f3f5;
|
|
|
|
|
|
--panel: #ffffff;
|
|
|
|
|
|
--line: #b9bec6;
|
|
|
|
|
|
--text: #14171a;
|
|
|
|
|
|
--ok: #1f6f3d;
|
|
|
|
|
|
--warn: #9a6b00;
|
|
|
|
|
|
--violated: #a51d1d;
|
|
|
|
|
|
font-family: system-ui, "Segoe UI", Roboto, sans-serif;
|
|
|
|
|
|
font-size: 15px;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
body {
|
|
|
|
|
|
margin: 0;
|
|
|
|
|
|
background: var(--bg);
|
|
|
|
|
|
color: var(--text);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
.stub {
|
|
|
|
|
|
padding: 24px;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
.stub h1 {
|
|
|
|
|
|
font-size: 20px;
|
|
|
|
|
|
font-weight: 600;
|
|
|
|
|
|
margin: 0 0 8px;
|
|
|
|
|
|
}
|
lct-08: каркас фронта, типизированный сокет, захват микрофона
Направление канала зашито в тип: у наблюдателя Out = never, отправить
нечего и нельзя; у преподавателя нет входящих. Разделение прав
архитектурное и на фронте тоже. Пока соединения нет, события не копятся:
истина на сервере, после переподключения придёт актуальное состояние.
Ресемплинг 48 → 16 кГц усредняет по окну выходного сэмпла: без фильтра
всё выше 8 кГц наложилось бы на речь и испортило распознавание. Проверено
числами: секунда звука — ровно 50 кадров по 320 сэмплов из 48 и 44.1 кГц,
помеха 15 кГц подавлена до 7.8%. Эхоподавление и автоусиление браузера
выключены: гарнитура эхо не даёт, а обработка портит речь для STT.
Бэкенд принимает бинарные кадры по тому же сокету, что и события; кадр
не того размера отбрасывается с одним предупреждением, а не 50 в секунду.
Логирование приложения не было настроено: uvicorn настраивает только
свои логгеры, и весь INFO модулей app.* молча терялся — нашлось, когда
в логе не оказалось строки о принятых кадрах.
make lesson запускает занятие и печатает ссылки на экраны — пульта
преподавателя ещё нет, а открыть АРМ курсанта без занятия не с чем.
Путь из браузера с живым микрофоном не проверен: нужен человек, шаги
записаны в карточке.
2026-09-17 14:19:38 +03:00
|
|
|
|
|
|
|
|
|
|
/* Плотная казённая сетка: таблица вместо карточек. */
|
|
|
|
|
|
.page { padding: 16px 24px; }
|
|
|
|
|
|
.page h1 { font-size: 20px; font-weight: 600; margin: 0 0 12px; }
|
|
|
|
|
|
.page h2 { font-size: 16px; font-weight: 600; margin: 20px 0 8px; }
|
|
|
|
|
|
.grid { border-collapse: collapse; background: var(--panel); min-width: 480px; }
|
|
|
|
|
|
.grid th, .grid td { border: 1px solid var(--line); padding: 4px 8px; text-align: left; vertical-align: top; }
|
|
|
|
|
|
.grid th { width: 200px; font-weight: 600; background: var(--bg); }
|
|
|
|
|
|
button { font: inherit; padding: 6px 16px; border: 1px solid var(--line); background: var(--panel); cursor: pointer; }
|
|
|
|
|
|
button:disabled { opacity: 0.5; cursor: default; }
|
|
|
|
|
|
.warn { color: var(--warn); }
|
|
|
|
|
|
.violated { color: var(--violated); }
|
lct-10: карточка КИО — форма, слияние правок, read-only
Фронт не хранит карточку как истину: локально живут только правки
курсанта, ещё не подтверждённые сервером. Распознанное сервером значение
перекрывает набранное, эхо своей правки её подтверждает. Иначе
автозаполнение и ручной ввод дерутся за одно поле — худший класс багов
для отладки в последнюю ночь.
Описание полей отдельно от отрисовки: по нему же карточка рисуется
read-only на мониторе, пульте и АРМ ДДС.
Сверка формы с контрактом встроена в make typecheck: все 40 полей
домена на форме, а поле, добавленное в контракт и забытое в форме,
теперь поймается само. Это пропущенный факт по вине интерфейса,
а не курсанта.
Открытый вопрос в карточке: нужно ли автозаполнение карточки из речи
вообще — полнота КИО оценивается кодом E5, и если сервер впишет адрес
сам, курсант перестанет за неё отвечать.
2026-09-17 21:16:51 +03:00
|
|
|
|
|
|
|
|
|
|
/* Две колонки: карточка и разговор рядом, как на настоящем АРМ. */
|
|
|
|
|
|
.columns { display: flex; gap: 24px; align-items: flex-start; flex-wrap: wrap; }
|
|
|
|
|
|
.columns > section { flex: 1 1 420px; min-width: 0; }
|
|
|
|
|
|
.kio { display: flex; flex-direction: column; gap: 12px; }
|
|
|
|
|
|
.kio .grid { width: 100%; }
|
|
|
|
|
|
.kio thead th { background: var(--line); }
|
|
|
|
|
|
.kio input[type="text"], .kio input[type="number"], .kio select { width: 100%; font: inherit; border: 1px solid var(--line); padding: 2px 4px; background: var(--panel); }
|
|
|
|
|
|
/* Обязательное поле помечено точкой, незаполненное — жёлтым. */
|
|
|
|
|
|
.required { color: var(--warn); font-weight: 700; }
|
|
|
|
|
|
/* Правка, которую сервер ещё не подтвердил. */
|
|
|
|
|
|
.pending { background: #fffbe6; }
|
2026-09-17 21:18:28 +03:00
|
|
|
|
|
|
|
|
|
|
/* Три состояния норматива — единственное место, где цвет несёт смысл.
|
|
|
|
|
|
На внешнем мониторе они должны различаться с последнего ряда. */
|
|
|
|
|
|
.state-ok { color: var(--ok); }
|
|
|
|
|
|
.state-warn { color: var(--warn); font-weight: 600; }
|
|
|
|
|
|
.state-violated { color: var(--violated); font-weight: 700; }
|
|
|
|
|
|
|
|
|
|
|
|
.interview { display: flex; align-items: baseline; gap: 12px; margin: 8px 0 16px; }
|
|
|
|
|
|
.interview-label { text-transform: uppercase; letter-spacing: 0.08em; font-size: 12px; }
|
|
|
|
|
|
.interview-value { font-size: 40px; font-variant-numeric: tabular-nums; font-weight: 700; line-height: 1; }
|
|
|
|
|
|
.interview-limit { font-size: 12px; color: #5a6068; }
|
|
|
|
|
|
.interview-big .interview-value { font-size: 96px; }
|
|
|
|
|
|
.interview-big .interview-label, .interview-big .interview-limit { font-size: 20px; }
|
|
|
|
|
|
|
|
|
|
|
|
.mode-banner { padding: 4px 24px; margin: -16px -24px 12px; border-bottom: 1px solid var(--line); font-weight: 600; }
|
|
|
|
|
|
.mode-training { background: #e8f0fb; }
|
|
|
|
|
|
.mode-exam { background: #fde8e8; }
|
|
|
|
|
|
.mode-self { background: #eef3ea; }
|
lct-16 и половина lct-19: разбор, отчёт, внешний монитор, эталон
Эталонный диалог собирается кодом из фактов и чек-листа: написанный
руками, он разошёлся бы с фактами при первой же правке сценария,
и курсанта оштрафовали бы за правильный ответ.
Отчёт: метрики фактом против норматива со ссылкой, отметка E1 на каждый
недобытый факт с эталонным вопросом, расхождение самооценки — что
курсант заметил сам, чего не заметил, что отметил зря. Не заметил —
самое ценное для разбора.
Внешний монитор — не отдельное приложение, а другой режим отрисовки тех
же событий: крупный таймер опроса, ход разговора, карточка, после оценки
разбор на весь экран.
Коррекция преподавателем сохраняет автооценку рядом: видно, что
скорректировано и кем.
Найдено: все метрики весили одинаково, и курсант, не задавший ни одного
вопроса, но заполнивший карточку руками, получал 87 из 100. Предварительные
веса (полнота опроса — 4) дают 74; окончательные утверждает методист,
вопрос записан в DEBRIEF.md.
2026-09-17 21:32:12 +03:00
|
|
|
|
|
|
|
|
|
|
/* Разбор. Ссылка на норматив — мелким, но рядом с фактом: отметка без
|
|
|
|
|
|
обоснования не появляется ни в одном интерфейсе. */
|
|
|
|
|
|
.debrief h3 { font-size: 15px; margin: 16px 0 6px; }
|
|
|
|
|
|
.ref { color: #5a6068; font-size: 12px; }
|
|
|
|
|
|
.radar { display: block; margin: 4px 0 8px; }
|
|
|
|
|
|
|
|
|
|
|
|
/* Внешний монитор: читается с последнего ряда. */
|
|
|
|
|
|
.wall { font-size: 20px; }
|
|
|
|
|
|
.wall h1 { font-size: 30px; }
|
|
|
|
|
|
.wall h2 { font-size: 24px; }
|
|
|
|
|
|
.wall .grid th { width: 160px; }
|
|
|
|
|
|
.debrief-big { font-size: 20px; }
|
lct-17: пульт преподавателя — сценарий, наблюдение, пометки, ссылки
Компоновка от того, по чему пульт оценит действующий преподаватель:
задать сценарий и не вмешиваться, видеть работу курсанта вживую,
получить готовый разбор, показать группе. Кнопка запуска одна и крупная,
ссылки на АРМ курсанта и монитор печатаются рядом.
Разделение прав архитектурное и здесь: пульт смотрит через observe,
пишет через control, карточка курсанта у него только для чтения.
Две ловушки запуска: scenario.start уходил из эффекта и мог повториться
при перерисовке, а открытая из истории ссылка на идущее занятие
запустила бы его заново и сбросила. Запускается только занятие,
созданное кнопкой.
2026-09-17 21:34:01 +03:00
|
|
|
|
|
|
|
|
|
|
/* Пульт: кнопка запуска одна и крупная. */
|
|
|
|
|
|
.start { font-size: 16px; padding: 10px 24px; font-weight: 600; }
|
|
|
|
|
|
.mode-choice { display: block; }
|
|
|
|
|
|
.clickable { cursor: pointer; }
|
|
|
|
|
|
.clickable:hover th { background: #e8ecf1; }
|