# anasalshmiri/yuraani-1 architecture

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

- Interactive diagram: https://gitdiagram.com/anasalshmiri/yuraani-1
- Repository: https://github.com/anasalshmiri/yuraani-1

## Overview

Yuraani is a home medical-care platform built around an ASP.NET Core API, CQRS application handlers, domain rules, and EF Core persistence. The visible workflow covers account registration, dual-channel verification, login/session management, and a separate professional-approval workflow. README capabilities for care requests, appointments, care execution, records, treatment, ratings, and AI are represented, but their implementation details and connections are not shown in the sampled source, so those links are omitted.

Main entry points: [`src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs`](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs) (Account and session handlers), [`src/Yuraani.API/Controllers/AuthController.cs`](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.API/Controllers/AuthController.cs) (HTTP API), [`src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs`](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs) (Submission and review), [`src/Yuraani.Domain/CareExecution/CareEncounter.cs`](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/CareEncounter.cs) (Home and video care)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and clients"]
  node_api["HTTP API<br/>[AuthController.cs]"]
  node_web["MVC client<br/>[Program.cs]"]
end

subgraph group_identity["Identity and access"]
  node_authflow["Account and session handlers"]
  node_authrepo["Authentication repository<br/>[AuthRepository.cs]"]
  node_tokens["JWT token service"]
  node_identitymodel["Account and session rules<br/>[UserAccount.cs]"]
  node_database[("SQL data store")]
end

subgraph group_approval["Professional approval"]
  node_approvalapi["Approval endpoints"]
  node_approvalhandlers["Submission and review"]
  node_approvalrepo["Approval repository"]
  node_approvalmodel["Approval aggregate"]
  node_admin["Administration<br/>[Administrator.cs]"]
end

subgraph group_care["Care services"]
  node_care_requests["Care requests and assignment<br/>[CareRequest.cs]"]
  node_appointments["Appointments<br/>[Appointment.cs]"]
  node_execution["Home and video care<br/>[CareEncounter.cs]"]
  node_records["Patient medical records<br/>[MedicalRecord.cs]"]
  node_treatment["Treatment and follow-up<br/>[TreatmentPlan.cs]"]
  node_ratings["Service ratings<br/>[ServiceRating.cs]"]
  node_ai["AI integration"]
end

node_users(("Patients and professionals"))

node_users -->|"uses"| node_api
node_web -->|"calls over HTTP"| node_api
node_api -->|"dispatches commands"| node_authflow
node_authflow -->|"uses repository"| node_authrepo
node_authflow -->|"issues tokens"| node_tokens
node_authflow -->|"applies account rules"| node_identitymodel
node_authrepo -->|"reads and writes"| node_database
node_api -->|"dispatches requests"| node_approvalhandlers
node_approvalhandlers -->|"uses repository"| node_approvalrepo
node_approvalhandlers -->|"submits and decides"| node_approvalmodel
node_approvalrepo -->|"reads and writes"| node_database
node_users -.->|"requests care"| node_care_requests
node_care_requests -.->|"schedules"| node_appointments
node_appointments -.->|"initiates care"| node_execution
node_execution -.->|"documents care"| node_records
node_execution -.->|"supports follow-up"| node_treatment
node_users -.->|"rates service"| node_ratings
node_ai -.->|"assists care"| node_care_requests
node_admin -.->|"reviews submissions"| node_approvalhandlers

