Files
ros_control/docs/changes/024-readme-restructure/summary.md
T

18 lines
2.2 KiB
Markdown
Raw Normal View History

2026-09-28 17:32:37 +03:00
# Итоги: 024 — оптимизация README по образцу ipam_control
## Сделано
- README переверстан по структуре `/opt/lvraid/claude/ipam_control/README.md`: «Быстрый старт», «Конфигурация» (одна таблица),
«Архитектура» (таблица слоёв и дерево каталогов), «Функциональность и правила» (полужирные подзаголовки, таблица состояний «Upgrade ROS»),
«Требования к устройствам», «API» (таблица по областям и «Соглашения»), «Безопасность», «Эксплуатация», «Интерфейс», «Тесты»,
«История изменений» (таблица со ссылками на `plan.md`/`summary.md` 001–024), «Отчёты ревью».
- Убраны повторы: требования к секретам и команды генерации — по одному месту; длинные описания истории изменений — в документах изменений.
- Добавлено: раздел «Отчёты ревью», копирование БД в режиме WAL (замечание 13 повторного ревью, только документация), текущий стенд на порту 8001,
коды ошибок API (включая 401), синхронность смены канала одного устройства и `refresh`.
## Проверено
- Все 51 ссылка (49 на `docs/changes/*`, 2 на `docs/reviews/*`) указывают на существующие файлы.
- Переменные `.env` сверены с `app/config.py`, эндпоинты — с `app/api/v1.py`, число тестов (33) — с `pytest --collect-only`.
- Код не менялся, стенд не пересобирался.
## Оговорки
- Документы изменений в этом проекте названы `plan.md`/`summary.md` (в образце — `PLAN.md`/`SUMMARY.md`); регистр сохранён как есть.