# lethabomohapi/siteledger architecture

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

- Interactive diagram: https://gitdiagram.com/lethabomohapi/siteledger
- Repository: https://github.com/lethabomohapi/siteledger

## Overview

SiteLedger is an unfinished multi-tenant construction-project management foundation: an ASP.NET Core MVC interface calls a separate API, which applies tenant and role rules and persists data in MySQL. The principal workflow is users working with projects, tasks, reports, and expenses; records can be submitted and reviewed, then exported. Other documented capabilities include account security, private files, invitations, membership administration, dashboards, and auditing. The README supports several feature relationships; the sampled source gives stronger evidence for selected service-to-database calls. Many controller implementations were not sampled, so their internal call paths are not asserted.

Main entry points: [`src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs`](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs) (Tenant database), [`src/SiteLedger.Api/Controllers`](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers) (Projects and tasks), [`src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/ProjectRecordsController.cs) (Reports and expenses), [`src/SiteLedger.Api/Program.cs`](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Program.cs) (API host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["MVC interface"]
  node_mvc["MVC pages<br/>[Controllers]"]
  node_sessions["Web sessions<br/>[WebSessions.cs]"]
  node_client["API client<br/>[ApiClient.cs]"]
end

subgraph group_api["API workflows"]
  node_api_entry["API host<br/>[Program.cs]"]
  node_projects["Projects and tasks<br/>[Controllers]"]
  node_records["Reports and expenses"]
  node_members["Membership and admin<br/>[Controllers]"]
  node_invitations["Invitations"]
  node_dashboard["Dashboard<br/>[Controllers]"]
  node_files["Private files"]
  node_exports["CSV and PDF exports<br/>[Controllers]"]
  node_audit["Audit events<br/>[Auditing]"]
end

subgraph group_security["Identity and access"]
  node_auth_api["Account and auth API<br/>[Controllers]"]
  node_login["Login and JWT<br/>[LoginService.cs]"]
  node_authenticator["Authenticator"]
  node_refresh["Refresh tokens"]
  node_email["Email outbox<br/>[EmailOutbox.cs]"]
end

subgraph group_data["Persistence and rules"]
  node_db[("Tenant database")]
  node_project_service["Project service<br/>[ProjectService.cs]"]
  node_write_lease["Project write lease"]
  node_permissions["Role permissions<br/>[Permissions.cs]"]
  node_plan_rules["Plan limits<br/>[PlanRules.cs]"]
end

node_user(("User"))

node_user -->|"uses"| node_mvc
node_mvc -->|"calls"| node_client
node_client -->|"gets tokens"| node_sessions
node_client -->|"sends HTTP"| node_api_entry
node_api_entry -.->|"routes requests"| node_projects
node_api_entry -.->|"routes requests"| node_records
node_api_entry -.->|"routes requests"| node_auth_api
node_projects -.->|"uses"| node_project_service
node_project_service -->|"reads and writes"| node_db
node_projects -->|"uses"| node_write_lease
node_records -->|"uses"| node_write_lease
node_records -->|"reads and writes"| node_db
node_projects -.->|"authorizes by role"| node_permissions
node_members -.->|"authorizes by role"| node_permissions
node_projects -->|"checks plan limits"| node_plan_rules
node_files -->|"checks quotas"| node_plan_rules
node_auth_api -.->|"delegates login"| node_login
node_auth_api -.->|"delegates setup"| node_authenticator
node_auth_api -.->|"delegates refresh"| node_refresh
node_login -->|"checks accounts"| node_db
node_login -->|"verifies codes"| node_authenticator
node_refresh -->|"rotates tokens"| node_db
node_records -->|"records events"| node_audit
node_projects -->|"records events"| node_audit
node_records -.->|"notifies users"| node_email
node_invitations -->|"persists invitations"| node_db
node_members -.->|"manages memberships"| node_db
node_dashboard -.->|"reads summaries"| node_db
node_files -->|"stores file metadata"| node_db
node_exports -->|"queries export data"| node_db
node_audit -->|"persists audit data"| node_db
node_email -->|"queues messages"| node_db

click node_mvc "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Web/Controllers"
click node_sessions "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Web/Services/WebSessions.cs"
click node_client "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Web/Services/ApiClient.cs"
click node_api_entry "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Program.cs"
click node_projects "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers"
click node_records "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/ProjectRecordsController.cs"
click node_members "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers"
click node_invitations "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/InvitationsController.cs"
click node_dashboard "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers"
click node_files "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/ProjectFilesController.cs"
click node_exports "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers"
click node_audit "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Auditing"
click node_auth_api "https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers"
click node_login "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/LoginService.cs"
click node_authenticator "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/AuthenticatorService.cs"
click node_refresh "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/RefreshTokenService.cs"
click node_email "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/EmailOutbox.cs"
click node_db "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs"
click node_project_service "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Projects/ProjectService.cs"
click node_write_lease "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Projects/ProjectWriteLease.cs"
click node_permissions "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Core/Permissions.cs"
click node_plan_rules "https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Core/PlanRules.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_mvc,node_sessions,node_client,node_user toneBlue
class node_api_entry,node_projects,node_records,node_members,node_invitations,node_dashboard,node_files,node_exports,node_audit toneAmber
class node_auth_api,node_login,node_authenticator,node_refresh,node_email toneMint
class node_db,node_project_service,node_write_lease,node_permissions,node_plan_rules toneRose
```

## Components

### MVC interface

- [MVC pages](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Web/Controllers): `src/SiteLedger.Web/Controllers`
- [Web sessions](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Web/Services/WebSessions.cs): `src/SiteLedger.Web/Services/WebSessions.cs`
- [API client](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Web/Services/ApiClient.cs): `src/SiteLedger.Web/Services/ApiClient.cs`

### API workflows

- [API host](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Program.cs): `src/SiteLedger.Api/Program.cs`
- [Projects and tasks](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers): `src/SiteLedger.Api/Controllers`
- [Reports and expenses](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/ProjectRecordsController.cs): `src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`
- [Membership and admin](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers): `src/SiteLedger.Api/Controllers`
- [Invitations](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/InvitationsController.cs): `src/SiteLedger.Api/Controllers/InvitationsController.cs`
- [Dashboard](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers): `src/SiteLedger.Api/Controllers`
- [Private files](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Controllers/ProjectFilesController.cs): `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`
- [CSV and PDF exports](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers): `src/SiteLedger.Api/Controllers`
- [Audit events](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Auditing): `src/SiteLedger.Api/Auditing`

### Identity and access

- [Account and auth API](https://github.com/lethabomohapi/siteledger/tree/master/src/SiteLedger.Api/Controllers): `src/SiteLedger.Api/Controllers`
- [Login and JWT](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/LoginService.cs): `src/SiteLedger.Api/Auth/LoginService.cs`
- [Authenticator](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/AuthenticatorService.cs): `src/SiteLedger.Api/Auth/AuthenticatorService.cs`
- [Refresh tokens](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/RefreshTokenService.cs): `src/SiteLedger.Api/Auth/RefreshTokenService.cs`
- [Email outbox](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Auth/EmailOutbox.cs): `src/SiteLedger.Api/Auth/EmailOutbox.cs`

### Persistence and rules

- [Tenant database](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs): `src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs`
- [Project service](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Projects/ProjectService.cs): `src/SiteLedger.Api/Projects/ProjectService.cs`
- [Project write lease](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Api/Projects/ProjectWriteLease.cs): `src/SiteLedger.Api/Projects/ProjectWriteLease.cs`
- [Role permissions](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Core/Permissions.cs): `src/SiteLedger.Core/Permissions.cs`
- [Plan limits](https://github.com/lethabomohapi/siteledger/blob/master/src/SiteLedger.Core/PlanRules.cs): `src/SiteLedger.Core/PlanRules.cs`

### Other components

- **User**

## Connections

- User → MVC pages: uses (evidence: `README.md`)
- MVC pages → API client: calls (evidence: `src/SiteLedger.Web/Controllers/ProjectsController.cs`)
- API client → Web sessions: gets tokens (evidence: `src/SiteLedger.Web/Services/ApiClient.cs`)
- API client → API host: sends HTTP (evidence: `src/SiteLedger.Web/Services/ApiClient.cs`)
- API host → Projects and tasks: routes requests
- API host → Reports and expenses: routes requests
- API host → Account and auth API: routes requests
- Projects and tasks → Project service: uses
- Project service → Tenant database: reads and writes (evidence: `src/SiteLedger.Api/Projects/ProjectService.cs`)
- Projects and tasks → Project write lease: uses (evidence: `src/SiteLedger.Api/Controllers/ProjectManagementController.cs`)
- Reports and expenses → Project write lease: uses (evidence: `src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`)
- Reports and expenses → Tenant database: reads and writes (evidence: `src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`)
- Projects and tasks → Role permissions: authorizes by role (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Membership and admin → Role permissions: authorizes by role (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Projects and tasks → Plan limits: checks plan limits (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Private files → Plan limits: checks quotas (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Account and auth API → Login and JWT: delegates login
- Account and auth API → Authenticator: delegates setup
- Account and auth API → Refresh tokens: delegates refresh
- Login and JWT → Tenant database: checks accounts (evidence: `src/SiteLedger.Api/Auth/LoginService.cs`)
- Login and JWT → Authenticator: verifies codes (evidence: `src/SiteLedger.Api/Auth/LoginService.cs`)
- Refresh tokens → Tenant database: rotates tokens (evidence: `src/SiteLedger.Api/Auth/RefreshTokenService.cs`)
- Reports and expenses → Audit events: records events (evidence: `src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`)
- Projects and tasks → Audit events: records events (evidence: `src/SiteLedger.Api/Controllers/ProjectRecordsController.cs`)
- Reports and expenses → Email outbox: notifies users
- Invitations → Tenant database: persists invitations (evidence: `src/SiteLedger.Api/Controllers/InvitationsController.cs`)
- Membership and admin → Tenant database: manages memberships (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Dashboard → Tenant database: reads summaries (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- Private files → Tenant database: stores file metadata (evidence: `src/SiteLedger.Api/Controllers/ProjectFilesController.cs`)
- CSV and PDF exports → Tenant database: queries export data (evidence: `src/SiteLedger.Api/Controllers/ExportsController.cs`)
- Audit events → Tenant database: persists audit data (evidence: `src/SiteLedger.Api/Auditing/AuditEvents.cs`)
- Email outbox → Tenant database: queues messages (evidence: `src/SiteLedger.Api/Auth/EmailOutbox.cs`)
