Case study · Dealer management platform

AlMiraj Dealers

A dealer management platform for automobile dealerships — bike sales, parts, workshop jobs and reports in one secure system. Runs as a web app or a Windows desktop app, with one install per dealership.

Dealer Management PlatformAutomobilesWebDesktop

The problem

Paper Deeds.
Lost Parts. Leaky Margins.

A busy motorcycle dealership runs on registers, spreadsheets and memory. Deeds are hand-written, nobody knows which rack a part is on, stock runs out without warning, and buying prices are visible to anyone at the counter. AlMiraj Dealers puts sales, stock, workshop and costs into one system with the right access for every person in the shop.

What it does

Every Module.
One Dealership.

Each module was built, tested and shipped in turn, and they all share one database, one login and one set of roles.

Module 1

Bike sales & sale deeds

  • Bike stock with filters and a guarded sell flow: a bike can only be sold once
  • Sales register with invoice numbers like INV-2026-00001 and search
  • Print-ready HTML deed plus PDF sale deeds (customer and dealership copies)
Module 1

Customer management

  • Customer records with CNIC search
  • Pakistani mobile validation (03XX or +92) normalised to one format
  • Separate workshop customer list for maintenance jobs
Module 2

Inventory

  • Parts with unique codes, categories, units and minimum thresholds
  • Stock in and stock out with reasons; stock can never go below zero
  • Low-stock and out-of-stock alerts on the dashboard and inventory list
  • Movement audit trail with user, time, before/after and CSV export
  • Rack locations such as RACK-A-01, with part-code auto-suggest search
Module 3

Spare parts catalog

  • Compatibility by make, model, variant, years and chassis prefix
  • Find the right parts for a bike by chassis number or model
  • Minimum sell price enforced on catalog prices and stock-out sales, with an owner-only override
  • Barcode and QR scanner lookup, plus printable Code128 / QR labels
  • Receipt scanning: upload, OCR (when Tesseract is installed) or manual entry, preview, then approve or reject
Module 4

Tools & equipment

  • Workshop asset register with service intervals and bays
  • Automatic depreciation and wear-out, service-due and fully-depreciated alerts
  • Service log, retire and restore, depreciation report with CSV
Module 5

Workshop maintenance

  • Daily workshop jobs with reusable job templates
  • Staff assignment and a workload view per mechanic
  • Customer-facing job invoice PDFs, Excel import and export

Counter sales

  • Fast walk-up parts sales, separate from workshop jobs
  • Edit, cancel and invoice PDF per sale
  • Counter sales reports

Dealer purchase orders

  • Upload OEM dealer rate lists from Excel
  • Build draft order forms from the rate list
  • Export the order as an Excel workbook

Roles & security

The Right Access.
For Every Role.

Four roles, hashed passwords and price visibility based on role. Buying prices and profit are hidden from everyone except the owner, and even the owner has to unlock them with a separate passkey.

Owner

Full access, including the cost book, which unlocks only with a separate passkey.

Admin

Runs sales, inventory, catalog, receipts and reports. Buying costs stay hidden.

Inventory manager

Full inventory, catalog and tools access, with no access to sales or finance pages.

Sales rep

Sells bikes and views stock read-only. Never sees buying prices or profit.

  • Werkzeug-hashed passwords, with no plain text stored
  • Cost fields are stripped from what sales reps can see or submit
  • Desktop build licensed to the shop’s own laptop
  • Automatic local backups, with the last 14 kept

Reports

Numbers You Can
Act On Today.

From a single day to a full quarter: pick a date range and get a summary, then take it to your accountant as CSV or Excel.

Sales reports

Date-range summaries with daily and monthly breakdowns, exported to CSV.

Stock movement history

Filter every stock movement by part, type and date, then export to CSV.

Workshop & tools

Maintenance reports and Excel exports, staff workload, and tool depreciation with CSV.

Counter sales

Counter sales reporting alongside the dealership-wide dashboard.

Tech stack

Lean Stack.
Built to Last.

A layered Flask app (routes, services, domain rules) with a pytest suite that covers every module. All the money calculations sit in plain, testable functions.

PythonFlask 3SQLAlchemyFlask-LoginSQLiteReportLab PDFCode128 & QR (python-barcode, segno)openpyxl ExcelPillowTesseract OCR (optional)pytest

Deployment

Web or Desktop.
Same Shop.

Web

Web app

  • Flask web application, opened in any browser
  • Schema upgrades run on startup without data loss, with a backup first
  • One codebase for every module
Windows

Desktop app

  • Dealership.exe runs the same shop locally on the shop laptop
  • Tray icon with Open shop, Backup now and data folders
  • Automatic backups, plus one-click updates through Update.exe

Coming soon

Cloud SaaS edition (multi-business, monthly plans)Phone-camera scanningPDF receipt OCRThermal label printersLow-stock email / SMSSale edit audit log

Let’s talk

Run a Dealership?
Get Your Own Platform.

Tell us how your shop works. We’ll reply within 24 hours with a plan that actually ships.