architect/standards/1-structure/README.md

type: index
aspect: structure
title: "Структура — Как организовано"
version: 1.0.0
date: 2026-02-19

Структура — Как организовано

Стандарты структуры workspace, проектов, компонентов и решений.

СОДЕРЖАНИЕ

Платформа и workspace

Документ Описание Статус
structure-workspace.md Структура workspace /opt/claude-workspace ✅ Active
structure-platform.md Структура папок платформы (9 аспектов) ✅ Active
structure-organization.md Структура организации (иерархия компаний/проектов) ✅ Active
structure-hierarchy.md Иерархия сущностей и классов ✅ Active
structure-tree.md Визуализация дерева структуры ✅ Active

Проекты и решения

Документ Описание Статус
structure-project.md Структура IT-проекта (правила и папки) ✅ Active
structure-solution.md Структура решения (solution) ✅ Active

Компоненты и библиотека

Документ Описание Статус
structure-component.md Архитектура компонентов (Parser/Scraper/Connector) ✅ Active
structure-library.md Структура library/ и правила переиспользования ✅ Active

Дизайн и контекст

Документ Описание Статус
structure-design-layers.md Слои дизайна (layout/styles/theme/branding) ✅ Active
structure-context-blocks.md Контекстные блоки для декомпозиции ✅ Active

НАЗНАЧЕНИЕ

Структура отвечает на вопрос "КАК УСТРОЕНО?"

Этот аспект определяет:
- Как организован workspace
- Как структурирован проект
- Как устроены компоненты
- Как разложить решение по папкам

ИЕРАРХИЯ СТРУКТУР

WORKSPACE (корень)
    ↓
ПЛАТФОРМА (architect/, system/, library/)
    ↓
РЕШЕНИЕ (solutions/X/)
    ↓
ПРОЕКТ (projects/org/X/)
    ↓
КОМПОНЕНТ (library/connectors/X/)
    ↓
МОДУЛЬ (@module/)

Каждый уровень имеет свою структуру.

СВЯЗАННЫЕ АСПЕКТЫ

Аспект Документ Связь
Типология typology-entity-types.md ЧТО это за сущность
Формат format-document.md КАК ВЫГЛЯДИТ документация
Именование naming-projects.md КАК НАЗВАТЬ проект
Жизненный цикл lifecycle-project.md КАК ЖИВЁТ проект
Процессы process-development.md КАК ДЕЛАТЬ в проекте

ПРИМЕНЕНИЕ

Создание нового проекта

  1. Определить тип: typology-project-types.md
  2. Применить структуру: structure-project.md
  3. Создать папки:
    projects/org/{name}/ ├── CLAUDE.md ├── PROJECT.md ├── data/ ├── docs/ └── app/ (если IT-проект)

Создание компонента

  1. Определить тип: Parser / Scraper / Connector / Adapter
  2. Применить архитектуру: structure-component.md
  3. Разместить в library/:
    library/connectors/{name}/ ├── __init__.py ├── client.py ├── models.py └── README.md

Организация workspace

  1. Следовать platform структуре: structure-platform.md
  2. 9 аспектов в architect/standards/:
    1-structure/ 2-lifecycle/ 3-process/ 4-policy/ 5-format/ 6-naming/ 7-typology/ 8-operation/ 9-guidance/

ДИАГРАММЫ

Структура workspace

/opt/claude-workspace/
├── architect/         ← Методология (theory/concept/standards)
├── library/           ← Переиспользуемый код
├── system/            ← Ядро платформы (agents/scheduler/monitor)
├── constructors/      ← Конструкторы решений
├── solutions/         ← Готовые решения
├── infra/             ← Инфраструктурные скрипты
└── projects/          ← Бизнес-проекты
    └── org/           ← Организации
        ├── pirotehnika/
        └── lideravto/

Структура IT-проекта

projects/org/{name}/
├── CLAUDE.md          ← Контекст для AI
├── PROJECT.md         ← Описание проекта (9 вопросов)
├── index.yaml         ← Метаданные
├── data/              ← Данные проекта
│   ├── connectors/    ← Коннекторы к внешним API
│   └── scripts/       ← Скрипты обработки
├── docs/              ← Документация
├── tests/             ← Тесты
└── app/               ← Приложение (если IT)
    ├── src/           ← Исходный код
    ├── config/        ← Конфигурации
    └── static/        ← Статика

СТАТИСТИКА

Файлов в 1-structure/: 12 (11 стандартов + 1 README)

Охват:
- ✅ Workspace (workspace, platform, organization)
- ✅ Проекты (project, solution)
- ✅ Компоненты (component, library)
- ✅ Дизайн (design-layers, context-blocks)
- ✅ Иерархия (hierarchy, tree)

Статус: ФАЗА 3 завершена ✅

CHANGELOG

2026-02-19 — v1.0.0

Версия: 1.0.0
Дата: 2026-02-19
Владелец: architect