u23-27gurkin 1 месяц назад
Родитель
Сommit
0932adc191
1 измененных файлов с 50 добавлено и 1 удалено
  1. 50 1
      README.md

+ 50 - 1
README.md

@@ -1,3 +1,52 @@
 # wave-spectr
 
-Механические волны. Звук. Среды распространения.
+Механические волны. Звук. Среды распространения.
+
+# Проект PWA: Интерактивная модель «Механические волны и спектр Фурье»
+
+## 1. Развернутое Техническое Задание (ТЗ)
+
+**Цель проекта:** Создать локальное одностраничное веб-приложение (PWA) для демонстрации физических принципов сложения гармонических колебаний (теорема Фурье), амплитудно-частотного спектра и влияния нелинейных преобразований (клиппинга) на форму сигнала и его звучание.
+
+**Требования к стеку:**
+* Разработка ведется на чистом HTML, CSS, JavaScript (Vanilla JS). 
+* Запрещено использование сторонних библиотек и фреймворков.
+* Генерация звука реализуется через встроенный Web Audio API.
+* Отрисовка графиков реализуется через HTML5 `<canvas>`.
+
+**Структура интерфейса (Сетка 2x2):**
+1. **Левая верхняя панель (Базовое колебание):** Динамический график выбранной пользователем гармонической волны.
+2. **Левая нижняя панель (Управление):** 
+   - Вывод теоретических формул: `y = A*cos(wt + θ)` и `V = 1/T`.
+   - Система вкладок (V1, V2, V3) для независимой настройки трех разных волн.
+   - Ползунки управления: Частота (от 0 до 20 кГц) и Амплитуда (0-100%).
+   - Переключатель шага настройки частоты (10 Гц / 100 Гц).
+   - Кнопка активации Web Audio API («Вывод на динамике»).
+   - Кнопка добавления нелинейного искажения (Клиппинга).
+   - Кнопка «Сбросить все».
+3. **Правая верхняя панель (Сумма колебаний):** Текстовое описание теоремы Фурье и график результирующего (сложного) колебания, полученного путем сложения волн из вкладок V1, V2 и V3. При активации клиппинга график должен обрезать пики по оси Y.
+4. **Правая нижняя панель (Амплитудно-частотный спектр):** Столбчатая диаграмма частот. При включении нелинейного преобразования должны программно отрисовываться дополнительные (паразитные) гармоники.
+
+---
+
+## 2. Журнал разработки (История запросов к нейросети)
+
+Ниже задокументирован процесс работы с ИИ-ассистентом при создании данного проекта.
+
+**Запрос 1:** `В чем ошибка? [Скриншот терминала Git с ошибкой src refspec master does not match any]`
+* **Ответ ИИ:** Объяснена причина (попытка отправить ветку без единого коммита) и даны 4 шага для создания файла `README.md`, добавления его в индекс (`git add`) и создания первого коммита (`git commit -m`).
+
+**Запрос 2:** `Ну вот нам говорили вот делать по этому сценарию формат вот: и что мне делать [Фотографии конспекта по физике и ТЗ на PWA]`
+* **Ответ ИИ:** Предоставлен черновой вариант сценария приложения, разбитый на 5 логических сцен на основе конспекта (базовое колебание, сумма Фурье, спектр, нелинейные преобразования, тестирование).
+
+**Запрос 3:** `Откуда ты взял такой сценарий... я же фото присылала интерактивного сценария по нему надо [Указание на ошибку контекста]`
+* **Ответ ИИ:** Произведена корректировка. Написан исходный код (`index.html`), в точности повторяющий 4 блока из физического конспекта (с графиками, вкладками и ползунками). 
+
+**Запрос 4:** `Оформи как у мен в точь и полноценный рабочий код чтобы работа до приложение по этому сценарию [Фото конспекта со звуком и графиками]`
+* **Ответ ИИ:** Код переписан. Добавлена интеграция с Web Audio API для вывода звука на динамик, математическая реализация клиппинга (искажения графика и звука), паразитные гармоники на спектре. 
+
+**Запрос 5:** `Сделай какие-то улучшения в коде и отобрази это в других файлах чтобы я сделал коммит типо изменения`
+* **Ответ ИИ:** Выпущена версия v1.1. Добавлено плавное нарастание звука (устранен щелчок), добавлена координатная сетка на спектр, введена кнопка «Сбросить все». Обновлен `issues.md`.
+
+**Запрос 6:** `Более подробное техническое задание и в файлике issues.md и изменения и напиши в отдельном файле мои запросы и свои ответы...`
+* **Ответ ИИ:** Сформирован текущий файл `README.md` с подробным ТЗ и историей промптов, а также расширен файл `issues.md`.