# edgarna95/chassoft architecture

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

- Interactive diagram: https://gitdiagram.com/edgarna95/chassoft
- Repository: https://github.com/edgarna95/chassoft

## Overview

Chassoft is a local-first management system for members, suppliers, and cash operations, with a Blazor web client, an ASP.NET API, and a retained WinForms supplier workflow. The main path is web user → client services → API controllers → repositories → SQL; controllers validate members, suppliers, income, expenses, and multi-period dues before persistence. A separate scheduled notification capability reserves and sends due-payment emails when enabled. The graph reflects documented and excerpted wiring; unsampled UI and job internals are represented conservatively.

Main entry points: [`Chassoft.API/Program.cs`](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Program.cs) (HTTP API), [`Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs`](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs) (Supplier repository), [`Chassoft.API/Controllers/OperacionControllers.cs`](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/OperacionControllers.cs) (Cash and dues), [`Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs`](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs) (Member repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_webui["Blazor UI<br/>[Chassoft.Web]"]
  node_webservices["Client services<br/>[Services]"]
end

subgraph group_api["API and workflows"]
  node_api["HTTP API<br/>[Program.cs]"]
  node_people["People CRUD<br/>[SocioController.cs]"]
  node_suppliers["Supplier CRUD"]
  node_employees["Employee lookup"]
  node_operations["Cash and dues"]
  node_scheduler["Dues reminder job"]
end

subgraph group_domain["Domain model"]
  node_peoplemodel["Member records<br/>[Socio.cs]"]
  node_suppliermodel["Supplier records<br/>[Proveedor.cs]"]
  node_cashmodel["Operations and dues<br/>[CobroCuotas.cs]"]
  node_repositorycontracts["Repository contracts"]
end

subgraph group_infra["Persistence and messaging"]
  node_sqlpeople["Member repository"]
  node_sqlsupplier["Supplier repository"]
  node_sqloperations["Operations repository"]
  node_sqlother["Other SQL repositories<br/>[Repositories]"]
  node_notificationservice["SMTP sender"]
end

subgraph group_desktop["Desktop client"]
  node_desktopui["Supplier forms<br/>[FormProveedor.cs]"]
  node_desktopentry["Desktop startup<br/>[Program.cs]"]
end

node_webuser(("Web user"))
node_desktopuser(("Desktop user"))
node_database[("SQL Server")]
node_mail["SMTP provider"]

node_webuser -.->|"uses"| node_webui
node_webui -.->|"uses"| node_webservices
node_webservices -.->|"calls API"| node_api
node_api -->|"routes requests"| node_people
node_api -->|"routes requests"| node_suppliers
node_api -->|"routes requests"| node_operations
node_people -->|"uses repository"| node_sqlpeople
node_suppliers -->|"uses repository"| node_sqlsupplier
node_operations -->|"records movements"| node_sqloperations
node_operations -->|"looks up member"| node_sqlpeople
node_operations -->|"looks up supplier"| node_sqlsupplier
node_people -->|"reads payment history"| node_sqlother
node_api -->|"registers implementation"| node_sqlpeople
node_api -->|"registers implementation"| node_sqlsupplier
node_api -->|"registers implementation"| node_sqloperations
node_api -->|"registers implementations"| node_sqlother
node_sqlpeople -.->|"reads and writes"| node_database
node_sqlsupplier -->|"reads and writes"| node_database
node_sqloperations -->|"stores transactions"| node_database
node_api -->|"enables conditionally"| node_scheduler
node_api -->|"registers sender"| node_notificationservice
node_scheduler -.->|"checks and reserves"| node_sqlother
node_scheduler -.->|"requests email"| node_notificationservice
node_notificationservice -->|"sends email"| node_mail
node_desktopuser -.->|"uses"| node_desktopui
node_desktopentry -->|"opens listing"| node_desktopui
node_desktopui -.->|"accesses SQL directly"| node_sqlsupplier

click node_webui "https://github.com/edgarna95/chassoft/tree/main/Chassoft.Web"
click node_webservices "https://github.com/edgarna95/chassoft/tree/main/Chassoft.Web/Services"
click node_desktopui "https://github.com/edgarna95/chassoft/blob/main/Chassoft.UI/FormProveedor.cs"
click node_api "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Program.cs"
click node_people "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/SocioController.cs"
click node_suppliers "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/ProveedorController.cs"
click node_employees "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/EmpleadoController.cs"
click node_operations "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/OperacionControllers.cs"
click node_scheduler "https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Jobs/VerificarCuotasJob.cs"
click node_peoplemodel "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Personas/Socio.cs"
click node_suppliermodel "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Personas/Proveedor.cs"
click node_cashmodel "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Entidades/CobroCuotas.cs"
click node_repositorycontracts "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Repositories/IOperacionRepository.cs"
click node_sqlpeople "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs"
click node_sqlsupplier "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs"
click node_sqloperations "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/OperacionRepositorySqlServer.cs"
click node_sqlother "https://github.com/edgarna95/chassoft/tree/main/Chassoft.Infrastructure/Repositories"
click node_notificationservice "https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Servicios/SmtpNotificacionEmailService.cs"
click node_desktopentry "https://github.com/edgarna95/chassoft/blob/main/Chassoft.UI/Program.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_webui,node_webservices,node_webuser,node_desktopuser toneBlue
class node_api,node_people,node_suppliers,node_employees,node_operations,node_scheduler,node_database toneAmber
class node_peoplemodel,node_suppliermodel,node_cashmodel,node_repositorycontracts toneMint
class node_sqlpeople,node_sqlsupplier,node_sqloperations,node_sqlother,node_notificationservice toneRose
class node_desktopui,node_desktopentry,node_mail toneIndigo
```

## Components

### Web client

- [Blazor UI](https://github.com/edgarna95/chassoft/tree/main/Chassoft.Web): `Chassoft.Web`
- [Client services](https://github.com/edgarna95/chassoft/tree/main/Chassoft.Web/Services): `Chassoft.Web/Services`

### API and workflows

- [HTTP API](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Program.cs): `Chassoft.API/Program.cs`
- [People CRUD](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/SocioController.cs): `Chassoft.API/Controllers/SocioController.cs`
- [Supplier CRUD](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/ProveedorController.cs): `Chassoft.API/Controllers/ProveedorController.cs`
- [Employee lookup](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/EmpleadoController.cs): `Chassoft.API/Controllers/EmpleadoController.cs`
- [Cash and dues](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Controllers/OperacionControllers.cs): `Chassoft.API/Controllers/OperacionControllers.cs`
- [Dues reminder job](https://github.com/edgarna95/chassoft/blob/main/Chassoft.API/Jobs/VerificarCuotasJob.cs): `Chassoft.API/Jobs/VerificarCuotasJob.cs`

### Domain model

- [Member records](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Personas/Socio.cs): `Chassoft.Dominio/Personas/Socio.cs`
- [Supplier records](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Personas/Proveedor.cs): `Chassoft.Dominio/Personas/Proveedor.cs`
- [Operations and dues](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Entidades/CobroCuotas.cs): `Chassoft.Dominio/Entidades/CobroCuotas.cs`
- [Repository contracts](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Dominio/Repositories/IOperacionRepository.cs): `Chassoft.Dominio/Repositories/IOperacionRepository.cs`

### Persistence and messaging

- [Member repository](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs): `Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs`
- [Supplier repository](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs): `Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs`
- [Operations repository](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Repositories/OperacionRepositorySqlServer.cs): `Chassoft.Infrastructure/Repositories/OperacionRepositorySqlServer.cs`
- [Other SQL repositories](https://github.com/edgarna95/chassoft/tree/main/Chassoft.Infrastructure/Repositories): `Chassoft.Infrastructure/Repositories`
- [SMTP sender](https://github.com/edgarna95/chassoft/blob/main/Chassoft.Infrastructure/Servicios/SmtpNotificacionEmailService.cs): `Chassoft.Infrastructure/Servicios/SmtpNotificacionEmailService.cs`

### Desktop client

- [Supplier forms](https://github.com/edgarna95/chassoft/blob/main/Chassoft.UI/FormProveedor.cs): `Chassoft.UI/FormProveedor.cs`
- [Desktop startup](https://github.com/edgarna95/chassoft/blob/main/Chassoft.UI/Program.cs): `Chassoft.UI/Program.cs`

### Other components

- **Web user**
- **Desktop user**
- **SQL Server**
- **SMTP provider**

## Connections

- Web user → Blazor UI: uses (evidence: `README.md`)
- Blazor UI → Client services: uses (evidence: `README.md`)
- Client services → HTTP API: calls API (evidence: `README.md`)
- HTTP API → People CRUD: routes requests (evidence: `Chassoft.API/Program.cs`)
- HTTP API → Supplier CRUD: routes requests (evidence: `Chassoft.API/Program.cs`)
- HTTP API → Cash and dues: routes requests (evidence: `Chassoft.API/Program.cs`)
- People CRUD → Member repository: uses repository (evidence: `Chassoft.API/Controllers/SocioController.cs`)
- Supplier CRUD → Supplier repository: uses repository (evidence: `Chassoft.API/Controllers/ProveedorController.cs`)
- Cash and dues → Operations repository: records movements (evidence: `Chassoft.API/Controllers/OperacionControllers.cs`)
- Cash and dues → Member repository: looks up member (evidence: `Chassoft.API/Controllers/OperacionControllers.cs`)
- Cash and dues → Supplier repository: looks up supplier (evidence: `Chassoft.API/Controllers/OperacionControllers.cs`)
- People CRUD → Other SQL repositories: reads payment history (evidence: `Chassoft.API/Controllers/SocioController.cs`)
- HTTP API → Member repository: registers implementation (evidence: `Chassoft.API/Program.cs`)
- HTTP API → Supplier repository: registers implementation (evidence: `Chassoft.API/Program.cs`)
- HTTP API → Operations repository: registers implementation (evidence: `Chassoft.API/Program.cs`)
- HTTP API → Other SQL repositories: registers implementations (evidence: `Chassoft.API/Program.cs`)
- Member repository → SQL Server: reads and writes (evidence: `Chassoft.Infrastructure/Repositories/SocioRepositorySqlServer.cs`)
- Supplier repository → SQL Server: reads and writes (evidence: `Chassoft.Infrastructure/Repositories/ProveedorRepositorySqlServer.cs`)
- Operations repository → SQL Server: stores transactions (evidence: `Chassoft.Infrastructure/Repositories/OperacionRepositorySqlServer.cs`)
- HTTP API → Dues reminder job: enables conditionally (evidence: `Chassoft.API/Program.cs`)
- HTTP API → SMTP sender: registers sender (evidence: `Chassoft.API/Program.cs`)
- Dues reminder job → Other SQL repositories: checks and reserves
- Dues reminder job → SMTP sender: requests email
- SMTP sender → SMTP provider: sends email (evidence: `Chassoft.Infrastructure/Servicios/SmtpNotificacionEmailService.cs`)
- Desktop user → Supplier forms: uses (evidence: `README.md`)
- Desktop startup → Supplier forms: opens listing (evidence: `Chassoft.UI/Program.cs`)
- Supplier forms → Supplier repository: accesses SQL directly (evidence: `README.md`)
