Refactor docs: topic folders, TOON, XCUT, protocol sync - Migrated all topic documentation into dedicated folders with canonical `README.md`, `ISSUES.md`, and `TODO.md` per topic (e.g., `LOGGING/`, `SIGNALR/`, `BINARY/`, `TOON/`). - Added comprehensive TOON serializer documentation: design, format, options, attributes, inference, issues, and TODOs. - Introduced `XCUT` folder for cross-cutting issues and TODOs, with canonical entries and topic cross-references. - Updated all references and navigation to use new folder-based doc paths; fixed links and clarified doc structure. - Enhanced AI agent protocol: enforce session skill preloading, `[LOADED_DOCS: ...]` short-name prefix, and mandatory `docs-check` skill for doc/code sync. - Updated `.csproj` to include all `README.md` files for IDE visibility. - Improved and clarified SignalR, grid, and project-level documentation. - Minor code/test tweaks and doc content corrections for consistency. |
||
|---|---|---|
| .github | ||
| AyCode.Blazor.Components | ||
| AyCode.Blazor.Components.Tests | ||
| AyCode.Blazor.Controllers | ||
| AyCode.Blazor.Models | ||
| AyCode.Blazor.Models.Server | ||
| AyCode.Maui.Core | ||
| docs | ||
| .gitignore | ||
| AyCode.Blazor.targets | ||
| AyCode.Maui.targets | ||
| AyCode.Project.targets | ||
| Aycode.Blazor.sln | ||
| CLAUDE.md | ||
| README.md | ||
README.md
AyCode.Blazor Solution
Blazor Server + MAUI Hybrid UI framework built on DevExpress 25.1.3 components. Targets net10.0 (AyCode.Project.targets). Provides reusable grids, card views, authentication, and SignalR-powered real-time data. Depends on AyCode.Core (net9.0) for serialization, entities, and services — referenced via DLL.
LLM Context
Domain rules and UI pitfalls live in a single file: .github/copilot-instructions.md
| Tool | Auto-loaded | Action needed |
|---|---|---|
| GitHub Copilot | ✅ copilot-instructions.md |
None |
| Claude Code | ✅ CLAUDE.md → references above |
None |
| Cursor / Windsurf | ✅ README.md |
Read copilot-instructions.md via @file |
Solution-level docs in docs/:
| Document | Topic |
|---|---|
GLOSSARY.md |
Blazor/MAUI terminology |
ARCHITECTURE.md |
Solution layers, dependency rules |
CONVENTIONS.md |
Coding conventions |
Project-level docs:
| Project | Documents |
|---|---|
AyCode.Blazor.Components/docs/ |
MGGRID/ — MgGrid system (grid base, toolbar, InfoPanel, layout, CRUD) |
Core framework rules: ../AyCode.Core/.github/copilot-instructions.md
Solution Structure
| Project | Purpose |
|---|---|
AyCode.Blazor.Components |
DevExpress UI components, grids, SignalR data sources, expression helpers |
AyCode.Blazor.Models |
Shared view models for Blazor components |
AyCode.Blazor.Models.Server |
Server-side model scaffolding |
AyCode.Blazor.Controllers |
Controller scaffolding (minimal) |
AyCode.Maui.Core |
MAUI cross-platform: Android, iOS, Windows |
Test Projects
| Project | Purpose |
|---|---|
AyCode.Blazor.Components.Tests |
Grid and component tests |