From 12d6983a493970fc599a0ecc7c4456405cbb98bc Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 13:34:42 +0300 Subject: [PATCH] =?UTF-8?q?[K-09]=20=D0=9F=D1=80=D0=B0=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=BE:=20=D0=B2=D1=81=D1=91=20=D0=B2=20Gitea=20=D1=81=D0=BE=20?= =?UTF-8?q?=D1=81=D1=82=D0=B0=D1=82=D1=83=D1=81=D0=B0=D0=BC=D0=B8;=20?= =?UTF-8?q?=D1=82=D1=80=D0=B5=D0=BA=D0=B5=D1=80,=20=D0=BF=D1=80=D0=BE?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=D0=BA=D0=B0=20ID,=20=D0=BE=D0=B1=D1=91=D1=80?= =?UTF-8?q?=D1=82=D0=BA=D0=B0=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B8=D1=82=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/PROJECT-RULES.md | 80 +++++++++++++++++++++++++++++ ops/STATUS.md | 62 ++++++++++++++++++++++ ops/tools/status.py | 120 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 262 insertions(+) create mode 100644 ops/PROJECT-RULES.md create mode 100644 ops/STATUS.md create mode 100644 ops/tools/status.py diff --git a/ops/PROJECT-RULES.md b/ops/PROJECT-RULES.md new file mode 100644 index 0000000..c726685 --- /dev/null +++ b/ops/PROJECT-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/ops/STATUS.md b/ops/STATUS.md new file mode 100644 index 0000000..25ddc39 --- /dev/null +++ b/ops/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 | diff --git a/ops/tools/status.py b/ops/tools/status.py new file mode 100644 index 0000000..9a7d384 --- /dev/null +++ b/ops/tools/status.py @@ -0,0 +1,120 @@ +#!/usr/bin/env python3 +"""Управление статусами проекта в ops/STATUS.md. + + status.py list — показать статусы + status.py check — проверить, что ID существует + status.py set <статус> — сменить статус (✅ 🔄 ⏳ ⛔) + status.py add <раздел> <задача> <приоритет> +""" +import re +import sys + +STATUS = "/root/buryan-infra/ops/STATUS.md" +ICONS = {"done": "✅", "wip": "🔄", "todo": "⏳", "blocked": "⛔"} + + +def read(): + try: + return open(STATUS, encoding="utf-8").read() + except Exception: + return "" + + +def write(text): + open(STATUS, "w", encoding="utf-8").write(text) + + +def rows(text): + """Все строки таблиц с ID вида X-01.""" + out = [] + for line in text.splitlines(): + if re.match(r"^\|\s*[A-Z]+-\d+\s*\|", line): + out.append(line) + return out + + +def has_id(text, ident): + return re.search(rf"\|\s*{re.escape(ident)}\s*\|", text) is not None + + +def cmd_check(ident): + text = read() + if has_id(text, ident): + print(f"ok: {ident} найден") + return 0 + print(f"ОШИБКА: {ident} нет в ops/STATUS.md — сначала добавьте задачу") + return 1 + + +def cmd_list(): + text = read() + for line in rows(text): + print(line.strip()) + + +def cmd_set(ident, state): + icon = ICONS.get(state.lower(), state) + text = read() + lines = text.splitlines() + changed = False + for i, line in enumerate(lines): + if re.match(rf"^\|\s*{re.escape(ident)}\s*\|", line): + parts = line.split("|") + # статус — третья колонка (индекс 3 для | # | задача | статус |) + if len(parts) > 4: + parts[3] = f" {icon} " + lines[i] = "|".join(parts) + changed = True + break + if not changed: + print(f"не найдено: {ident}") + return 1 + write("\n".join(lines) + "\n") + print(f"{ident} → {icon}") + return 0 + + +def cmd_add(ident, section, task, prio="средний"): + text = read() + if has_id(text, ident): + print("уже есть") + return 0 + marker = f"## {section}" + if marker not in text: + text = text.rstrip() + f"\n\n{marker}\n\n| # | Задача | Статус | Приоритет |\n|---|---|---|---|\n" + new_row = f"| {ident} | {task} | ⏳ | {prio} |" + lines = text.splitlines() + insert_at = None + in_section = False + for i, line in enumerate(lines): + if line.strip() == marker: + in_section = True + continue + if in_section: + if line.startswith("## "): + insert_at = i + break + if line.startswith("|") and not line.startswith("|---") and "Задача" not in line: + insert_at = i + 1 + if insert_at is None: + insert_at = len(lines) + lines.insert(insert_at, new_row) + write("\n".join(lines) + "\n") + print(f"добавлено: {new_row}") + return 0 + + +if __name__ == "__main__": + if len(sys.argv) < 2: + cmd_list() + elif sys.argv[1] == "list": + cmd_list() + elif sys.argv[1] == "check" and len(sys.argv) > 2: + sys.exit(cmd_check(sys.argv[2])) + elif sys.argv[1] == "set" and len(sys.argv) > 3: + sys.exit(cmd_set(sys.argv[2], sys.argv[3])) + elif sys.argv[1] == "add" and len(sys.argv) > 4: + sys.exit(cmd_add(sys.argv[2], sys.argv[3], sys.argv[4], + sys.argv[5] if len(sys.argv) > 5 else "средний")) + else: + print(__doc__)