# reyjager/jds architecture

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

## Overview

JDS is a Laravel-based agency/CMS site. Visitors browse public pages and submit contact messages; administrators and editors authenticate, then manage site content, while administrators also manage users. The route table is the main dispatcher, with controllers handling dynamic content and Eloquent models representing persisted records. The graph reflects relationships visible in the supplied excerpts and source index; some listed capabilities, including password resets and portfolio display, have no controller excerpts, so their internal implementation is not expanded.

Main entry points: [`routes/web.php`](https://github.com/reyjager/jds/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/Admin/ContentController.php`](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/Admin/ContentController.php) (Content management), [`bootstrap/app.php`](https://github.com/reyjager/jds/blob/main/bootstrap/app.php) (App bootstrap), [`app/Http/Controllers/AboutController.php`](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/AboutController.php) (About content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Web runtime"]
  node_front["Laravel entry<br/>[index.php]"]
  node_bootstrap["App bootstrap<br/>[app.php]"]
  node_routes["Web routes<br/>[web.php]"]
end

subgraph group_public["Public site"]
  node_publicpages["Public pages<br/>[home.blade.php]"]
  node_about["About content"]
  node_servicespage["Services page<br/>[services.blade.php]"]
  node_portfoliopage["Portfolio page"]
  node_resumepage["Resume page<br/>[layout.blade.php]"]
  node_contact["Contact form<br/>[contact.blade.php]"]
  node_mail["Contact email<br/>[ContactMessage.php]"]
end

subgraph group_cms["CMS and accounts"]
  node_auth["Admin authentication<br/>[AuthController.php]"]
  node_content["Content management"]
  node_aboutadmin["About editor"]
  node_rolecheck["Role middleware"]
end

subgraph group_domain["Content records"]
  node_settings[("Site settings<br/>[Setting.php]")]
  node_service[("Service records<br/>[Service.php]")]
  node_project[("Portfolio records")]
  node_team[("Team records<br/>[TeamMember.php]")]
  node_user[("User accounts<br/>[User.php]")]
end

node_visitor(("Visitor"))
node_adminuser(("Admin or editor"))

node_visitor -->|"requests pages"| node_front
node_adminuser -->|"requests CMS"| node_front
node_front -->|"starts app"| node_bootstrap
node_bootstrap -->|"loads routes"| node_routes
node_bootstrap -->|"aliases role"| node_rolecheck
node_routes -->|"renders home"| node_publicpages
node_routes -->|"dispatches about"| node_about
node_routes -->|"renders services"| node_servicespage
node_routes -->|"renders portfolio"| node_portfoliopage
node_routes -->|"renders resume"| node_resumepage
node_routes -->|"renders contact"| node_contact
node_routes -->|"sends message"| node_mail
node_routes -->|"dispatches auth"| node_auth
node_routes -->|"dispatches CMS"| node_content
node_routes -->|"dispatches editor"| node_aboutadmin
node_routes -->|"applies role"| node_rolecheck
node_routes -->|"queries published"| node_service
node_routes -->|"queries published"| node_project
node_about -->|"reads and updates"| node_settings
node_about -->|"queries published"| node_team
node_content -->|"manages records"| node_service
node_content -->|"manages records"| node_project
node_content -->|"manages records"| node_team
node_auth -->|"authenticates and manages"| node_user
node_auth -->|"checks roles"| node_rolecheck
node_servicespage -->|"uses service data"| node_service

click node_front "https://github.com/reyjager/jds/blob/main/public/index.php"
click node_bootstrap "https://github.com/reyjager/jds/blob/main/bootstrap/app.php"
click node_routes "https://github.com/reyjager/jds/blob/main/routes/web.php"
click node_publicpages "https://github.com/reyjager/jds/blob/main/resources/views/home.blade.php"
click node_about "https://github.com/reyjager/jds/blob/main/app/Http/Controllers/AboutController.php"
click node_servicespage "https://github.com/reyjager/jds/blob/main/resources/views/services.blade.php"
click node_portfoliopage "https://github.com/reyjager/jds/blob/main/resources/views/portfolio.blade.php"
click node_resumepage "https://github.com/reyjager/jds/blob/main/resources/views/resume/layout.blade.php"
click node_contact "https://github.com/reyjager/jds/blob/main/resources/views/contact.blade.php"
click node_mail "https://github.com/reyjager/jds/blob/main/app/Mail/ContactMessage.php"
click node_auth "https://github.com/reyjager/jds/blob/main/app/Http/Controllers/Admin/AuthController.php"
click node_content "https://github.com/reyjager/jds/blob/main/app/Http/Controllers/Admin/ContentController.php"
click node_aboutadmin "https://github.com/reyjager/jds/blob/main/app/Http/Controllers/AboutController.php"
click node_rolecheck "https://github.com/reyjager/jds/blob/main/app/Http/Middleware/EnsureUserHasRole.php"
click node_settings "https://github.com/reyjager/jds/blob/main/app/Models/Setting.php"
click node_service "https://github.com/reyjager/jds/blob/main/app/Models/Service.php"
click node_project "https://github.com/reyjager/jds/blob/main/app/Models/PortfolioProject.php"
click node_team "https://github.com/reyjager/jds/blob/main/app/Models/TeamMember.php"
click node_user "https://github.com/reyjager/jds/blob/main/app/Models/User.php"

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_front,node_bootstrap,node_routes toneBlue
class node_publicpages,node_about,node_servicespage,node_portfoliopage,node_resumepage,node_contact,node_mail toneAmber
class node_auth,node_content,node_aboutadmin,node_rolecheck toneMint
class node_settings,node_service,node_project,node_team,node_user toneRose
class node_visitor,node_adminuser toneIndigo
```

## Components

### Web runtime

- [Laravel entry](https://github.com/reyjager/jds/blob/main/public/index.php): `public/index.php`
- [App bootstrap](https://github.com/reyjager/jds/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Web routes](https://github.com/reyjager/jds/blob/main/routes/web.php): `routes/web.php`

### Public site

- [Public pages](https://github.com/reyjager/jds/blob/main/resources/views/home.blade.php): `resources/views/home.blade.php`
- [About content](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/AboutController.php): `app/Http/Controllers/AboutController.php`
- [Services page](https://github.com/reyjager/jds/blob/main/resources/views/services.blade.php): `resources/views/services.blade.php`
- [Portfolio page](https://github.com/reyjager/jds/blob/main/resources/views/portfolio.blade.php): `resources/views/portfolio.blade.php`
- [Resume page](https://github.com/reyjager/jds/blob/main/resources/views/resume/layout.blade.php): `resources/views/resume/layout.blade.php`
- [Contact form](https://github.com/reyjager/jds/blob/main/resources/views/contact.blade.php): `resources/views/contact.blade.php`
- [Contact email](https://github.com/reyjager/jds/blob/main/app/Mail/ContactMessage.php): `app/Mail/ContactMessage.php`

### CMS and accounts

- [Admin authentication](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/Admin/AuthController.php): `app/Http/Controllers/Admin/AuthController.php`
- [Content management](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/Admin/ContentController.php): `app/Http/Controllers/Admin/ContentController.php`
- [About editor](https://github.com/reyjager/jds/blob/main/app/Http/Controllers/AboutController.php): `app/Http/Controllers/AboutController.php`
- [Role middleware](https://github.com/reyjager/jds/blob/main/app/Http/Middleware/EnsureUserHasRole.php): `app/Http/Middleware/EnsureUserHasRole.php`

### Content records

- [Site settings](https://github.com/reyjager/jds/blob/main/app/Models/Setting.php): `app/Models/Setting.php`
- [Service records](https://github.com/reyjager/jds/blob/main/app/Models/Service.php): `app/Models/Service.php`
- [Portfolio records](https://github.com/reyjager/jds/blob/main/app/Models/PortfolioProject.php): `app/Models/PortfolioProject.php`
- [Team records](https://github.com/reyjager/jds/blob/main/app/Models/TeamMember.php): `app/Models/TeamMember.php`
- [User accounts](https://github.com/reyjager/jds/blob/main/app/Models/User.php): `app/Models/User.php`

### Other components

- **Visitor**
- **Admin or editor**

## Connections

- Visitor → Laravel entry: requests pages
- Admin or editor → Laravel entry: requests CMS
- Laravel entry → App bootstrap: starts app (evidence: `public/index.php`)
- App bootstrap → Web routes: loads routes (evidence: `bootstrap/app.php`)
- App bootstrap → Role middleware: aliases role (evidence: `bootstrap/app.php`)
- Web routes → Public pages: renders home (evidence: `routes/web.php`)
- Web routes → About content: dispatches about (evidence: `routes/web.php`)
- Web routes → Services page: renders services (evidence: `routes/web.php`)
- Web routes → Portfolio page: renders portfolio (evidence: `routes/web.php`)
- Web routes → Resume page: renders resume (evidence: `routes/web.php`)
- Web routes → Contact form: renders contact (evidence: `routes/web.php`)
- Web routes → Contact email: sends message (evidence: `routes/web.php`)
- Web routes → Admin authentication: dispatches auth (evidence: `routes/web.php`)
- Web routes → Content management: dispatches CMS (evidence: `routes/web.php`)
- Web routes → About editor: dispatches editor (evidence: `routes/web.php`)
- Web routes → Role middleware: applies role (evidence: `routes/web.php`)
- Web routes → Service records: queries published (evidence: `routes/web.php`)
- Web routes → Portfolio records: queries published (evidence: `routes/web.php`)
- About content → Site settings: reads and updates (evidence: `app/Http/Controllers/AboutController.php`)
- About content → Team records: queries published (evidence: `app/Http/Controllers/AboutController.php`)
- Content management → Service records: manages records (evidence: `app/Http/Controllers/Admin/ContentController.php`)
- Content management → Portfolio records: manages records (evidence: `app/Http/Controllers/Admin/ContentController.php`)
- Content management → Team records: manages records (evidence: `app/Http/Controllers/Admin/ContentController.php`)
- Admin authentication → User accounts: authenticates and manages (evidence: `app/Http/Controllers/Admin/AuthController.php`)
- Admin authentication → Role middleware: checks roles (evidence: `app/Http/Controllers/Admin/AuthController.php`)
- Services page → Service records: uses service data (evidence: `resources/views/services.blade.php`)
