63 lines
5.9 KiB
Markdown
63 lines
5.9 KiB
Markdown
 
|
# Статус устройства и сведения об устройстве в списке адресов префикса (изменение 039)
|
|||
|
|
|
|||
|
|
## Context
|
|||
|
|
Сейчас в списке адресов префикса (`screens.address`) не видно, к какому устройству привязан адрес, — только в диалоге правки.
|
|||
|
|
У устройства нет эксплуатационного статуса. Нужно:
|
|||
|
|
1. Ввести **статус устройства** — «Активен», «Выключен», «На обслуживании». Статус назначается вручную на экране устройств:
|
|||
|
|
в диалоге создания и правки, в таблице устройств — новая колонка «Статус».
|
|||
|
|
2. В списке адресов префикса — три новые колонки: **тип устройства**, **имя устройства**, **статус устройства**
|
|||
|
|
(пусто или «—», если адрес не привязан к устройству).
|
|||
|
|
|
|||
|
|
## Модель и миграция `0016_device_status.py`
|
|||
|
|
- `app/models.py`: `class DeviceStatus(str, enum.Enum): active, off, maintenance`.
|
|||
|
|
`Device.status: Mapped[DeviceStatus]` — `Enum(DeviceStatus, name="device_status")`, `default=active`, `server_default='active'`, NOT NULL.
|
|||
|
|
- Миграция: создать тип `device_status`, добавить колонку с `server_default 'active'` — существующие устройства станут «Активен».
|
|||
|
|
`downgrade`: удалить колонку и тип.
|
|||
|
|
|
|||
|
|
## API
|
|||
|
|
- `app/schemas.py`:
|
|||
|
|
- `DeviceIn.status: DeviceStatus = DeviceStatus.active`;
|
|||
|
|
- `DeviceUpdate.status: DeviceStatus | None = None`;
|
|||
|
|
- `DeviceOut.status`;
|
|||
|
|
- `AddressOut`: `device_type_name: str | None`, `device_status: str | None`.
|
|||
|
|
- `app/api/v1/refs.py`: создание и правка устройства принимают `status`. Смена статуса попадает в журнал через существующий `apply_update`
|
|||
|
|
(`device.updated` с `diff`); `_device_outs` отдаёт `status`.
|
|||
|
|
- `app/api/v1/prefixes.py::list_addresses`:
|
|||
|
|
- запрос `select(Address, Device.name)` расширить: `Device.status` и `DeviceType.name` через `outerjoin(DeviceType, …)`;
|
|||
|
|
- `_addr_out(a, device_name, device_type_name, device_status)` — обновить все вызовы;
|
|||
|
|
- остальные эндпоинты, возвращающие `AddressOut` (создание, правка, автоназначение), отдают поля так же — через общий хелпер
|
|||
|
|
или отдельный запрос по `device_id`, без N+1 в списке.
|
|||
|
|
- Фильтр и поиск по статусу устройства не требуются.
|
|||
|
|
|
|||
|
|
## UI — `web/app.js`
|
|||
|
|
- Справочник `DEVICE_STATUS = {active: ["green","Активен"], off: ["", "Выключен"], maintenance: ["amber","На обслуживании"]}` —
|
|||
|
|
цвет бейджа и подпись, по образцу `ADDR_STATUS`.
|
|||
|
|
- **Экран устройств** (`screens.devices`):
|
|||
|
|
- колонка «Статус» с бейджем (после «Тип»), расширить `selCols` и заголовок;
|
|||
|
|
- в `deviceDialog` — `fSelect("status", "Статус", …)`, по умолчанию «Активен», значение уходит в `POST`/`PATCH`.
|
|||
|
|
- **Список адресов** (`screens.address`): после «Описание» колонки «Тип устройства», «Устройство», «Статус устройства».
|
|||
|
|
- имя устройства ссылкой не делаем — строка и так кликабельна; у свободных и непривязанных адресов — «—»;
|
|||
|
|
- статус — тем же бейджем;
|
|||
|
|
- ширины подобрать так, чтобы таблица не переполнялась: «Описание» может стать уже; «Изменено» оставить.
|
|||
|
|
- Цвета — только через существующие классы бейджей и токены тёмной темы (изменение 038), без литералов.
|
|||
|
|
|
|||
|
|
## Тесты (минимально)
|
|||
|
|
Одна проверка в существующем тесте `tests/test_api.py`, например в `test_in_use_objects_cannot_be_deleted` или рядом, без нового файла:
|
|||
|
|
- создать устройство со `status="maintenance"`, привязать к нему адрес;
|
|||
|
|
- `GET /prefixes/{id}/addresses` → у адреса `device_name`, `device_type_name`, `device_status == "maintenance"`;
|
|||
|
|
- `PATCH /devices/{id} {"status": "off"}` → 200, `status == "off"`.
|
|||
|
|
|
|||
|
|
## Документация
|
|||
|
|
- `README.md`: модель данных — статус устройства; «Интерфейс» — колонки; миграции `0001`–`0016`; строка 039 в истории.
|
|||
|
|
- `SUMMARY.md` — по завершении (моя часть).
|
|||
|
|
|
|||
|
|
## Исполнение
|
|||
|
|
По принятой схеме: код, миграцию, UI и тест пишет агент на Sonnet, он же пересобирает стенд с `--force-recreate`; тесты он не запускает.
|
|||
|
|
Моя часть — ревью, `pytest`, проверка миграции и API. UI проверяет пользователь.
|
|||
|
|
|
|||
|
|
## Проверка
|
|||
|
|
- `alembic current` = `0016`, `alembic check` чисто; откат до 0015 и повторный upgrade.
|
|||
|
|
- Существующие устройства после миграции — `active`.
|
|||
|
|
- `pytest -q` — все зелёные.
|
|||
|
|
- API: статус меняется и пишется в журнал (`device.updated`, `diff.status`); адреса отдают три новых поля;
|
|||
|
|
у свободных и непривязанных адресов — `null`.
|