31 lines
2.3 KiB
Markdown
31 lines
2.3 KiB
Markdown
# AyCode.Blazor — Domain Rules
|
|
|
|
> This is the **single source of truth** for Blazor/MAUI UI domain rules. Do not duplicate these elsewhere.
|
|
> For core framework rules see: `../AyCode.Core/.github/copilot-instructions.md`
|
|
> For detailed docs see: `README.md` → `docs/`
|
|
|
|
## DevExpress Components
|
|
1. **DevExpress Blazor 25.1.3** — always use `DxGrid`, `DxFormLayout`, etc. Do NOT mix with generic Blazor component libraries.
|
|
2. **Grid system** uses `AcSignalRDataSource` for real-time data — grids fetch data via SignalR, not REST.
|
|
3. **CardView components** wrap DevExpress grids with card-style layout for mobile-friendly display.
|
|
|
|
## Architecture
|
|
4. **Blazor.Components** is the main UI library — both Blazor Server and MAUI Hybrid consume it.
|
|
5. **Blazor.Models** = shared view models (client + server). **Blazor.Models.Server** = server-only scaffolding.
|
|
6. **MAUI.Core** targets Android (API 33+), iOS (15.0+), Windows (10.0.19041+) via platform folders.
|
|
7. **Controllers** project is scaffolding — do not add business logic here.
|
|
|
|
## Serialization in UI
|
|
8. SignalR uses **AcBinaryHubProtocol** (custom binary) — not the default JSON protocol.
|
|
9. Grid filters use **AcExpressionNode** serialization — LINQ expressions are serialized and sent to server.
|
|
|
|
## Related Solutions
|
|
14. **AyCode.Core** solution (`../AyCode.Core/AyCode.Core.sln`) contains all core framework code (SignalR, serialization, data sources, base classes, interfaces). When a type is referenced in this Blazor solution but not defined here (e.g. `AcSignalRDataSource`, `AcBinaryHubProtocol`, `IId<TId>`, `AcObservableCollection`, `AcLoggerBase`), look it up in AyCode.Core source.
|
|
15. For AyCode.Core domain rules see: `../AyCode.Core/.github/copilot-instructions.md`
|
|
|
|
## Conventions
|
|
10. Do not suggest removal/rollback as a solution — find a fix for the problem.
|
|
11. All DLL references to AyCode.Core projects are via `DllReference` (not ProjectReference) — this is intentional.
|
|
12. **No redundant code** — before writing new logic, search for existing methods. Reuse or extract shared logic into smaller methods rather than duplicating.
|
|
13. **Keep all .md files in sync** — when you modify code, update any affected .md file (README.md, docs/, GLOSSARY, ARCHITECTURE, CONVENTIONS, etc.). If you notice any .md content does not match the current code, fix it automatically.
|