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

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


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

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

В каждой такой папке находится исходный код PWA-приложения и документация:
*   `index.html` — интерфейс;
*   `app.js` — логика (физика, формулы);
*   `style.css` — оформление;
*   `manifest.json` — настройки PWA для установки на телефон.
*   `specification.md` — Лист спецификации

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


## 🗺️ Навигация по курсу МДК.01.04 Эксплуатация автоматизированных (информационных)  систем в защищенном исполнении

*   **[МДК.01.04 Эксплуатация Автоматизированных (Информационных)  Систем в Защищенном Исполнении](./easvzi.md)**


### Формат
Квиз, игра, сказка, тренажёр — на выбор. Главное: интерактивность и проверка знаний.

### Объём
3–10 минут прохождения. Минимум 3 сцены/экрана.

### Содержание
- Тема из программы предмета.
- Все факты — из учебника/лекции/ГОСТ (со ссылкой).
- Вопросы должны быть однозначными (проверить на одногруппнике).
Студент может взять готовую модель из хаба (свою или чужую, с указанием автора) и развить её: улучшить дизайн, добавить сцены, функции, исправить ошибки. Работа оформляется как форк с явным указанием исходного автора и описанием внесённых изменений.


### Работа с ИИ
- Спецификация до кода (раздел 1–2 Листа Спецификации).
- Журнал: что попросили, что ИИ выдал, что исправили.
- Коммиты с осмысленными сообщениями.

### Приёмка
- Содержание верное.
- Обратная связь в Листе спецификаций есть (не просто «неверно», а «неверно, потому что...»).
- Автор объясняет, какие ошибки ИИ нашёл.

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

1. **Сделайте ответвление** этого репозитория.
2. **Заполните Разделы 1-2 Листа спецификации** ([Пример](template/specification-base.md)). Для каждого проекта лист спецификаций свой. 
3. **Напишите код** (можно использовать ИИ-ассистентов). [Пособие](requirements-base.md) по выбору темы и написанию кода.
4. **Проверьте интерактив** по вашему же листу спецификации. Приложите краткий отчет о найденных ошибках ИИ.
5. **Итерация и доработка (Возврат к п. 3).** Если интерактив не проходит проверку или в нем обнаружены ошибки, возвращайтесь к шагу 3 (корректировка промпта или ручное исправление кода). Не забудьте зафиксировать каждую итерацию коммитом и пометкой в таблице 4. Журнал работы с ИИ! Повторяйте цикл «генерация → проверка» до тех пор, пока модель полностью не будет соответствовать вашему Листу спецификации. 
6. **Отправьте Pull Request**. В описании PR укажите: ФИО, группу.

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


## 🗺️ Навигация по курсу ПМ0.3

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

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

*   **[ПМ03.01. Техническая защита информации (ТЗИ)](./tzi.md)**
    *   Физика каналов (акустика, оптика, электричество), побочные электромагнитные излучения и наводки, методы и средства защиты.
*   **[ПМ03.02. Инженерно-технические средства физической защиты объектов информатизации (ИТСФЗОИ)](./itsfzoi.md)**
    *   Материально-вещественный канал, периметровая и пожарная сигнализация, СКУД, видеонаблюдение и системы воздействия.


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

Если Вы готовите новый интерактив, ваша задача — не просто сгенерировать код с помощью ИИ, а **доказать, что он физически корректен**. Вы можете взять готовую модель из хаба (свою или чужую, с указанием автора) и развить её: улучшить дизайн, добавить сцены, функции, исправить ошибки. Работа оформляется как форк с явным указанием исходного автора и описанием внесённых изменений.

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

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

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

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

## 🎓 Методика

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

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