How lethabomohapi/siteledger works
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: SiteLedgerDbContext.cs Tenant database · Controllers Projects and tasks · ProjectRecordsController.cs Reports and expenses · Program.cs API host
Components 23
MVC interface
- MVC pages
src/SiteLedger.Web/Controllers - Web sessions
src/SiteLedger.Web/Services/WebSessions.cs - API client
src/SiteLedger.Web/Services/ApiClient.cs
API workflows
- API host
src/SiteLedger.Api/Program.cs - Projects and tasks
src/SiteLedger.Api/Controllers - Reports and expenses
src/SiteLedger.Api/Controllers/ProjectRecordsController.cs - Membership and admin
src/SiteLedger.Api/Controllers - Invitations
src/SiteLedger.Api/Controllers/InvitationsController.cs - Dashboard
src/SiteLedger.Api/Controllers - Private files
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - CSV and PDF exports
src/SiteLedger.Api/Controllers - Audit events
src/SiteLedger.Api/Auditing
Identity and access
- Account and auth API
src/SiteLedger.Api/Controllers - Login and JWT
src/SiteLedger.Api/Auth/LoginService.cs - Authenticator
src/SiteLedger.Api/Auth/AuthenticatorService.cs - Refresh tokens
src/SiteLedger.Api/Auth/RefreshTokenService.cs - Email outbox
src/SiteLedger.Api/Auth/EmailOutbox.cs
Persistence and rules
- Tenant database
src/SiteLedger.Infrastructure/SiteLedgerDbContext.cs - Project service
src/SiteLedger.Api/Projects/ProjectService.cs - Project write lease
src/SiteLedger.Api/Projects/ProjectWriteLease.cs - Role permissions
src/SiteLedger.Core/Permissions.cs - Plan limits
src/SiteLedger.Core/PlanRules.cs
Other components
- User
Connections 32
- User → MVC pages: uses
README.md - MVC pages → API client: calls
src/SiteLedger.Web/Controllers/ProjectsController.cs - API client → Web sessions: gets tokens
src/SiteLedger.Web/Services/ApiClient.cs - API client → API host: sends HTTP
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
src/SiteLedger.Api/Projects/ProjectService.cs - Projects and tasks → Project write lease: uses
src/SiteLedger.Api/Controllers/ProjectManagementController.cs - Reports and expenses → Project write lease: uses
src/SiteLedger.Api/Controllers/ProjectRecordsController.cs - Reports and expenses → Tenant database: reads and writes
src/SiteLedger.Api/Controllers/ProjectRecordsController.cs - Projects and tasks → Role permissions: authorizes by role
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - Membership and admin → Role permissions: authorizes by role
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - Projects and tasks → Plan limits: checks plan limits
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - Private files → Plan limits: checks quotas
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
src/SiteLedger.Api/Auth/LoginService.cs - Login and JWT → Authenticator: verifies codes
src/SiteLedger.Api/Auth/LoginService.cs - Refresh tokens → Tenant database: rotates tokens
src/SiteLedger.Api/Auth/RefreshTokenService.cs - Reports and expenses → Audit events: records events
src/SiteLedger.Api/Controllers/ProjectRecordsController.cs - Projects and tasks → Audit events: records events
src/SiteLedger.Api/Controllers/ProjectRecordsController.cs - Reports and expenses → Email outbox: notifies users
- Invitations → Tenant database: persists invitations
src/SiteLedger.Api/Controllers/InvitationsController.cs - Membership and admin → Tenant database: manages memberships
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - Dashboard → Tenant database: reads summaries
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - Private files → Tenant database: stores file metadata
src/SiteLedger.Api/Controllers/ProjectFilesController.cs - CSV and PDF exports → Tenant database: queries export data
src/SiteLedger.Api/Controllers/ExportsController.cs - Audit events → Tenant database: persists audit data
src/SiteLedger.Api/Auditing/AuditEvents.cs - Email outbox → Tenant database: queues messages
src/SiteLedger.Api/Auth/EmailOutbox.cs