Skip to content

Repository files navigation

💰 Calculate Money

React TypeScript Vite Supabase Tailwind

🚀 О Проекте

Calculate Money — это современное веб-приложение (PWA), созданное, чтобы забыть о тетрадках и сложных Excel-таблицах. Оно позволяет вести учет каждой услуги за секунды, автоматически считает проценты, чаевые и подводит баланс в конце дня.

Для кого:

  • 💅 Мастера: Видят свою зарплату в реальном времени, историю клиентов и долговые обязательства.
  • 🏢 Администраторы/Владельцы: Контролируют общую выручку, видят занятость мастеров и сводные отчеты.

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

📝 Учет Записей

  • Быстрый ввод: Добавление клиента, выбор услуг (Маникюр, Педикюр и др.) и типа оплаты (Наличные/Карта/Смешанная) за пару кликов.
  • Гибкие настройки: Учет ситуаций, когда клиент платит Админу или переводит Мастеру на карту.
  • Чаевые: Отдельный учет чаевых (Наличные остаются у мастера, Карточные делятся или учитываются в балансе).

💸 Финансы и Баланс

  • Умный расчет: Приложение само считает, кто кому должен в конце дня (Мастер Салону или Салон Мастеру) с учетом установленного процента (например, 40/60).
  • Долги и Корректировки: Специальный режим для записи ручных долгов ("Взял из кассы", "Купил материалы", "Салон оплатил обед").
  • Проценты: Настройка разных процентов для Наличных и Безналичных оплат.

📊 Отчетность

  • PDF Экспорт: Генерация профессионального чека/отчета за любой период.
    • Группировка по дням.
    • Подсчет итогов за каждый день: "Салон мне: +40€".
    • Общий итог за период.
  • Excel: Возможность выгрузки данных для детальной аналитики.

📱 Удобство (UX/UI)

  • PWA: Можно установить как приложение на телефон.
  • Роли: Разграничение прав доступа (Мастер видит только своё, Админ — всё).
  • Dark Mode: Стильный и понятный интерфейс.

🛠 Технический Стек

  • Frontend: React, TypeScript, Vite
  • UI Kit: Tailwind CSS, Shadcn UI, Lucide Icons
  • Backend/BaaS: Supabase (PostgreSQL, Auth, Realtime)
  • PDF Generation: html2pdf.js + Custom CSS
  • State Management: React Hooks + Context

📸 Скриншоты

Дашборд Мастера Добавление Записи PDF Отчет
Баланс, список клиентов и итоги дня Удобная форма с выбором услуг и оплаты Профессиональная верстка с итогами

📦 Установка и Запуск

  1. Клонируйте репозиторий

    git clone https://github.com/nikita-ursulenko/CalculateMoney.git
  2. Установите зависимости

    npm install
  3. Настройте окружение (.env) Создайте файл .env и добавьте ключи Supabase:

    VITE_SUPABASE_URL=your_supabase_url
    VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
  4. Запустите проект

    npm run dev

💡 Как это работает (Логика Расчета)

Система использует уникальную логику "Баланса" для расчета взаиморасчетов:

  1. Если Мастер принял Наличные:

    • Деньги у мастера.
    • Мастер должен отдать Салону процент (например, 60%).
    • Баланс Мастера уменьшается.
  2. Если Клиент платил Картой (в кассу):

    • Деньги у Салона.
    • Салон должен отдать Мастеру его процент (например, 40%).
    • Баланс Мастера увеличивается.
  3. Итог Дня:

    • Суммируются все плюсы и минусы.
    • Результат показывает, кто кому должен передать деньги в конце смены.

Создано с ❤️ для beauty-индустрии.

About

Система автоматического расчета зарплаты и учета услуг для мастеров и салонов красоты.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages