docs(fusion_accounting_assets): CLAUDE.md, UPGRADE_NOTES.md, README.md

Mirrors Phase 1 + 2 doc layout. CLAUDE.md captures architecture, the
7-method engine API, persisted models, controllers, OWL frontend,
performance baselines (Tasks 23 + 41 numbers), test counts (140), and
Phase 3.5 backlog. UPGRADE_NOTES.md anchors the Odoo 19 reference and
records V19 deprecations applied. README.md is the user-facing intro.

Made-with: Cursor

fusion_accounting_assets/README.md

@@ -0,0 +1,53 @@
+# fusion_accounting_assets
+
+AI-augmented fixed asset management for Odoo 19 Community — a
+Fusion-native replacement for Enterprise's `account_asset` module.
+
+## What it does
+
+- Three depreciation methods: straight-line, declining balance, and
+  units-of-production
+- Asset lifecycle state machine: draft → running → paused → disposed
+- Editable depreciation board with full schedule recompute
+- Disposal flow (sale, scrap, donation) plus partial-sale wizard
+- Daily cron for posting periodic depreciation
+- AI augmentation:
+  - **Anomaly detection** — variance vs expected schedule, low utilization
+  - **Useful-life suggestion** — LLM-driven from invoice context, with a
+    keyword-based templated fallback so the feature still works offline
+- Coexists with Enterprise `account_asset` (Enterprise wins by default;
+  the Fusion menu only appears when Enterprise is uninstalled)
+- Migration-aware: bootstrap step backfills `fusion.asset` from existing
+  `account.asset` rows so the AI has memory from day 1
+
+## Quick start
+
+```bash
+# Install
+odoo --addons-path=... -i fusion_accounting_assets
+
+# Open the dashboard (when Enterprise's account_asset is NOT installed)
+# Apps -> Asset Management -> Assets
+
+# When Enterprise IS installed: use Enterprise's UI; the engine + AI tools
+# are still available via the AI chat.
+```
+
+## Configuration
+
+- Local LLM (LM Studio, Ollama):
+  - `fusion_accounting.openai_base_url` =
+    `http://host.docker.internal:1234/v1`
+  - `fusion_accounting.openai_model` = your local model name
+  - `fusion_accounting.openai_api_key` = `lm-studio` (anything non-empty)
+  - `fusion_accounting.provider.asset_useful_life` = `openai`
+
+## Public API (engine)
+
+`fusion.asset.engine` is the single write surface. See `CLAUDE.md` for
+the full 7-method signature list.
+
+## See also
+
+- `CLAUDE.md` — agent context
+- `UPGRADE_NOTES.md` — Odoo version anchoring