Working Notes¶
This page indexes repo-local working notes that informed the current documentation set.
Use these notes as draft or source material, not as the final authority when an active design page or ADR already captures the decision.
Current Working Notes¶
| Note | Status | Current authoritative surface |
|---|---|---|
notes/association model for SA.md |
Source note for the V3 association-model decision |
ADR 0003 - V3 Association-Model Migration Pattern |
notes/odoo-model-extension-guideline-draft.md |
Earlier draft material for Odoo model-shaping guidance | Odoo Model Extension Strategy |
notes/PA_Asset_Governance_Prompt.md |
Earlier asset-governance exploration; parts are now superseded by V3 association guidance and the fleet/item ADR |
ADR 0004 - Fleet And Item Governance Layer and Odoo Model Extension Strategy |
notes/fleet-item-sa.md |
Source note for the fleet/item governance refinement | ADR 0004 - Fleet And Item Governance Layer |
notes/fleet-model-justification.md |
Developer-facing rationale for why fleet membership should remain distinct from physical location when the business grouping survives movement | ADR 0004 - Fleet And Item Governance Layer |
notes/record-assignment-ideas.md |
Exploratory assignment note that feeds later visibility guidance | Odoo Model Extension Strategy and ADR 0003 - V3 Association-Model Migration Pattern |
notes/visibility-regimes-and-crud-draft.md |
Working draft behind the visibility-regime section | Odoo Model Extension Strategy |
Imported Artifacts (2026-06-11)¶
The following deliverables from the live Odoo.SH instance audit were added to this repo:
| Artifact | Location | Description |
|---|---|---|
| Odoo Extension Architecture | docs/concepts/odoo-extension-architecture.md |
Architectural constitution for all Odoo extension work — graph model, SA associations, core principles |
| Implementation Scorecard | docs/reference/implementation-scorecard.md |
ADR compliance audit against live Odoo instance — 62 ov.* models, base model leakage found |
| HM POS Deployment Checklist | docs/reference/hm-pos-deployment-checklist.md |
POS retail setup for Oves Shenzhen (3 stores: Daiyun/Buji/Longhua) |
| Odoo.SH Summary Report | docs/reports/odoosh-summary-report.html |
Comprehensive project summary (11 chapters, Chart.js radar chart) |
| Serial Tracking Report | docs/reports/serial-tracking-report.html |
Serial/lot tracking across all companies |
| OVT Audit Report | docs/reports/audit-ovt-report.html |
Data quality audit for Oves Togo (French language) |
| Audit Scripts | scripts/audit/*.py |
7 Python XML-RPC scripts for SA FK verification, serial tracking, OVT audit, HM analysis, scorecard |
Guidance¶
- Prefer ADRs and active design pages when they conflict with a working note.
- Use working notes to recover design intent, source phrasing, and migration rationale.
- Promote a note into
docs/when it becomes durable enough to guide future implementation.