Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Luisangelebp/SCO_Autolavados/llms.txt

Use this file to discover all available pages before exploring further.

SCO Autolavados is a full-stack web platform purpose-built for car wash owners and operators who need to replace paper-based workflows with a real-time, digitally-integrated system. It handles every stage of the business day — from receiving a vehicle at the front desk and routing it through the wash queue, to issuing multi-currency invoices, tracking chemical inventory, calculating laundrer commissions, and letting customers schedule appointments from their phones. The platform eliminates the guesswork of manual bookkeeping by centralizing operations into two distinct interfaces: an Admin Dashboard for staff and owners, and a Customer Portal for self-service clients.
SCO Autolavados was developed using “Multiservicios La Miami” in Barinas, Venezuela as its real-world case study. All business logic, commission structures, and multi-currency rules reflect the operational context of that establishment.

​
Two Interfaces, One System

Admin Dashboard is the command center for the business owner and reception staff. It provides real-time visibility into the active service queue, a point-of-sale (POS) interface for registering walk-in services and product sales, inventory controls, financial summaries in both USD and Bolívares, and a payroll module for computing daily laundrer commissions. Customer Portal is a lightweight, mobile-optimized interface for registered clients. Customers can create service reservations, track the real-time status of their vehicle in the wash queue, browse the product store, and review their complete service history — all from a browser with no app download required.

​
Core Modules

Service Queue

Real-time operational board tracking every vehicle from EN_ESPERA → LAVANDO → FINALIZADO, with laundrer assignment and estimated wait-time calculation.

Inventory

Stock tracking for chemicals, accessories, and retail products. Each service is linked to the inventory items it consumes, triggering automatic deductions on fulfillment.

Payments & Sales

Multi-method payment recording (Pago Móvil, efectivo, Binance, débito) with admin approval flow and immutable invoice generation in USD and Bolívares.

Payroll

Automated daily commission calculation for laundrers based on completed services, configurable commission type (full price or base service) and percentage.

​
User Roles

SCO Autolavados enforces a strict three-role access model. Every action in the system is gated behind role-based middleware.

​
Admin (Administrator)

Admins have full system control. They manage all users, services, inventory, sales, payments, and payroll. When registering a walk-in customer or laundrer at the physical counter, admins can create accounts without requiring an email or password, keeping the reception queue moving quickly.

​
Customer (Cliente)

Customers are the only role permitted to create reservations and self-service purchase orders from the Customer Portal. When a customer signs up independently online, the system checks whether their national ID (cédula) was already entered by an admin. If a match is found, their name, phone, and vehicle data are auto-populated — they only need to supply an email and password to activate their login credentials.

​
Laundrer (Lavador / Operario)

Laundrers have no login credentials and no access to any frontend interface. Their role is purely operational: they are assigned to service orders to track individual productivity and calculate commission payouts. Their isWorkingToday flag determines shift availability, which the system resets automatically at midnight via a scheduled cron job.
Because laundrers have no login, they never occupy a seat in the frontend authentication flow. Registration takes seconds from the admin panel — just a name, ID number, and phone.

​
Multi-Currency Engine

All prices, sales, and balances are stored in US Dollars (USD) as the canonical currency. Bolívar (BsS) amounts are derived at transaction time using the official exchange rates, which the system fetches automatically every morning at 6:00 AM from dolarapi (ve.dolarapi.com). Both the USD/BsS and EUR/BsS rates are retrieved in a single parallel fetch. The AutoLavado configuration record tracks both balanceUsd and balanceBs, as well as currentTasaBs (USD/BsS) and currentTasaEurBs (EUR/BsS) for flexible billing. Payments can be split across multiple methods and currencies within a single transaction.

​
Technology Stack

SCO Autolavados is built on a modern, production-ready stack with full TypeScript coverage across both tiers. Backend
  • Runtime: Node.js with TypeScript (v5.7.3)
  • Framework: Express.js v4
  • ORM: Prisma ORM v7 with @prisma/adapter-pg
  • Database: PostgreSQL 15
  • Auth: jsonwebtoken (JWT) + bcryptjs for password hashing
  • Scheduler: node-cron for automated daily tasks
  • Utilities: dayjs (timezone-aware date handling), multer (file uploads), morgan (HTTP logging)
Frontend
  • Framework: React 19 + Vite 8
  • UI Library: Ant Design v6 + @ant-design/icons
  • Routing: React Router v7
  • Charts: Recharts v3
  • Styling: Tailwind CSS v4
  • HTTP Client: Axios
Infrastructure: Docker & Docker Compose — the entire stack (database, API, and frontend) runs as isolated containers orchestrated from a single docker-compose.yml.

Build docs developers (and LLMs) love

Get started for freeTalk to us