PaashERP — Stone Crusher ERP

A local-first, offline-first ERP for a stone crusher business unit in India. Built in Swift + SwiftUI for macOS 15+, with SQLite (GRDB) as a single-file database. Single admin user, no cloud, no auth, no server.

Status: MVP complete and hardening pass done. All core modules implemented: dashboard with live charts, production, GST sales & invoicing (PDF export), payments, purchases, stock with adjustments, reports with CSV export, and masters. 91 unit tests passing — schema/seeder invariants, formatting, invoice number sequences, backup/restore consistency, PDF/CSV exports, and a business-workflow suite that exercises production batches, GST invoice math (CGST/SGST/IGST), invoice numbering, stock deduction & reversal, invoice cancellation, payments, receivables aging, stock valuation, and the Reports KPIs end-to-end.

Recent hardening, all test-covered:

• Negative-stock guard — a sale, adjustment or batch shrink that would drive any product below zero is rejected up front with a clear message.
• Unified receivables — one ReceivablesCalculator (FIFO payment allocation) drives the dashboard, Customers, Sales and aged-Reports views.
• Consistent backups — exports go through SQLite's Online Backup API, so a snapshot is consistent even mid-write; restore validates the schema.
• Launch recovery — a failed DB open shows a blocking, retryable error screen instead of silently degrading.
• Off-main-actor I/O — every database read/write is async (GRDB @Sendable closures), so the UI never blocks on SQLite work.

---

Why PaashERP?

A crusher unit runs on: quarry royalty, plant production, truck dispatch, weighbridge slips, GST tax invoices, diesel/electricity bills, daily-wage labour and dozens of customers on credit. Most units still run this on Excel + a paper diary because every "cloud ERP" needs internet and training.

PaashERP is the opposite: a native macOS app that works fully offline, keeps every record in one local SQLite file, and gives the owner a single dashboard showing what was crushed, what was sold, what's in the yard, and who owes what — at a glance.

Features (MVP)

• 📊 Central dashboard — KPIs and live charts (Swift Charts)
• 🏭 Production — batches, shifts, machine hours, diesel, product-wise tonnes
• 🚚 Sales & dispatch — trucks, weighbridge net weight, GST tax invoices (CGST/SGST/IGST, HSN)
• 💰 Payments — cash / UPI / cheque / transfer, advances, receivables
• 🛒 Purchases & expenses — diesel, electricity, royalty, parts, labour, misc
• 🏗 Stock — stock-in/out, adjustments, wastage, stock statement & valuation
• 📋 Reports — daily production/sales, GST summary, receivables aging, mini P&L (CSV export)
• 💾 Local-first — single-file SQLite DB, one-click backup and validated restore
• 🛡 Guard rails — negative-stock prevention, credit-limit warnings, cancellation with stock reversal
• 🧮 Single source of truth — one InvoiceCalculator, one ReceivablesCalculator, integer-safe StockValuation
• 🎨 Uniform enterprise design system — one consistent theme across every screen

Roadmap

Phase	Scope	Status
P0	Project skeleton, DB schema + migrations, design system, app shell, demo data	✅ Done
P1	Masters — Products, Customers, Suppliers, Vehicles	✅ Done
P2	Production module	✅ Done
P3	Sales, GST invoicing, payments	✅ Done
P4	Purchases & expenses	✅ Done
P5	Stock & adjustments	✅ Done
P6	Dashboard & analytics (live KPIs + charts)	✅ Done
P7	Reports, mini P&L, PDF & CSV export	✅ Done
P8	Polish, backups & restore, tests, handover	✅ Verified — 91 tests green

Tech stack

• Language: Swift 6 (strict concurrency, Swift 6 language mode)
• UI: SwiftUI — NavigationSplitView, Swift Charts
• Persistence: SQLite via GRDB.swift with versioned migrations
• Concurrency: all database access is off the main actor (async GRDB @Sendable reads/writes) — the UI never blocks on SQLite
• Money: stored as paise (Int64), quantities stored as kilograms (Int64)
• Formatting: Indian digit grouping (₹1,23,456.00), tonnes with 2 decimals

Build & run

Requirements: Xcode 15+ on macOS 13+ (built against Xcode 27 / macOS 27).

Uses XcodeGen to generate the project (install with brew install xcodegen). The .xcodeproj is checked in for convenience but is fully reproducible from project.yml — regenerate it anytime with xcodegen generate.

brew install xcodegen
xcodegen generate          # creates PaashERP.xcodeproj
open PaashERP.xcodeproj    # ⇧⌘R to run

Or build from the command line:

xcodegen generate
xcodebuild -scheme PaashERP -configuration Debug build

SwiftPM quick start

For day-to-day development you can skip XcodeGen — Package.swift builds the same sources:

swift run      # build and launch the app
swift test     # run the test suite

This produces a bare executable without the sandbox entitlements and generated Info.plist, so shipping and CI builds still go through xcodegen generate && xcodebuild.

First launch

On first launch the app creates ~/Library/Application Support/PaashERP/ and seeds realistic demo data (≈30 days of a modelled crushing unit) so every screen is instantly demonstrable. Clear it anytime from System → Reset database to start fresh.

Project layout

Sources/
  App/          App entry point, app state, root shell
  DesignSystem/ Color/type tokens + reusable enterprise components
  Database/     GRDB store, migrations, demo seeder
  Models/       GRDB record types (one file per entity)
  Support/      Formatting (₹/tonnes), backup, helpers
  Views/        Dashboard, Production, Sales, Purchases, Stock, Masters, Reports
Tests/          XCTest unit tests (services, formatting)

Contributing

MIT-licensed and open source. Bug reports and feature requests via GitHub issues — see CONTRIBUTING.md. No auth, no cloud, no telemetry: keep it local-first and dependency-light.

License

MIT