A self-hosted web ERP for a commercial heat-treating shop — built to run in parallel with, and eventually replace, Visual Shop (Cornerstone Systems, Inc.).
Status: Phase 1 (Foundation), Phase 2A (reference data) and Phase 2B (customers) complete and merged to main — login, owner-configurable roles & permissions, full audit trail, typed settings, admin pages, app shell, Docker packaging with fail-loud nightly backups, GL accounts/materials/inspection/process step codes and other reference data, and customers with addresses and contacts. 258 integration tests. The Prisma 7 upgrade is in progress on a branch; Phase 2C (parts) is next.
Continuing this project on a new machine or in a fresh session? Start at
docs/HANDOFF.md— it is the portable project memory: decisions, conventions, backlog, Fedora setup, and the Phase 2 kickoff prompt.
| Path | What it is |
|---|---|
erp/ |
The application — Next.js 15 + Prisma 7 + PostgreSQL. See erp/README.md for dev setup and production deployment |
docs/superpowers/specs/ |
The approved design specification (the contract for what gets built) |
docs/superpowers/plans/ |
The 8-phase build roadmap and per-phase implementation plans |
docs/2026-07-29-crossref-findings.md |
Cross-reference of the two Visual Shop reference documents |
Visual-Shop-ERP-Reference-Report.md |
Teardown of Visual Shop compiled from the vendor knowledge base (design reference) |
- Foundation — auth, permissions, audit, settings, shell ✅
- Master data — customers, parts, process steps & process step codes, reference tables
- Orders & loads — order entry, auto load-split, order board, traveler PDF
- Certs & shipping — certifications, shippers, MOS, BOL
- Invoicing & A/R — pricing, surcharges, finance charges, QuickBooks Online export
- Quoting
- Template designer — self-service document layouts (traveler, certs, invoices…)
- Reports & parallel-run tools
Full roadmap: docs/superpowers/plans/2026-07-29-roadmap.md.
- Visual Shop remains the system of record until a full parallel-run month closes clean (spec §13).
- No scheduling, no shop-floor tracking, no equipment integration — deliberate scope decisions, see spec §3.
- Every mutation is audited; deletes are soft; permissions are enforced server-side.