PLATFORM.md

Версия: 1.0.0
Дата: 2025-11-26
Статус: Концепция

1. ЧТО ЭТО

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ПЛАТФОРМА — система для управления проектами и разработки продуктов.        ║
║                                                                               ║
║   Первый проект платформы — сама платформа (bootstrap).                       ║
║   Основной фокус — IT-проекты.                                                ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

2. ЗАЧЕМ (Цель)

3. СТРУКТУРА

3.1 Иерархия уровней

Проблема	Решение
Проекты ведутся хаотично	Единая методология
Знания теряются	База знаний (Wiki)
Код не переиспользуется	Компоненты
AI используется случайно	AI-агенты как часть системы
Нет прозрачности	Статусы и метрики

УРОВЕНЬ -1: ТЕОРИЯ
│
│   Универсальные законы систем
│   architect/theory/
│
▼
УРОВЕНЬ 0: КОНЦЕПЦИЯ
│
│   Описание платформы (этот документ)
│   architect/concept/
│
▼
УРОВЕНЬ 1: ПЛАТФОРМА
│
│   Агенты + Стандарты + Шаблоны
│   system/ + platform/
│
▼
УРОВЕНЬ 2: ПРОЕКТЫ
│
│   Конкретные реализации
│   projects/
│
▼
УРОВЕНЬ 3: КОМПОНЕНТЫ + ИНТЕГРАЦИИ
│
│   Переиспользуемый код + Внешние API

3.2 Структура файлов

/opt/claude-workspace/
│
├── CLAUDE.md                 ← Точка входа
├── start-menu.md             ← Меню навигации
│
├── architect/                ← ЗНАНИЯ
│   ├── theory/               ← Теория систем
│   └── concept/              ← Концепция (этот уровень)
│
├── system/                   ← АГЕНТЫ
│   ├── menu.ai.md
│   ├── terminal.ai.md
│   ├── architect.ai.md
│   ├── projector.ai.md
│   ├── coder-v1.ai.md
│   ├── coder-v2.ai.md        ← ЦИФРА
│   ├── integrator.ai.md
│   └── infra.ai.md
│
├── platform/                 ← ИНСТРУМЕНТЫ
│   ├── standards/            ← Стандарты
│   ├── templates/            ← Шаблоны
│   └── procedures/           ← Процедуры
│
├── projects/                 ← ПРОЕКТЫ
│   └── {name}/
│
├── data/                     ← ДАННЫЕ
│   └── pim/                  ← Прайсы, файлы
│
└── infra/                    ← ИНФРАСТРУКТУРА
    └── {name}/

4. АГЕНТЫ (8 штук)

4.1 Схема

ОПЕРАТОР
     │
     ▼
┌─────────┐
│  МЕНЮ   │ ← Навигация
└────┬────┘
     │
     ▼
┌──────────┐
│ ТЕРМИНАЛ │ ← Общение
└────┬─────┘
     │
     ├────────┬────────┬────────┬────────┬────────┬────────┐
     │        │        │        │        │        │        │
     ▼        ▼        ▼        ▼        ▼        ▼        ▼
┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐
│АРХИТЕКТ││ПРОЕКТОР││КОДЕР 1 ││КОДЕР 2 ││ИНТЕГРАТ││ ИНФРА  │
│        ││        ││        ││(ЦИФРА) ││        ││        │
└────────┘└────────┘└────────┘└────────┘└────────┘└────────┘

4.2 Роли

4.3 Что делает каждый

#	Агент	Файл	Роль
1	МЕНЮ	menu.ai.md	Навигация, выбор действий
2	ТЕРМИНАЛ	terminal.ai.md	Общение с оператором
3	АРХИТЕКТОР	architect.ai.md	Платформа, стандарты, агенты
4	ПРОЕКТОР	projector.ai.md	Управление проектами, задачи
5	КОДЕР 1	coder-v1.ai.md	Стандартные приложения
6	КОДЕР 2	coder-v2.ai.md	ЦИФРА — AI-генерация кода
7	ИНТЕГРАТОР	integrator.ai.md	Внешние API
8	ИНФРА	infra.ai.md	Серверы, деплой

МЕНЮ
├── Показывает экраны навигации
├── Даёт выбор действий
└── Направляет в нужный контекст

ТЕРМИНАЛ
├── Принимает команды оператора
├── Понимает контекст
├── Направляет к агентам
└── Форматирует ответы

АРХИТЕКТОР
├── Развивает платформу
├── Пишет стандарты
├── Создаёт агентов
└── НЕ трогает проекты

ПРОЕКТОР
├── Ведёт проекты
├── Управляет задачами
├── Отслеживает статусы
└── Планирует работы

КОДЕР 1 (стандартный)
├── Пишет код приложений
├── Знает фреймворки (Streamlit, Drupal, etc.)
├── Работает по ТЗ от проектора
└── Создаёт компоненты

КОДЕР 2 (ЦИФРА)
├── Генерирует код по описанию
├── Понимает бизнес-логику
├── Создаёт из концепции
└── AI-powered разработка

ИНТЕГРАТОР
├── Настраивает внешние API
├── Ozon, доставка, платежи
├── MCP серверы
└── Управляет подключениями

ИНФРА
├── Управляет серверами
├── Деплой приложений
├── Настройка окружений
└── Мониторинг

5. ПРОЦЕСС РАБОТЫ

5.1 Три этапа автоматизации

ЭТАП 1: ВРУЧНУЮ
│   Человек делает, AI помогает
│
▼
ЭТАП 2: ПОЛУАВТОМАТИЧЕСКИ
│   Человек запускает, AI делает, человек проверяет
│
▼
ЭТАП 3: АВТОМАТИЧЕСКИ
    AI делает сам, человек контролирует

5.2 Три шага на каждом модуле

ШАГ 1: КОНЦЕПЦИЯ + СТАНДАРТЫ
│   Зачем? Какие правила?
│
▼
ШАГ 2: ОПИСАНИЕ
│   8 вопросов, структура, процессы
│
▼
ШАГ 3: РЕАЛИЗАЦИЯ
    Код / AI / Софт / Вместе

6. ДОМЕНЫ (области)

ПЛАТФОРМА
│
├── IT-ПРОЕКТЫ (первичный фокус)
│   ├── Разработка ПО
│   ├── Инфраструктура
│   └── Интеграции
│
├── ПРОДАЖИ
│   ├── Маркетплейсы (Ozon)
│   ├── Заказы
│   └── Клиенты
│
├── ДАННЫЕ
│   ├── PIM (каталог товаров)
│   ├── Прайсы
│   └── 1С интеграция
│
└── ... (расширяется)

Проект	Домен	Статус
Платформа	IT	В разработке
Marketplace	IT + Продажи	Активен
PIM-Drupal	IT + Данные	Активен
Pirotehnika	IT	Поддержка

Метрика	Цель
Проектов в системе	>5 активных
Время старта проекта	<1 день
Переиспользование компонентов	>50%
Документация	100% проектов описаны
Автоматизация	Этап 2 к концу года

PLATFORM: Концепция платформы