Struct AccountingModule 

pub struct AccountingModule { /* private fields */ }

Accounting module configuration

Use the builder pattern to configure and register this module:

let accounting = AccountingModule::builder()
    .with_database(pool.clone())
    .build()?;

// Unguarded full CRUD (trusted/admin); compose a guarded router for production.
let router = accounting.all_crud_routes();

Implementations

impl AccountingModule

pub fn builder() -> AccountingModuleBuilder

Create a new module builder

pub fn all_crud_routes(&self) -> Router

Mount ALL generated CRUD endpoints (12 per entity) with NO domain validation — the fully unguarded surface. A well-formed request can create invalid rows or soft-delete a referenced master out from under its dependents. Prefer a guarded composition (read + validated writes) for any real deployment; use this only in trusted/admin/seeding contexts.

pub fn routes(&self) -> Router

👎Deprecated:

mounts unvalidated generic CRUD; prefer readonly_routes() + validated writes, or all_crud_routes() for the full/unguarded surface

Deprecated alias for Self::all_crud_routes. routes() reads like “the routes” but mounts UNVALIDATED generic CRUD on every entity — a naive mount exposes unguarded writes. Compose a guarded router (read + validated writes) for production, or call all_crud_routes() to opt into the full unguarded surface explicitly.

pub fn readonly_routes(&self) -> Router

Read-only routes for every entity (GET endpoints only) — the safe base.

Generic mutation can’t reach here, so this surface cannot bypass a validated write service’s invariants. Use this as the production base and merge validated write routes (or a write service’s HTTP layer) onto it.

pub fn budget_control(&self) -> Option<Arc<dyn BudgetControlPort>>

The registered budget-control port, if any — the single registration a host threads into every PostingService it builds from this module (.with_budget_control_if_set(m.budget_control())), so the HTTP posting verb, the journal workflow, and the period close all consult the same control.

pub fn reporting_service(&self) -> Arc<ReportingService>

The on-the-fly financial reports (Trial Balance tree, Balance Sheet, Income Statement, General Ledger, Partner Ledger, Aged AR/AP). Read-only; scoped reads.

pub fn reconcile_write_service(&self) -> Arc<ReconcileWriteService>

The reconciliation write service — the ONLY sanctioned writer of the reconciliation graph (guards + CLAMP + side-effecting unlink). The graph tables carry no CRUD surface anywhere; guarded_routes mounts its verb routes.

pub fn reconcile_write_service_with_exchange_account( &self, exchange_account_id: Uuid, ) -> Arc<ReconcileWriteService>

Build a reconcile write service with the FX (exchange-difference) account configured. Without one, any rate divergence that demands an exchange move fails closed (exchange_account_unconfigured) — normal single-currency posts never generate one, so the default service is complete for them.

pub fn chart_install_service(&self) -> Arc<ChartInstallService>

The chart install engine — validates, gates, and writes a registered chart dataset into the accounts, idempotently. The install VERB itself is host-mounted (it orchestrates beyond this module); this handle is the engine the host verb drives.

pub fn check_printing_service(&self) -> Arc<CheckPrintingService>

The check printing surface — sequence registration, atomic number allocation, the printed-check registry, and voids. guarded_routes mounts its verb routes; there is no CRUD path to these tables.

pub fn emv_qr_service(&self) -> Arc<EmvQrService>

The EMV(QRCPS)/QRIS display surface — merchant QR configuration and the invoice payload render (payloads are built on demand, never stored).

pub fn tax_tag_repair_service(&self) -> Arc<TaxTagRepairService>

The tax-tag legal-change repair verb (reason mandatory, locked periods refused, closed periods overridden explicitly, every run audit-stamped) plus its audit-ledger read.