Перейти к содержанию

TaoMaster

TaoMaster — это SaaS-платформа (СРМ) для посредников выкупа товаров из Китая. Посредник регистрируется в системе, получает собственный кабинет и поддомен, подключает своих клиентов и ведёт полный цикл: от создания заказа на товары (1688, Taobao, Tmall, Poizon и др.) до выкупа, консолидации, международной доставки и приёмки получателем в стране назначения.

Назначение этой документации

Документ описывает архитектуру, структуру базы данных, ключевые проектные решения, все страницы интерфейса и дорожную карту проекта. Это внутренний материал для команды разработки и сопровождения.

Что делает система

flowchart TD
    A[Клиент создаёт заказ] --> C[Посредник проверяет]
    C -->|реквизиты / баланс| D[Оплата]
    D --> E[Выкуп на площадках]
    E --> F[Консолидация на складе в Китае]
    F --> G[Отгрузка + расчёт доставки]
    G --> H[Груз: международная доставка]
    H --> I[Прибытие в страну]
    I --> J[Приёмка получателем]

Платформа покрывает три роли:

Роль Кабинет Вход Назначение
Посредник (и его сотрудники) /agent/*, поддомен {sub}.test142.ru Телефон + пароль / код Ведёт заказы, клиентов, выкуп, отгрузки, грузы, настройки, тарифы
Клиент (и сотрудники клиента) /client/* Телефон + OTP (Telegram/MAX) / пароль Создаёт заказы, оплачивает, общается в чате, отслеживает доставку
Администратор СРМ /admin (Filament) Email + пароль Модерация посредников, тарифы, каталоги, переводы, чек-листы

Ключевые характеристики

  • Мультиарендность (multitenancy). Все данные посредника изолированы по agent_id через глобальный scope. Сотрудники видят только данные своего посредника; клиенты — только свои заказы.
  • Гибкая система прав (ПДИУ). Объекты доступа × уровни (view/add/edit/delete) × scope (свои / чужие / все). Группы прав клонируются каждому посреднику из эталонных.
  • Мультивалютность. Внутренний учёт в ¥/$, отображение клиенту — в валюте его страны; курсы посредника (ручные ладдеры + ЦБ РФ + bestchange).
  • Реальные мессенджер-каналы. Telegram и MAX-боты для OTP, подтверждения телефона и уведомлений.
  • Полная локализация (RU/EN/CN). Статические строки + автоперевод динамики через Google Translate. Посредники могут быть китайцами, клиенты — русскими.
  • Realtime-чат по каждому заказу (Laravel Reverb / WebSocket) с переводом, реакциями, файлами и внутренней перепиской сотрудников.
  • Доп. услуги к товарам (фото/видео/обмер/пересчёт) с загрузкой медиа, плюс кастомные уведомления, заметки сотрудников, онбординг-визард и переключение кабинетов.
  • Chrome-расширение для клиента — отправка товара со страницы магазина (1688/Taobao/Poizon) в черновик заказа через токен-API.

Технологический стек (кратко)

Слой Технология
Backend Laravel 11.54 (PHP 8.3)
Frontend (SPA) Inertia.js + Vue 3 + Vite, дизайн-система в стиле Metronic на Tailwind
Админка Filament (отдельная панель /admin)
Очереди Laravel Horizon + Redis
Realtime Laravel Reverb (WebSocket)
БД MySQL 8.0 (тесты — SQLite in-memory)
Импорт maatwebsite/excel (XLS/CSV)
Стейт-машины spatie/laravel-model-states

Подробнее — в разделе Технологический стек.

Как читать документацию

Актуальность

Документация отражает состояние проекта на момент последней сборки. Канонический источник истины — код на сервере (/var/www/www-root/data/taomaster/).