SemCue · система подготовки отчетов
Вывод на первом экране.Доказательства внутри.
Большой отчет должен помочь принять решение, а затем передать работу исполнителю. Мы собрали движок, который превращает тексты и проверенные данные в интерактивный документ: короткий итог, раскрываемые источники и план действий. Готовый отчет открывается одним HTML-файлом, вместе с оформлением и кодом интерфейса.
Движок реализован · Показан готовый отчет о вымышленной компании. Все показатели на экранах демонстрационные.
- 1 HTMLсодержит интерфейс, оформление и данныесборщик встраивает CSS и JavaScript
- 5ширин экрана в программе проверкиот 320 до 1 440 пикселей
- SHA-256сверяет полный ответ с сохраненным текстомпроверка содержимого, показанного читателю
- Офлайнотчет работает без серверапереходы к внешним источникам требуют интернета
Сначала понять вывод
У руководителя и разработчика разные вопросы к одному отчету. Руководителю нужно понять, что происходит и за что взяться. Исполнителю нужны детали, примеры и способ проверить результат.
Поэтому первый экран показывает короткий вывод и опорные показатели. Подробности остаются ниже: находки, полные материалы и порядок действий. Читатель сам выбирает глубину, не теряя общий смысл.
Автошкола на экранах вымышленная. Ее цифры показывают возможности интерфейса и не описывают результат клиентского проекта.
Документ можно передать целиком
Обычная веб-страница зависит от файлов рядом с ней. Если отправить только HTML, оформление или кнопки могут пропасть. Мы встраиваем стили и JavaScript прямо в готовый документ.
Перед выдачей сборщик проверяет, что ссылки на отдельные файлы интерфейса не остались. Готовую копию можно открыть локально. Внешние источники остаются ссылками: для перехода к ним нужен интернет.
- Данные
Тексты и материалы компании
Содержимое отчета отделено от общего шаблона.
- Сборка
Временная рабочая копия
Сборщик подставляет содержимое, проверяет типы и собирает интерфейс.
- Выдача
Самостоятельный HTML-файл
Оформление и логика уже внутри. Рядом сохраняется контрольная сумма.
От вывода до полного ответа
Короткое резюме удобно читать, но по нему трудно проверить вывод. В отчете можно открыть полный сохраненный ответ и посмотреть, на какие источники он ссылается.
Для проверки мы сравниваем текст, который появился в браузере, с исходным сохраненным текстом и его контрольной суммой. Если часть ответа пропала или изменилась при сборке, программа сообщает об ошибке.
Исполнителю есть с чем работать
Совета «поправить страницу» мало для передачи работы. У шага плана есть пояснение, список действий и критерий, по которому можно принять результат.
Подробная инструкция раскрывается по запросу. В ней можно скопировать готовый текст задачи, посмотреть пример и отмечать выполненные пункты. Отметки сохраняются в браузере читателя.
Проверяем раскрытый документ
Закрытая карточка может выглядеть аккуратно, а после раскрытия длинная ссылка или таблица уедет за экран. Поэтому проверка проходит по разным размерам и открывает скрытые разделы.
Программа проверяет горизонтальную прокрутку, переходы по меню, фильтры ответов и ошибки интерфейса. Во время проверки внешние сетевые запросы блокируются: документ должен работать с тем, что уже находится внутри.
- 320–1 440 pxдиапазон ширин в автоматической проверкетелефоны, планшет и компьютер
- Текст + хешпроверка сохраненных ответоввместе с количеством ссылок на источники
Новая сборка остается новой сборкой
У каждого собранного файла есть время выпуска и контрольная сумма. История пополняется новой записью, поэтому версии можно различить по содержимому.
Если прежняя версия отмечена опубликованной, новая сборка не вытесняет ее из записи о текущей выдаче. Она остается в истории как черновик. Так подготовка правок отделена от решения выдать новый документ.
Общий шаблон отвечает за интерфейс, материалы компании — за содержание. Перед выдачей отдельная проверка открывает готовый файл так, как его откроет читатель.
Как это делалось
Общий шаблон, отдельное содержание
Мы вынесли структуру отчета, интерактивные блоки и оформление в общий шаблон. Тексты, данные и изображения конкретного отчета подставляются при сборке во временную копию.
В этом кейсе показан существующий демонстрационный документ на вымышленной автошколе. Для съемки мы открыли его локально и заблокировали внешнюю сеть.
- СодержаниеВыводы, исходные материалы, план и критерии приемки.
- ДвижокОбщий интерфейс, автономная сборка, история файлов и контрольные суммы.
- ПроверкаОтображение на разных экранах, раскрытие материалов и точность сохраненного текста.
Для технических читателей
Устройство
- Интерфейс
- React и TypeScript: раскрываемые разделы, окна ответов, фильтры и чек-листы.
- Сборка
- Python запускает проверку типов и Vite во временной копии, затем встраивает CSS и JavaScript в HTML.
- Проверки
- Puppeteer открывает локальный файл с запретом внешних запросов; сравнивает текст ответов, хеши и источники.
- Версии
- Манифест хранит имя файла, время сборки, размер, SHA-256 и статус; новая сборка добавляется в историю.
Откуда цифры
На чем основан кейс
- Исходный код шаблона, автономного сборщика и программы проверки отчета.
- Существующий демонстрационный отчет и его генератор: компания, ответы и показатели обозначены вымышленными.
- Локальные снимки настоящего интерфейса на компьютере и телефоне с блокировкой внешней сети.
Следующая система
Данные из сайтов, PDF и вакансий для автоматизации →