specification.md 23 KB

ЛИСТ СПЕЦИФИКАЦИИ И ПРИЁМКИ МОДЕЛИ

Тема по программе: 3.2.300 Экранирование Название модели: Симулятор эффективности электромагнитного экрана "Фарадей-2" Автор: Петрова М., группа 46 Использованный ИИ-инструмент: Claude 3.5 Sonnet Ветка разработки: feature/faraday-2-fork Ссылка на Pull Request: (будет добавлена)


0. Исходный проект (заполняется только для форка)

  • Автор исходной модели: Смирнова А., группа 46
  • Ссылка на исходный код: ./3.2.300/01/ (PR #12)
  • Что взято за основу: Логика расчёта скин-эффекта (SE = 8.686 · t / δ), базовая архитектура Canvas-осциллографа (источник → экран → приёмник), три металлических материала (Cu, Al, Fe), структура сцен.

  • Что изменено (список):

    1. Добавлены два диэлектрических материала:
      • Дерево (δ = 3.6 мм) — диэлектрик, при максимальной толщине 2 мм даёт SE ≈ 4.8 дБ, что соответствует ослаблению сигнала в ~3.0 раза.
      • Пенопласт (δ = 9.9 мм) — почти воздух, при максимальной толщине 2 мм даёт SE ≈ 1.75 дБ, что соответствует ослаблению сигнала в ~1.5 раза.
      • Примечание: изначально в первой версии форка для дерева и пенопласта были взяты δ = 50 и 300 мм (SE ≈ 0.35 и 0.06 дБ). На защите было замечено, что такое ослабление визуально неотличимо от нуля на осциллографе. По согласованию с преподавателем константы были скорректированы так, чтобы при полной толщине ослабление было заметным, но всё равно на порядки хуже металлов. Это осознанное методическое упрощение (см. п. 3).
    2. Добавлен сравнительный график (правый нижний угол): отображает кривые SE(t) для всех пяти материалов одновременно. Текущий материал подсвечен ярче, остальные — полупрозрачны. Наглядно видно, что дерево и пенопласт лежат почти на оси абсцисс, но всё же не сливаются с ней.
    3. Добавлена панель физических свойств материала под ползунком: тип (металл/диэлектрик), δ, коэффициент ослабления (рассчитывается динамически: 10^(SE/20)), краткое описание.
    4. Добавлен баннер-предупреждение «⚠ ДИЭЛЕКТРИК — СЛАБОЕ ОСЛАБЛЕНИЕ (~N×)», где N — текущий коэффициент ослабления. Баннер виден только при выборе дерева или пенопласта и толщине > 0.
    5. Добавлена строка «Ослабление сигнала» в протокол испытаний (сцена 3). Показывает, во сколько раз ослабляется сигнал по мощности при текущих параметрах.
    6. Переработан дизайн:
      • Латунная гравированная табличка с названием прибора вместо простого заголовка.
      • Деревянный корпус с текстурой волокон и латунными заклёпками по углам.
      • CRT-экран с сеткой осциллографа, скан-линиями и виньеткой.
      • Выбор материала — бакелитовые кнопки-переключатели вместо выпадающего списка <select>.
      • Стрелочные индикаторы значений с цветовой кодировкой (красный/жёлтый/зелёный).
    7. Добавлены звуковые щелчки (Web Audio API) при выборе материала и движении ползунка.
    8. Визуализация диэлектриков на Canvas: для дерева и пенопласта добавлена штриховка внутри экрана (показывает, что материал «рыхлый» и не является проводником).
    9. Обновлён вердикт в протоколе для диэлектриков: вместо общего «НЕПРИГОДЕН» — конкретная причина с числом («Диэлектрик ослабляет сигнал всего в ~2.8 раза»).
  • Что НЕ менялось:

    • Формула скин-эффекта SE = 8.686 · (t / δ) и расчёт уровня перехвата 100 · 10^(-SE/20).
    • Диапазон толщины (0–2 мм).
    • Логика перехода между сценами.
    • Вопросы итогового теста (кроме уточнения формулировок под новые материалы, см. п. 7).

1. Физическая (аналитическая) основа

Эффективность экранирования зависит от проводимости материала, магнитной проницаемости и толщины (скин-эффект).

1.1. Моделируемые физические величины и их единицы:

  • Эффективность экранирования (SE): дБ (децибелы)
  • Коэффициент ослабления сигнала: безразмерный (K = 10^(SE/20))
  • Толщина экрана (t): мм
  • Глубина проникновения (δ): мм
  • Частота излучения (f): 100 кГц (фиксирована для примера)

1.2. Базовые формулы и законы:

  • Затухание в материале: SE = 8.686 * (t / δ) (перевод неперов в дБ).
  • Коэффициент ослабления: K = 10^(SE / 20).
  • Глубина проникновения: δ = 1 / sqrt(π * f * μ * σ).
  • Используемые константы δ:
Материал Тип δ (мм) SE при t = 2 мм Ослабление (K) при t = 2 мм
Медь (Cu) металл 0.2 ~87 дБ ~22000×
Алюминий (Al) металл 0.3 ~58 дБ ~800×
Сталь (Fe) металл 0.05 >120 дБ (потолок) >10⁶×
Дерево диэлектрик 3.6 ~4.8 дБ ~3.0×
Пенопласт диэлектрик 9.9 ~1.75 дБ ~1.5×

1.3. Параметры по умолчанию:

  • Диапазон толщины: от 0 (нет экрана) до 2 мм.

2. Граничные условия (Крайние случаи)

  • Толщина = 0: Эффективность = 0 дБ, коэффициент ослабления = 1× (сигнал проходит без потерь).
  • Максимальная толщина (2 мм):
    • Медь: ~87 дБ (~22000×) — сигнал подавлен.
    • Алюминий: ~58 дБ (~800×) — частичное подавление.
    • Сталь: >120 дБ — достигает потолка уже при 0.55 мм.
    • Дерево: ~4.8 дБ (~3.0×) — непригодно, видно слабое снижение амплитуды.
    • Пенопласт: ~1.75 дБ (~1.5×) — непригодно, снижение едва заметно.
  • Выбор «Нет экрана»: Ползунок блокируется, эффективность 0 дБ, коэффициент ослабления 1×.
  • Выбор диэлектрика (дерево, пенопласт) при толщине > 0: Появляется баннер «⚠ ДИЭЛЕКТРИК — СЛАБОЕ ОСЛАБЛЕНИЕ (~N×)»; вердикт в протоколе — «НЕПРИГОДЕН. Диэлектрик ослабляет сигнал всего в ~N раза».

3. Упрощения модели

  • Не учитываем отражение волны от поверхности (только поглощение в толще материала).
  • Частота фиксирована (100 кГц), чтобы не перегружать интерфейс.
  • Используем упрощённые справочные константы δ, не рассчитывая их динамически по σ и μ.
  • Значения δ для дерева и пенопласта методически подобраны так, чтобы при полной толщине (2 мм) ослабление было заметно глазом на осциллографе (3× и 1.5× соответственно). Реальные диэлектрики при такой толщине ослабляют сигнал существенно слабее. Это осознанное решение для наглядности: студент должен увидеть разницу между «плохим» и «хорошим» экраном, а не просто прочитать цифры.
  • Реальный диэлектрик может накапливать заряд на поверхности, но этот эффект не моделируется.

4. Сценарий

Сцена 1: Вводная. CRT-экран с текстом: «Обнаружено излучение ПЭМИН от ЭВМ. За окном — станция перехвата. Подберите материал и толщину экрана». Кнопка «Запустить стенд».

Сцена 2: Испытания.

  • CRT-осциллограф с волной: слева источник, справа приёмник, по центру — экран выбранного материала.
  • Выбор материала: 6 кнопок-переключателей (Нет, Cu, Al, Fe, Дерево, Пенопласт).
  • Ползунок толщины (0–2 мм, шаг 0.05).
  • Индикаторы: «Эффективность (дБ)» и «Уровень перехвата (%)».
  • Панель свойств выбранного материала (тип, δ, коэффициент ослабления, описание).
  • Сравнительный график SE(t) для всех материалов.
  • Баннер-предупреждение для диэлектриков с указанием текущего коэффициента ослабления.
  • Блок формул.

Сцена 3: Протокол испытаний.

  • Выбранный материал, толщина, эффективность, коэффициент ослабления, вердикт.
  • Итоговый тест (5 вопросов).
  • Кнопка «Проверить знания».

5. Методика проверки и тестирования

5.1. Проверка формул (tester.html):

  • При толщине 0 затухание 0, коэффициент ослабления 1×.
  • При увеличении толщины меди до 2 мм SE линейно растёт в дБ по формуле 8.686 · (t / 0.2).
  • Для стали SE достигает 120 дБ при ~0.55 мм — потолок срабатывает корректно.
  • Для дерева при 2 мм: SE ≈ 4.8 дБ, коэффициент ослабления ≈ 3.0× — соответствует ожиданию.
  • Для пенопласта при 2 мм: SE ≈ 1.75 дБ, коэффициент ослабления ≈ 1.5× — соответствует ожиданию.

5.2. Проверка крайних случаев:

  • При выборе «Нет экрана» ползунок блокируется, SE = 0, K = 1×.
  • При выборе дерева/пенопласта с толщиной > 0 появляется баннер с конкретным числом, вердикт в протоколе — «НЕПРИГОДЕН».
  • При стали толщиной 2 мм значение SE упирается в потолок 120 дБ.

5.3. Проверка интерфейса (Canvas):

  • Волна слева от экрана имеет полную амплитуду, внутри экрана затухает, справа — ослаблена.
  • Для дерева при 2 мм амплитуда волны за экраном визуально падает примерно до 1/3 от исходной — заметно глазу.
  • Для пенопласта при 2 мм амплитуда волны за экраном падает примерно до 2/3 от исходной — тоже заметно, но слабее.
  • Для дерева и пенопласта внутри экрана нарисована штриховка (визуальное отличие от металлов).
  • Ширина экрана на Canvas пропорциональна толщине.
  • Сравнительный график корректно отображает все пять кривых и текущую толщину; дерево и пенопласт лежат почти на оси абсцисс, но не сливаются с ней.

5.4. Проверка звука:

  • Щелчок при выборе материала (тяжёлый, низкочастотный — как у рубильника).
  • Щелчок при движении ползунка (лёгкий, высокочастотный — как у переключателя).

5.5. Проверка регрессии:

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

6. Стратегия работы с Git

  1. Форк: Студент форкнул репозиторий исходной модели (feature/shielding-model) в свою ветку feature/faraday-2-fork.
  2. Первый коммит: chore: fork from SmirnovaA/faraday-1 @ v1.0-ready — только исходный код, без изменений.
  3. Теги на вехах:
    • v0.1-spec — спецификация форка заполнена, план изменений зафиксирован.
    • v0.2-materials — добавлены дерево и пенопласт, обновлены материалы и логика.
    • v0.3-design — переработан дизайн (табличка, заклёпки, кнопки, CRT-сетка).
    • v0.3.1-fix-delta — скорректированы константы δ для дерева и пенопласта (3.6 и 9.9 мм вместо 50 и 300 мм) для наглядного ослабления; добавлена строка «Ослабление сигнала» в панель и протокол.
    • v1.0-ready — готово, тест пройден, документация заполнена.
  4. Слияние: Pull Request в основную ветку хаба с описанием изменений и ссылкой на исходный PR. Squash при слиянии.

7. Журнал верификации и отладки (Борьба с галлюцинациями ИИ)

№ Что попросили у ИИ Что сгенерировал ИИ Ошибка (галлюцинация) Как исправили Имя коммита
1 Добавить материалы «дерево» и «пенопласт» с физическими константами ИИ добавил их в объект materials с δ = 0.1 и 0.2 мм Неверно: у диэлектриков σ ≈ 0, поэтому δ должна быть большой. Иначе дерево экранировало бы как медь. Исправили константы на большие значения (первая итерация: 50 и 300 мм). b2c3d4e — fix: correct delta values for dielectrics
2 Отрисовка сравнительного графика ИИ нарисовал все кривые, но для дерева и пенопласта они уходят в бесконечность (деление на очень маленькое δ) При δ = 0.001 формула даёт тысячи дБ, график ломается. Ограничили SE сверху 120 дБ при отрисовке. f5g6h7i — fix: clamp SE to 120 dB in comparison chart
3 Баннер-предупреждение для диэлектриков ИИ сделал баннер, но он показывался всегда, даже при выборе «Нет» Неверное условие: if (mat.type === 'dielectric') без проверки толщины. Добавили условие && currentThickness > 0. j8k9l0m — fix: show dielectric warning only when thickness > 0
4 Звуковые щелчки при выборе материала ИИ подключил playSwitch() к событию onchange выпадающего списка Мы заменили <select> на кнопки — onchange не срабатывает. Перенесли вызов playSwitch() в обработчик click на кнопках. n1o2p3q — fix: bind switch sound to button click instead of select change
5 Тест с вопросами про новые материалы ИИ добавил вопросы, но с ошибкой в формулировке: «Почему дерево НЕ экранирует? — Потому что оно лёгкое» Абсурдный дистрактор. Переписали вопрос: «Потому что это диэлектрик — почти нет свободных зарядов». r4s5t6u — fix: correct physics in test questions
6 Проверка наглядности ослабления для диэлектриков при 2 мм При δ = 50 и 300 мм осциллограф практически не менялся: волна за деревом/пенопластом визуально не отличалась от волны без экрана Это методическая проблема, не ошибка ИИ, но требующая решения. Студент заметил на защите: «Снижение не видно». Скорректировали δ до 3.6 мм (дерево) и 9.9 мм (пенопласт): теперь при 2 мм ослабление ~3× и ~1.5× соответственно — заметно глазу, но всё равно несопоставимо с металлами. Добавили строку «Ослабление сигнала» в панель и протокол, а в баннер — конкретный коэффициент. v0w1x2y — feat: tune dielectric deltas for visible attenuation + show factor in UI

8. Критерии приёмки (Чек-лист преподавателя)

  • Указан автор исходной модели и ссылка на неё (раздел 0).
  • В разделе 0 перечислены конкретные изменения (дизайн, материалы, график, звук, корректировка δ).
  • Физика не сломана: формула скин-эффекта сохранена, tester.html проходит 100%.
  • Добавлены два новых материала с обоснованными константами: дерево δ = 3.6 мм (~3× при 2 мм), пенопласт δ = 9.9 мм (~1.5× при 2 мм).
  • Дерево и пенопласт визуально ослабляют сигнал (волна за экраном заметно ниже), но остаются непригодными для реальной защиты (по сравнению с металлами — на порядки хуже).
  • Работает сравнительный график SE(t) для всех материалов; дерево и пенопласт видны как почти плоские линии.
  • Баннер-предупреждение появляется только для диэлектриков при толщине > 0 и показывает текущий коэффициент ослабления.
  • В протоколе есть строка «Ослабление сигнала» с числом.
  • Формулы выведены на экране (блок «[Ф-ЛА]»).
  • Есть тест из 5 вопросов (включая вопросы про диэлектрики).
  • Работает офлайн (PWA).
  • В интерфейсе есть пометка «Учебная модель».
  • Звуковые щелчки работают при выборе материала и движении ползунка.
  • Студент может объяснить на защите: что было в исходнике, что добавлено, почему дерево и пенопласт не экранируют по-настоящему, и почему значения δ для них скорректированы (методическое упрощение для наглядности).

Подпись студента: _______________ Оценка: _______________