ayurishchevandClaude Opus 5.5
7c830be721
README переверстан (docs/changes/024): быстрый старт, конфигурация одной таблицей, архитектура с деревом каталогов, функциональность и правила по разделам (таблица состояний «Upgrade ROS»), API по областям с соглашениями, безопасность, эксплуатация (в т.ч. копия БД в режиме WAL, стенд на порту 8001), интерфейс, тесты, история изменений таблицей со ссылками на план и итог, отчёты ревью. Повторы убраны. Все 51 ссылка на документы проверены; переменные, эндпоинты и число тестов сверены с кодом. Код не менялся. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
33 lines
3.5 KiB
Markdown
33 lines
3.5 KiB
Markdown
# План: 024 — оптимизация README по образцу ipam_control
|
||
|
||
## Context
|
||
README вырос за 23 изменения: длинные абзацы, повторы (требования к секретам — в трёх разделах, генерация ключей — в двух),
|
||
история изменений — список с длинными описаниями без ссылок на документы, нет раздела об отчётах ревью, эксплуатационные сведения
|
||
(том, миграции, один процесс, WAL) разбросаны. Пользователь просит переверстать README по образцу `/opt/lvraid/claude/ipam_control/README.md`.
|
||
|
||
## Изменения (только `README.md`)
|
||
Структура образца:
|
||
1. Заголовок и абзац о проекте (+ схема компонентов).
|
||
2. **Быстрый старт** — команды и адреса UI/OpenAPI, вход.
|
||
3. **Конфигурация (`.env`)** — одна таблица «Переменная | По умолчанию | Назначение», требования к секретам — только здесь и в «Безопасности».
|
||
4. **Архитектура** — таблица слоёв и дерево каталогов.
|
||
5. **Функциональность и правила** — полужирные подзаголовки: устройства, состояния «Upgrade ROS», группы и фильтры, операции и задачи,
|
||
бэкапы, откат ROS, идентификаторы, журнал событий.
|
||
6. **Требования к устройствам**.
|
||
7. **API (`/api/v1`)** — таблица по областям + «Соглашения».
|
||
8. **Безопасность** — секреты, вход, cookie, шифрование, секреты в бэкапах.
|
||
9. **Эксплуатация** — контейнер и том, миграции, один процесс, кэш бакета, копирование БД в режиме WAL (замечание 13 повторного ревью — только документация), текущий стенд на порту 8001.
|
||
10. **Интерфейс** — короткий список.
|
||
11. **Тесты** — команда и число тестов.
|
||
12. **История изменений** — таблица «№ | Изменение | Документы» со ссылками на `plan.md`/`summary.md` (001–024).
|
||
13. **Отчёты ревью** — ссылки на `docs/reviews/` с указанием, в какие изменения они вылились.
|
||
|
||
Содержание не теряется: каждое утверждение текущего README переносится в свой раздел (сверка списком фактов при ревью).
|
||
|
||
## Исполнение
|
||
Только документация — оркестратор сам (навык change-flow: документация без исполнителя). Код не меняется, стенд не пересобирается.
|
||
|
||
## Проверка
|
||
- Все ссылки на `docs/changes/*/plan.md|summary.md` и `docs/reviews/*.md` указывают на существующие файлы (скрипт).
|
||
- Сверка фактов: переменные `.env` из `app/config.py`, эндпоинты из `app/api/v1.py`, число тестов из `pytest --collect-only`.
|