Дистрибутив платформы — План

Дата: 2026-04-03
Статус: Составление

Концепция

Дистрибутив = всё что нужно чтобы развернуть платформу на чистом сервере.

Сервер = БАЗА + РОЛЬ [+ надстройки]

Главный:    БАЗА + МАТЬ  [+ ОТЕЦ] [+ СЫН]
Дочерний:   БАЗА + ДОЧКА [+ СЫН]

5 компонентов

БАЗА

Фундамент любого сервера. Ставится первой.

- ОС: пакеты, UFW, fail2ban
- Docker Engine + настройка логов
- Docker сети (proxy-net)
- WireGuard (ядро)

Откуда: system/install/base/ ✅ есть

МАТЬ

Главный сервер. Публичный вход в платформу.

- Nginx + Certbot (SSL, роутинг)          ← на dev-pro-eu: nginx ✅
- Authelia (SSO)                           ← на aipd.ru: Traefik+Authelia ✅
- Gitea (git-сервер)                       ← на aipd.ru ✅
- Uptime Kuma (мониторинг)                 ← на aipd.ru ✅
- Monitor бот (Telegram алерты)            ← на aipd.ru ✅
- Microsocks SOCKS5 → Anthropic            ← на dev-pro-eu ✅

Откуда: system/install/stacks/gateway.sh, git.sh, uptime.sh, monitor.sh ✅ есть

ОТЕЦ (Архитектор)

Интерактивная среда архитектора платформы.

- code-server (VS Code в браузере)         ← dev-pro-eu: code.0kt.ru ✅
- Claude Code (claude CLI)                 ← работает ✅
- claude-api (HTTP обёртка для claude)     ← dev-pro-eu ✅
- orchestrator-api                         ← dev-pro-eu ✅
- Воркспейс: /opt/claude-workspace (rw)

Откуда:
- infra/@claude-api.service/ ✅ есть
- projects/platform/claude-code-control-center/ ✅ есть
- code-server: устанавливается через apt

СЫН (Проектор)

Интерактивная среда для работы над конкретным проектом.

- code-server (отдельный инстанс или тот же)
- Claude Code
- chat-connector (чат-шлюз)               ← dev-pro-eu ✅
- Воркспейс: projects/org/{проект} (rw)

Откуда:
- library/services/chat-connector/ ✅ есть
- system/install/stacks/agents.sh ⚠️ устарел (смешан с Кодером)

ДОЧКА

Дочерний вычислительный узел.

- WireGuard client → Мать
- PostgreSQL + Redis (Executor)            ← опционально
- СЫН (proj-claude)                        ← опционально

Откуда: system/install/stacks/executor.sh ✅ есть

Воркспейс (отдельно от дистрибутива)

Воркспейс = "мозг" платформы. Хранится в git, клонируется при установке.

git clone git.aipd.ru/platform/workspace → /opt/claude-workspace

Содержит: CLAUDE.md, architect/, system/agents/, library/, projects/

Проблема первой установки: git.aipd.ru ещё нет.
Решение: зеркало на GitHub или bundle в дистрибутиве.

Что нужно сделать

Скопировать (уже готово):

• [ ] system/install/base/ → distr/base/
• [ ] system/install/lib/ → distr/lib/
• [ ] system/install/stacks/gateway.sh → distr/stacks/мать/
• [ ] system/install/stacks/git.sh → distr/stacks/мать/
• [ ] system/install/stacks/uptime.sh → distr/stacks/мать/
• [ ] system/install/stacks/monitor.sh → distr/stacks/мать/
• [ ] system/install/stacks/executor.sh → distr/stacks/дочка/
• [ ] infra/@claude-api.service/ → distr/stacks/отец/

Создать (нет или устарело):

• [ ] distr/install.sh — новая точка входа (БАЗА → роль → надстройки)
• [ ] distr/stacks/мать/nginx.sh — nginx + certbot (вместо Traefik)
• [ ] distr/stacks/мать/microsocks.sh — SOCKS5
• [ ] distr/stacks/отец/code-server.sh — установка code-server
• [ ] distr/stacks/отец/orchestrator.sh — orchestrator-api
• [ ] distr/stacks/сын/chat-connector.sh — chat-connector
• [ ] distr/stacks/сын/son.sh — proj-claude контейнер
• [ ] distr/Dockerfile.agent — образ с claude-code
• [ ] distr/MANUAL.md — ручные шаги после установки

Решить:

• [ ] nginx vs Traefik — два разных подхода на двух серверах, унифицировать
• [ ] Воркспейс: GitHub зеркало или bundle

Структура дистрибутива (целевая)

system/distr/
├── PLAN.md              ← этот файл
├── install.sh           ← точка входа
├── MANUAL.md            ← ручные шаги
├── Dockerfile.agent     ← образ для Отца/Сына
│
├── lib/                 ← утилиты (ui, checks, config, common)
│
├── base/                ← БАЗА (любой сервер)
│   ├── system.sh
│   ├── docker.sh
│   ├── networks.sh
│   └── wireguard.sh
│
├── stacks/
│   ├── мать/            ← МАТЬ
│   │   ├── nginx.sh
│   │   ├── microsocks.sh
│   │   ├── authelia.sh
│   │   ├── gitea.sh
│   │   ├── uptime.sh
│   │   └── monitor.sh
│   │
│   ├── отец/            ← ОТЕЦ (Архитектор)
│   │   ├── code-server.sh
│   │   ├── claude-api.sh
│   │   └── orchestrator.sh
│   │
│   ├── сын/             ← СЫН (Проектор)
│   │   ├── son.sh
│   │   └── chat-connector.sh
│   │
│   └── дочка/           ← ДОЧКА
│       ├── wireguard-client.sh
│       └── executor.sh
│
└── tests/               ← проверки