# bennettforkner/brookwoods-laravel architecture

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

- Interactive diagram: https://gitdiagram.com/bennettforkner/brookwoods-laravel
- Repository: https://github.com/bennettforkner/brookwoods-laravel

## Overview

This Laravel application manages people, activity scoresheets, awards, achievements, and attendance across sessions. Users enter through web routes to browse or update those records; session workflows also import people from CSV, and PDF endpoints produce signup and achievement reports. The Eloquent models express the relationships among these domain records. The sampled files support the controller-to-model and model relationships shown; other listed capabilities are included only where the route index or README provides evidence.

Main entry points: [`app/Models/Activity.php`](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Activity.php) (Activities), [`app/Models/Person.php`](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Person.php) (People), [`routes/web.php`](https://github.com/bennettforkner/brookwoods-laravel/blob/main/routes/web.php) (Web routes), [`app/Models/Achievement.php`](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Achievement.php) (Achievements)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_activity_controller["Activity pages"]
  node_award_controller["Award pages"]
  node_person_controller["People pages"]
  node_scoresheet_controller["Scoresheet pages"]
  node_auth_controller["Authentication<br/>[AuthController.php]"]
  node_people_search["People search<br/>[PeopleSearch.php]"]
end

subgraph group_domain["Activity records"]
  node_activity[("Activities<br/>[Activity.php]")]
  node_award[("Awards<br/>[Award.php]")]
  node_achievement[("Achievements<br/>[Achievement.php]")]
  node_person[("People<br/>[Person.php]")]
  node_scoresheet[("Scoresheets<br/>[Scoresheet.php]")]
  node_visuals["Activity visuals<br/>[Visuals.php]"]
  node_database_seeders["Domain seed data"]
end

subgraph group_sessions["Session management"]
  node_sessions_controller["Session workflows"]
  node_session[("Sessions<br/>[Session.php]")]
  node_people_sessions[("Attendance links")]
end

subgraph group_reports["PDF reporting"]
  node_pdf_controller["Report generation<br/>[PDFController.php]"]
  node_pdf_views["PDF templates"]
end

node_user(("User"))

node_user -->|"requests pages"| node_web_routes
node_web_routes -->|"routes to"| node_activity_controller
node_web_routes -->|"routes to"| node_award_controller
node_web_routes -->|"routes to"| node_person_controller
node_web_routes -->|"routes to"| node_scoresheet_controller
node_web_routes -->|"routes to"| node_auth_controller
node_web_routes -->|"routes to"| node_pdf_controller
node_web_routes -->|"registers search"| node_people_search
node_activity_controller -->|"reads"| node_activity
node_activity_controller -->|"reads"| node_person
node_activity_controller -->|"reads"| node_scoresheet
node_person_controller -->|"reads and creates"| node_person
node_person_controller -->|"loads activities"| node_activity
node_person_controller -->|"creates sheets"| node_scoresheet
node_scoresheet_controller -->|"reads"| node_person
node_scoresheet_controller -->|"reads"| node_scoresheet
node_people_search -->|"searches"| node_person
node_activity -->|"has awards"| node_award
node_activity -->|"queries achievements"| node_achievement
node_activity -->|"generates color"| node_visuals
node_award -->|"has achievements"| node_achievement
node_award -->|"belongs to"| node_activity
node_achievement -->|"belongs to"| node_scoresheet
node_achievement -->|"belongs to"| node_award
node_person -->|"has scoresheets"| node_scoresheet
node_person -->|"has achievements"| node_achievement
node_person -->|"attends sessions"| node_session
node_scoresheet -->|"belongs to"| node_person
node_scoresheet -->|"belongs to"| node_activity
node_scoresheet -->|"has achievements"| node_achievement
node_sessions_controller -->|"reads and creates"| node_session
node_sessions_controller -->|"loads activities"| node_activity
node_sessions_controller -->|"imports people"| node_person
node_sessions_controller -->|"writes attendance"| node_people_sessions
node_session -->|"attends"| node_person
node_session -->|"has dated achievements"| node_achievement
node_pdf_controller -->|"loads session"| node_session
node_pdf_controller -->|"loads activity"| node_activity
node_pdf_controller -->|"queries date range"| node_achievement
node_pdf_controller -->|"renders reports"| node_pdf_views
node_database_seeders -->|"seeds records"| node_activity
node_database_seeders -->|"seeds records"| node_award
node_database_seeders -->|"seeds records"| node_achievement

click node_web_routes "https://github.com/bennettforkner/brookwoods-laravel/blob/main/routes/web.php"
click node_activity_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/ActivityController.php"
click node_award_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/AwardController.php"
click node_person_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/PersonController.php"
click node_scoresheet_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/ScoresheetController.php"
click node_auth_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/AuthController.php"
click node_people_search "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Livewire/PeopleSearch.php"
click node_activity "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Activity.php"
click node_award "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Award.php"
click node_achievement "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Achievement.php"
click node_person "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Person.php"
click node_scoresheet "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Scoresheet.php"
click node_visuals "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Providers/Visuals.php"
click node_sessions_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/SessionsController.php"
click node_session "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Session.php"
click node_people_sessions "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/SessionsController.php"
click node_pdf_controller "https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/PDFController.php"
click node_pdf_views "https://github.com/bennettforkner/brookwoods-laravel/tree/main/resources/views/pdf"
click node_database_seeders "https://github.com/bennettforkner/brookwoods-laravel/tree/main/database/seeders"

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_web_routes,node_activity_controller,node_award_controller,node_person_controller,node_scoresheet_controller,node_auth_controller,node_people_search,node_user toneBlue
class node_activity,node_award,node_achievement,node_person,node_scoresheet,node_visuals,node_database_seeders toneAmber
class node_sessions_controller,node_session,node_people_sessions toneMint
class node_pdf_controller,node_pdf_views toneRose
```

## Components

### Web workflows

- [Web routes](https://github.com/bennettforkner/brookwoods-laravel/blob/main/routes/web.php): `routes/web.php`
- [Activity pages](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/ActivityController.php): `app/Http/Controllers/ActivityController.php`
- [Award pages](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/AwardController.php): `app/Http/Controllers/AwardController.php`
- [People pages](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/PersonController.php): `app/Http/Controllers/PersonController.php`
- [Scoresheet pages](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/ScoresheetController.php): `app/Http/Controllers/ScoresheetController.php`
- [Authentication](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [People search](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Livewire/PeopleSearch.php): `app/Livewire/PeopleSearch.php`

### Activity records

- [Activities](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Activity.php): `app/Models/Activity.php`
- [Awards](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Award.php): `app/Models/Award.php`
- [Achievements](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Achievement.php): `app/Models/Achievement.php`
- [People](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Person.php): `app/Models/Person.php`
- [Scoresheets](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Scoresheet.php): `app/Models/Scoresheet.php`
- [Activity visuals](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Providers/Visuals.php): `app/Providers/Visuals.php`
- [Domain seed data](https://github.com/bennettforkner/brookwoods-laravel/tree/main/database/seeders): `database/seeders`

### Session management

- [Session workflows](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/SessionsController.php): `app/Http/Controllers/SessionsController.php`
- [Sessions](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Models/Session.php): `app/Models/Session.php`
- [Attendance links](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/SessionsController.php): `app/Http/Controllers/SessionsController.php`

### PDF reporting

- [Report generation](https://github.com/bennettforkner/brookwoods-laravel/blob/main/app/Http/Controllers/PDFController.php): `app/Http/Controllers/PDFController.php`
- [PDF templates](https://github.com/bennettforkner/brookwoods-laravel/tree/main/resources/views/pdf): `resources/views/pdf`

### Other components

- **User**

## Connections

- User → Web routes: requests pages (evidence: `routes/web.php`)
- Web routes → Activity pages: routes to (evidence: `routes/web.php`)
- Web routes → Award pages: routes to (evidence: `routes/web.php`)
- Web routes → People pages: routes to (evidence: `routes/web.php`)
- Web routes → Scoresheet pages: routes to (evidence: `routes/web.php`)
- Web routes → Authentication: routes to (evidence: `routes/web.php`)
- Web routes → Report generation: routes to (evidence: `routes/web.php`)
- Web routes → People search: registers search (evidence: `routes/web.php`)
- Activity pages → Activities: reads (evidence: `app/Http/Controllers/ActivityController.php`)
- Activity pages → People: reads (evidence: `app/Http/Controllers/ActivityController.php`)
- Activity pages → Scoresheets: reads (evidence: `app/Http/Controllers/ActivityController.php`)
- People pages → People: reads and creates (evidence: `app/Http/Controllers/PersonController.php`)
- People pages → Activities: loads activities (evidence: `app/Http/Controllers/PersonController.php`)
- People pages → Scoresheets: creates sheets (evidence: `app/Http/Controllers/PersonController.php`)
- Scoresheet pages → People: reads (evidence: `app/Http/Controllers/ScoresheetController.php`)
- Scoresheet pages → Scoresheets: reads (evidence: `app/Http/Controllers/ScoresheetController.php`)
- People search → People: searches (evidence: `app/Livewire/PeopleSearch.php`)
- Activities → Awards: has awards (evidence: `app/Models/Activity.php`)
- Activities → Achievements: queries achievements (evidence: `app/Models/Activity.php`)
- Activities → Activity visuals: generates color (evidence: `app/Models/Activity.php`)
- Awards → Achievements: has achievements (evidence: `app/Models/Award.php`)
- Awards → Activities: belongs to (evidence: `app/Models/Award.php`)
- Achievements → Scoresheets: belongs to (evidence: `app/Models/Achievement.php`)
- Achievements → Awards: belongs to (evidence: `app/Models/Achievement.php`)
- People → Scoresheets: has scoresheets (evidence: `app/Models/Person.php`)
- People → Achievements: has achievements (evidence: `app/Models/Person.php`)
- People → Sessions: attends sessions (evidence: `app/Models/Person.php`)
- Scoresheets → People: belongs to (evidence: `app/Models/Scoresheet.php`)
- Scoresheets → Activities: belongs to (evidence: `app/Models/Scoresheet.php`)
- Scoresheets → Achievements: has achievements (evidence: `app/Models/Scoresheet.php`)
- Session workflows → Sessions: reads and creates (evidence: `app/Http/Controllers/SessionsController.php`)
- Session workflows → Activities: loads activities (evidence: `app/Http/Controllers/SessionsController.php`)
- Session workflows → People: imports people (evidence: `app/Http/Controllers/SessionsController.php`)
- Session workflows → Attendance links: writes attendance (evidence: `app/Http/Controllers/SessionsController.php`)
- Sessions → People: attends (evidence: `app/Models/Session.php`)
- Sessions → Achievements: has dated achievements (evidence: `app/Models/Session.php`)
- Report generation → Sessions: loads session (evidence: `app/Http/Controllers/PDFController.php`)
- Report generation → Activities: loads activity (evidence: `app/Http/Controllers/PDFController.php`)
- Report generation → Achievements: queries date range (evidence: `app/Http/Controllers/PDFController.php`)
- Report generation → PDF templates: renders reports (evidence: `app/Http/Controllers/PDFController.php`)
- Domain seed data → Activities: seeds records (evidence: `database/seeders/ActivitySeeder.php`)
- Domain seed data → Awards: seeds records (evidence: `database/seeders/AwardSeeder.php`)
- Domain seed data → Achievements: seeds records (evidence: `database/seeders/AchievementSeeder.php`)
