Debian
38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
---
|
|
name: nexus-clean-architecture
|
|
description: Clean Architecture & CQRS implementation for .NET 10 with Blazor Hybrid
|
|
---
|
|
# Clean Architecture Standards
|
|
|
|
- **Project Structure (Layered):**
|
|
- `NexusReader.Domain`: Enterprise business rules (Entities, Value Objects, Domain Events).
|
|
- `NexusReader.Application`: Application business rules (Commands, Queries, DTOs, Mappings, Interfaces).
|
|
- `NexusReader.Infrastructure`: Data access, external services, and platform-specific implementations.
|
|
- `NexusReader.UI.Shared`: UI logic and Blazor components.
|
|
- `NexusReader.Maui` / `NexusReader.Web`: Platform host projects.
|
|
|
|
- **CQRS & Messaging:**
|
|
- **MediatR**: Use standard `MediatR` for decoupling.
|
|
- **Queries**: Read-only operations, return `Task<Result<T>>`.
|
|
- **Commands**: State-changing operations, return `Task<Result>` or `Task<Result<T>>`.
|
|
- **Handlers**: Located in `Application` layer, grouped by feature (e.g., `Queries/Reader/...`).
|
|
|
|
- **Functional Error Handling:**
|
|
- Mandatory use of `FluentResults`.
|
|
- No exceptions for business logic flow. Handlers must return `Result.Ok()` or `Result.Fail()`.
|
|
|
|
- **UI Architecture (Atomic Design):**
|
|
- Components in `NexusReader.UI.Shared` must follow Atomic Design:
|
|
- `Atoms`: Smallest functional units (Buttons, Inputs).
|
|
- `Molecules`: Groups of atoms (Search Bar, Form Field).
|
|
- `Organisms`: Complex UI sections (Navigation, Header).
|
|
- `Pages`: Composed organisms forming a full view.
|
|
|
|
- **Object Mapping:**
|
|
- Use `Mapster` for all DTO/Entity mappings.
|
|
- Centralize configuration in `NexusReader.Application/Mappings/MappingConfig.cs`.
|
|
- No `AutoMapper` allowed.
|
|
|
|
- **Cross-Platform Strategy:**
|
|
- Maximize code sharing in `NexusReader.UI.Shared`.
|
|
- Use `IPlatformService` (or similar abstractions) for native features, implemented in `Infrastructure.Mobile` or Maui projects. |