One engine for sales, purchases and warehouse documents (ADR 0032). Each document
type now carries a kind that decides its family of tables, life cycle, effects,
accepted lines, the kinds it fulfils and its permissions, so company-defined types
work without code.
- Six families of header and line tables plus document_links; document_types gets
document_kind (seeded types filled by the migration and the Italian template),
document_numerators gets last_date.
- DocumentStateMachine with the order, invoice and simple life cycles and the
actions each state admits; issued invoices are immutable and are cancelled with
a reason only before the file reaches the exchange system.
- DocumentNumberingService numbers at confirmation inside the transaction under
the numerator lock (advisory lock on PostgreSQL, write lock on SQLite): no
duplicates, a rollback gives the number back, out-of-sequence dates refused on
gap-free numerators, the new year's numerator created on first use, gap report.
- DocumentEngine, the generic DocumentService<THeader, TLine> and
DocumentCopyService: save, confirm or issue, cancel, close, reopen, delete,
duplicate and transform; links are recorded at confirmation and removed at
cancellation, and FulfillmentCalculator recomputes quantities and states.
- Tests: rules in Core, concurrent numbering on SQLite and PostgreSQL (data tests,
run on PostgreSQL 18 locally), order to delivery notes to deferred invoice on a
real instance. Wiki (Vendite, Tabelle azienda), CHANGELOG, STATUS, DATA-MODEL.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>