specification.md 6.1 KB

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

Тема по программе: 2.1.410 Акустические датчики охранной сигнализации Название модели: Симулятор настройки акустического датчика "Стекло-1" Автор: Байдукова К., группа 46 Использованный ИИ-инструмент: Claude 3.5 Sonnet Ветка разработки: feature/acoustic-sensor Ссылка на Pull Request: (будет добавлена)


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

Датчик разбития стекла реагирует не просто на громкость, а на специфический акустический профиль.

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

  • Частота звука: Герцы (Гц)
  • Уровень сигнала: дБ
  • Порог срабатывания: дБ

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

  • Разбитие стекла имеет две фазы:
    1. Высокочастотный треск (3–5 кГц).
    2. Низкочастотный удар/гул (ниже 500 Гц).
  • Датчик срабатывает только если высокочастотный пик превышает порог, и за ним следует низкочастотный.
  • Обычный шум (речь, шаги) находится в диапазоне 500–2000 Гц и не должен вызывать тревогу.

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

  • Порог срабатывания: регулируется от 40 до 80 дБ.

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

  • Порог = 40 дБ (Максимальная чувствительность): Датчик ловит даже легкое постукивание, возможны ложные срабатывания.
  • Порог = 80 дБ (Минимальная чувствительность): Датчик не сработает, если стекло разбивают тихо.
  • Тишина: Сигнала нет, тревоги нет.
  • Проверка гипотезы: Если просто крикнуть в датчик (высокая громкость, но неправильный спектр), тревоги быть не должно.

3. Упрощения модели (Что мы НЕ учитываем)

  • Мы не обрабатываем реальный сигнал с микрофона (это потребовало бы FFT-анализа), а симулируем готовый частотный профиль по нажатию кнопки.
  • Не учитываем эхо помещения.

4. Сценарий

Сцена 1: Вводная. Текст: «Вы настраиваете датчик в музее. В зале стоит тишина. Настройте порог чувствительности, чтобы датчик не реагировал на шаги охраны, но ловил разбитие витрины». Сцена 2: Пульт настройки. Ползунок порога, экран осциллографа, кнопки: «Шаги», «Крик», «Разбить стекло». Сцена 3: Тестирование. Пользователь нажимает кнопки и видит на осциллографе профиль сигнала. Если порог настроен неверно — датчик орет от шагов. Если верно — срабатывает только на стекло. Сцена 4: Тест. 5 вопросов.


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

5.1. Проверка через tester.html: Проверено, что при сигнале "Шаги" (частота 1000 Гц, 50 дБ) и пороге 60 дБ срабатывания нет. 5.2. Проверка крайних случаев: При пороге 40 дБ датчик срабатывает на крик (что является ошибкой). При пороге 80 дБ не срабатывает на стекло. 5.3. Проверка звука: Синтезированы 3 разных звука с помощью Web Audio API.


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

  1. Ветка: feature/acoustic-sensor.
  2. Теги: v0.1-spec, v1.0-ready.
  3. Слияние через PR с Squash.

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

№ Что попросили у ИИ Что сгенерировал ИИ Ошибка (галлюцинация) Как исправили Имя коммита
1 Логика срабатывания датчика if (volume > threshold) { alarm(); } ИИ сделал реакцию только на громкость. Датчик орал от любого громкого крика. Добавили проверку частотного профиля (высокие + низкие). a1b2c3d — fix: add frequency profile check
2 Синтез звука разбития стекла Просто белый шум Слишком долгий и ровный звук, не похож на стекло. Сделали резкий высокочастотный всплеск + короткий низкий удар. e4f5g6h — fix: synth glass break with two phases

8. Критерии приёмки (Чек-лист)

  • Код физически корректен.
  • Граничные условия работают.
  • Формулы выведены на экране.
  • Есть пометка «Учебная модель».
  • Есть тест.
  • Работает офлайн (PWA).