Files
sfera-new/docs
Veronika Smirnova d200885ff5 docs: обновить документацию для V2 системы
Обновления:
- CLAUDE.md - обновлены правила взаимодействия с акцентом на модульную архитектуру
- docs/development/MODULAR_ARCHITECTURE_PATTERN.md - обновлена документация паттерна модульной архитектуры

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-25 23:09:29 +03:00
..

📚 АРХИТЕКТУРА ПРАВИЛ СИСТЕМЫ 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