Files
sfera-new/docs
Veronika Smirnova 3f0cc933fc feat: завершить полную миграцию V1→V2 с модульной архитектурой и документацией
АРХИТЕКТУРНЫЕ ИЗМЕНЕНИЯ:
- Полная миграция на URL структуру /{role}/{domain}/{section}/{view}
- Удаление всех старых директорий (/fulfillment-supplies/, /fulfillment-warehouse/, etc.)
- Модульная архитектура seller warehouse с URL-based routing
- Система rollback через комментарии для безопасных изменений

НОВЫЕ КОМПОНЕНТЫ И СТРАНИЦЫ:
- Создание всех недостающих страниц для FULFILLMENT, SELLER ролей
- Модульный layout для seller warehouse с 3 табами
- Извлечение переиспользуемого хука useWBWarehouseData

ИСПРАВЛЕНИЯ БЕЗОПАСНОСТИ:
- Добавление 'use client' директив во все WHOLESALE и LOGISTICS страницы
- Исправление отсутствующих security guards (useRoleGuard + AuthGuard)
- Обновление navigation конфигураций для всех ролей

ДОКУМЕНТАЦИЯ:
- Создание MIGRATION_GUIDE_V1_TO_V2.md: 8-этапное руководство по миграции
- Создание NEXTJS_BEST_PRACTICES.md: паттерны для Next.js 13+ в SFERA
- Обновление URL_ROUTING_RULES.md с seller warehouse и rollback системой
- Обновление SIDEBAR_ARCHITECTURE_IMPLEMENTATION.md с новыми метриками
- Обновление INDEX.md с новыми документами Development раздела

ИСПРАВЛЕНИЯ ESLINT:
- Удаление неиспользуемых импортов и переменных
- Исправление import/order ошибок в модульных компонентах
- Исправление react/no-unescaped-entities
- Перенос длинных строк для соответствия max-len

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-30 22:37:15 +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