59 lines
5.6 KiB
Markdown
59 lines
5.6 KiB
Markdown
# Журнал дефектов и корневых причин
|
||
|
||
Правило: каждый дефект — строка с **корневой причиной** и **какой практикой
|
||
он бы ловился**. Дефект без причины не закрываем.
|
||
|
||
| # | Дата | Что сломалось | Корневая причина | Практика, которая бы поймала | Статус |
|
||
|---|---|---|---|---|---|
|
||
| 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 | удалены |
|