type: standard
aspect: process
title: "Платформа — Архитектура, Проекты и Процессы"
status: active
version: 0.2.0
date: 2026-04-10
owner: architect
knowledge_level: У1
Стандарт описывает архитектуру платформы, виды проектов, процессы и модули исполнения.
Проект — ограниченное усилие с целью, результатом и сроками.
ПРОЕКТ = ЦЕЛЬ + РЕЗУЛЬТАТ + РЕСУРСЫ + ВРЕМЯ
Проект всегда:
- Имеет начало и конец
- Производит артефакт (продукт, сервис, знание)
- Ведётся командой модулей
- Документируется по фазам
| Понятие | Что | Форма |
|---|---|---|
| Компонент | Раздел платформы верхнего уровня | Обычная папка |
| Модуль | Автономная функциональная единица | @name.type/ |
| Агент | Определение роли и правил | {name}.ai.md файл |
| AI.md | Служебный контекст папки для AI | Навигация для AI |
| CLAUDE.md | Навигатор папки для Claude Code | Навигация для CLI |
Модуль = контейнер (пассивный, хранит)
Агент = исполнитель (активный, Claude Code читает {name}.ai.md и берёт роль)
| Суффикс | Где | Что |
|---|---|---|
.module |
project/ |
процессный модуль (управление) |
.domain |
domains/ |
диспетчер домена исполнения |
.coder |
domains/@it.domain/ |
IT стек |
.maker |
domains/@production.domain/ |
производственная специализация |
.flow |
domains/@business.domain/ |
бизнес-процессная специализация |
.data |
domains/@data.domain/ |
специализация данных |
.service |
services/ |
платформенный сервис |
.connector |
system/connectors/ |
интеграция с внешней системой |
Платформа состоит из шести слоёв. Каждый отвечает на один вопрос:
arch/ ← ЧТО МЫ ЗНАЕМ? стандарты, методология
project/ ← КАК МЫ УПРАВЛЯЕМ? процессы, фазы, документы
domains/ ← ЧТО МЫ СТРОИМ? IT / производство / бизнес / данные
infra/ ← ГДЕ ЭТО РАБОТАЕТ? серверы, деплой, поддержка
system/ ← ЧЕМ МЫ РАБОТАЕМ? общие библиотеки, коннекторы, MCP
services/ ← КТО ОБСЛУЖИВАЕТ? планировщик, мониторинг
ПЛАТФОРМА/
│
├── arch/ ← СЛОЙ 1: ЗНАНИЯ
│ ├── architect.ai.md ← агент архитектора
│ ├── AI.md
│ ├── theory/ — теория (LOCKED)
│ ├── concept/ — концепция платформы
│ ├── standards/ — стандарты для всех слоёв
│ ├── patterns/ — паттерны решений
│ ├── decisions/ — ADR
│ └── templates/ — шаблоны документов
│
├── project/ ← СЛОЙ 2: УПРАВЛЕНИЕ
│ ├── @projector.module/ — проектирование (фазы 0–6)
│ │ ├── projector.ai.md
│ │ └── AI.md
│ ├── @manager.module/ — управление (фазы 7–15)
│ │ ├── manager.ai.md
│ │ └── AI.md
│ ├── @tester.module/ — тестирование результата
│ │ ├── tester.ai.md
│ │ └── AI.md
│ ├── org/ — клиентские проекты
│ │ ├── it/ ← IT проекты ✅
│ │ ├── production/ ← производство ⏸
│ │ ├── business/ ← бизнес-процессы ⏸
│ │ └── data/ ← данные ⏸
│ └── sys/ — системные проекты платформы
│
├── domains/ ← СЛОЙ 3: ИСПОЛНЕНИЕ
│ ├── @it.domain/ ← ДОМЕН: IT ✅ текущий
│ │ ├── it.ai.md ← агент-диспетчер домена
│ │ ├── AI.md
│ │ ├── @drupal.coder/ — стек Drupal
│ │ │ ├── drupal.ai.md
│ │ │ ├── AI.md
│ │ │ ├── library/
│ │ │ ├── references/
│ │ │ ├── instructions/
│ │ │ ├── practices/
│ │ │ └── exceptions/
│ │ ├── @react.coder/ — стек React
│ │ ├── @python.coder/ — стек Python
│ │ └── @{стек}.coder/ ↑ расширяется новыми стеками
│ │
│ ├── @production.domain/ ← ДОМЕН: Производство ⏸
│ │ ├── @design.maker/ — проектирование изделий
│ │ ├── @supply.maker/ — материалы, снабжение
│ │ ├── @assembly.maker/ — сборка
│ │ └── @quality.maker/ — контроль качества
│ │
│ ├── @business.domain/ ← ДОМЕН: Бизнес-процессы ⏸
│ │ ├── @crm.flow/
│ │ ├── @erp.flow/
│ │ └── @compliance.flow/
│ │
│ └── @data.domain/ ← ДОМЕН: Данные ⏸
│ ├── @pipeline.data/
│ ├── @model.data/
│ └── @dashboard.data/
│
├── infra/ ← СЛОЙ 4: ИНФРАСТРУКТУРА
│ ├── @executor.module/ — деплой
│ │ ├── executor.ai.md
│ │ └── AI.md
│ ├── @support.module/ — поддержка после релиза
│ │ ├── support.ai.md
│ │ └── AI.md
│ └── servers/ — конфиги серверов
│
├── system/ ← СЛОЙ 5: ОБЩЕЕ
│ ├── library/ — общий код, утилиты
│ ├── data/ — общие данные
│ ├── @mcp.service/ — MCP серверы для Claude
│ └── connectors/ — внешние интеграции
│ ├── @ozon.connector/
│ ├── @telegram.connector/
│ └── @{новый}.connector/ ↑ расширяется
│
└── services/ ← СЛОЙ 6: СЕРВИСЫ ОБСЛУЖИВАНИЯ
├── @scheduler.service/ — планировщик задач
└── @monitor.service/ — мониторинг платформы
| Добавить | Куда | Как |
|---|---|---|
| Новый IT стек | domains/@it.domain/ |
новый @стек.coder/ |
| Новый домен | domains/ |
новый @домен.domain/ + project/org/домен/ |
| Новый коннектор | system/connectors/ |
новый @имя.connector/ |
| Новый сервис | services/ |
новый @имя.service/ |
Три версии платформы. Ключевое изменение — роль исполнения кода:
v1 (было) v2 (строим) v3 (будущее)
────────────── ────────────────── ──────────────────
Claude Code @it.domain агент — Только конфиг-файлы
пишет напрямую диспетчер стеков для модулей платформы
без специализации → открывает @стек.coder/ Код не пишется
→ работает по правилам "Проект Цифра"
Каждый @стек.coder/ — полная база знаний по технологии:
@drupal.coder/
drupal.ai.md ← агент стека
library/ ← готовые модули, сниппеты
references/ ← справочники (API, хуки, схемы)
instructions/ ← как строить типовые вещи
practices/ ← лучшие практики
exceptions/ ← edge cases, известные проблемы
⏸ Кодер v3 и "Проект Цифра" — отдельное обсуждение.
| Вид | Путь | Заказчик | Результат |
|---|---|---|---|
| Системный | project/sys/ |
Архитектор | Улучшение платформы |
| Клиентский | project/org/ |
Оператор / клиент | Продукт клиента |
| Домен | Путь | Статус |
|---|---|---|
| IT | project/org/it/ |
✅ Текущий |
| Производство | project/org/production/ |
⏸ Будущий |
| Бизнес-процессы | project/org/business/ |
⏸ Будущий |
| Данные | project/org/data/ |
⏸ Будущий |
| Тип | Суть |
|---|---|
| Сайт | Публичный веб-ресурс |
| Веб-приложение | SaaS, личный кабинет, портал |
| Интеграция | Связь систем через API |
| Телеграм-бот | Автоматизация через мессенджер |
| Данные / ETL | Сбор, обработка, хранение данных |
| E-commerce | Интернет-магазин, каталог, PIM |
| Автоматизация | Бизнес-процессы, роботы |
| AI-агент | Автономный AI-процесс |
Применяются к любому проекту независимо от домена:
ИНИЦИАЦИЯ → ПЛАНИРОВАНИЕ → ИСПОЛНЕНИЕ → КОНТРОЛЬ → ЗАКРЫТИЕ
| Процесс | Что происходит | Документы |
|---|---|---|
| Инициация | Цель, границы, команда | КОНЦЕПЦИЯ, БРИФ |
| Планирование | Решение и план работ | ПЛАН, СПЕЦИФИКАЦИЯ |
| Исполнение | Создать продукт | РЕАЛИЗАЦИЯ, ТИКЕТ |
| Контроль | Проверить качество | АНАЛИЗ, ТИКЕТ |
| Закрытие | Сдать, зафиксировать опыт | ПРАКТИКА, ИНСТРУКЦИЯ |
@projector → @manager → @it.domain → @tester → @executor → @support
↑____________|
(фикс багов)
Цель: понять задачу и спроектировать решение.
| Фаза | Название | Документ | Тип |
|---|---|---|---|
| 0 | ТРИГГЕР | — | — |
| 0.5 | INTAKE | brief.md | КОНЦЕПЦИЯ |
| 1 | ПОНИМАНИЕ | brief-detail.md | КОНЦЕПЦИЯ |
| 2 | ИССЛЕДОВАНИЕ | research.md | ИССЛЕДОВАНИЕ |
| 3 | АНАЛИЗ | analysis.md | АНАЛИЗ |
| 4 | ТРЕБОВАНИЯ | requirements.md | СТАНДАРТ |
| 5 | СПЕЦИФИКАЦИЯ | spec.md | ИНСТРУКЦИЯ |
| 6 | ПЛАН | plan.md | ПЛАН |
Цель: обеспечить исполнение и сдачу результата.
| Фаза | Название | Документ | Тип |
|---|---|---|---|
| 7–12 | РАЗРАБОТКА | TICKET-NNN.md | ТИКЕТ |
| 13 | ТЕСТИРОВАНИЕ | test-report.md | АНАЛИЗ |
| 14 | ДЕПЛОЙ | deploy.md | ИНСТРУКЦИЯ |
| 15 | ЭКСПЛУАТАЦИЯ | lessons-learned.md | ПРАКТИКА |
ЦЕЛЬ: публичный веб-ресурс с контентом
ФАЗЫ: Дизайн → Вёрстка → CMS → Контент → SEO → Деплой
ДОКУМЕНТЫ: brief.md, design.md, content-plan.md, seo.md, deploy.md
СТЕК: @drupal.coder / @react.coder
ЦЕЛЬ: SaaS / личный кабинет / портал
ФАЗЫ: Архитектура → API → Backend → Frontend → Auth → Деплой
ДОКУМЕНТЫ: architecture.md, api.md, auth.md, deploy.md
СТЕК: @python.coder / @react.coder / @nodejs.coder
ЦЕЛЬ: связать системы через API
ФАЗЫ: Анализ API → Маппинг → Коннектор → Тест → Мониторинг
ДОКУМЕНТЫ: api-analysis.md, data-mapping.md, connector.md
СТЕК: @python.coder / @nodejs.coder
ЦЕЛЬ: автоматизация через Telegram
ФАЗЫ: Сценарии → Bot API → Логика → Интеграции → Деплой
ДОКУМЕНТЫ: scenarios.md, commands.md, deploy.md
СТЕК: @python.coder
ЦЕЛЬ: сбор, обработка, хранение данных
ФАЗЫ: Источники → Схема → Пайплайн → Хранилище → Дашборд
ДОКУМЕНТЫ: data-sources.md, schema.md, pipeline.md, dashboard.md
СТЕК: @python.coder / @data.domain
ЦЕЛЬ: интернет-магазин с каталогом, оплатой, доставкой
ФАЗЫ: Каталог → PIM → Корзина → Оплата → Доставка → SEO → Деплой
ДОКУМЕНТЫ: catalog.md, pim.md, payment.md, delivery.md
СТЕК: @drupal.coder
ЦЕЛЬ: автоматизировать бизнес-процесс
ФАЗЫ: As-is → Требования → Регламент → Скрипт → Тест → Мониторинг
ДОКУМЕНТЫ: process-asis.md, process-tobe.md, script.md
СТЕК: @python.coder / @nodejs.coder
ЦЕЛЬ: автономный AI-процесс с ролью и протоколами
ФАЗЫ: Роль → Протоколы → Инструменты → Тест → Деплой → Мониторинг
ДОКУМЕНТЫ: {name}.ai.md, AI.md, protocols.md, test-cases.md
СТЕК: domains/@it.domain