click node_api "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.API/Controllers/AuthController.cs"
click node_web "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Web/Program.cs"
click node_authflow "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs"
click node_authrepo "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Identity/AuthRepository.cs"
click node_tokens "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Identity/JwtAuthTokenService.cs"
click node_identitymodel "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/Identity/UserAccount.cs"
click node_database "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Persistence/YuraaniDbContext.cs"
click node_approvalapi "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.API/Controllers/ProfessionalApprovalController.cs"
click node_approvalhandlers "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs"
click node_approvalrepo "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/ProfessionalApproval/ProfessionalApprovalRepository.cs"
click node_approvalmodel "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/ProfessionalApproval/ProfessionalApproval.cs"
click node_care_requests "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareRequests/CareRequest.cs"
click node_appointments "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareRequests/Appointment.cs"
click node_execution "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/CareEncounter.cs"
click node_records "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/Patients/MedicalRecord.cs"
click node_treatment "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/TreatmentPlan.cs"
click node_ratings "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/ServiceRating.cs"
click node_admin "https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/ProfessionalApproval/Administrator.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_api,node_web toneBlue
class node_authflow,node_authrepo,node_tokens,node_identitymodel,node_database toneAmber
class node_approvalapi,node_approvalhandlers,node_approvalrepo,node_approvalmodel,node_admin toneMint
class node_care_requests,node_appointments,node_execution,node_records,node_treatment,node_ratings,node_ai toneRose
class node_users toneIndigo
```

## Components

### API and clients

- [HTTP API](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.API/Controllers/AuthController.cs): `src/Yuraani.API/Controllers/AuthController.cs`
- [MVC client](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Web/Program.cs): `src/Yuraani.Web/Program.cs`

### Identity and access

- [Account and session handlers](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs): `src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs`
- [Authentication repository](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Identity/AuthRepository.cs): `src/Yuraani.Infrastructure/Identity/AuthRepository.cs`
- [JWT token service](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Identity/JwtAuthTokenService.cs): `src/Yuraani.Infrastructure/Identity/JwtAuthTokenService.cs`
- [Account and session rules](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/Identity/UserAccount.cs): `src/Yuraani.Domain/Identity/UserAccount.cs`
- [SQL data store](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/Persistence/YuraaniDbContext.cs): `src/Yuraani.Infrastructure/Persistence/YuraaniDbContext.cs`

### Professional approval

- [Approval endpoints](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.API/Controllers/ProfessionalApprovalController.cs): `src/Yuraani.API/Controllers/ProfessionalApprovalController.cs`
- [Submission and review](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs): `src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs`
- [Approval repository](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Infrastructure/ProfessionalApproval/ProfessionalApprovalRepository.cs): `src/Yuraani.Infrastructure/ProfessionalApproval/ProfessionalApprovalRepository.cs`
- [Approval aggregate](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/ProfessionalApproval/ProfessionalApproval.cs): `src/Yuraani.Domain/ProfessionalApproval/ProfessionalApproval.cs`
- [Administration](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/ProfessionalApproval/Administrator.cs): `src/Yuraani.Domain/ProfessionalApproval/Administrator.cs`

### Care services

- [Care requests and assignment](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareRequests/CareRequest.cs): `src/Yuraani.Domain/CareRequests/CareRequest.cs`
- [Appointments](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareRequests/Appointment.cs): `src/Yuraani.Domain/CareRequests/Appointment.cs`
- [Home and video care](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/CareEncounter.cs): `src/Yuraani.Domain/CareExecution/CareEncounter.cs`
- [Patient medical records](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/Patients/MedicalRecord.cs): `src/Yuraani.Domain/Patients/MedicalRecord.cs`
- [Treatment and follow-up](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/TreatmentPlan.cs): `src/Yuraani.Domain/CareExecution/TreatmentPlan.cs`
- [Service ratings](https://github.com/anasalshmiri/yuraani-1/blob/main/src/Yuraani.Domain/CareExecution/ServiceRating.cs): `src/Yuraani.Domain/CareExecution/ServiceRating.cs`
- **AI integration**

### Other components

- **Patients and professionals**

## Connections

- Patients and professionals → HTTP API: uses (evidence: `README.md`)
- MVC client → HTTP API: calls over HTTP (evidence: `README.md`)
- HTTP API → Account and session handlers: dispatches commands (evidence: `src/Yuraani.API/Controllers/AuthController.cs`)
- Account and session handlers → Authentication repository: uses repository (evidence: `src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs`)
- Account and session handlers → JWT token service: issues tokens
- Account and session handlers → Account and session rules: applies account rules (evidence: `src/Yuraani.Application/Features/Identity/Auth/Commands/RegisterAccount/RegisterAccountHandler.cs`)
- Authentication repository → SQL data store: reads and writes (evidence: `src/Yuraani.Infrastructure/Identity/AuthRepository.cs`)
- HTTP API → Submission and review: dispatches requests
- Submission and review → Approval repository: uses repository (evidence: `src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs`)
- Submission and review → Approval aggregate: submits and decides (evidence: `src/Yuraani.Application/Features/ProfessionalApproval/Commands/SubmitProfessionalApproval/SubmitProfessionalApprovalHandler.cs`)
- Approval repository → SQL data store: reads and writes (evidence: `src/Yuraani.Infrastructure/ProfessionalApproval/ProfessionalApprovalRepository.cs`)
- Patients and professionals → Care requests and assignment: requests care (evidence: `README.md`)
- Care requests and assignment → Appointments: schedules
- Appointments → Home and video care: initiates care
- Home and video care → Patient medical records: documents care
- Home and video care → Treatment and follow-up: supports follow-up (evidence: `README.md`)
- Patients and professionals → Service ratings: rates service (evidence: `README.md`)
- AI integration → Care requests and assignment: assists care
- Administration → Submission and review: reviews submissions (evidence: `README.md`)
