type: standard
aspect: structure
title: "Стандарт структуры Workspace"
version: 1.0.0
date: 2026-02-19
status: active
Версия: 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/ ← Стандарты
├── 1-structure/structure-component.md ← Структура компонентов
├── 1-structure/structure-workspace.md ← Этот документ
└── ...
$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/ (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/ ← Архивные данные
| Тип | Описание | Где |
|---|---|---|
| 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 |
| Тип | Описание | Где |
|---|---|---|
| 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 | Терминал |
Версия: 4.0.0