architect/standards/functions/FUNCTIONS.md

Атомарные функции платформы

Версия: 1.0.0
Дата: 2025-11-28
Уровень: У1 (Правила)

Вытекает из: ../../concept/PLATFORM.md

НАЗНАЧЕНИЕ

Полный реестр атомарных функций с привязкой к ролям.
Одна функция = одна роль = нет дублирования.

ПРИНЦИП

АТОМАРНАЯ ФУНКЦИЯ — минимальная неделимая операция.

Каждая функция принадлежит РОВНО ОДНОЙ роли.
Если функция дублируется — это ошибка архитектуры.

РЕЕСТР ФУНКЦИЙ ПО ВРЕМЕННЫМ СОСТОЯНИЯМ

DESIGN-TIME (Проектирование)

ID Функция Роль Примечание
D01 Разработка методологии Архитектор theory/, concept/
D02 Создание стандартов Архитектор standards/
D03 Создание паттернов Архитектор patterns/
D04 Определение миссии/границ Оператор Владелец
D05 Планирование фич Проектор Бизнес-проекты
D06 ROADMAP платформы Архитектор PLAT-XXX
D07 ROADMAP проекта Проектор {PROJ}-XXX
D08 Спецификация модуля Архитектор design/*.md
D09 Спецификация API Интегратор API внешних систем
D10 Дизайн БД Кодер schema, models

BUILD-TIME (Разработка)

ID Функция Роль Примечание
B01 Написание кода Кодер v1 Стандартный код
B02 AI-генерация (TEA) Кодер v2 По спецификации
B03 Написание тестов Кодер pytest
B04 Code review Архитектор На соответствие паттернам
B05 Документирование кода Кодер docstrings
B06 Создание миграций БД Кодер alembic
B07 Интеграция API Интегратор modules/api/
B08 Рефакторинг Реструктуризатор Структурные изменения

DEPLOY-TIME (Развёртывание)

ID Функция Роль Примечание
P01 Бэкап перед деплоем Инфра ОБЯЗАТЕЛЬНО!
P02 Остановка сервиса Инфра systemctl, docker
P03 Обновление кода Инфра git pull
P04 Применение миграций Инфра alembic upgrade
P05 Запуск сервиса Инфра systemctl, docker
P06 Проверка работы Инфра health check
P07 Откат при ошибке Инфра rollback
P08 Настройка Nginx Инфра reverse proxy, SSL
P09 Настройка Docker Инфра containers

RUN-TIME (Выполнение)

ID Функция Роль Примечание
R01 Мониторинг Инфра logs, metrics
R02 Синхронизация Ozon Интегратор API Ozon
R03 Синхронизация 1C Интегратор API 1C
R04 Обработка заказов Интегратор Маркетплейсы
R05 Отправка уведомлений Интегратор Email, Telegram
R06 Работа с БД Кодер queries, ORM

MAINTENANCE-TIME (Обслуживание)

ID Функция Роль Примечание
M01 Создание бэкапов Инфра pg_dump, rclone
M02 Очистка логов Инфра logrotate
M03 Обновление зависимостей Кодер pip, npm
M04 Ротация секретов Инфра .env, passwords
M05 Аудит структуры Архитектор validate
M06 Аудит безопасности Инфра security scan
M07 Оптимизация БД Инфра vacuum, reindex

INCIDENT-TIME (Инцидент)

ID Функция Роль Примечание
I01 Диагностика сервера Инфра logs, status
I02 Диагностика кода Кодер debug, trace
I03 Откат версии Инфра git checkout, restore
I04 Восстановление из бэкапа Инфра pg_restore
I05 Горячий фикс Кодер hotfix branch
I06 Post-mortem Архитектор Анализ причин
I07 Создание превентивных мер Архитектор Обновление процессов

РЕЕСТР ФУНКЦИЙ ПО СКВОЗНЫМ АСПЕКТАМ

Безопасность

ID Функция Роль
S01 Управление доступом Инфра
S02 Шифрование данных Инфра
S03 Аудит действий Инфра
S04 Политики безопасности Архитектор

Наблюдаемость

ID Функция Роль
O01 Логирование Инфра
O02 Метрики Инфра
O03 Алертинг Инфра
O04 Трейсинг Инфра

Надёжность

ID Функция Роль
L01 Резервное копирование Инфра
L02 Восстановление Инфра
L03 Отказоустойчивость Архитектор
L04 Масштабирование Инфра

Качество

ID Функция Роль
Q01 Тестирование Кодер
Q02 Линтинг Кодер
Q03 Code review Архитектор
Q04 Документация Кодер

МАТРИЦА ФУНКЦИЙ ПО РОЛЯМ

Терминал (~400 токенов)

ФУНКЦИИ:
- Приём команд от оператора
- Маршрутизация к нужной роли
- Вывод результатов
- Меню навигации

НЕ ДЕЛАЕТ:
- Не выполняет сам — делегирует

Архитектор (~500 токенов)

ФУНКЦИИ:
- Методология (D01, D02, D03)
- ROADMAP платформы (D06)
- Спецификации (D08)
- Code review (B04)
- Аудит структуры (M05)
- Post-mortem (I06, I07)
- Политики безопасности (S04)
- Отказоустойчивость (L03)
- Code review (Q03)

НЕ ДЕЛАЕТ:
- Не пишет код приложений
- Не деплоит
- Не управляет бизнес-проектами

Проектор (~400 токенов)

ФУНКЦИИ:
- Планирование фич (D05)
- ROADMAP проекта (D07)
- Тикеты {PROJ}-XXX
- Статусы задач
- Сроки и приоритеты

НЕ ДЕЛАЕТ:
- Не пишет код
- Не деплоит
- Не меняет методологию

Кодер v1 (~400 токенов)

ФУНКЦИИ:
- Написание кода (B01)
- Тесты (B03)
- Документирование (B05)
- Миграции (B06)
- Обновление зависимостей (M03)
- Диагностика кода (I02)
- Горячий фикс (I05)
- Линтинг (Q02)

НЕ ДЕЛАЕТ:
- Не деплоит
- Не управляет проектами

Кодер v2 (~500 токенов)

ФУНКЦИИ:
- AI-генерация по TEA (B02)
- Трансформация данных

НЕ ДЕЛАЕТ:
- Не генерирует без TEA-спецификации

Инфра (~500 токенов)

ФУНКЦИИ:
- Бэкапы (P01, M01, L01)
- Деплой (P02-P07)
- Настройка (P08, P09)
- Мониторинг (R01, O01-O04)
- Обслуживание (M02, M04, M06, M07)
- Восстановление (I01, I03, I04, L02)
- Безопасность (S01-S03)
- Масштабирование (L04)

НЕ ДЕЛАЕТ:
- Не пишет код приложений
- Деплоит ТОЛЬКО с бэкапом!

Интегратор (~600 токенов)

ФУНКЦИИ:
- Спецификация API (D09)
- Интеграция (B07)
- Синхронизация (R02-R05)
- Работа с внешними системами

НЕ ДЕЛАЕТ:
- Не пишет бизнес-логику

Реструктуризатор (~400 токенов)

ФУНКЦИИ:
- Рефакторинг (B08)
- Миграции структуры
- Архивация старых версий
- Обновление индексов

НЕ ДЕЛАЕТ:
- Не пишет новый код
- Не меняет бизнес-логику

ПРОВЕРКА ДУБЛИРОВАНИЯ

Функция Может показаться дублем Почему НЕ дубль
Code review Кодер? Архитектор проверяет на паттерны
Миграции Реструктуризатор? Кодер — БД, Реструктуризатор — структура
Документация Архитектор? Кодер — код, Архитектор — методология
Диагностика Кодер + Инфра Разные уровни: код vs инфра

ПРАВИЛА

МОЖНО

НЕЛЬЗЯ

ОБЯЗАТЕЛЬНО

Версия: 1.0.0