252 lines
18 KiB
Markdown
252 lines
18 KiB
Markdown
# История разработки app-autotest
|
||
|
||
# v1.0.74 (27.07.2026) — version bump for push
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` create-операция отделена от обычных операций: CREATE использует фиксированный префикс `autotest-`, а non-create берёт имя выбранного инстанса.
|
||
- Из non-create ветки убран случайный fallback `tut` и общий create-style `displayName`.
|
||
- В `site/routes/api_test.py` backend больше не подставляет create-имя по умолчанию для обычных операций и возвращает `displayName` для финального статуса.
|
||
- В `site/routes/main.py` список autotest-инстансов теперь строится cloud-first без старой склейки через map по имени; tracker остался только как временный fallback, если cloud ещё не вернул новый инстанс.
|
||
|
||
### Что это чинит
|
||
- Путаницу между CREATE и обычными операциями.
|
||
- Ситуацию, когда в UI появлялся лишний `tut`.
|
||
- Дубли `running/creating` на одном autotest-инстансе.
|
||
- Неясный финальный статус, где было видно операцию, но не было понятно, над каким инстансом она выполнялась.
|
||
|
||
# v1.0.72 (27.07.2026) — service list keeps one autotest row per displayName
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` сервисный список теперь cloud-first и не склеивает разные строки в одну map.
|
||
- Tracker остаётся только как fallback, если cloud ещё не вернул конкретный autotest-инстанс.
|
||
|
||
### Что это чинит
|
||
- Дубли `running/creating` на одном и том же autotest-инстансе.
|
||
|
||
# v1.0.71 (27.07.2026) — finished status shows instance name
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` финальная строка после `OK/FAIL` теперь показывает имя инстанса.
|
||
- Имя операции и длительность остаются рядом, отдельно от имени инстанса.
|
||
|
||
### Что это чинит
|
||
- Ситуацию, когда после завершения delete/modify было видно только название операции, но не ясно, над каким инстансом она выполнялась.
|
||
|
||
# v1.0.70 (27.07.2026) — dedupe autotest instances by displayName
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` сервисный список теперь склеивает записи по `displayName`.
|
||
- Если cloud уже отдал `running`, он выигрывает у tracker-fallback `creating`.
|
||
|
||
### Что это чинит
|
||
- Дубли одной и той же autotest-записи после CREATE, когда в списке появлялись и `running`, и `creating`.
|
||
|
||
## v1.0.69 (27.07.2026) — autotest prefix fixed in CREATE field
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` префикс `autotest-` отображается отдельным фиксированным текстом.
|
||
- Рядом с ним остаётся только редактируемый суффикс имени.
|
||
- При отправке CREATE имя собирается как `autotest-` + введённый хвост.
|
||
|
||
### Что это чинит
|
||
- Ситуацию, когда весь `displayName` показывался в одном редактируемом поле.
|
||
- Риск случайно стереть обязательный префикс `autotest-`.
|
||
|
||
## v1.0.68 (27.07.2026) — operation name shown after OK + muted operation buttons
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` финальный статус теперь показывает имя операции рядом со временем.
|
||
- Кнопки операций получили спокойные неброские оттенки по типу операции.
|
||
|
||
### Что это чинит
|
||
- Неясность после завершения операции, когда было видно только `OK` и время без указания, что именно выполнялось.
|
||
- Слишком кислотный вид кнопок операций.
|
||
|
||
## v1.0.67 (27.07.2026) — autotest instances are shown by cloud prefix
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` список инстансов сервиса больше не отфильтровывается через `/tmp/instances.json`.
|
||
- Теперь в таблицу попадают все облачные инстансы с префиксом `autotest-`.
|
||
- Трекер оставлен только как fallback, если новый autotest-инстанс ещё не успел появиться в ответе облака.
|
||
|
||
### Что это чинит
|
||
- Ситуацию, когда autotest-инстанс уже есть в облаке, но не показывается в таблице из-за отсутствия записи в json.
|
||
|
||
## v1.0.66 (27.07.2026) — backend status resolver for operations
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` добавлен канонический резолвер статуса инстанса для `/api/operations/<svc_id>`.
|
||
- Backend теперь отдаёт `status` для инстансов, а UI читает именно его вместо угадывания по `explainedStatus`.
|
||
- В `site/templates/index.html` убрано раннее отображение «Готово» во время выполнения операции.
|
||
|
||
### Что это чинит
|
||
- Путаницу между `creating`, `running` и фактическим статусом в UI.
|
||
- Ситуацию, когда фронтенд сам интерпретировал статусы и показывал не то состояние.
|
||
|
||
## v1.0.65 (27.07.2026) — cloud list pagination fix
|
||
|
||
### Что изменилось
|
||
- В `site/operations/get_instances.py` пагинация списка инстансов теперь останавливается по размеру страницы, а не по `total`.
|
||
- Это убирает ситуацию, когда инстанс уже создан в облаке, но приложение не дочитало следующую страницу и показывает `creating`.
|
||
- В `DOCS/ARCHITECTURE.md` и `site/app.py` синхронизирована версия `1.0.65`.
|
||
|
||
### Что это чинит
|
||
- Ложный `creating` для уже существующего инстанса, если он попал не на первую страницу `/instances`.
|
||
|
||
## v1.0.64 (27.07.2026) — header version + editable displayName placeholder
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` версия теперь гарантированно попадает в `config.VERSION` даже после `load_config()`.
|
||
- В `site/templates/index.html` поле `displayName` остаётся редактируемым, но автотест-имя показывается как placeholder.
|
||
- При CREATE пользователь может ввести своё имя, а backend всё равно добавит `autotest-` и проверит уникальность.
|
||
- В `DOCS/ARCHITECTURE.md` зафиксированы оба изменения.
|
||
|
||
### Что это чинит
|
||
- Пропадающую версию в шапке.
|
||
- Неправильное поведение поля `displayName`, когда оно выглядело как готовое значение вместо подсказки.
|
||
|
||
## v1.0.63 (27.07.2026) — autotest namespace for instances
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` CREATE теперь генерирует `displayName` с префиксом `autotest-` и проверяет его на уникальность среди текущих инстансов.
|
||
- В `site/routes/api_test.py` backend тоже нормализует `displayName` с этим префиксом и, если нужно, добавляет суффикс для уникальности перед созданием в облаке.
|
||
- В `site/routes/main.py` список инстансов фильтруется по namespace `autotest-`, чтобы в UI попадали только тестовые инстансы приложения.
|
||
- В `DOCS/ARCHITECTURE.md` зафиксирован переход на namespace-based фильтрацию.
|
||
|
||
### Что это чинит
|
||
- Дубли `displayName` при CREATE.
|
||
- Чужие инстансы в списке.
|
||
- Зависимость от локального трекера как от основного признака принадлежности.
|
||
|
||
## v1.0.62 (27.07.2026) — immediate visual refresh after CREATE
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` после завершения CREATE список инстансов перерисовывается полностью.
|
||
- `refreshInstances()` больше не зависит от DOM-diff и сразу ставит новый инстанс в список.
|
||
- `DOCS/ARCHITECTURE.md` и `site/app.py` синхронизированы на `1.0.62`.
|
||
|
||
### Что это чинит
|
||
- После появления кнопки «Готово» созданный инстанс должен сразу быть виден в списке.
|
||
|
||
## v1.0.61 (27.07.2026) — immediate list rebuild after CREATE
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` `refreshInstances()` теперь всегда полностью перерисовывает список инстансов после завершения операции.
|
||
- После `OK` новый инстанс должен появляться в списке сразу, без зависимости от DOM-diff и без перезагрузки страницы.
|
||
- В `DOCS/ARCHITECTURE.md` и `site/app.py` синхронизирована версия `1.0.61`.
|
||
|
||
### Что это чинит
|
||
- Убрана ситуация, когда после CREATE статус уже `OK`, но в UI инстанс ещё не виден.
|
||
|
||
## v1.0.60 (27.07.2026) — full list rerender after CREATE
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` `refreshInstances()` теперь полностью перерисовывает список инстансов, а не пытается вставить только diff.
|
||
- После завершения CREATE новый инстанс должен появляться в списке сразу после `OK`.
|
||
- В `DOCS/ARCHITECTURE.md` добавлен отдельный шаг про полную перерисовку списка.
|
||
|
||
### Что это чинит
|
||
- Снята зависимость от частичного DOM-diff-а, из-за которого созданный инстанс мог не появляться сразу.
|
||
|
||
## v1.0.59 (27.07.2026) — restore tracked instance after reload
|
||
|
||
### Что изменилось
|
||
- В `site/routes/main.py` tracked-инстансы, которых Nubes уже не отдает в ответе после reload, снова добавляются в список из `/tmp/instances.json`.
|
||
- В `site/templates/index.html` статус CREATE теперь показывает имя инстанса, а не только `create`.
|
||
- В `DOCS/ARCHITECTURE.md` зафиксирован новый шаг восстановления списка после F5.
|
||
|
||
### Что это чинит
|
||
- После F5 инстанс не пропадает из UI, если он есть в локальном трекере.
|
||
- В статусе выполнения видно, по какому displayName идет CREATE.
|
||
|
||
## v1.0.58 (27.07.2026) — version bump
|
||
|
||
- Поднята версия проекта до `1.0.58`.
|
||
- Синхронизированы заголовки в `site/app.py` и `DOCS/ARCHITECTURE.md`.
|
||
|
||
## v1.0.57 (27.07.2026) — UI hardening + history sync
|
||
|
||
### Что изменилось
|
||
- В `site/templates/index.html` финальное состояние кнопки вынесено в `setFinishedState()`, чтобы не держать логику завершения операции в двух местах.
|
||
- После завершения операции кнопка «Готово» теперь гарантированно сбрасывает обработчик через `btn.onclick = null`.
|
||
- Повторный CREATE через старый обработчик больше не воспроизводится.
|
||
- `displayName` больше не теряется в нормальном сценарии завершения CREATE.
|
||
- В `site/app.py` версия поднята до `1.0.57`.
|
||
- В `DOCS/ARCHITECTURE.md` отмечено закрытие бага с повторным CREATE и синхронизирован статус по `displayName`.
|
||
|
||
### Зачем это было сделано
|
||
- Убрать хрупкость вокруг состояния кнопки после завершения операции.
|
||
- Привести документацию и версию к текущему состоянию кода.
|
||
|
||
## v1.0.54 (27.07.2026) — Аудит #3: 4 бага исправлено
|
||
|
||
### Баг #1: `_client()` не автоопределял стенд (КРИТИЧЕСКИЙ)
|
||
- **Где:** `api_test.py:_client()` — использовал `current_app.config["NUBES_API_ENDPOINT"]` (raw env var)
|
||
- **Симптом:** main.py автоопределял стенд для главной, но POST /api/test падал с 401 если токен от другого стенда
|
||
- **Исправление:** `detect_endpoint()` вынесен в `api/http_client.py`, используется в `_client()`
|
||
- **Как пропустили:** анализировал main.py и api_test.py в изоляции, не сравнил
|
||
|
||
### Баг #2: `_find_uid()` возвращал не тот UUID (КРИТИЧЕСКИЙ)
|
||
- **Где:** `api_test.py:_find_uid()` — итерировал по ВСЕМ значениям dict, искал 36-символьную строку
|
||
- **Симптом:** `/instanceOperations` возвращает оба `instanceUid` + `instanceOperationUid`, функция брала первый попавшийся → `run` шёл на неправильный URL
|
||
- **Исправление:** ищет по конкретным ключам: `instanceOperationUid` → `instanceUid` → `uid` → `Uid`
|
||
- **Как пропустили:** не проверил реальный формат ответа API
|
||
|
||
### Баг #3: Сироты при ошибке params (СРЕДНИЙ)
|
||
- **Где:** `api_test.py`: порядок — `POST /instances` → `POST /instanceOperations` → params loop → `tracker_add`
|
||
- **Симптом:** если params падает — инстанс и операция созданы в Nubes, трекер пуст → сироты
|
||
- **Исправление:** `tracker_add` вызывается ДО params loop, сразу после получения `instanceUid`
|
||
- **Как пропустили:** не трассировал линейно порядок вызовов
|
||
|
||
### Баг #4: `flock` без таймаута (НИЗКИЙ)
|
||
- **Где:** `tracker.py:_locked_read/_write` — `fcntl.flock(fd, LOCK_EX)` без LOCK_NB
|
||
- **Симптом:** при зависшем процессе с локом все воркеры блокируются навсегда
|
||
- **Исправление:** `_acquire_lock()` с `LOCK_EX | LOCK_NB` + retry до 2 секунд
|
||
- **Как пропустили:** новый код flock не перечитал с нуля после добавления
|
||
|
||
### Архитектурное: `detect_endpoint` вынесен в http_client.py
|
||
- Раньше был в main.py → недоступен для api_test.py
|
||
- Теперь в `api/http_client.py` → оба модуля используют
|
||
|
||
---
|
||
|
||
## v1.0.53 (27.07.2026) — Файловый трекер с fcntl.flock
|
||
- In-memory dict заменён на `/tmp/instances.json` с `fcntl.LOCK_EX`
|
||
- Multi-worker gunicorn: все воркеры читают/пишут один файл под локом
|
||
|
||
## v1.0.52 (27.07.2026) — `_tmpl()` helper
|
||
- Все переменные шаблона передаются во всех трёх return-путях index()
|
||
- Исправлен UndefinedError при «Выйти»
|
||
|
||
## v1.0.51 (27.07.2026) — Автоопределение стенда + UnboundLocalError
|
||
- `detect_endpoint()` в main.py: пробует токен против dev и test API
|
||
- `instance_groups = {}` инициализирован до if
|
||
- `_finish_op` обёрнут в полный try/except
|
||
|
||
## v1.0.50 (27.07.2026) — showStages + api_operations fix
|
||
- `showStages()`: dtFinish вместо isSuccessful для ⏳/✅/❌
|
||
- `api_operations()`: не фильтровать "not created", добавлять tracked-сирот
|
||
|
||
## v1.0.49 (27.07.2026) — In-memory tracker + refreshInstances
|
||
- Трекер: in-memory dict вместо файла `/tmp/instances.json`
|
||
- `refreshInstances()` добавляет новые инстансы в DOM (не только бейджи)
|
||
- `selectService()` заменён на `refreshInstances()` после OK
|
||
|
||
## v1.0.48 (27.07.2026) — tracker_add синхронно
|
||
- `tracker_add` в `api_test()` до `threading.Thread`
|
||
- Лог `is_ok` в `_finish_op`
|
||
- Flexbox-кнопки горизонтально
|
||
|
||
## v1.0.47 (27.07.2026) — displayName fix
|
||
- displayName захватывается до очистки формы
|
||
- tracker_add до _op_results[OK]
|
||
- autotest-1 в _INITIAL
|
||
|
||
## v1.0.46 (27.07.2026) — _finish_op signature
|
||
- Добавлены op_name, svc_op_id в _finish_op()
|
||
|
||
## v1.0.45 и ранее
|
||
- Базовый CREATE/MODIFY/SUSPEND/DELETE/RESUME/REDEPLOY
|
||
- UI с этапами, поллинг, params форма
|
||
- Множественные баги CREATE flow (документированы в DOCS/api-create-flow.md)
|