Sfera/sfera-new
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(supplier-orders): добавить параметры поставки в таблицу заявок

Browse Source 
- Добавлены колонки Объём и Грузовые места между Цена товаров и Статус
- Реализованы инпуты для ввода volume и packagesCount в статусе PENDING для роли WHOLESALE
- Добавлена мутация UPDATE_SUPPLY_PARAMETERS с проверками безопасности
- Скрыта строка Поставщик для роли WHOLESALE (поставщик знает свои данные)
- Исправлено выравнивание таблицы при скрытии уровня поставщика
- Реорганизованы документы: legacy-rules/, docs/, docs-and-reports/

ВНИМАНИЕ: Компонент multilevel-supplies-table.tsx (1697 строк) нарушает правило модульной архитектуры (>800 строк требует рефакторинга)

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Veronika Smirnova
2025-08-23 18:47:23 +03:00
parent 35cbbac504
commit 12fd8ddf61
27 changed files with 1250 additions and 208 deletions
Download Patch File Download Diff File Expand all files Collapse all files

432
docs-and-reports/PLAN_MISSING_DOCUMENTATION.md Normal file
View File

@ -0,0 +1,432 @@
# ПЛАН ДОКУМЕНТИРОВАНИЯ НЕДОСТАЮЩИХ КОМПОНЕНТОВ СИСТЕМЫ SFERA
## 🎯 ЦЕЛЬ ПЛАНА
Создать полную документацию для **75-80% недокументированных компонентов** системы SFERA, обнаруженных при глубоком аудите кодовой базы.
## 📊 СТАТИСТИКА ПРОПУСКОВ
- **Общий объем системы:** 347 компонентов
- **Уже документировано:** ~70 компонентов (20-25%)
- **Требует документирования:** ~277 компонентов (75-80%)
- **Критические пропуски:** 5 основных модулей + API + сервисы
---
## 🚀 ФАЗА 1: КРИТИЧЕСКИЕ СИСТЕМЫ
_Приоритет: ВЫСОКИЙ | Срок: 3-5 дней_
### 1.1 Административная Система (28+ компонентов)
**Путь:** `src/components/admin/`
**Создать документы:**
- `docs/business-processes/ADMIN_SYSTEM.md`
- `docs/development/ADMIN_UI_KIT.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- admin-dashboard.tsx (основной компонент)
- admin-guard.tsx, admin-login.tsx (аутентификация)
- categories-section.tsx, users-section.tsx (управление)
- ui-kit/ (28 demo компонентов)
└── animations-demo, business-demo, fulfillment-warehouse-demo
└── timesheet-demo/ (6 блоков + типы + хуки)
└── navigation-demo/ (5 блоков + типы + хуки)
📝 ДОКУМЕНТИРОВАТЬ:
- Роли администратора
- UI-Kit система (все 28 компонентов)
- Навигационные паттерны
- Timesheet система (6 вариантов)
- Бизнес-процессы демо
- Системы аутентификации админа
```
### 1.2 Логистические Модули (ДЕТАЛЬНОЕ РАСШИРЕНИЕ)
**Путь:** `src/components/logistics*/`
**Создать документы:**
- `docs/business-processes/LOGISTICS_SYSTEM.md` (расширить существующий)
- `docs/development/LOGISTICS_WORKFLOWS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- logistics-dashboard.tsx (система перевозок)
- logistics-orders-dashboard.tsx (обработка заказов)
- GraphQL мутации логистики
📝 ДОКУМЕНТИРОВАТЬ:
- Workflow: SUPPLIER_APPROVED → LOGISTICS_CONFIRMED → SHIPPED → DELIVERED
- Роли и права логистов
- Интеграция с поставщиками
- Система подтверждения/отклонения заказов
- Статистика и маршруты
```
### 1.3 Статистика и Аналитика (ДЕТАЛЬНОЕ РАСШИРЕНИЕ)
**Путь:** `src/components/*-statistics/`
**Создать документы:**
- `docs/business-processes/ANALYTICS_SYSTEM.md`
- `docs/development/CACHING_ANALYTICS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- seller-statistics-dashboard.tsx (+ advertising-tab/)
- fulfillment-statistics-dashboard.tsx
- economics/ (5 специализированных модулей)
📝 ДОКУМЕНТИРОВАТЬ:
- Система многоуровневого кэширования (24-часовой цикл)
- AI-аналитика и прогнозы
- Специализация по типам организаций
- Интеграция с внешними данными
- Визуализация и метрики
```
### 1.4 Складские Системы (ДЕТАЛЬНОЕ РАСШИРЕНИЕ)
**Путь:** `src/components/*warehouse*/`
**Создать документы:**
- `docs/business-processes/WAREHOUSE_SYSTEMS.md`
- `docs/integrations/MARKETPLACE_INTEGRATIONS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- wb-warehouse-dashboard.tsx (Wildberries интеграция)
- warehouse-dashboard.tsx (общий склад)
- fulfillment-warehouse/ (17+ компонентов)
📝 ДОКУМЕНТИРОВАТЬ:
- Интеграция с Wildberries API
- Система управления товарами/расходниками
- Рыночные интеграции (Садовод, ТЯК Москва)
- Статистика складов и остатков
- Workflow возвратов и претензий
```
---
## 🔧 ФАЗА 2: API И СЕРВИСЫ
_Приоритет: ВЫСОКИЙ | Срок: 2-3 дня_
### 2.1 API Endpoints (11 эндпоинтов)
**Путь:** `src/app/api/`
**Создать документ:**
- `docs/development/REST_API_ENDPOINTS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- upload-* (avatar, employee-document, file, service-image, voice)
- track-click/ (аналитика кликов)
- events/ (система событий)
- health/ (мониторинг состояния)
- download-file/ (скачивание файлов)
- placeholder/ (динамические заглушки)
📝 ДОКУМЕНТИРОВАТЬ:
- Схемы запросов/ответов
- Аутентификация
- Обработка файлов
- Система событий
- Мониторинг и аналитика
```
### 2.2 Внешние Сервисы (5+ сервисов)
**Путь:** `src/services/`
**Создать документ:**
- `docs/integrations/EXTERNAL_SERVICES.md` (расширить существующий)
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- wildberries-service.ts (детальная интеграция)
- marketplace-service.ts (общие маркетплейсы)
- dadata-service.ts (проверка данных)
- sms-service.ts (SMS уведомления)
- s3-service.ts (файловое хранилище)
📝 ДОКУМЕНТИРОВАТЬ:
- API интеграции
- Обработка ошибок
- Rate limiting
- Кэширование ответов
- Конфигурация сервисов
```
### 2.3 Специализированные Хуки (4+ хука)
**Путь:** `src/hooks/`
**Создать документ:**
- `docs/development/REACT_HOOKS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- useAdminAuth.ts (админская аутентификация)
- useRealtime.ts (real-time функциональность)
- useApolloRefresh.ts (обновление Apollo кэша)
- useAuth.ts (основная аутентификация)
📝 ДОКУМЕНТИРОВАТЬ:
- Паттерны хуков
- Интеграция с GraphQL
- Real-time обновления
- Управление состоянием
```
---
## 🧩 ФАЗА 3: КОМПОНЕНТНЫЕ СИСТЕМЫ
_Приоритет: СРЕДНИЙ | Срок: 4-5 дней_
### 3.1 Модульные Архитектуры
**Создать документы:**
- `docs/development/MODULAR_COMPONENTS.md`
- `docs/development/COMPONENT_BLOCKS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- fulfillment-warehouse/fulfillment-warehouse-dashboard/ (blocks/, components/, hooks/, types/, utils/)
- seller-statistics/advertising-tab/ (blocks/, hooks/, types/)
- admin/ui-kit/timesheet-demo/ (blocks/, constants/, hooks/, types/)
- admin/ui-kit/navigation-demo/ (blocks/, hooks/, types/)
📝 ДОКУМЕНТИРОВАТЬ:
- Модульная архитектура блоков
- Переиспользуемые компоненты
- Типизация и интерфейсы
- Хуки предметных областей
- Утилиты и константы
```
### 3.2 UI Компоненты и Демо
**Создать документ:**
- `docs/development/UI_COMPONENTS_CATALOG.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- admin/ui-kit/ (28 demo компонентов)
└── animations-demo, buttons-demo, cards-demo, colors-demo
└── forms-demo, icons-demo, layouts-demo, media-demo
└── states-demo, typography-demo, etc.
📝 ДОКУМЕНТИРОВАТЬ:
- Каталог всех UI компонентов
- Варианты использования
- Стилевая система
- Интерактивные демо
- Код примеров
```
---
## 🌐 ФАЗА 4: ИНТЕГРАЦИИ И WORKFLOW
_Приоритет: СРЕДНИЙ | Срок: 3-4 дня_
### 4.1 Маркетплейс Интеграции
**Создать документ:**
- `docs/integrations/MARKETPLACE_APIS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- Wildberries API (полная интеграция)
- Ozon интеграция (статистика)
- Другие маркетплейсы (Яндекс.Маркет, Авито)
📝 ДОКУМЕНТИРОВАТЬ:
- Схемы API
- Аутентификация
- Rate limiting правила
- Обработка ошибок
- Синхронизация данных
```
### 4.2 Workflow Системы
**Создать документ:**
- `docs/business-processes/CROSS_SYSTEM_WORKFLOWS.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- Межсистемные связи
- Роли пользователей
- Статусные переходы
- Уведомления
📝 ДОКУМЕНТИРОВАТЬ:
- Полный workflow от поставщика до клиента
- Роли и права доступа
- Системы уведомлений
- Интеграционные точки
```
---
## 🧪 ФАЗА 5: ТЕСТИРОВАНИЕ И ИНФРАСТРУКТУРА
_Приоритет: НИЗКИЙ | Срок: 2-3 дня_
### 5.1 Системы Тестирования
**Путь:** `src/test/`
**Создать документ:**
- `docs/development/TESTING_STRATEGY.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- test/e2e/ (end-to-end тесты)
- test/integration/ (интеграционные тесты)
- test/integration/api/ (API тесты)
- test/integration/graphql/ (GraphQL тесты)
📝 ДОКУМЕНТИРОВАТЬ:
- Стратегия тестирования
- E2E тесты
- Интеграционные тесты
- API и GraphQL тесты
- CI/CD интеграция
```
### 5.2 Конфигурация и Типы
**Путь:** `src/types/`, `src/lib/`
**Создать документ:**
- `docs/development/TYPE_SYSTEM.md`
**Содержание:**
```
🔍 ИССЛЕДОВАТЬ:
- types/ (системные типы)
- lib/ (утилиты и конфигурация)
📝 ДОКУМЕНТИРОВАТЬ:
- Типизация системы
- Общие утилиты
- Конфигурационные файлы
- Константы и enum'ы
```
---
## 📋 ПЛАН ВЫПОЛНЕНИЯ
### Неделя 1: Критические системы
- **Дни 1-2:** Административная система (ADMIN_SYSTEM.md, ADMIN_UI_KIT.md)
- **День 3:** Логистические модули (LOGISTICS_SYSTEM.md)
- **Дни 4-5:** Статистика и аналитика (ANALYTICS_SYSTEM.md)
### Неделя 2: API и сервисы
- **Дни 1-2:** API endpoints (REST_API_ENDPOINTS.md)
- **День 3:** Внешние сервисы (EXTERNAL_SERVICES.md)
- **Дни 4-5:** Складские системы (WAREHOUSE_SYSTEMS.md)
### Неделя 3: Компонентные системы
- **Дни 1-3:** Модульные архитектуры (MODULAR_COMPONENTS.md)
- **Дни 4-5:** UI компоненты (UI_COMPONENTS_CATALOG.md)
### Неделя 4: Финализация
- **Дни 1-2:** Интеграции (MARKETPLACE_APIS.md)
- **День 3:** Workflow системы (CROSS_SYSTEM_WORKFLOWS.md)
- **Дни 4-5:** Тестирование (TESTING_STRATEGY.md)
## 🎯 ОЖИДАЕМЫЕ РЕЗУЛЬТАТЫ
### Количественные показатели:
- **+15 новых файлов документации**
- **~20,000+ строк технической документации**
- **Покрытие системы: 95%+**
### Качественные показатели:
- Полная документация всех business-процессов
- Техническая документация всех API
- Руководства по интеграции с внешними сервисами
- Каталог всех UI компонентов
- Стратегии тестирования и развертывания
### Структура финальной документации:
```
docs/
├── business-processes/ (7 файлов)
│ ├── ADMIN_SYSTEM.md ⭐ НОВЫЙ
│ ├── ANALYTICS_SYSTEM.md ⭐ НОВЫЙ
│ ├── WAREHOUSE_SYSTEMS.md ⭐ НОВЫЙ
│ ├── LOGISTICS_SYSTEM.md (расширен)
│ └── CROSS_SYSTEM_WORKFLOWS.md ⭐ НОВЫЙ
├── development/ (9 файлов)
│ ├── ADMIN_UI_KIT.md ⭐ НОВЫЙ
│ ├── REST_API_ENDPOINTS.md ⭐ НОВЫЙ
│ ├── MODULAR_COMPONENTS.md ⭐ НОВЫЙ
│ ├── UI_COMPONENTS_CATALOG.md ⭐ НОВЫЙ
│ ├── REACT_HOOKS.md ⭐ НОВЫЙ
│ ├── CACHING_ANALYTICS.md ⭐ НОВЫЙ
│ ├── TESTING_STRATEGY.md ⭐ НОВЫЙ
│ └── TYPE_SYSTEM.md ⭐ НОВЫЙ
├── integrations/ (4 файла)
│ ├── MARKETPLACE_APIS.md ⭐ НОВЫЙ
│ └── EXTERNAL_SERVICES.md (расширен)
└── infrastructure/ (4 файла существующих)
```
**ИТОГО:** Переход от **20-25%** к **95%+** покрытия документацией системы SFERA!