Skip to content

Latest commit

 

History

History
259 lines (197 loc) · 11.3 KB

RELEASE.md

File metadata and controls

259 lines (197 loc) · 11.3 KB

🎯 Samurai Car Service Management System v1.0.0

Дата релиза: 28 сентября 2025

License: MIT Node.js Version Vue.js Version Docker

🏗️ Архитектура системы

Микросервисная архитектура

Система состоит из 5 основных сервисов, каждый из которых развертывается в отдельном Docker контейнере:

┌─────────────────────────────────────────────────────────────────┐
│                        Samurai Car Service                      │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────┐  │
│  │  Admin      │  │   Client    │  │  Workers    │  │ Node-   │  │
│  │  Panel      │  │   Portal    │  │ Interface   │  │  RED    │  │
│  │  Vue 3      │  │  Vue 3      │  │  Vue 3      │  │ Flows   │  │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────┘  │
├─────────────────────────────────────────────────────────────────┤
│                    Strapi 5 (Headless CMS)                     │
│                    SQLite Database                             │
└─────────────────────────────────────────────────────────────────┘

Компоненты системы

Компонент Технологии Порт Домен
Админ-панель Vue 3 + Vite 1100 a.your-domain.com
Клиентский портал Vue 3 + Vite 1101 your-domain.com
Интерфейс исполнителей Vue 3 + Vite 1102 in.your-domain.com
Strapi CMS Strapi 5 + TypeScript 1103 strapi.your-domain.com
Node-RED Node-RED + Flows 1880 api.your-domain.com

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

🤖 Интеллектуальное создание заказ-нарядов

Используйте простые предложения вроде "замена масла, обслуживание шруса" - система автоматически:

  • Создаст структурированный заказ-наряд
  • Найдет нормочасы для работ
  • Подберет необходимые запчасти
  • Предложит сопутствующие работы

📊 Полная прозрачность бизнеса

  • Мониторинг ремонтов в реальном времени
  • Детальная финансовая аналитика
  • Автоматические уведомления клиентов
  • Персонализированное обслуживание

🔧 Мощная система управления данными

Клиенты (Clients)

  • Полная база клиентов с контактными данными
  • История взаимодействий
  • Управление предпочтениями

Автомобили (Cars)

  • Учет транспортных средств с VIN, номерами
  • Полная история обслуживания
  • Назначение механиков

Заказ-наряды (Orders)

  • Многостатусная система управления ремонтами
  • Отслеживание прогресса
  • Финансовый учет

Запчасти (Parts)

  • Каталог с артикулами и ценами
  • Статусы поставки
  • Автоматические рекомендации

Работы (Work)

  • Планирование и учет выполненных работ
  • Система вознаграждений исполнителей
  • Контроль качества

Мониторинг ремонта (RepairMonitor)

  • Отслеживание ремонта в реальном времени
  • Детальные отчеты о прогрессе
  • История изменений

👥 Ролевые интерфейсы

Админ-панель

  • Полное управление системой
  • Управление пользователями и ролями
  • Аналитика и отчетность
  • Настройка бизнес-процессов

Клиентский портал

  • Онлайн-заявки на обслуживание
  • Отслеживание статуса ремонта
  • Личный кабинет с историей
  • Система уведомлений

Интерфейс исполнителей

  • Персональный дашборд с задачами
  • Отчетность о выполненных работах
  • Коммуникация с клиентами
  • Система вознаграждений

🛠️ Технологии

Frontend

  • Vue 3 - Прогрессивный JavaScript фреймворк
  • Vite - Молниеносный билдер
  • Tailwind CSS - Utility-first CSS фреймворк
  • Pinia - Современное управление состоянием
  • Vue Router - Маршрутизация
  • PWA - Progressive Web Apps поддержка

Backend

  • Strapi 5 - Headless CMS
  • SQLite - Легковесная база данных
  • TypeScript - Типизация

Автоматизация и AI

  • Node-RED - Flow-based programming для автоматизации
  • YandexGPT API - Искусственный интеллект для обработки заказов
  • Yandex Vision API - Распознавание изображений
  • Telegram Bot API - Система уведомлений

DevOps

  • Docker - Контейнеризация
  • Traefik - Reverse proxy и load balancer
  • PM2 - Process management
  • Let's Encrypt - SSL сертификаты

🚀 Быстрый старт

Предварительные требования

  • Node.js >= 18.0.0
  • Docker & Docker Compose
  • Git

Установка в один клик

# 1. Клонировать репозиторий
git clone https://github.com/ti-rudin/samurai.git
cd samurai

# 2. Запустить систему
docker-compose up -d

# 3. Открыть в браузере
# Админ-панель: https://a.your-domain.com
# Клиентский портал: https://your-domain.com

Готово! 🎉 Система запущена и готова к работе.

Доступ к сервисам

После успешного запуска сервисы будут доступны по адресам:

🔑 API интеграция

Yandex AI API

Система интегрирована с Yandex AI сервисами:

  • YandexGPT для обработки естественного языка
  • Vision API для распознавания изображений
  • OAuth токен для аутентификации

Получение токенов

  1. Перейти в Yandex ID
  2. Создать приложение в разделе "Управление приложениями"
  3. Получить API ключи в Yandex Cloud Console

📋 Что включено в релиз

✅ Готовые компоненты

  • Преднастроенная схема данных Strapi
  • Готовые Docker образы всех сервисов
  • Настроенные переменные окружения
  • CORS конфигурация для всех доменов
  • SSL готовность через Let's Encrypt
  • Полная документация по развертыванию

✅ Преднастроенные модели данных

  • Clients - управление клиентами
  • Cars - учет автомобилей
  • Orders - заказ-наряды
  • Parts - запчасти
  • Work - работы
  • RepairMonitor - мониторинг ремонта

✅ API endpoints

  • RESTful API для всех моделей
  • Автоматическая документация
  • CORS настроен для всех доменов
  • JWT аутентификация

🔮 Готовые для развития

🎯 Планируемые улучшения

  • Telegram Bot для уведомлений
  • Финансовая аналитика с отчетами
  • Мобильное приложение (PWA)
  • Интеграция с 1C и другими системами
  • AI чат-бот для клиентской поддержки

🚀 Масштабирование

  • Готовность к горизонтальному масштабированию
  • Микросервисная архитектура
  • Отдельные базы данных для каждого сервиса
  • Load balancer готовность

📞 Поддержка

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

Контакты

📝 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для деталей.

Создано с ❤️ для автобизнеса

⭐ Поставьте звезду | 🐛 Сообщить о баге | 💬 Обсудить