Concepts¶
This section gives short, concept-first explanations of the key modelling ideas in dirac-odoo.
Each page is written for someone who has not read the ADRs yet. Start here, then follow the links to the formal decision records when you need the full rationale.
Pages¶
| Concept | One-line summary | Start here |
|---|---|---|
| Fleet | How to group serialized items into stable operational collections — and why stock.location is not enough |
Fleet concept |
| Placeholder: V3 Association Model | How governance relationships are modelled as explicit association records instead of stamping fields onto native Odoo objects | — |
| Placeholder: SA Governance Layers | The three-layer refinement (V1 → V2 → V3) and when each applies | — |
| Placeholder: Actor Subset Rule | Why actor scope must always be a subset of SA scope | — |
How to use this section¶
- Read the concept page that matches your current question.
- If the concept page raises new questions, follow its "See also" links to the relevant ADR.
- If you are implementing code, also read the corresponding Active Design page for the current practical guidance.
Relationship to other doc sections¶
| If you want… | …go to… |
|---|---|
| a formal decision record | ADRs |
| current implementation guidance | Active Designs (top-level nav) |
| repo conventions and terminology | Reference |