[K-09] Правило: всё в Gitea со статусами; трекер, проверка ID, обёртка коммита
This commit is contained in:
1 parent
d47a8c5bba
commit
12d6983a49
3 files changed
+262
No files matched your search
@@ -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 <ID> "сообщение"
|
||||
```
|
||||
|
||||
Скрипт:
|
||||
1. проверяет, что ID есть в `STATUS.md`;
|
||||
2. требует, чтобы `STATUS.md` был обновлён (или явно `--no-status`);
|
||||
3. делает коммит с префиксом `[ID]`;
|
||||
4. пушит в Gitea.
|
||||
@@ -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 |
|
||||
@@ -0,0 +1,120 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Управление статусами проекта в ops/STATUS.md.
|
||||
|
||||
status.py list — показать статусы
|
||||
status.py check <ID> — проверить, что ID существует
|
||||
status.py set <ID> <статус> — сменить статус (✅ 🔄 ⏳ ⛔)
|
||||
status.py add <ID> <раздел> <задача> <приоритет>
|
||||
"""
|
||||
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__)
|
||||
Reference in new issue
Block a user