Architecture Decision Records

2026-04-30

This folder holds progressive architecture decisions for dirac-odoo.

Use numbered ADR files such as 0001-title.md, 0002-title.md, and so on.

Current ADRs

• 0001 - V1 SA Construction Model
• 0002 - ov.* Model Namespace And Semantic Independence
• 0003 - V3 Association-Model Migration Pattern

Current Focus

For current implementation work, start with 0003 - V3 Association-Model Migration Pattern.

That ADR now carries the repo's durable guidance for:

• two-layer SA and actor association design
• strict subset-rule enforcement
• externalized governance overlays over native Odoo classes
• the default rule that native class x should not be modified merely because SA scope exists
• engineering rationale and query-efficiency expectations for sparse association tables