# jose-angell/approvalflow architecture

> Architecture diagram of the GitHub repository jose-angell/approvalflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jose-angell/approvalflow
- Repository: https://github.com/jose-angell/approvalflow

## Overview

ApprovalFlow is a .NET application organized around user administration and a domain model for departmental purchase approvals. The visible user workflow is represented by an application use case: validate and resolve user data, hash passwords when needed, apply domain rules, persist changes, and return DTOs. Purchase requests have a rich domain lifecycle, but no request-management use case or API endpoint is shown. The README only names the product; links and capabilities beyond the sampled source and source index remain unverified.

Main entry points: [`ApprovalFlow.Application/Users/UserUseCase.cs`](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Users/UserUseCase.cs) (User administration), [`ApprovalFlow.Domain/Entities/User.cs`](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/User.cs) (User rules), [`ApprovalFlow.Domain/Entities/PurchaseRequest.cs`](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/PurchaseRequest.cs) (Purchase lifecycle), [`ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs`](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs) (EF Core context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and errors"]
  node_program["Application startup<br/>[Program.cs]"]
  node_error_handler["Exception handler"]
end

subgraph group_application["Application services"]
  node_user_use_case["User administration<br/>[UserUseCase.cs]"]
  node_user_contract["User use-case contract<br/>[IUserUseCase.cs]"]
  node_user_dtos["User DTOs<br/>[Dtos]"]
  node_db_contract["Application DB contract"]
  node_exceptions["Application exceptions<br/>[Exceptions]"]
end

subgraph group_domain["Domain model"]
  node_domain_user["User rules<br/>[User.cs]"]
  node_department["Department rules<br/>[Department.cs]"]
  node_purchase_request["Purchase lifecycle<br/>[PurchaseRequest.cs]"]
  node_user_roles["User roles<br/>[UserRole.cs]"]
  node_request_status["Request statuses"]
end

subgraph group_infrastructure["Persistence and security"]
  node_db_context["EF Core context<br/>[AppDbContext.cs]"]
  node_database[("Relational database")]
  node_password_hasher["Password hashing<br/>[PasswordHasher.cs]"]
end

node_client(("API client"))

node_program -->|"registers"| node_error_handler
node_user_use_case -->|"queries and saves"| node_db_contract
node_user_use_case -->|"hashes passwords"| node_password_hasher
node_user_use_case -->|"creates and updates"| node_domain_user
node_user_use_case -->|"resolves department"| node_department
node_user_use_case -->|"maps results"| node_user_dtos
node_user_use_case -->|"throws errors"| node_exceptions
node_user_use_case -->|"implements"| node_user_contract
node_db_context -->|"implements"| node_db_contract
node_db_context -.->|"reads and writes"| node_database
node_domain_user -->|"checks department"| node_department
node_purchase_request -->|"checks participants"| node_domain_user
node_purchase_request -->|"changes status"| node_request_status
node_purchase_request -->|"checks roles"| node_user_roles
node_domain_user -->|"validates role"| node_user_roles
node_error_handler -->|"maps exceptions"| node_exceptions
node_client -.->|"sends requests"| node_program

click node_program "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow/Program.cs"
click node_error_handler "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow/Middleware/GlobalExceptionHandler.cs"
click node_user_use_case "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Users/UserUseCase.cs"
click node_user_contract "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Abstractions/UseCases/IUserUseCase.cs"
click node_user_dtos "https://github.com/jose-angell/approvalflow/tree/master/ApprovalFlow.Application/Users/Dtos"
click node_db_contract "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Abstractions/IApplicationDbContext.cs"
click node_domain_user "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/User.cs"
click node_department "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/Department.cs"
click node_purchase_request "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/PurchaseRequest.cs"
click node_user_roles "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Enums/UserRole.cs"
click node_request_status "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Enums/PurchaseRequestStatus.cs"
click node_db_context "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs"
click node_password_hasher "https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Infrastructure/Security/PasswordHasher.cs"
click node_exceptions "https://github.com/jose-angell/approvalflow/tree/master/ApprovalFlow.Application/Exceptions"

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_program,node_error_handler,node_client toneBlue
class node_user_use_case,node_user_contract,node_user_dtos,node_db_contract,node_exceptions toneAmber
class node_domain_user,node_department,node_purchase_request,node_user_roles,node_request_status toneMint
class node_db_context,node_database,node_password_hasher toneRose
```

## Components

### API and errors

- [Application startup](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow/Program.cs): `ApprovalFlow/Program.cs`
- [Exception handler](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow/Middleware/GlobalExceptionHandler.cs): `ApprovalFlow/Middleware/GlobalExceptionHandler.cs`

### Application services

- [User administration](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Users/UserUseCase.cs): `ApprovalFlow.Application/Users/UserUseCase.cs`
- [User use-case contract](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Abstractions/UseCases/IUserUseCase.cs): `ApprovalFlow.Application/Abstractions/UseCases/IUserUseCase.cs`
- [User DTOs](https://github.com/jose-angell/approvalflow/tree/master/ApprovalFlow.Application/Users/Dtos): `ApprovalFlow.Application/Users/Dtos`
- [Application DB contract](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Application/Abstractions/IApplicationDbContext.cs): `ApprovalFlow.Application/Abstractions/IApplicationDbContext.cs`
- [Application exceptions](https://github.com/jose-angell/approvalflow/tree/master/ApprovalFlow.Application/Exceptions): `ApprovalFlow.Application/Exceptions`

### Domain model

- [User rules](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/User.cs): `ApprovalFlow.Domain/Entities/User.cs`
- [Department rules](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/Department.cs): `ApprovalFlow.Domain/Entities/Department.cs`
- [Purchase lifecycle](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Entities/PurchaseRequest.cs): `ApprovalFlow.Domain/Entities/PurchaseRequest.cs`
- [User roles](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Enums/UserRole.cs): `ApprovalFlow.Domain/Enums/UserRole.cs`
- [Request statuses](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Domain/Enums/PurchaseRequestStatus.cs): `ApprovalFlow.Domain/Enums/PurchaseRequestStatus.cs`

### Persistence and security

- [EF Core context](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs): `ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs`
- **Relational database**
- [Password hashing](https://github.com/jose-angell/approvalflow/blob/master/ApprovalFlow.Infrastructure/Security/PasswordHasher.cs): `ApprovalFlow.Infrastructure/Security/PasswordHasher.cs`

### Other components

- **API client**

## Connections

- Application startup → Exception handler: registers (evidence: `ApprovalFlow/Program.cs`)
- User administration → Application DB contract: queries and saves (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → Password hashing: hashes passwords (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → User rules: creates and updates (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → Department rules: resolves department (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → User DTOs: maps results (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → Application exceptions: throws errors (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- User administration → User use-case contract: implements (evidence: `ApprovalFlow.Application/Users/UserUseCase.cs`)
- EF Core context → Application DB contract: implements (evidence: `ApprovalFlow.Infrastructure/Persistence/AppDbContext.cs`)
- EF Core context → Relational database: reads and writes
- User rules → Department rules: checks department (evidence: `ApprovalFlow.Domain/Entities/User.cs`)
- Purchase lifecycle → User rules: checks participants (evidence: `ApprovalFlow.Domain/Entities/PurchaseRequest.cs`)
- Purchase lifecycle → Request statuses: changes status (evidence: `ApprovalFlow.Domain/Entities/PurchaseRequest.cs`)
- Purchase lifecycle → User roles: checks roles (evidence: `ApprovalFlow.Domain/Entities/PurchaseRequest.cs`)
- User rules → User roles: validates role (evidence: `ApprovalFlow.Domain/Entities/User.cs`)
- Exception handler → Application exceptions: maps exceptions (evidence: `ApprovalFlow/Middleware/GlobalExceptionHandler.cs`)
- API client → Application startup: sends requests
