AVISHU Fashion Superapp

Единая платформа для fashion-франшизы нового поколения, объединяющая клиентское web-приложение, специализированные дашборды для партнеров-франчайзи, систему управления производством, а также глубокую интеграцию с инновационным AI-модулем (AI Stylist и Виртуальная примерочная).

Дизайн-код платформы: строгий, премиальный, минималистичный, монохромный brutalism (черно-белые тона, прямые углы, тонкие границы, uppercase typography).

---

🌟 Ключевые возможности (Key Features)

🛒 Для клиентов (Client App)

• AI Виртуальная примерочная (AI Try-On): Фотореалистичная примерка одежды на профессиональных 3D-манекенах с использованием генеративного ИИ.
• Гендерный фильтр: Персонализированный каталог и алгоритмы примерки, адаптированные под выбранный пол.
• Личный кабинет: История заказов, просмотр статусов и галерея сохраненных сгенерированных образов.
• Премиальный UI/UX: Интуитивно понятный интерфейс для удобного шопинга.

🏢 Для франчайзи (Franchisee Dashboard)

• AI-Аналитика продаж: Продвинутая аналитика, визуализация метрик эффективности работы точки и популярности товаров на основе ИИ.
• Управление каталогом: Контроль наличия ассортимента и метаданных товаров.
• Обработка заказов: Мониторинг и управление заказами клиентов, закрепленными за конкретной точкой франшизы.

🏭 Для производства (Production Dashboard)

• Система управления заказами: Единое окно для приема заявок на пошив и комплектацию от клиентского приложения и франчайзи.
• Трекинг статусов: Управление жизненным циклом заказа (От создания до отгрузки со склада).

---

🛠 Технологический стек (Tech Stack)

Бэкенд (Backend)

• Node.js + Express.js — Основное REST API приложения.
• Prisma ORM — Современный инструмент для взаимодействия с БД и типизации.
• PostgreSQL — Основная реляционная база данных (Shared DB).
• JWT Auth — Ролевая модель авторизации (CLIENT, FRANCHISEE, PRODUCTION).
• AI Vision Services — Интеграция микросервисов для реалистичной генерации изображений примерочной.

Фронтенд (Web)

• Next.js (App Router) — React-фреймворк для быстрой работы SSR и клиентского роутинга.
• Tailwind CSS — Кастомная тема, реализующая строгий монохромный дизайн (Brutalism Aesthetic).
• TypeScript (в новых модулях) — Строгая типизация компонентов и API-ответов.

---

⚙️ Переменные окружения (Environment Variables)

Для запуска убедитесь, что у вас настроены .env файлы:

backend/.env (пример)

# Подключение к локальной БД в Docker
DATABASE_URL="postgresql://user:password@localhost:5432/avishu?schema=public"

# Секрет для JWT токенов
JWT_SECRET="your-super-secret-key-123"

# Порт бэкенда (по умолчанию 3000)
PORT=3000

web/.env или web/.env.local (пример)

# Ссылка на локальный бэкенд
NEXT_PUBLIC_API_URL="http://localhost:3000/api"

---

🚀 Как запустить проект (Start)

Выполните эти команды по очереди в разных терминалах:

1. База данных (Docker) — в корне проекта

docker-compose up -d

Подождите 10-20 секунд, пока база запустится.

2. Бэкенд (API) — в папке backend

cd backend
npm install
npm run dev

Запустится на http://localhost:3000.

3. Сайт (Frontend) — в папке web

cd web
npm install
npm run dev

Запустится на http://localhost:3001 (или 3000, если порт свободен).

---

🛑 Как остановить проект (Stop)

1. Сервера: Нажмите Ctrl + C в терминалах, где запущены Бэкенд и Сайт.
2. База данных: В корне проекта выполните:

docker-compose down

---

👤 Тестовые доступы (Demo Accounts)

Все пароли одинаковые: 123456

• Клиент: client@avishu.com
• Франчайзи: franchise@avishu.com
• Производство: factory@avishu.com

---

Tip

Первый запуск БД: Если вы запускаете базу данных впервые или после удаления volumes, выполните в папке backend:

1. npx prisma db push или npx prisma migrate dev --name init — создание таблиц
2. npx prisma generate — генерация клиента Prisma
3. npm run seed — заполнение базы демо-данными (пользователи из списка выше, товары, аналитика).