81 lines
2.9 KiB
Markdown
81 lines
2.9 KiB
Markdown
# Правила проекта
|
|
|
|
Обязательны для людей и агентов. Нарушение = работа не засчитана.
|
|
|
|
## Правило 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.
|