v1.0.89: detailed code comments — all Python files + index.html architecture overview

site/routes/api_test.py

@@ -1,3 +1,28 @@
+"""
+Основной модуль: запуск операций, параметры, поллинг статуса, логирование.
+
+Эндпоинты:
+  GET  /api/services                          — список сервисов
+  GET  /api/instances/list                    — все инстансы
+  GET  /api/operations/<svc_id>               — операции + tracked-инстансы сервиса
+  GET  /api/params/<op_id>[?instanceUid=xxx]  — параметры операции (шаблон или текущие)
+  POST /api/test                              — запустить операцию (CREATE или non-CREATE)
+  GET  /api/test/status/<op_uid>              — поллинг статуса операции
+  GET  /api/log                               — последние строки лога
+
+Ключевые функции:
+  _client()                         — HttpClient с токеном из cookie/env
+  _client_id()                      — ClientID из JWT
+  _stand()                          — dev/test по токену
+  _with_prefix(name)                — гарантирует префикс autotest-
+  _unique_display_name(client, name)— проверка на дубликат + суффикс
+  _find_uid(resp)                   — извлечение UUID из ответа API
+  _uid_from_location(loc)           — извлечение UUID из Location-заголовка
+  _get_instance_display_name(...)   — GET /instances/{uid} → displayName
+  _finish_op(...)                   — фоновый поллинг до dtFinish
+  _log(msg)                         — лог в stdout + /tmp/app-autotest.log
+"""
+
 from flask import Blueprint, current_app, jsonify, request
 import uuid
 import os