Обновлен README.md с новыми возможностями платформы Sfera V для управления бизнесом, добавлен раздел о складе Wildberries для селлеров. В компоненте Sidebar добавлена кнопка для перехода к складу ВБ, доступная только для пользователей с типом организации "SELLER". В классе WildberriesService реализованы новые методы для получения остатков товаров и интеграции с API Wildberries, включая обработку ошибок и кэширование данных.

2025-07-23 18:02:20 +03:00
parent f478754bef
commit ff81d603a6
5 changed files with 1278 additions and 118 deletions
--- a/README.md
+++ b/README.md
@ -1,122 +1,57 @@
-# SferaV - Система управления бизнесом
+# Sfera V - Управление бизнесом

-Красивое приложение для авторизации и управления кабинетами Фулфилмент и Wildberries с современным фиолетовым дизайном.
+Платформа для управления различными типами бизнеса: фулфилмент, селлеры, логистика, оптовики.

-## ✨ Особенности
+## Новые возможности

- 🎨 **Современный UI/UX** - Фиолетовые градиенты и стеклянный эффект
- 📱 **Адаптивный дизайн** - Отлично работает на всех устройствах
- 🔐 **Многоэтапная авторизация** - Номер телефона → SMS → Выбор кабинета → Данные
- 📞 **Умная маска телефона** - Автоформатирование номера +7 (999) 999-99-99
- 💼 **Два типа кабинетов** - Фулфилмент (ИНН) и Wildberries (API ключ)
- ⚡ **Быстрая навигация** - Плавные переходы между этапами
+### 🏪 Склад Wildberries для селлеров

-## 🛠 Технологии
+Новый раздел для селлеров, позволяющий:

- **Next.js 15** - React фреймворк
- **TypeScript** - Типизация
- **Tailwind CSS 4** - Стилизация
- **shadcn/ui** - UI компоненты
- **react-input-mask** - Маска ввода
+- **Просмотр остатков** товаров на всех складах WB в реальном времени
+- **Статистика по складам** - общее количество товаров, остатки, товары в пути
+- **Фильтрация и поиск** товаров по названию, артикулу, бренду
+- **Детальная информация** по каждому складу отдельно
+- **Красивые карточки товаров** с изображениями и статусами остатков

-## 🚀 Быстрый старт
+#### Как использовать:
+1. Настройте API ключ Wildberries в разделе "Настройки" → "API"
+2. Перейдите в раздел "Склад ВБ" в боковом меню
+3. Система автоматически загрузит актуальные остатки с вашего аккаунта WB

-1. **Установка зависимостей:**
-   ```bash
-   npm install
-   ```
+#### Технические особенности:
+- Интеграция с официальным API Wildberries
+- Поддержка всех типов складов WB
+- Кэширование данных для быстрой работы
+- Адаптивный дизайн в стиле платформы

-2. **Запуск приложения:**
-   ```bash
-   npm run dev
-   ```
+## Структура проекта

-3. **Откройте браузер:**
-   ```
-   http://localhost:3000
-   ```
+- `src/app/wb-warehouse/` - Страница склада WB
+- `src/components/wb-warehouse/` - Компоненты интерфейса склада
+- `src/services/wildberries-service.ts` - Интеграция с API WB

-## 📱 Этапы авторизации
+## Технологии

-### 1. Ввод номера телефона
- Красивая маска ввода с автоформатированием
- Валидация российских номеров (+7)
- Плавная анимация при вводе
+- Next.js 15
+- React 18
+- TypeScript
+- GraphQL
+- Prisma
+- TailwindCSS
+- Shadcn/ui

-### 2. Подтверждение SMS
- 4 отдельных поля для цифр кода
- Автопереключение между полями
- Возможность вернуться к изменению номера
+## Установка и запуск

-### 3. Выбор типа кабинета
- Фулфилмент кабинет (складские операции)
- Wildberries кабинет (маркетплейс)
- Интерактивные карточки с описанием
-
-### 4. Ввод данных
- **Фулфилмент:** ИНН организации (10-12 цифр)
- **Wildberries:** API ключ с инструкцией получения
-
-## 🎨 Дизайн
-
- **Цветовая схема:** Фиолетовые градиенты
- **Эффекты:** Стеклянные поверхности, размытие
- **Анимации:** Плавные переходы и hover эффекты
- **Типографика:** Современные шрифты с хорошей читаемостью
-
-## 📂 Структура проекта
-
-```
-src/
-├── app/                    # Next.js App Router
-│   ├── globals.css        # Глобальные стили
-│   ├── layout.tsx         # Основной layout
-│   └── page.tsx           # Главная страница
-├── components/
-│   ├── auth/              # Компоненты авторизации
-│   │   ├── auth-flow.tsx      # Основной флоу
-│   │   ├── auth-layout.tsx    # Layout для этапов
-│   │   ├── phone-step.tsx     # Ввод телефона
-│   │   ├── sms-step.tsx       # Ввод SMS
-│   │   ├── cabinet-select-step.tsx # Выбор кабинета
-│   │   ├── inn-step.tsx       # Ввод ИНН
-│   │   └── wb-api-step.tsx    # Ввод API ключа WB
-│   └── ui/                # shadcn/ui компоненты
-│       ├── button.tsx
-│       ├── card.tsx
-│       ├── input.tsx
-│       ├── label.tsx
-│       ├── phone-input.tsx
-│       └── select.tsx
-└── lib/
-    └── utils.ts           # Утилиты
+```bash
+npm install
+npm run dev
 ```

-## 🔧 Настройка
+## API интеграции

-### Цвета
-Фиолетовая тема настроена в `src/app/globals.css` с использованием CSS переменных oklch.
+- Wildberries API для получения остатков и информации о складах
+- DaData для работы с организациями
+- SMS Aero для отправки SMS

-### Компоненты
-Все UI компоненты основаны на shadcn/ui и адаптированы под дизайн системы.
-
-## 📝 Будущие улучшения
-
- [ ] Интеграция с реальным API для SMS
- [ ] Сохранение состояния в localStorage
- [ ] Темная/светлая темы
- [ ] Интернационализация (i18n)
- [ ] Мобильное приложение
- [ ] Анимации между этапами
-
-## 🤝 Вклад в проект
-
-Приветствуются все улучшения! Создавайте issues и pull requests.
-
-## 📄 Лицензия
-
-MIT License - используйте свободно!
-
---
-
-Сделано с ❤️ для удобной работы с маркетплейсами
+Доступ к разделу "Склад ВБ" имеют только пользователи с типом организации "SELLER".