How oca/account-financial-tools works
1. What this repository is
- This is an OCA Odoo 18.0 addon monorepo, not a single application.
- The runtime architecture is “Odoo core + many independent accounting extensions,” each delivered as a separate installable module.
2. Top-level architecture
- Every addon follows the same Odoo package boundary: __manifest__.py, Python models, XML views, security rules, optional wizards, optional reports, optional scheduled jobs, tests, and translations.
- There is no shared internal service layer across addons; coupling happens mainly through Odoo model inheritance and standard accounting records.
3. Primary integration point: Odoo accounting models
- Most modules extend core accounting entities such as account.move, account.move.line, account.journal, account.account, account.asset*, res.company, and res.partner.
- That means the architecture revolves around modifying posting, numbering, locking, reporting, and asset/depreciation behavior rather than introducing new standalone domains.
4. Asset-management subsystem
- Several addons cluster around fixed assets:
- account_asset_management is the main asset lifecycle module.
- account_asset_compute_batch, account_asset_force_account, account_asset_low_value, account_asset_number, and account_asset_transfer each add a focused capability around compute, account assignment, low-value treatment, numbering, or transfer workflows.
- Typical flow: asset records are created/updated from accounting data, then wizards or cron jobs generate depreciation/reclassification entries back into journal entries.
5. Accounting period and lock-date subsystem
- Modules like account_fiscal_year, account_fiscal_year_auto_create, account_fiscal_month, account_journal_lock_date, account_lock_date_update, account_lock_to_date, and account_journal_restrict_mode govern time boundaries and edit restrictions.
- These modules alter company/journal configuration and posting validation, ensuring certain periods or journals cannot be modified once locked.
6. Move numbering, sequencing, and chronology
- account_move_name_sequence, account_journal_general_sequence, account_sequence_option, and account_invoice_constraint_chronology control how journal entries and invoices are numbered and ordered.
- The data flow is usually: journal/move configuration → sequence selection/renumbering → posting constraints that reject gaps or out-of-order entries.
7. Spreads, accruals, loans, and deferred recognition
- account_spread_cost_revenue, account_loan, and related wizards automate multi-period accounting flows.
- They create scheduled accounting entries over time, often driven by cron jobs, so the main boundary is between a business document and the recurring journal entries it generates.
8. Cash, checks, netting, and reconciliation-related workflows
- account_cash_deposit, account_check_deposit, account_netting, and purchase_unreconciled manage operational accounting processes around deposits, compensation/netting, and unreconciled purchase items.
- These modules typically add dedicated transactional records plus wizards/reports that transform operational inputs into accounting moves.
9. Reporting and dashboard extensions
- account_dashboard_banner and account_dashboard_banner_mis_builder extend the accounting dashboard with custom KPIs/banners.
- account_asset_management and account_asset_number also include reporting/XLS artifacts.
- These are UI/reporting layers on top of accounting data, not separate data stores.
10. Validation and data-enrichment extensions
- account_fiscal_position_vat_check, account_partner_required, account_maturity_date_default, account_move_fiscal_year, account_move_post_date_user, account_move_line_tax_editable, account_move_line_purchase_info, account_move_line_sale_info, and product_category_tax add validation rules or defaulting logic to core accounting documents.
- The common pattern is “hook into create/write/post/validate on Odoo records” to enrich or constrain transaction data.
11. Administrative UI and wizards
- Many modules expose configuration views and one-off wizards under views/ and wizard/ or wizards/.
- These are the user-facing entry points for operations that would otherwise be too complex for direct form editing: updating lock dates, computing assets, generating loan entries, running chart updates, transferring assets, and so on.
12. Background processing
- Several addons use data/cron.xml or similar scheduled actions.
- This indicates asynchronous accounting maintenance: batch depreciation, auto fiscal-year creation, spread posting, and other recurring jobs are triggered server-side rather than by user interaction.
13. Security and access boundaries
- Each addon defines its own security/*.xml and ir.model.access.csv where needed.
- This is important architecturally because many modules expose wizard models or sensitive accounting configuration; access control is modular and per-addon.
14. Repository-level tooling and delivery
- The repo is packaged for OCA/Odoo distribution with pyproject.toml, requirements.txt, setup metadata, and extensive CI via GitHub Actions.
- Quality gates include pre-commit, linting, tests, translation files, and documentation generation; these do not affect runtime architecture but define the maintenance and release pipeline.
15. How to draw the architecture
- Show Odoo core accounting as the central platform.
- Around it, group addons by concern: assets, fiscal periods/locks, move numbering, deferred/loan accounting, deposits/netting, reporting/dashboard, and validation/enrichment.
- Use arrows from addon wizards/cron jobs into core accounting moves and configuration models, since most modules read/modify standard Odoo records rather than communicating with each other directly.
Main entry points: account_asset_management Asset mgmt · account_move_name_sequence Move sequence · account_fiscal_year Fiscal year · account_journal_lock_date Journal lock
Components 34
Odoo accounting
Core accounting models and configuration that most addons extend.
- Accounting core · Central Odoo accounting boundary: moves, lines, journals, accounts, partners, companies, assets.
Assets
Fixed-asset lifecycle and depreciation extensions.
- Asset mgmt · Main fixed-asset lifecycle module.
account_asset_management - Batch compute · Batch asset depreciation computation.
account_asset_compute_batch - Force account · Overrides asset/account assignment behavior.
account_asset_force_account - Low value · Low-value asset handling and removal workflow.
account_asset_low_value - Asset numbers · Asset numbering and related reporting.
account_asset_number - Asset transfer · Asset transfer wizard and posting flow.
account_asset_transfer
Periods & locks
Fiscal period and edit-lock boundaries.
- Fiscal year · Fiscal-year definitions and company settings.
account_fiscal_year - Auto create · Scheduled creation of future fiscal years.
account_fiscal_year_auto_create - Fiscal month · Monthly fiscal date ranges.
account_fiscal_month - Journal lock · Journal-specific lock dates and restrictions.
account_journal_lock_date - Lock update · Wizard for updating accounting lock dates.
account_lock_date_update - Lock to date · Lock exceptions and date-based posting restrictions.
account_lock_to_date - Restrict mode · Journal edit restriction mode.
account_journal_restrict_mode
Numbering
Move numbering, sequencing, and chronology rules.
- Move sequence · Journal entry naming and sequencing.
account_move_name_sequence - General seq · General-journal numbering and renumbering.
account_journal_general_sequence - Seq options · Sequence configuration options for accounting moves.
account_sequence_option - Chronology · Invoice/date chronology constraints.
account_invoice_constraint_chronology
Deferred flows
Spreading, loans, and other multi-period recognition flows.
- Spread & revenue · Recurring spread recognition for costs and revenue.
account_spread_cost_revenue - Loans · Loan schedules and recurring loan entries.
account_loan
Operational accounting
Cash, checks, netting, and unreconciled purchase workflows.
- Cash deposit · Cash-deposit workflow and cash-unit setup.
account_cash_deposit - Check deposit · Check-deposit workflow and deposit reporting.
account_check_deposit - Netting · Accounting netting and compensation entries.
account_netting - Unreconciled PO · Purchase-side unreconciled item handling.
purchase_unreconciled
Validation
Defaulting and validation hooks on core accounting records.
- VAT check · Fiscal-position VAT validation.
account_fiscal_position_vat_check - Partner required · Partner requirement enforcement on accounting lines.
account_partner_required - Maturity default · Default maturity-date logic.
account_maturity_date_default - Move FY · Fiscal-year metadata on moves and lines.
account_move_fiscal_year - Post user · Tracks who set the posting date.
account_move_post_date_user - Tax editable · Editable tax behavior on move lines.
account_move_line_tax_editable
UI & reports
Dashboard, printing, and administrative UI/reporting extensions.
- Chart update · Chart-template update tooling.
account_chart_update - Dashboard banner · Accounting dashboard KPI/banner extension.
account_dashboard_banner - MIS banner · Dashboard banner backed by MIS Builder data.
account_dashboard_banner_mis_builder - Move print · Journal-entry print/report output.
account_move_print
Connections 33
- Asset mgmt → Accounting core: extends · Adds asset lifecycle behavior on top of accounting records.
- Batch compute → Asset mgmt: batch compute · Triggers depreciation computation for asset records.
- Force account → Asset mgmt: force accounts · Overrides asset account selection.
- Low value → Asset mgmt: low-value rules · Adds low-value treatment and removal logic.
- Asset numbers → Asset mgmt: numbering · Adds asset numbering and reporting.
- Asset transfer → Asset mgmt: transfer · Moves assets through transfer workflows.
- Fiscal year → Accounting core: period setup · Defines fiscal periods used by accounting postings.
- Auto create → Fiscal year: cron create · Automatically creates future fiscal years.
- Fiscal month → Fiscal year: monthly ranges · Refines fiscal periods into months.
- Journal lock → Accounting core: journal locks · Constrains posting/editing by journal lock date.
- Lock update → Journal lock: update locks · Wizard for changing lock dates.
- Lock to date → Accounting core: date locks · Adds date-based lock exceptions and checks.
- Restrict mode → Accounting core: restrict mode · Tightens journal edit and posting permissions.
- Move sequence → Accounting core: move names · Controls journal entry numbering.
- General seq → Move sequence: renumber · General-journal numbering and renumbering flow.
- Seq options → Move sequence: sequence options · Configures move numbering behavior.
- Chronology → Move sequence: chronology guard · Rejects out-of-order invoice numbering/posting.
- Spread & revenue → Accounting core: spread entries · Generates recurring accounting entries over time.
- Loans → Accounting core: loan entries · Creates scheduled loan journal entries.
- Cash deposit → Accounting core: cash moves · Turns cash orders into accounting records.
- Check deposit → Accounting core: check moves · Turns check deposits into accounting records.
- Netting → Accounting core: netting entries · Creates compensation or netting moves.
- Unreconciled PO → Accounting core: unreconciled items · Bridges purchase operations to unreconciled accounting lines.
- Chart update → Accounting core: chart config · Updates chart-template and company accounting setup.
- Dashboard banner → Accounting core: dashboard · Reads accounting data for dashboard banners.
- MIS banner → Dashboard banner: banner data · Feeds dashboard banners from MIS Builder KPIs.
- Move print → Accounting core: reports · Formats journal-entry output for printing.
- VAT check → Accounting core: validate · Validates VAT/fiscal-position consistency.
- Partner required → Accounting core: require partner · Enforces partner presence on accounting records.
- Maturity default → Accounting core: default maturity · Adds maturity-date defaults to moves/lines.
- Move FY → Accounting core: fiscal year · Annotates moves with fiscal-year context.
- Post user → Accounting core: post audit · Records who set posting dates.
- Tax editable → Accounting core: tax editing · Makes move-line taxes editable.