Подробные комментарии ко всем JS-файлам фронтенда

site/static/app.js

@@ -1,17 +1,34 @@
-// app.js — загрузчик модулей фронтенда
-// Файлы подгружаются в index.html в порядке зависимостей:
+// app.js — загрузчик и точка входа фронтенда
+//
+// Файлы подгружаются в index.html в СТРОГОМ порядке зависимостей:
 //   utils.js → instances.js → operations.js → history.js → scenario-list.js
-// window.APP — переменные из Jinja2: { version, stand, hasUserToken, firstServiceId }
+//   scenario-form.js → params-render.js → scenario-create/edit/delete.js
+//   icons.js, snackbar.js, views.js — без зависимостей
+//
+// Глобальные переменные из Jinja2 (window.APP):
+//   { version, stand, hasUserToken, firstServiceId }
 
 /*
- * Архитектура: ванильный JS, модули по файлам:
- *   utils.js         — _esc(), validateJson(), busy, лог-панель
- *   instances.js     — selectService(), toggleInstance(), refreshInstances()
- *   operations.js    — startCreate(), runOp(), showParams(), executeOp(), poll
- *   history.js       — toggleHistory(), loadHistory()
- *   scenario-list.js — toggleScenario(), loadScenarios(), runScenario()
+ * Архитектура фронтенда — ванильный JS (без фреймворков).
+ * Модули по файлам, функции в глобальной области видимости:
+ *
+ *   utils.js             — _esc(), validateJson(), busy, relativeTime(), лог-панель
+ *   instances.js         — selectService(), toggleInstance(), refreshInstances()
+ *   operations.js        — startCreate(), runOp(), showParams(), executeOp(), poll
+ *   history.js           — toggleHistory(), loadHistory()
+ *   scenario-list.js     — toggleScenario(), loadScenarios(), runScenario()
+ *   scenario-form.js     — showScenarioEditor(), renderEditor(), saveScenario()
+ *   params-render.js     — renderParamRow(), renderMapFixedRow(), collectParams()
+ *   icons.js             — ICONS = {play, edit, trash, ...}  (inline-SVG)
+ *   snackbar.js          — showSnackbar(msg, type)
+ *   views.js             — switchView(viewId)
  */
 
-// Инициализация
+// ── Инициализация при загрузке страницы ──
+
+// Запускаем поллинг логов (каждые 2 секунды, только если панель видна)
 startLogPoll();
+
+// Выбираем первый сервис из переданного Jinja2 значения
+// currentSvcId берётся из window.APP.firstServiceId (задаётся в index.html)
 selectService(currentSvcId);