Spare-Parts Pack

A vehicle master of makes, models, years, and engine variants, with part-to-vehicle fitment so the counter clerk can find the right part from the car in front of them. VIN lookup, serial-number capture, and warranty periods. Ships switched off until you enable it.

In this module
  • Vehicle master and part fitment
  • VIN lookup at the counter
  • Serial capture and reservation
  • Warranty period per part

An auto-parts counter has a search problem, not a stock problem. The customer describes a car, not a part number. This pack closes that gap.

What it switches on

  • A vehicle master: make, model, year, engine variant
  • Part fitment — which products fit which vehicles
  • VIN lookup that resolves a vehicle and suggests fitting parts
  • Serial-number capture and reservation, with a queue for serials still owed
  • Warranty period held per part
  • OEM and manufacturer part numbers on the product record

The pack ships in an inactive state. Switch it on from Settings when you are ready; nothing in the core changes when you do.

Module shape

How Spare-Parts Pack fits the rest of the system

Bounded

The module owns its tables and its service interface. Other modules reach in only through services and async events — never SQL.

Test-vector verified

Every domain rule has two implementations — Dart and Java — and a single shared test vector. CI fails on any divergence.

Audit-logged

Every command writes an entry to the append-only audit log with a chain hash. The daily verifier proves the log has not been tampered with.