Files
buryan-infra/ops/work/web/DEFECTS.md

59 lines
5.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Журнал дефектов и корневых причин
Правило: каждый дефект — строка с **корневой причиной** и **какой практикой
он бы ловился**. Дефект без причины не закрываем.
| # | Дата | Что сломалось | Корневая причина | Практика, которая бы поймала | Статус |
|---|---|---|---|---|---|
| 1 | 06.11 | Данные матрицы: `√` → `в€љ`, `×` → `Г—` | чтение UTF-8 как CP1251 | фикстура на разбор XLSX | исправлено |
| 2 | 06.11 | 22 ложных конфликта в сверке | отсутствие поля `supported` → `False` по умолчанию | схема-валидация YAML | исправлено |
| 3 | 06.11 | MeetingDisplay подключался по USB | извлечённые порты перекрывали правило роли | тест «дисплей → HDMI» (теперь есть) | исправлено |
| 4 | 06.11 | WPP30 предлагался как VCH-хаб | фильтр по наличию `ports.vch`, без проверки типа устройства | тест осмысленности предложений | исправлено |
| 5 | 06.11 | Страница не открывалась (пустая) | обработчики ссылались на удалённые функции | проверка целостности UI (`check_ui`) | исправлено |
| 6 | 06.11 | `boot()` обрывался, направления не выбирались | лишняя `}` при патче файла | проверка баланса скобок / смоук UI | исправлено |
| 7 | 06.11 | Вкладки «Схема», «Кабели» пустые | `showTab` не вызывал отрисовку | приёмочный сценарий «открыть все вкладки» | исправлено |
| 8 | 06.11 | PDF-экспорт 500 | забыт `import io` в модуле сервиса | смоук эндпойнта после правки | исправлено |
| 9 | 06.11 | Смена данных не подхватывалась | модель в памяти сервиса | контракт «данные изменились → перечитать» | исправлено |
| 10 | 06.11 | Сохранение проекта 403 | включили токен, UI не отправлял | смоук «сохранить с токеном» | исправлено |
| 11 | 06.11 | `/matrix` 500 | затенение переменной `hosts` | юнит-тест сервиса | исправлено |
## Системные выводы
| Причина | Сколько дефектов | Практика внедрена |
|---|---|---|
| Патч файла без проверки синтаксиса | 2 (5, 6) | `check_webui.py` + pre-commit |
| Нет прогона эндпойнта после правки | 2 (8, 10) | смоук сервисов + pre-commit |
| Нет эталона «как должно быть» | 3 (2, 3, 4) | юнит-тесты + фикстуры |
| Нет приёмки в браузере | 1 (7) | `ACCEPTANCE.md` |
| Нет контракта данных | 1 (9) | `reload_if_changed` |
## Открытые дефекты
| # | Что | Почему пока не исправлено |
|---|---|---|
| 12 | VCH-цепочка считается приблизительно | нет данных: порты in/out у аксессуаров, ёмкость цепи |
| 13 | MCore/A40/A50 — один источник данных | нет официального списка (ждать LLM) |
| 14 | Покрытие пустое у ряда устройств | нет `pickup_m`/`fov_h` (есть ручной ввод) |
## Форма новой записи
```
| N | дата | что сломалось | корневая причина | практика | статус |
```
## Ночной спринт 06–07.11.2026
| # | Дефект | Где | Статус |
|---|---|---|---|
| 13 | Nextcloud: два SSO-приложения (`user_oidc` + `oidc_login`), дубль провайдера, чужие креды Vaultwarden | CT109 | исправлено |
| 14 | Nextcloud 35 несовместим с `user_oidc` 8.11 — маршруты 404 | CT109 | обновлено до 8.13.0 |
| 15 | `allow_local_remote_servers=false` не давал Nextcloud достучаться до Authentik | CT109 | исправлено |
| 16 | CT109 без интернета — приложения обновляются только вручную | CT109 | задокументировано |
| 17 | Immich ML-контейнер упал (`Exited 255`) — лица/места не работают | VM104 | открыт |
| 18 | Immich: 0 ассетов по API при 220 МБ в `/mnt/photos` | VM104 | открыт |
| 19 | Paperless: 1 документ (postgres `paperless_main`) вместо ожидаемых | CT105 | открыт |
| 20 | Vaultwarden: официальный образ без OIDC (SSO_* env не работают) | CT109 | ограничение образа |
| 21 | Секреты в открытом виде в `.env`/конфигах (Nextcloud, Paperless) | CT109/CT105 | открыт |
| 22 | Kavita автоматически перезапускалась после `docker stop` | CT111 | исправлено (`restart=no`) |
| 23 | Мёртвые приложения в Authentik (plex, tautulli, kavita) | CT114 | удалены |