# 📚 АРХИТЕКТУРА ПРАВИЛ СИСТЕМЫ SFERA

Новая модульная структура правил, соответствующая архитектуре кода.

## 🏗️ СТРУКТУРА ПАПОК

### 🎯 CORE - Ядро системы

- `DOMAIN_MODEL.md` - Доменная модель (4 типа организаций)
- `BUSINESS_RULES_CORE.md` - Ядро бизнес-правил
- `WORKFLOW_ENGINE_SPEC.md` - Спецификация движка процессов

### 🔌 API_LAYER - Уровень API

- `GRAPHQL_SCHEMA_RULES.md` - Правила GraphQL схемы
- `RESOLVERS_PATTERNS.md` - Паттерны резолверов
- `API_CONTRACTS.md` - Контракты внешних API

### 💾 DATA_LAYER - Уровень данных

- `PRISMA_MODEL_RULES.md` - Правила моделей Prisma
- `DATABASE_PATTERNS.md` - Паттерны работы с БД
- `MIGRATIONS_GUIDE.md` - Руководство по миграциям

### 🎨 PRESENTATION_LAYER - Уровень представления

- `COMPONENT_ARCHITECTURE.md` - Архитектура компонентов
- `HOOKS_PATTERNS.md` - Паттерны custom hooks
- `UI_COMPONENT_RULES.md` - Правила UI компонентов
- `STATE_MANAGEMENT.md` - Управление состоянием

### 🏢 ORGANIZATION_TYPES - По типам организаций

- `FULFILLMENT_DOMAIN.md` - Домен фулфилмента
- `SELLER_DOMAIN.md` - Домен селлеров
- `WHOLESALE_DOMAIN.md` - Домен поставщиков
- `LOGIST_DOMAIN.md` - Домен логистики

### 🔄 BUSINESS_PROCESSES - Бизнес-процессы

- `SUPPLY_CHAIN_WORKFLOW.md` - Цепочка поставок (8 статусов)
- `PARTNERSHIP_SYSTEM.md` - Система партнерства
- `REFERRAL_MECHANICS.md` - Механика рефералов
- `MARKETPLACE_INTEGRATION.md` - Интеграция с маркетплейсами

### 🛠️ DEVELOPMENT - Разработка

- `MODULAR_ARCHITECTURE_GUIDE.md` - Руководство модульной архитектуры
- `CODING_STANDARDS.md` - Стандарты кодирования
- `TESTING_PATTERNS.md` - Паттерны тестирования
- `DEPLOYMENT_RULES.md` - Правила развертывания

### 🔧 INFRASTRUCTURE - Инфраструктура

- `SERVICES_ARCHITECTURE.md` - Архитектура сервисов
- `REALTIME_SYSTEM.md` - Система real-time
- `SECURITY_RULES.md` - Правила безопасности

## 🎯 ПРИНЦИПЫ НОВОЙ АРХИТЕКТУРЫ

1. **Соответствие коду** - каждый слой документации отражает реальную структуру
2. **Модульность** - правила разбиты по доменам и слоям
3. **Трассируемость** - четкая связь правил с кодом
4. **Расширяемость** - легко добавлять новые типы организаций/процессы

## 🔄 СТАТУС

📁 **НОВАЯ СТРУКТУРА** - в разработке  
📁 **LEGACY ПРАВИЛА** - см. `/legacy-rules/` (архив)

---

_Создано: 2025-08-21_  
_На основе анализа архитектуры кода системы SFERA_