# amantinband/clean-architecture architecture

> Architecture diagram of the GitHub repository amantinband/clean-architecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amantinband/clean-architecture
- Repository: https://github.com/amantinband/clean-architecture

## Overview

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: [`src/CleanArchitecture.Domain/Users/User.cs`](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Users/User.cs) (User Rules), [`src/CleanArchitecture.Api/Controllers/RemindersController.cs`](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/RemindersController.cs) (Reminder Routes), [`src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs`](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs) (EF Data Context), [`src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs`](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs) (Subscription Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_reminder_api["Reminder Routes"]
  node_subscription_api["Subscription Routes"]
  node_token_api["Token Route"]
  node_api_errors["API Error Mapping<br/>[ApiController.cs]"]
end

subgraph group_application["Application Use Cases"]
  node_reminder_cases["Reminder Use Cases"]
  node_reminder_queries["Reminder Queries"]
  node_subscription_cases["Subscription Use Cases"]
  node_subscription_query["Subscription Query"]
  node_token_case["Token Generation"]
  node_auth_behavior["Authorization Behavior"]
  node_validation_behavior["Validation Behavior"]
end

subgraph group_domain["Domain Model"]
  node_user_domain["User Rules<br/>[User.cs]"]
  node_reminder_domain["Reminder Entity<br/>[Reminder.cs]"]
  node_subscription_domain["Subscription Model<br/>[Subscription.cs]"]
  node_entity_events["Entity Events<br/>[Entity.cs]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_app_db[("EF Data Context<br/>[AppDbContext.cs]")]
  node_reminder_repo["Reminder Repository"]
  node_user_repo["User Repository<br/>[UsersRepository.cs]"]
  node_auth_service["Authorization Service"]
  node_policy_enforcer["Policy Enforcer<br/>[PolicyEnforcer.cs]"]
  node_current_user["Current User"]
  node_jwt_generator["JWT Generator"]
  node_event_middleware["Eventual Consistency"]
  node_email_worker["Reminder Email Worker"]
end

node_user(("API Client"))

node_user -->|"requests token"| node_token_api
node_user -->|"manages plan"| node_subscription_api
node_user -->|"manages reminders"| node_reminder_api
node_reminder_api -->|"dispatches commands"| node_reminder_cases
node_reminder_api -->|"dispatches queries"| node_reminder_queries
node_subscription_api -->|"dispatches commands"| node_subscription_cases
node_subscription_api -->|"dispatches query"| node_subscription_query
node_token_api -->|"dispatches query"| node_token_case
node_reminder_cases -.->|"applies rules"| node_user_domain
node_subscription_cases -.->|"applies rules"| node_user_domain
node_reminder_queries -->|"reads reminders"| node_reminder_repo
node_subscription_query -->|"reads user"| node_user_repo
node_reminder_repo -->|"uses context"| node_app_db
node_user_repo -->|"uses context"| node_app_db
node_user_domain -->|"tracks reminders"| node_reminder_domain
node_user_domain -->|"owns subscription"| node_subscription_domain
node_user_domain -->|"records events"| node_entity_events
node_auth_behavior -.->|"authorizes request"| node_auth_service
node_auth_service -->|"gets identity"| node_current_user
node_auth_service -->|"checks policies"| node_policy_enforcer
node_token_case -->|"creates token"| node_jwt_generator
node_app_db -->|"queues events"| node_event_middleware
node_email_worker -->|"reads reminders"| node_app_db
node_api_errors -.->|"maps errors"| node_reminder_api

click node_reminder_api "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/RemindersController.cs"
click node_subscription_api "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs"
click node_token_api "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/TokensController.cs"
click node_api_errors "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/ApiController.cs"
click node_reminder_cases "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Reminders/Commands/SetReminder/SetReminderCommandHandler.cs"
click node_reminder_queries "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs"
click node_subscription_cases "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Subscriptions/Commands/CreateSubscription/CreateSubscriptionCommandHandler.cs"
click node_subscription_query "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs"
click node_token_case "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs"
click node_auth_behavior "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Common/Behaviors/AuthorizationBehavior.cs"
click node_validation_behavior "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Common/Behaviors/ValidationBehavior.cs"
click node_user_domain "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Users/User.cs"
click node_reminder_domain "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Reminders/Reminder.cs"
click node_subscription_domain "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Users/Subscription.cs"
click node_entity_events "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Common/Entity.cs"
click node_app_db "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs"
click node_reminder_repo "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs"
click node_user_repo "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs"
click node_auth_service "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs"
click node_policy_enforcer "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/PolicyEnforcer/PolicyEnforcer.cs"
click node_current_user "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/CurrentUserProvider/CurrentUserProvider.cs"
click node_jwt_generator "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/TokenGenerator/JwtTokenGenerator.cs"
click node_event_middleware "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Common/Middleware/EventualConsistencyMiddleware.cs"
click node_email_worker "https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reminder_api,node_subscription_api,node_token_api,node_api_errors,node_user toneBlue
class node_reminder_cases,node_reminder_queries,node_subscription_cases,node_subscription_query,node_token_case,node_auth_behavior,node_validation_behavior toneAmber
class node_user_domain,node_reminder_domain,node_subscription_domain,node_entity_events toneMint
class node_app_db,node_reminder_repo,node_user_repo,node_auth_service,node_policy_enforcer,node_current_user,node_jwt_generator,node_event_middleware,node_email_worker toneRose
```

## Components

### HTTP API

- [Reminder Routes](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/RemindersController.cs): `src/CleanArchitecture.Api/Controllers/RemindersController.cs`
- [Subscription Routes](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs): `src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs`
- [Token Route](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/TokensController.cs): `src/CleanArchitecture.Api/Controllers/TokensController.cs`
- [API Error Mapping](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Api/Controllers/ApiController.cs): `src/CleanArchitecture.Api/Controllers/ApiController.cs`

### Application Use Cases

- [Reminder Use Cases](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Reminders/Commands/SetReminder/SetReminderCommandHandler.cs): `src/CleanArchitecture.Application/Reminders/Commands/SetReminder/SetReminderCommandHandler.cs`
- [Reminder Queries](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs): `src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs`
- [Subscription Use Cases](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Subscriptions/Commands/CreateSubscription/CreateSubscriptionCommandHandler.cs): `src/CleanArchitecture.Application/Subscriptions/Commands/CreateSubscription/CreateSubscriptionCommandHandler.cs`
- [Subscription Query](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs): `src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs`
- [Token Generation](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs): `src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs`
- [Authorization Behavior](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Common/Behaviors/AuthorizationBehavior.cs): `src/CleanArchitecture.Application/Common/Behaviors/AuthorizationBehavior.cs`
- [Validation Behavior](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Application/Common/Behaviors/ValidationBehavior.cs): `src/CleanArchitecture.Application/Common/Behaviors/ValidationBehavior.cs`

### Domain Model

- [User Rules](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Users/User.cs): `src/CleanArchitecture.Domain/Users/User.cs`
- [Reminder Entity](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Reminders/Reminder.cs): `src/CleanArchitecture.Domain/Reminders/Reminder.cs`
- [Subscription Model](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Users/Subscription.cs): `src/CleanArchitecture.Domain/Users/Subscription.cs`
- [Entity Events](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Domain/Common/Entity.cs): `src/CleanArchitecture.Domain/Common/Entity.cs`

### Infrastructure

- [EF Data Context](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs): `src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs`
- [Reminder Repository](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs): `src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs`
- [User Repository](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs): `src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs`
- [Authorization Service](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs): `src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs`
- [Policy Enforcer](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/PolicyEnforcer/PolicyEnforcer.cs): `src/CleanArchitecture.Infrastructure/Security/PolicyEnforcer/PolicyEnforcer.cs`
- [Current User](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/CurrentUserProvider/CurrentUserProvider.cs): `src/CleanArchitecture.Infrastructure/Security/CurrentUserProvider/CurrentUserProvider.cs`
- [JWT Generator](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Security/TokenGenerator/JwtTokenGenerator.cs): `src/CleanArchitecture.Infrastructure/Security/TokenGenerator/JwtTokenGenerator.cs`
- [Eventual Consistency](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Common/Middleware/EventualConsistencyMiddleware.cs): `src/CleanArchitecture.Infrastructure/Common/Middleware/EventualConsistencyMiddleware.cs`
- [Reminder Email Worker](https://github.com/amantinband/clean-architecture/blob/main/src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs): `src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs`

### Other components

- **API Client**

## Connections

- API Client → Token Route: requests token (evidence: `README.md`)
- API Client → Subscription Routes: manages plan (evidence: `README.md`)
- API Client → Reminder Routes: manages reminders (evidence: `README.md`)
- Reminder Routes → Reminder Use Cases: dispatches commands (evidence: `src/CleanArchitecture.Api/Controllers/RemindersController.cs`)
- Reminder Routes → Reminder Queries: dispatches queries (evidence: `src/CleanArchitecture.Api/Controllers/RemindersController.cs`)
- Subscription Routes → Subscription Use Cases: dispatches commands (evidence: `src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs`)
- Subscription Routes → Subscription Query: dispatches query (evidence: `src/CleanArchitecture.Api/Controllers/SubscriptionsController.cs`)
- Token Route → Token Generation: dispatches query (evidence: `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 (evidence: `src/CleanArchitecture.Application/Reminders/Queries/GetReminder/GetReminderQueryHandler.cs`)
- Subscription Query → User Repository: reads user (evidence: `src/CleanArchitecture.Application/Subscriptions/Queries/GetSubscription/GetSubscriptionQueryHandler.cs`)
- Reminder Repository → EF Data Context: uses context (evidence: `src/CleanArchitecture.Infrastructure/Reminders/Persistence/RemindersRepository.cs`)
- User Repository → EF Data Context: uses context (evidence: `src/CleanArchitecture.Infrastructure/Users/Persistence/UsersRepository.cs`)
- User Rules → Reminder Entity: tracks reminders (evidence: `src/CleanArchitecture.Domain/Users/User.cs`)
- User Rules → Subscription Model: owns subscription (evidence: `src/CleanArchitecture.Domain/Users/User.cs`)
- User Rules → Entity Events: records events (evidence: `src/CleanArchitecture.Domain/Users/User.cs`)
- Authorization Behavior → Authorization Service: authorizes request
- Authorization Service → Current User: gets identity (evidence: `src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs`)
- Authorization Service → Policy Enforcer: checks policies (evidence: `src/CleanArchitecture.Infrastructure/Security/AuthorizationService.cs`)
- Token Generation → JWT Generator: creates token (evidence: `src/CleanArchitecture.Application/Tokens/Queries/Generate/GenerateTokenQueryHandler.cs`)
- EF Data Context → Eventual Consistency: queues events (evidence: `src/CleanArchitecture.Infrastructure/Common/Persistence/AppDbContext.cs`)
- Reminder Email Worker → EF Data Context: reads reminders (evidence: `src/CleanArchitecture.Infrastructure/Reminders/BackgroundServices/ReminderEmailBackgroundService.cs`)
- API Error Mapping → Reminder Routes: maps errors (evidence: `src/CleanArchitecture.Api/Controllers/RemindersController.cs`)
