How othoth77/idauto works
IDauto is a vehicle-identity and history reference implementation. The citizen-facing path captures a plate, resolves it to an identity (IVID), and presents a passport; the authenticated workspace supports manual registration, vehicle dossiers, owner contacts, interventions, parts, and workshop operations. Supporting layers normalize and resolve vehicle identifiers, persist records and evidence, and audit mutations. The README also describes ingestion/review and operator capabilities, but their runtime wiring is not shown here. Edges reflect sampled calls, indexed references, or explicit README statements; unsampled connections are omitted.
Main entry points: db.js PostgreSQL · vehicle-repository.js Vehicle repository · workspace-routes.js Workspace routes · writes.js Audited writes
Components 24
Citizen passport
- Plate scanner
web/citizen/plate-scanner.js - Passport pages
web/citizen/passport.js - Public API
reference/api.js
Workspace operations
- Workspace UI
reference/app-vehicles.js - Workspace routes
reference/workspace-routes.js - Manual registration
reference/workspace/registration-service.js - Workspace reads
reference/workspace/workspace-repository.js - Owner contacts
reference/workspace/owner-contacts.js - Interventions
reference/workspace/intervention-service.js
Vehicle identity
- Identification routes
reference/v12-routes.js - Vehicle resolver
reference/vehicle/vehicle-resolver.js - Plate normalizer
reference/vehicle/plate-normalizer.js - Vehicle repository
reference/vehicle/vehicle-repository.js - Workshop service
reference/workshop/workshop-vehicle-service.js - Parts catalogue
reference/parts/parts-catalog.js - Local parts
reference/parts/local-parts-catalog.js
Persistence and evidence
- Document service
reference/documents/document-service.js - Document records
reference/documents/document-repository.js - Media storage
reference/storage.js - Audited writes
reference/writes.js - PostgreSQL
reference/db.js - Community ingestion
reference/ingestion.js - Admin read model
reference/admin/admin-repository.js
Other components
- Citizen
Connections 33
- Citizen → Plate scanner: scans plate
README.md - Plate scanner → Public API: submits plate
- Public API → Passport pages: serves passport
README.md - Workspace UI → Workspace routes: uses API
- Workspace routes → Manual registration: registers vehicle
reference/workspace-routes.js - Workspace routes → Workspace reads: reads workspace
reference/workspace-routes.js - Workspace routes → Owner contacts: manages contacts
reference/workspace-routes.js - Workspace routes → Interventions: manages repairs
reference/workspace-routes.js - Manual registration → Vehicle repository: creates identity
reference/workspace/registration-service.js - Manual registration → Owner contacts: records owner
reference/workspace/registration-service.js - Manual registration → Audited writes: audits mutation
reference/workspace/registration-service.js - Identification routes → Vehicle resolver: resolves vehicle
reference/v12-routes.js - Identification routes → Parts catalogue: queries parts
reference/v12-routes.js - Identification routes → Workshop service: handles workshop
reference/v12-routes.js - Vehicle resolver → Plate normalizer: normalizes plate
reference/vehicle/vehicle-resolver.js - Vehicle resolver → Vehicle repository: looks up vehicle
reference/vehicle/vehicle-resolver.js - Workshop service → Vehicle repository: uses identity
reference/workshop/workshop-vehicle-service.js - Parts catalogue → Local parts: queries catalogue
reference/parts/parts-catalog.js - Document service → Document records: stores metadata
reference/documents/document-service.js - Document service → Media storage: stores media
reference/documents/document-service.js - Document records → PostgreSQL: reads and writes
reference/documents/document-repository.js - Vehicle repository → PostgreSQL: reads and writes
reference/vehicle/vehicle-repository.js - Vehicle repository → Audited writes: audits changes
reference/vehicle/vehicle-repository.js - Local parts → PostgreSQL: queries catalogue
reference/parts/local-parts-catalog.js - Local parts → Audited writes: audits changes
reference/parts/local-parts-catalog.js - Workspace reads → Vehicle repository: reads records
reference/workspace/workspace-repository.js - Workspace reads → PostgreSQL: queries workspace
reference/workspace/workspace-repository.js - Owner contacts → PostgreSQL: persists contacts
reference/workspace/owner-contacts.js - Interventions → Vehicle repository: uses vehicle
reference/workspace/intervention-service.js - Interventions → PostgreSQL: persists repairs
reference/workspace/intervention-service.js - Audited writes → PostgreSQL: commits audit
reference/writes.js - Audited writes → Media storage: cleans media
reference/writes.js - Admin read model → PostgreSQL: queries registry
reference/admin/admin-repository.js