diff --git a/Rules.md b/Rules.md new file mode 100644 index 0000000..c726685 --- /dev/null +++ b/Rules.md @@ -0,0 +1,80 @@ +# Правила проекта + +Обязательны для людей и агентов. Нарушение = работа не засчитана. + +## Правило 1. Всё в Gitea + +Любое изменение — код, конфиг, документ, решение — попадает в Gitea. +Нет коммита — изменения не существует. + +| Что | Куда | +|---|---| +| Код и скрипты | `agent-qwen/buryan-infra` | +| Документация и знания | `infrastructure/buryan-wiki` | +| Статусы | `ops/STATUS.md` + страница Wiki `Status` | +| Решения | `ops/adr/` + страница `ADR` | + +## Правило 2. У каждого изменения есть статус + +Каждый коммит содержит идентификатор задачи из `ops/STATUS.md`: + +``` +[K-03] Бэкап конфигов CT-сервисов +``` + +Где префикс — раздел статуса: + +| Префикс | Раздел | +|---|---| +| `K-` | Скелет | +| `A-` | Агенты | +| `S-` | Сервисы и структура | +| `W-` | Работа (Presale) | +| `X-` | Инфраструктура и эксплуатация | + +Запрещено коммитить без идентификатора. Проверка: + +``` +python3 ops/tools/status.py check "K-03" +``` + +## Правило 3. Статус меняется вместе с работой + +| Статус | Значение | +|---|---| +| ⏳ | запланировано | +| 🔄 | в работе (начато) | +| ✅ | сделано и проверено | +| ⛔ | заблокировано (указать чем) | + +Нельзя поставить ✅ без артефакта: файл, сервис, страница, коммит. + +## Правило 4. Нет карточки — нет сервиса + +Новый сервис добавляется только вместе с: +- карточкой в `ops/services/cards/`, +- записью в `services.yaml`, +- бэкапом, +- мониторингом, +- строкой в `STATUS.md`. + +## Правило 5. Документация обновляется тем же коммитом + +Изменил поведение — обнови описание. Иначе Wiki врёт. + +## Правило 6. Агенты подчиняются политике + +Классы A/B/C/D из `ops/agents/policy.yaml`. Класс C — только с +подтверждением владельца. Журнал — обязателен. + +## Проверка перед пушем + +``` +/usr/local/bin/commit-with-status "сообщение" +``` + +Скрипт: +1. проверяет, что ID есть в `STATUS.md`; +2. требует, чтобы `STATUS.md` был обновлён (или явно `--no-status`); +3. делает коммит с префиксом `[ID]`; +4. пушит в Gitea. diff --git a/Status.md b/Status.md new file mode 100644 index 0000000..25ddc39 --- /dev/null +++ b/Status.md @@ -0,0 +1,62 @@ +# Статус проекта + +Источник истины по статусам. Страница Wiki `Status` — копия этого файла. +Правила ведения — `ops/PROJECT-RULES.md`. + +Легенда: ✅ сделано · 🔄 в работе · ⏳ запланировано · ⛔ заблокировано + +## K. Скелет (закрыт) + +| # | Задача | Статус | Артефакт | +|---|---|---|---| +| K-01 | Реестр сервисов | ✅ | `ops/registry/services.yaml` | +| K-02 | Сверка с Full-Audit | ✅ | аудит развития, раздел 12 | +| K-03 | Вики проекта | ✅ | `infrastructure/buryan-wiki` | +| K-04 | Статус-страница | ✅ | `hub-core /status` | +| K-05 | Карточки сервисов | ✅ | `ops/services/cards/` (83) | +| K-06 | Отчёт о дырах | ✅ | `ops/services/GAPS.md` | +| K-07 | Бэкап конфигураций | ✅ | `ops/backup/backup_configs.py` | +| K-08 | Дайджест «Что нового» | ✅ | 12:00 ежедневно | +| K-09 | Правила и статусы | ✅ | `ops/PROJECT-RULES.md` | + +## A. Агенты + +| # | Задача | Статус | Артефакт | +|---|---|---|---| +| A-01 | Политика A/B/C/D | ✅ | `ops/agents/policy.yaml` | +| A-02 | ТЗ шести агентов | ✅ | `ops/agents/agents/*.yaml` | +| A-03 | Раннер наблюдения | ✅ | `ops/agents/agent_runner.py` | +| A-04 | Мозг на DeepSeek | ✅ | `ops/agents/agent_brain.py` | +| A-05 | Заявки класса C | ✅ | `ops/agents/approvals.py` | +| A-06 | Исполнение одобренных | ✅ | `approvals.py approve` | +| A-07 | Бэкап конфигов CT-сервисов | 🔄 | `backup_configs.py` CT_TARGETS | +| A-08 | Граф зависимостей | ⏳ | Wiki `Graph` | +| A-09 | Уведомления с приоритетами | ⏳ | policy.yaml | + +## S. Сервисы и структура + +| # | Задача | Статус | Артефакт | +|---|---|---|---| +| S-01 | SSO: Home Assistant | ⏳ | — | +| S-02 | SSO: Gitea | ⏳ | — | +| S-03 | SSO: Prometheus | ⏳ | — | +| S-04 | Mosquitto — исключение | ⏳ | документ | +| S-05 | Мониторинг 7 сервисов | ⏳ | Kuma | +| S-06 | Ссылка на статус в карточках | ⏳ | cards | +| S-07 | Закрыть 39 сервисов без бэкапа | ⏳ | — | + +## X. Инфраструктура + +| # | Задача | Статус | Артефакт | +|---|---|---|---| +| X-01 | Тонкий пул 83% | ⏳ | — | +| X-02 | Родители `.63` | ⛔ | ждёт питания | +| X-03 | Frigate без камер | ⏳ | — | +| X-04 | Проверка восстановления | ⏳ | drill | + +## W. Работа (после сервисов) + +| # | Задача | Статус | Артефакт | +|---|---|---|---| +| W-01 | Presale Cockpit MVP | ⏳ | — | +| W-02 | Транскрипция встреч | ⏳ | Whisper |