Стандарт структуры Workspace
Версия: 4.0.0
Дата: 2025-12-18
Уровень: У1 (Стандарт)
Вытекает из: ../../concept/PLATFORM.md, ../../concept/RESOURCES.md
КЛЮЧЕВОЙ ПРИНЦИП
КОД и ДАННЫЕ лежат в двух пространствах с ОДИНАКОВОЙ ИЕРАРХИЕЙ
$WORKSPACE = код, документация, конфигурации (git)
$DATASPACE = данные, изображения, бэкапы (S3)
ИЕРАРХИЯ ДОКУМЕНТОВ
theory/ ← LOCKED, универсальная теория
↓
concept/PLATFORM.md ← Главный документ платформы
↓
concept/ARCHITECTURE.md ← Техническая архитектура
↓
standards/ ← Стандарты
├── structure/COMPONENTS.md ← Структура компонентов
├── structure/WORKSPACE.md ← Этот документ
└── ...
СТРУКТУРА WORKSPACE
$WORKSPACE/
│
├── CLAUDE.md ← Точка входа (Терминал)
│
├── architect/ ← МЕТОДОЛОГИЯ
│ ├── theory/ ← Теория (LOCKED)
│ ├── concept/ ← Концепция
│ │ ├── PLATFORM.md ← Главный документ
│ │ ├── ARCHITECTURE.md ← Архитектура
│ │ └── RESOURCES.md ← Ресурсы и доступ (NEW)
│ └── standards/ ← Стандарты
│
├── system/ ← РЕСУРСЫ ПЛАТФОРМЫ
│ ├── agents/ ← AI-агенты (*.ai.md)
│ │
│ ├── connectors/ ← Внешние API
│ │ ├── marketplaces/ ← ozon/, wildberries/
│ │ ├── messengers/ ← telegram/
│ │ └── accounting/ ← 1c/
│ │
│ ├── drivers/ ← Устройства
│ │ └── printers/ ← label/
│ │
│ ├── adapters/ ← Форматы данных
│ │ ├── spreadsheets/ ← xlsx/, csv/
│ │ └── documents/ ← pdf/
│ │
│ └── stores/ ← Хранилища
│ ├── sql/ ← postgres/
│ └── object/ ← s3/
│
├── projects/ ← БИЗНЕС-ПРОЕКТЫ
│ ├── pirotehnika/
│ │ ├── CLAUDE.md
│ │ ├── config/ ← Конфигурации ресурсов
│ │ ├── integrations/ ← Бизнес-процессы
│ │ ├── services/ ← Приложения (@ozon.api/, @pim.service/)
│ │ └── _shared/ ← Документация к данным
│ │
│ └── lideravto/
│
├── infra/ ← ИНФРАСТРУКТУРА
│ ├── @dev-pro.server/
│ └── @backup.service/
│
└── archive/ ← Архив
СТРУКТУРА DATASPACE
$DATASPACE/ (mount: $DATASPACE)
│
├── projects/ ← Данные бизнес-проектов
│ ├── pirotehnika/
│ │ ├── prices/ ← Прайсы xlsx
│ │ ├── images/ ← Фото товаров
│ │ ├── products/ ← Данные 1С
│ │ ├── exports/ ← Выгрузки
│ │ └── _inbox/ ← Входящие файлы
│ │
│ └── lideravto/
│
├── backup/ ← Бэкапы (beget-infra bucket)
│ ├── critical/ ← CLAUDE.md, settings
│ ├── postgres/ ← Дампы БД
│ ├── git/ ← Git bundles
│ └── restic/ ← Restic repository
│
└── archive/ ← Архивные данные
ТИПЫ КОМПОНЕНТОВ
Платформа (system/)
| Тип |
Описание |
Где |
| Connector API |
Доступ к внешнему API |
library/connectors/api/{name}/ |
| Connector Data |
Доступ к БД |
library/connectors/data/{name}/ |
| Connector Device |
Работа с устройством |
library/connectors/device/{name}/ |
| Parser |
Формат данных |
library/functions/parsers/{name}/ |
| Agent |
AI-агент |
system/agents/{name}.ai.md |
Проект (projects/)
| Тип |
Описание |
Где |
| Config |
Настройки ресурсов |
projects/{name}/config/*.yaml |
| Integration |
Бизнес-процесс |
projects/{name}/integrations/{name}/ |
| Service |
Приложение |
projects/{name}/services/@{name}.{type}/ |
| Script |
Разовая задача |
projects/{name}/scripts/*.py |
Подробнее: ../../concept/RESOURCES.md
ИМЕНОВАНИЕ
Папки
| Тип |
Формат |
Пример |
| Бизнес |
{name}/ |
pirotehnika/ |
| Сайт |
@{domain}/ |
@pirotehnika.spb.ru/ |
| API |
@{name}.api/ |
@ozon.api/ |
| Сервис |
@{name}.service/ |
@pim.service/ |
| Приложение |
@{name}.app/ |
@market.app/ |
| Сервер |
@{name}.server/ |
@dev-pro.server/ |
| Хранилище |
@{name}.storage/ |
@beget-s3.storage/ |
| Данные |
_{name}/ |
_shared/ |
Файлы
| Тип |
Формат |
Пример |
| Документация |
UPPER_CASE.md |
README.md |
| AI-агент |
kebab-case.ai.md |
coder-v1.ai.md |
| Код Python |
snake_case.py |
weekly_report.py |
| Метаданные |
INDEX.yaml |
(всегда так) |
ЗАЩИЩЁННЫЕ ФАЙЛЫ
| Путь |
Статус |
| architect/theory/*.md |
LOCKED |
| architect/concept/PLATFORM.md |
Главный документ |
| CLAUDE.md |
Терминал |
СВЯЗАННЫЕ ДОКУМЕНТЫ
ИСТОРИЯ
- 2025-12-18 v4.0.0: Концепция ресурсов и зеркальной структуры
- Зеркальная структура $WORKSPACE / $DATASPACE
- Новая терминология: Connector, Driver, Adapter, Store
- Терминология проекта: Config, Integration, Service, Script
- Обновлена структура system/ и projects/
- 2025-12-02 v3.0.0: Синхронизация с COMPONENTS.md и ARCHITECTURE.md v2.0.0
- 2025-11-30 v2.0.0: Создан документ
Версия: 4.0.0