docs: document Avalonia ReactiveUI demo blueprint

[luckydizzier]

Summary

• add a dedicated demo blueprint describing the Avalonia + ReactiveUI showcase for xBase .NET
• outline architecture, components, workflows, testing strategy, and milestones for the desktop demo solution

Testing

• not run (documentation-only change)

---

https://chatgpt.com/codex/tasks/task_e_68dd817be6e88322a1905fb47da0e673

Summary by CodeRabbit

• Documentation
  • Added a comprehensive blueprint for an xBase .NET Demo Solution using Avalonia 11 and ReactiveUI. Covers objectives/scope, architecture, component responsibilities, workflows (catalog discovery, online DDL, index rebuild, CRUD, import/recovery), data model mappings, configuration profiles, UX/resilience, diagnostics/telemetry, build/release, testing strategy, sample assets, milestones, risks, and next steps. Includes sequence diagrams and a suggested folder structure to guide implementation and evaluation.

[coderabbitai]

Walkthrough

Adds a new documentation blueprint describing an Avalonia 11 + ReactiveUI xBase .NET demo solution, covering architecture, components, workflows, data model mappings, configuration, diagnostics/telemetry, testing, release tracks, risks, and milestones, including multiple Mermaid diagrams and proposed folder structure.

Changes

Cohort / File(s)	Summary
Documentation: Demo Plan docs/demo/avalonia-reactiveui-demo-plan.md	New comprehensive plan outlining objectives, architecture, solution layout, workflows (catalog scanning, online DDL, index rebuild, CRUD, journaling), entities/indexing, configs, diagnostics/telemetry, testing strategy, sample assets, milestones, risks, and next steps; includes Mermaid sequence diagrams and commands/events list.

Sequence Diagram(s)

sequenceDiagram
    autonumber
    actor User
    participant UI as Avalonia UI
    participant VM as ReactiveUI ViewModels
    participant SVC as Services (Catalog, DDL, Index, Data)
    participant DB as xBase Engine
    participant TEL as Telemetry/Diagnostics

    User->>UI: Initiate operation (scan/CRUD/index)
    UI->>VM: Command binding triggers
    VM->>SVC: Invoke service method (async)
    SVC->>TEL: Emit start event
    SVC->>DB: Execute operation
    DB-->>SVC: Result/stream of progress
    SVC->>TEL: Progress/metrics/logs
    SVC-->>VM: Success/Error with data
    VM-->>UI: Update state/notifications
    UI-->>User: Render results/alerts

    rect rgb(240,248,255)
    note over SVC,DB: Changed/defined workflows per plan (catalog scan, online DDL, side-by-side index rebuild)
    end

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A rabbit sketched a demo’s map, so bright,
With Avalonia windows, ReactiveUI in sight.
Indices rebuild while queries hop,
Telemetry nibbling every stop.
Catalogs burrow, DDL takes flight—
A blueprint garden, ready to ignite. 🥕✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check	✅ Passed	The title “docs: document Avalonia ReactiveUI demo blueprint” succinctly conveys that the pull request adds documentation for an Avalonia and ReactiveUI demonstration blueprint. It follows conventional “docs:” prefixing, focuses on the primary change, and is clear and specific enough for teammates to understand the intent at a glance. There is no extraneous detail or vague wording, making it an appropriate summary of the changeset.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch codex/2025-10-01_19-35-19_build-xbase-avalonia-reactiveui-demo

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Copilot]

Pull Request Overview

This PR adds comprehensive documentation for an Avalonia + ReactiveUI demo blueprint that will showcase xBase .NET Phase A capabilities through a cross-platform desktop application.

Key changes include:

• Complete architectural blueprint with component diagrams and interaction flows
• Detailed functional scenarios covering schema management, indexing, and data operations
• Testing strategy and milestone planning for the demo implementation

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

docs/demo/avalonia-reactiveui-demo-plan.md (1)

44-56: Add a language hint to this fenced code block.

markdownlint/MD040 flags this block because it lacks a language qualifier. Adding one (e.g., text) keeps the docs lint-clean.

-```
+```text
 xBase.Demo/
 ...
-```
+```

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4480556 and 83c7a87.

📒 Files selected for processing (1)

• docs/demo/avalonia-reactiveui-demo-plan.md (1 hunks)

🧰 Additional context used

📓 Path-based instructions (1)

docs/**

📄 CodeRabbit inference engine (AGENTS.md)

Keep reference documentation under docs/

Files:

• docs/demo/avalonia-reactiveui-demo-plan.md

🪛 markdownlint-cli2 (0.18.1)

docs/demo/avalonia-reactiveui-demo-plan.md

44-44: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: build-test (windows-latest)