Ревью кодовой базы (docs/reviews/2026-09-26-codebase-review.md) и планы по каждой находке:
011 IP уникален в VRF и хранится в самом узком префиксе (addresses.vrf_id, составной FK
с каскадом при переносе VRF, миграция 0007 с остановкой на дублях).
012 Ограничение попыток входа (login_attempts, 429 + Retry-After), выравнивание времени
ответа, журнал без вытеснения анонимными событиями (миграция 0006).
013 Границы пагинации: отрицательные/чрезмерные limit/offset дают 422 вместо 500.
014 Экран адресов: страница свободных адресов арифметикой, пагинация в SQL.
015 Запрет адреса сети/broadcast, загрузка не выше 100 %.
016 Роль по умолчанию — viewer.
017 Проверка JWT_SECRET/ADMIN_PASSWORD при старте.
018 null в PATCH очищает текстовые поля; нейтральный текст конфликта БД.
019 Пакетная загрузка в списках вместо N+1.
020 Автоназначение адреса вне вложенных префиксов, с блокировкой префикса.
021 Advisory-lock при снятии прав администратора, уникальный lower(username) (миграция 0008).
022 Контейнер не от root, healthcheck, блокировка миграций, requirements.lock.
023 Экранирование LIKE, журнал отказов очистки, заголовки безопасности, учёт force-удаления,
отзыв токенов при смене пароля (claim pv, миграция 0005).
024 Исправление находок ревью 011-023 (docs/reviews/2026-09-26-changes-011-023-review.md):
сериализация попыток входа, запрет переноса адресов в адрес сети/broadcast, журнал входов,
запрет смены своего пароля через PATCH, валидация PATCH устройства, обновлён тест токенов.
Тесты: 14 passed. Документация: README.md, docs/changes/011-024, docs/reviews.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
PATCH адреса: null даёт ложный 409 (изменение 018)
Находка ревью № 8, серьёзность — низкая.
Context
update_address (app/api/v1/prefixes.py) использует model_dump(exclude_unset=True) без exclude_none: {"description": null} пишет NULL в колонку NOT NULL →
IntegrityError → 409 «Запись с такими значениями уже существует» (воспроизведено). Остальные PATCH-эндпоинты исключают None.
Решение
- Единая семантика PATCH:
nullдля текстовых полей — «очистить» (записать""), дляstatus— 422 (обязательное поле), дляdevice_id— отвязать устройство (None, как сейчас). Реализация — вAddressUpdateчерезfield_validator: текстовыеNone → "",status— типAddressStatusбезNone-варианта (поле по-прежнему необязательное). - Проверить тем же правилом
PrefixUpdate,DeviceUpdate,VrfUpdate,UserUpdate: гдеexclude_noneскрывает намерение очистить поле (note,description) — применить то же приведение. - Общий обработчик
IntegrityErrorоставить как страховку, но текст «Конфликт с существующими данными» (уже так вmain.py); сообщение «Запись с такими значениями уже существует» вcommit()по умолчанию заменить на нейтральное — сейчас оно вводит в заблуждение при нарушении NOT NULL/FK.
Файлы
app/schemas.py, app/api/v1/prefixes.py, app/services.py (текст по умолчанию), tests/test_api.py.
Тест
PATCH адреса {"description": null} → 200 и description == ""; {"status": null} → 422.
Проверка
pytest -q; в UI правка адреса с очисткой описания.