av
dff05ad097
- каталог скилла и все вызовы переименованы: префикс `doc-` называл материал, а скилл занят формой — раскладкой всех частей проекта и общим повышением версии, включая каталог задач; - README перестроен: `canon` вынесен из семейства документов отдельным блоком и отдельным узлом графа, правило префиксов переформулировано, у документов уточнено владение — содержимым, а не раскладкой; - заведена запись 2 журнала версий: в проекте ничего не переехало, но путь к `docs.py` и имя вызова живут в гейте и в `CLAUDE.md` проекта и сломаются молча; - прежние адреса в записи 1 и в журнале решений оставлены как есть: журнал описывает состояния, которые были, и задним числом не переписывается.
34 lines
3.0 KiB
Markdown
34 lines
3.0 KiB
Markdown
# Сопровождение и эксплуатация
|
|
|
|
**Это дом.** Словарь «чем держат проект» назван в трёх местах трёх разных
|
|
скиллов: секция `Сопровождение` в роадмапе (`task-track`), раздел «Эксплуатация»
|
|
в `architecture.md` (`canon`) и тема ревью `operations` (`code-review`). Ни
|
|
один из трёх им не владеет, поэтому дом стоит в `shared/`.
|
|
|
|
Три перечня «чем держат проект» уже разъезжались — на «метриках и логах» против
|
|
«мониторинга», — и разъехались молча. Пока скиллы жили тремя плагинами, отсюда
|
|
уезжали дословные копии: путь в чужое дерево не разрешался. Теперь дерево одно —
|
|
кому словарь нужен, тот открывает **этот файл**, и сверять машиной больше нечего.
|
|
|
|
Одна тема живёт в трёх местах, и путать их слова нельзя.
|
|
|
|
**Сопровождение** — всё, чем держат проект: инструмент и сборка, процесс,
|
|
выкладка, метрики и логи, инфраструктура, дежурство. **Эксплуатация** — его
|
|
часть: работа системы на проде. Целое и часть, и никогда наоборот.
|
|
|
|
| Место | Уровень | Что там |
|
|
| --- | --- | --- |
|
|
| `ROADMAP.md`, секция `Сопровождение` | план | **работы**, которые собираемся делать: цели и их задачи |
|
|
| `architecture.md`, раздел «Эксплуатация» | состояние | **как устроено сейчас**: где работает, что рядом, кто перезапускает |
|
|
| тема ревью `operations` | оптика | **чем проверяем**: «это упало через неделю на проде» |
|
|
|
|
Слово **«поддержка» не употребляется вовсе** — в нём слышится помощь
|
|
пользователю, а это другая работа.
|
|
|
|
**Граница с возможностями проходит по тому, кто наблюдает.** «Приложение
|
|
сообщает о своём состоянии» — возможность приложения, её место среди прочих
|
|
целей: наблюдает пользователь сервиса. «Дежурный видит состояние на одном
|
|
экране» — сопровождение: наблюдаем мы. Одни и те же метрики попадают в разные
|
|
секции роадмапа, и это верно — секции отвечают на разные вопросы.
|
|
|