Артель «Заслон» — хаб интерактивов по защите информации

ypv 8666baa92c specification_template 3 недель назад
4.1.400 8666baa92c specification_template 3 недель назад
template 8666baa92c specification_template 3 недель назад
README.md c42ab96956 fix 3 недель назад
itsfzoi.md ad3d1a9a2a tzi.md 3 недель назад
requirements.md e6bac22337 tester 3 недель назад
tester.html e6bac22337 tester 3 недель назад
tzi.md ad3d1a9a2a tzi.md 3 недель назад
yakushenko_1.md 8666baa92c specification_template 3 недель назад

README.md

Диводел — хаб интерактивов по технической защите информации

Добро пожаловать в Диводел — репозиторий интерактивных PWA-моделей, созданных студентами колледжа в рамках изучения дисциплин по защите информации.

Мы не используем дорогостоящие физические стенды. Вместо этого мы собираем виртуальные приборы и симуляторы физических каналов утечки, чтобы понять, как работает защита информации на уровне физики, схем и алгоритмов.

🗺️ Навигация по курсу

Учебный материал разделен на две большие части. Выберите нужный раздел, чтобы увидеть список тем и привязанных к ним интерактивов:

📁 Структура репозитория

Все модели хранятся в строгом порядке. Путь к каждому интерактиву строится по схеме: /номер_темы/номер_интерактива/ (например: 1.1.100/01/).

В каждой такой папке находится исходный код PWA-приложения и документация:

  • index.html — интерфейс;
  • app.js — логика (физика, формулы);
  • style.css — оформление;
  • manifest.json — настройки PWA для установки на телефон.
  • docs/specification_template.md — Лист спецификации

⚠️ Важно: Gogs отображает только исходный код. Чтобы запустить PWA-модель, переходите по ссылкам в колонке «Демо» в файлах со списками тем. Они ведут на витрину проекта: steelfeet.ru/divodel.

🛠️ Как добавить свою модель (Инструкция для студентов)

Если вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а доказать, что он физически корректен.

  1. Сделайте форк этого репозитория (или работайте в своей ветке).
  2. Скопируйте шаблон из папки /template/ в папку вашей темы (например, 3.1.400/01/). (Не обязательно, можете использовать свой стиль).
  3. Заполните Лист спецификации (Пример). Для каждого проекта лист спецификаций свой. Укажите:
    • какие физические величины моделируются (и в каких единицах);
    • какая формула лежит в основе;
    • как модель должна вести себя на крайних значениях (0, бесконечность, максимум шума и т.д.).
  4. Напишите код (можно использовать ИИ-ассистентов). Пособие по выбору темы и написанию кода.
  5. Проверьте модель по вашему же листу спецификации. Если ИИ наврал в формуле — исправьте. Приложите краткий отчет о найденных ошибках ИИ.
    • 5.1. Каждое логическое изменение (добавил сцену, исправил формулу, поправил дизайн) должно сопровождаться коммитом с осмысленным сообщением. Коммиты вида "fix" или "update" без пояснений не принимаются.
  6. Итерация и доработка (Возврат к п. 4). Если модель не проходит проверку или в ней обнаружены ошибки, возвращайтесь к шагу 4 (корректировка промпта или ручное исправление кода). Повторяйте цикл «генерация → проверка» до тех пор, пока модель полностью не будет соответствовать вашему Листу спецификации. Не забудьте зафиксировать каждую итерацию коммитом!
  7. Отправьте Pull Request. В описании PR укажите: ФИО, группу, тему и ссылку на задеплоенную версию.

Работы без заполненной спецификации и проверки на крайние случаи не принимаются.

🧪 Испытательный стенд

В корне репозитория находится страница (tester.html)[tester.html]. Это автоматический тестер, который прогоняет вашу модель по сетке параметров и сверяет результаты с аналитической формулой (обратные квадраты, децибелы, АЧХ фильтров). Если модель проходит тестер — она готова к показу на Steelfeet.

🎓 Методика

В основе курса лежит последовательность: Физика канала → Использование канала → Способы защиты → Конкретные приборы. ИИ здесь выступает в роли «стажера», который быстро пишет код, а студент — в роли «ведущего инженера», который ставит задачу и проверяет результаты.


Учебные модели. Не являются калиброванными средствами измерения. Пригодны для демонстрации физических принципов и обучения.