How amantinband/clean-architecture works
This repository is a .NET reminder-service template. Users generate a token, create a subscription, then manage reminders through HTTP endpoints; subscription type governs reminder limits. The API dispatches requests to application use cases, which apply domain rules and persistence abstractions. The product also includes authorization, domain-event handling with eventual consistency, and background reminder email. The README documents the principal capabilities; source excerpts show selected dispatch, domain, persistence, authorization, and email behavior, but not every use-case implementation or service registration.
Main entry points: User.cs User Rules · RemindersController.cs Reminder Routes · AppDbContext.cs EF Data Context · SubscriptionsController.cs Subscription Routes
Components 25
HTTP API
- Reminder Routes
src/CleanArchitecture.Api/Controllers/RemindersController.cs - Subscription Routes
src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs - Token Route
src/CleanArchitecture.Api/Controllers/TokensController.cs - API Error Mapping
src/CleanArchitecture.Api/Controllers/ApiController.cs
Application Use Cases
- Reminder Use Cases
src/CleanArchitecture.Application/Reminders/Commands/SetReminder/SetReminderCommandHandler.cs - Reminder Queries
src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs - Subscription Use Cases
src/CleanArchitecture.Application/Subscriptions/Commands/CreateSubscription/CreateSubscriptionCommandHandler.cs - Subscription Query
src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs - Token Generation
src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs - Authorization Behavior
src/CleanArchitecture.Application/Common/Behaviors/AuthorizationBehavior.cs - Validation Behavior
src/CleanArchitecture.Application/Common/Behaviors/ValidationBehavior.cs
Domain Model
- User Rules
src/CleanArchitecture.Domain/Users/User.cs - Reminder Entity
src/CleanArchitecture.Domain/Reminders/Reminder.cs - Subscription Model
src/CleanArchitecture.Domain/Users/Subscription.cs - Entity Events
src/CleanArchitecture.Domain/Common/Entity.cs
Infrastructure
- EF Data Context
src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs - Reminder Repository
src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs - User Repository
src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs - Authorization Service
src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs - Policy Enforcer
src/CleanArchitecture.Infrastructure/Security/PolicyEnforcer/PolicyEnforcer.cs - Current User
src/CleanArchitecture.Infrastructure/Security/CurrentUserProvider/CurrentUserProvider.cs - JWT Generator
src/CleanArchitecture.Infrastructure/Security/TokenGenerator/JwtTokenGenerator.cs - Eventual Consistency
src/CleanArchitecture.Infrastructure/Common/Middleware/EventualConsistencyMiddleware.cs - Reminder Email Worker
src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs
Other components
- API Client
Connections 24
- API Client → Token Route: requests token
README.md - API Client → Subscription Routes: manages plan
README.md - API Client → Reminder Routes: manages reminders
README.md - Reminder Routes → Reminder Use Cases: dispatches commands
src/CleanArchitecture.Api/Controllers/RemindersController.cs - Reminder Routes → Reminder Queries: dispatches queries
src/CleanArchitecture.Api/Controllers/RemindersController.cs - Subscription Routes → Subscription Use Cases: dispatches commands
src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs - Subscription Routes → Subscription Query: dispatches query
src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs - Token Route → Token Generation: dispatches query
src/CleanArchitecture.Api/Controllers/TokensController.cs - Reminder Use Cases → User Rules: applies rules
- Subscription Use Cases → User Rules: applies rules
- Reminder Queries → Reminder Repository: reads reminders
src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs - Subscription Query → User Repository: reads user
src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs - Reminder Repository → EF Data Context: uses context
src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs - User Repository → EF Data Context: uses context
src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs - User Rules → Reminder Entity: tracks reminders
src/CleanArchitecture.Domain/Users/User.cs - User Rules → Subscription Model: owns subscription
src/CleanArchitecture.Domain/Users/User.cs - User Rules → Entity Events: records events
src/CleanArchitecture.Domain/Users/User.cs - Authorization Behavior → Authorization Service: authorizes request
- Authorization Service → Current User: gets identity
src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs - Authorization Service → Policy Enforcer: checks policies
src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs - Token Generation → JWT Generator: creates token
src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs - EF Data Context → Eventual Consistency: queues events
src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs - Reminder Email Worker → EF Data Context: reads reminders
src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs - API Error Mapping → Reminder Routes: maps errors
src/CleanArchitecture.Api/Controllers/RemindersController.cs