# nasstyfox/giftofthegivers architecture

> Architecture diagram of the GitHub repository nasstyfox/giftofthegivers, 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/nasstyfox/giftofthegivers
- Repository: https://github.com/nasstyfox/giftofthegivers

## Overview

Gift of the Givers is an ASP.NET Core MVC web application for charitable giving and relief-project administration. Its principal workflow accepts and validates a donation, optionally associates it with a signed-in user, persists it, creates a tax-certificate record, and shows success or certificate information. Other product stages include volunteer registration, public project browsing and employee project updates, account registration, and a dashboard. The excerpts show controller-to-database operations and startup configuration; the README is empty, and several controllers and views were not sampled, so those relationships are not asserted.

Main entry points: [`GiftOfTheGivers/Data/ApplicationDbContext.cs`](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Data/ApplicationDbContext.cs) (Application database), [`GiftOfTheGivers/Controllers/ProjectController.cs`](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/ProjectController.cs) (Project workflow), [`GiftOfTheGivers/Models/ApplicationUser.cs`](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ApplicationUser.cs) (User entity), [`GiftOfTheGivers/Controllers/DonationController.cs`](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/DonationController.cs) (Donation workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_donations["Donation workflow"]
  node_projects["Project workflow"]
  node_volunteers["Volunteer workflow"]
  node_dashboard["Dashboard"]
  node_contact["Contact"]
  node_home["Home pages<br/>[HomeController.cs]"]
end

subgraph group_identity["Identity and startup"]
  node_registration["Account registration<br/>[Register.cshtml.cs]"]
  node_startup["Application startup<br/>[Program.cs]"]
  node_seeder["Initial data seeding<br/>[DbSeeder.cs]"]
end

subgraph group_data["Domain and persistence"]
  node_database[("Application database")]
  node_users["User entity<br/>[ApplicationUser.cs]"]
  node_donation["Donation entity<br/>[Donation.cs]"]
  node_certificate["Tax certificate entity<br/>[TaxCertificate.cs]"]
  node_volunteer["Volunteer entity<br/>[Volunteer.cs]"]
  node_relief["Relief project entity<br/>[ReliefProject.cs]"]
  node_updates["Project update entity<br/>[ProjectUpdate.cs]"]
  node_error["Error view model<br/>[ErrorViewModel.cs]"]
end

node_donor(("Donor"))
node_visitor(("Visitor"))
node_employee(("Employee"))

node_donor -.->|"submits"| node_donations
node_visitor -.->|"browses"| node_projects
node_employee -.->|"maintains"| node_projects
node_donor -.->|"registers"| node_volunteers
node_donor -.->|"creates account"| node_registration
node_donations -->|"saves and reads"| node_database
node_donations -->|"gets user ID"| node_users
node_projects -->|"queries and saves"| node_database
node_projects -->|"gets employee ID"| node_users
node_volunteers -->|"saves volunteer"| node_database
node_volunteers -->|"gets user ID"| node_users
node_dashboard -->|"queries"| node_database
node_startup -->|"configures provider"| node_database
node_startup -->|"runs seeding"| node_seeder
node_seeder -->|"seeds projects"| node_database
node_database -->|"maps identity"| node_users
node_database -->|"maps donations"| node_donation
node_database -->|"maps certificates"| node_certificate
node_database -->|"maps volunteers"| node_volunteer
node_database -->|"maps projects"| node_relief
node_database -->|"maps updates"| node_updates

click node_donations "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/DonationController.cs"
click node_projects "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/ProjectController.cs"
click node_volunteers "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/VolunteerController.cs"
click node_dashboard "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/DashboardController.cs"
click node_contact "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/ContactController.cs"
click node_home "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/HomeController.cs"
click node_registration "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Areas/Identity/Pages/Account/Register.cshtml.cs"
click node_startup "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Program.cs"
click node_seeder "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Data/DbSeeder.cs"
click node_database "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Data/ApplicationDbContext.cs"
click node_users "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ApplicationUser.cs"
click node_donation "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/Donation.cs"
click node_certificate "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/TaxCertificate.cs"
click node_volunteer "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/Volunteer.cs"
click node_relief "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ReliefProject.cs"
click node_updates "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ProjectUpdate.cs"
click node_error "https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ErrorViewModel.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_donations,node_projects,node_volunteers,node_dashboard,node_contact,node_home toneBlue
class node_registration,node_startup,node_seeder toneAmber
class node_database,node_users,node_donation,node_certificate,node_volunteer,node_relief,node_updates,node_error toneMint
class node_donor,node_visitor,node_employee toneIndigo
```

## Components

### Web workflows

- [Donation workflow](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/DonationController.cs): `GiftOfTheGivers/Controllers/DonationController.cs`
- [Project workflow](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/ProjectController.cs): `GiftOfTheGivers/Controllers/ProjectController.cs`
- [Volunteer workflow](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/VolunteerController.cs): `GiftOfTheGivers/Controllers/VolunteerController.cs`
- [Dashboard](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/DashboardController.cs): `GiftOfTheGivers/Controllers/DashboardController.cs`
- [Contact](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/ContactController.cs): `GiftOfTheGivers/Controllers/ContactController.cs`
- [Home pages](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Controllers/HomeController.cs): `GiftOfTheGivers/Controllers/HomeController.cs`

### Identity and startup

- [Account registration](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Areas/Identity/Pages/Account/Register.cshtml.cs): `GiftOfTheGivers/Areas/Identity/Pages/Account/Register.cshtml.cs`
- [Application startup](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Program.cs): `GiftOfTheGivers/Program.cs`
- [Initial data seeding](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Data/DbSeeder.cs): `GiftOfTheGivers/Data/DbSeeder.cs`

### Domain and persistence

- [Application database](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Data/ApplicationDbContext.cs): `GiftOfTheGivers/Data/ApplicationDbContext.cs`
- [User entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ApplicationUser.cs): `GiftOfTheGivers/Models/ApplicationUser.cs`
- [Donation entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/Donation.cs): `GiftOfTheGivers/Models/Donation.cs`
- [Tax certificate entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/TaxCertificate.cs): `GiftOfTheGivers/Models/TaxCertificate.cs`
- [Volunteer entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/Volunteer.cs): `GiftOfTheGivers/Models/Volunteer.cs`
- [Relief project entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ReliefProject.cs): `GiftOfTheGivers/Models/ReliefProject.cs`
- [Project update entity](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ProjectUpdate.cs): `GiftOfTheGivers/Models/ProjectUpdate.cs`
- [Error view model](https://github.com/nasstyfox/giftofthegivers/blob/master/GiftOfTheGivers/Models/ErrorViewModel.cs): `GiftOfTheGivers/Models/ErrorViewModel.cs`

### Other components

- **Donor**
- **Visitor**
- **Employee**

## Connections

- Donor → Donation workflow: submits
- Visitor → Project workflow: browses
- Employee → Project workflow: maintains
- Donor → Volunteer workflow: registers
- Donor → Account registration: creates account
- Donation workflow → Application database: saves and reads (evidence: `GiftOfTheGivers/Controllers/DonationController.cs`)
- Donation workflow → User entity: gets user ID (evidence: `GiftOfTheGivers/Controllers/DonationController.cs`)
- Project workflow → Application database: queries and saves (evidence: `GiftOfTheGivers/Controllers/ProjectController.cs`)
- Project workflow → User entity: gets employee ID (evidence: `GiftOfTheGivers/Controllers/ProjectController.cs`)
- Volunteer workflow → Application database: saves volunteer (evidence: `GiftOfTheGivers/Controllers/VolunteerController.cs`)
- Volunteer workflow → User entity: gets user ID (evidence: `GiftOfTheGivers/Controllers/VolunteerController.cs`)
- Dashboard → Application database: queries (evidence: `GiftOfTheGivers/Controllers/DashboardController.cs`)
- Application startup → Application database: configures provider (evidence: `GiftOfTheGivers/Program.cs`)
- Application startup → Initial data seeding: runs seeding (evidence: `GiftOfTheGivers/Program.cs`)
- Initial data seeding → Application database: seeds projects (evidence: `GiftOfTheGivers/Data/DbSeeder.cs`)
- Application database → User entity: maps identity (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
- Application database → Donation entity: maps donations (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
- Application database → Tax certificate entity: maps certificates (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
- Application database → Volunteer entity: maps volunteers (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
- Application database → Relief project entity: maps projects (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
- Application database → Project update entity: maps updates (evidence: `GiftOfTheGivers/Data/ApplicationDbContext.cs`)
