docs: добавь поясняющие комментарии к модулям и инструментам

python/tests/test_generator_data.py

@@ -1,3 +1,10 @@
+# Проверки generator_data: фиксируют ожидаемое поведение на воспроизводимых входных данных.
+# Сценарии для навигации по файлу:
+#   test_processing_csv_roundtrip_into_generator
+#   test_samples_recipe_and_resampling
+# Тестовые значения и подмены окружения относятся к проверке контракта; они не являются
+# настройками рабочего устройства.
+
 """Waveform data helpers run independently of SETGUI and Qt."""
 import io
 import json