Neatoo Framework Skill
Description
Neatoo is a Domain-Driven Design (DDD) framework for .NET that simplifies building business applications with Blazor WebAssembly and WPF. It combines two core repositories:
- Neatoo Core: DDD framework with entities, rules, validation, and Roslyn source generators
- Neatoo.RemoteFactory: Client-server communication layer enabling shared domain models
When to Use This Skill
Use this skill when:
- Building domain entities with EntityBase or ValidateBase classes
- Implementing business rules and validation logic
- Creating factory classes with [Factory] attribute
- Setting up client-server communication with RemoteFactory
- Working with aggregates and parent-child entity relationships
- Implementing data mapping between domain and persistence entities
- Building Blazor UI components with MudNeatoo
- Configuring authorization for factory operations
- Troubleshooting Neatoo source generator issues
Reference Files
| File | Topics | |------|--------| | best-practices.md | Interface-first design, factory pattern, save patterns | | entities.md | EntityBase, ValidateBase, Value Objects, property patterns | | aggregates.md | Aggregate roots, entity graphs, parent-child, complete examples | | rules.md | Rules engine, data annotations, custom rules, async validation | | factories.md | Create/Fetch/Save operations, Commands & Queries | | client-server.md | RemoteFactory setup, server/client configuration | | properties.md | Meta-properties, INotifyPropertyChanged, dirty tracking | | data-mapping.md | MapFrom, MapTo, MapModifiedTo patterns | | testing.md | Unit testing patterns for rules | | authorization.md | [Authorize] attribute, role-based access | | blazor-integration.md | MudBlazor binding, validation display | | source-generators.md | What gets generated, troubleshooting | | migration.md | Version upgrade patterns | | pitfalls.md | Common mistakes and anti-patterns (see best-practices.md for correct patterns) |
Repository References
| Repository | Purpose | |------------|---------| | NeatooDotNet/Neatoo | Core DDD framework | | NeatooDotNet/RemoteFactory | Client-server communication |