Артель «Заслон» — хаб интерактивов по защите информации
Добро пожаловать в Артель «Заслон» — репозиторий интерактивных PWA-моделей, созданных студентами колледжа в рамках изучения дисциплин по защите информации.
📁 Структура репозитория
Все модели хранятся в строгом порядке. Путь к каждому интерактиву строится по схеме:
/номер_темы/номер_интерактива/ (например: 1.1.100/01/).
В каждой такой папке находится исходный код PWA-приложения и документация:
index.html — интерфейс;
app.js — логика (физика, формулы);
style.css — оформление;
manifest.json — настройки PWA для установки на телефон.
specification.md — Лист спецификации
⚠️ Важно: Gogs отображает только исходный код. Чтобы запустить PWA-модель, переходите по ссылкам в колонке «Демо» в файлах со списками тем. Они ведут на витрину проекта: steelfeet.ru/zaslon.
🗺️ Навигация по курсу МДК.01.04 Эксплуатация автоматизированных (информационных) систем в защищенном исполнении
Формат
Квиз, игра, сказка, тренажёр — на выбор. Главное: интерактивность и проверка знаний.
Объём
3–10 минут прохождения. Минимум 3 сцены/экрана.
Содержание
- Тема из программы предмета.
- Все факты — из учебника/лекции/ГОСТ (со ссылкой).
- Вопросы должны быть однозначными (проверить на одногруппнике).
Студент может взять готовую модель из хаба (свою или чужую, с указанием автора) и развить её: улучшить дизайн, добавить сцены, функции, исправить ошибки. Работа оформляется как форк с явным указанием исходного автора и описанием внесённых изменений.
Работа с ИИ
- Спецификация до кода (раздел 1–2 Листа Спецификации).
- Журнал: что попросили, что ИИ выдал, что исправили.
- Коммиты с осмысленными сообщениями.
Приёмка
- Содержание верное.
- Обратная связь в Листе спецификаций есть (не просто «неверно», а «неверно, потому что...»).
- Автор объясняет, какие ошибки ИИ нашёл.
Если вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а доказать, что Вы разобрались в теме.
- Сделайте ответвление этого репозитория.
- Заполните Разделы 1-2 Листа спецификации (Пример). Для каждого проекта лист спецификаций свой.
- Напишите код (можно использовать ИИ-ассистентов). Пособие по выбору темы и написанию кода.
- Проверьте интерактив по вашему же листу спецификации. Приложите краткий отчет о найденных ошибках ИИ.
- Итерация и доработка (Возврат к п. 3). Если интерактив не проходит проверку или в нем обнаружены ошибки, возвращайтесь к шагу 3 (корректировка промпта или ручное исправление кода). Не забудьте зафиксировать каждую итерацию коммитом и пометкой в таблице 4. Журнал работы с ИИ! Повторяйте цикл «генерация → проверка» до тех пор, пока модель полностью не будет соответствовать вашему Листу спецификации.
- Отправьте Pull Request. В описании PR укажите: ФИО, группу.
Работы без заполненной спецификации не принимаются.
🗺️ Навигация по курсу ПМ0.3
Мы не используем дорогостоящие физические стенды. Вместо этого мы собираем виртуальные приборы и симуляторы физических каналов утечки, чтобы понять, как работает защита информации на уровне физики, схем и алгоритмов.
Учебный материал разделен на две большие части. Выберите нужный раздел, чтобы увидеть список тем и привязанных к ним интерактивов:
🛠️ Как добавить свой проект (Инструкция для студентов)
Если Вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а доказать, что он физически корректен. Вы можете взять готовую модель из хаба (свою или чужую, с указанием автора) и развить её: улучшить дизайн, добавить сцены, функции, исправить ошибки. Работа оформляется как форк с явным указанием исходного автора и описанием внесённых изменений.
- Сделайте форк этого репозитория (или работайте в своей ветке).
- Скопируйте шаблон из папки
/template/ в папку вашей темы (например, 3.1.400/001/). (Не обязательно, можете использовать свой стиль).
- Заполните Лист спецификации (Пример). Для каждого проекта лист спецификаций свой. Укажите:
- какие физические величины моделируются (и в каких единицах);
- какая формула лежит в основе;
- как модель должна вести себя на крайних значениях (0, бесконечность, максимум шума и т.д.).
- Напишите код (можно использовать ИИ-ассистентов). Пособие по выбору темы и написанию кода.
- Проверьте модель по вашему же листу спецификации. Если ИИ наврал в формуле — исправьте. Приложите краткий отчет о найденных ошибках ИИ.
- 5.1. Каждое логическое изменение (добавил сцену, исправил формулу, поправил дизайн) должно сопровождаться коммитом с осмысленным сообщением. Коммиты вида "fix" или "update" без пояснений не принимаются.
- Итерация и доработка (Возврат к п. 4). Если модель не проходит проверку или в ней обнаружены ошибки, возвращайтесь к шагу 4 (корректировка промпта или ручное исправление кода). Не забудьте зафиксировать каждую итерацию коммитом! Повторяйте цикл «генерация → проверка» до тех пор, пока модель полностью не будет соответствовать вашему Листу спецификации.
- Отправьте Pull Request. В описании PR укажите: ФИО, группу.
Работы без заполненной спецификации и проверки на крайние случаи не принимаются.
🧪 Испытательный стенд
В корне репозитория находится страница tester.html.
Это автоматический тестер, который прогоняет вашу модель по сетке параметров и сверяет результаты с аналитической формулой (обратные квадраты, децибелы, АЧХ фильтров). Если модель проходит тестер — она готова к показу на Steelfeet.
🎓 Методика
В основе курса лежит последовательность: Физика канала → Использование канала → Способы защиты → Конкретные приборы.
ИИ здесь выступает в роли «стажера», который быстро пишет код, а студент — в роли «ведущего инженера», который ставит задачу и проверяет результаты.
Учебные модели. Не являются калиброванными средствами измерения. Пригодны для демонстрации физических принципов и обучения.