architect/arh/standards/structure-old/WORKSPACE.md

Стандарт структуры 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 Терминал

СВЯЗАННЫЕ ДОКУМЕНТЫ


ИСТОРИЯ


Версия: 4.0.0