⚠️ PROPRIETARY / VIEW-ONLY: No license is granted. All rights reserved.

SalesFlow — Automated Sales Management System

SalesFlow — full-stack система управления продажами (CRM/ERP-стиля) с админ-панелью, аналитикой и отчётностью.
Проект оформлен как демо-готовое приложение: быстро разворачивается на ПК, имеет реалистичные тестовые данные, стабильный UX и наглядный Dashboard.

---

✨ Ключевые возможности

🧑‍🤝‍🧑 Продажи и клиенты

• Управление клиентами (сегментация B2C/SMALL/MID/CORP/VIP, статус active/inactive)
• Управление категориями и товарами (цены, себестоимость, SKU, статусы)
• Управление заказами + позициями заказа
• Учёт оплат и возвратов
• Полноценный CRUD через таблицы и модалки

📊 Аналитика и отчёты

• KPI-метрики: выручка, средний чек, кол-во заказов, активные клиенты и др.
• Sales by day (динамика продаж)
• Top products / Top clients
• Orders breakdown (распределение по статусам)
• Графики в UI — responsive и интерактивные (Recharts)

🔐 Безопасность и доступ

• JWT-авторизация (SimpleJWT)
• Приватные роуты и защита страниц (RequireAuth)
• Авто-обработка 401 (сброс токена + редирект на login)

🧪 Демо-режим

• Команда bootstrap_dev:
  • очищает dev-базу
  • применяет миграции
  • создаёт админа
  • наполняет систему реалистичными данными (клиенты/товары/заказы/оплаты/возвраты)

---

🧰 Технологический стек

Frontend

• React + Vite + TypeScript
• TailwindCSS + shadcn/ui-style компоненты
• Axios (с interceptor для JWT)
• Recharts (Dashboard / Reports)

Backend

• Django + Django REST Framework
• JWT auth: SimpleJWT
• SQLite (dev)
• django-cors-headers (dev CORS для localhost)

---

📚 Документация

• ✅ Быстрый старт (Windows, для чайников): [ открыть ]
• 🧯 Решение проблем (Troubleshooting): [ открыть ]
• 🖥️ Frontend документация: [ открыть ]
• 🧠 Backend документация: [ открыть ]

---

🚀 Быстрый старт (Windows, вручную)

0) Требования

Установить один раз:

• Python 3.11+ (64-bit)
• Node.js 20 LTS

Проверка:

python --version
node -v
npm -v

---

1) Backend

cd backend
python -m venv .venv
# Windows:
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
python manage.py migrate
python manage.py bootstrap_dev
python manage.py runserver 8000

✅ Проверка, что backend поднялся:

• Admin: http://localhost:8000/admin/
• Health: http://localhost:8000/api/health/
• API base: http://localhost:8000/api/

Примечание: корень http://localhost:8000/ вернёт 404 — это нормально (в проекте не задан route для пустого пути).

---

2) Frontend (в отдельном терминале)

cd frontend
npm ci
npm run dev

Frontend обычно на:

• http://localhost:5173/

⚠️ Важная Windows-особенность (бывает на некоторых конфигурациях):

• Vite пишет, что сервер запущен, порт LISTENING, но браузер/curl не подключается к localhost:5173.

Решение:

npm run dev -- --host 127.0.0.1

Тогда открывать:

• http://127.0.0.1:5173/

---

🔐 Данные для входа (demo)

• Логин: admin
• Пароль: 12345678

---

🧭 Навигация по проекту

SalesFlow/
  backend/                      # Django + DRF API + Admin
  frontend/                     # React + Vite UI
  docs/                         # Quickstart + Troubleshooting

---

🔗 Основные API эндпоинты

Auth

• POST /api/auth/token/
• POST /api/auth/refresh/

CRUD

• /api/clients/
• /api/categories/
• /api/products/
• /api/orders/
• /api/order-items/
• /api/payments/
• /api/returns/

Reports

• /api/reports/kpi/
• /api/reports/sales-by-day/
• /api/reports/top-products/
• /api/reports/top-clients/
• /api/reports/status-breakdown/

---

✅ Рекомендованный сценарий для демонстрации

1. Запустить bootstrap_dev (данные “как в реальном бизнесе”)
2. Зайти на Dashboard → показать KPI и интерактивные графики
3. Перейти в Orders → показать статусы, деталку заказа, позиции
4. Перейти в Reports → выбрать период → показать топы и breakdown
5. Показать Payments/Returns (как финальный блок учёта)

---

🧾 Лицензия

Проект является проприетарным. Все права защищены (All rights reserved). Никакие права на использование, копирование, модификацию или распространение не предоставляются. См. файл LICENSE.

Автор: Arsenij Ingannamorte — @IngannamorteScienceDev