# jmrckvr/olfu-capstones architecture

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

- Interactive diagram: https://gitdiagram.com/jmrckvr/olfu-capstones
- Repository: https://github.com/jmrckvr/olfu-capstones

## Overview

This is an academic project repository web application for students, coordinators, and administrators. Students register or sign in, submit project details and files, and track their work; coordinators review submissions and publish, return, or hide them; users can browse published work and download files subject to access checks. Laravel routes and controllers provide the server workflow, while Inertia and Vue render its pages. The excerpts show these principal paths, but not database configuration or every frontend interaction, so unspecified connections are omitted.

Main entry points: [`resources/js/app.js`](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/app.js) (Vue Inertia app), [`app/Models/Project.php`](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/Project.php) (Project records), [`routes/web.php`](https://github.com/jmrckvr/olfu-capstones/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/ProjectController.php`](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/ProjectController.php) (Project submission and browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry"]
  node_routes["Web routes<br/>[web.php]"]
  node_bootstrap["Laravel middleware setup<br/>[app.php]"]
  node_role["Role middleware<br/>[EnsureRole.php]"]
  node_inertia_mw["Inertia middleware"]
end

subgraph group_workflow["Project workflow"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_dashboard["Dashboard data"]
  node_projects["Project submission and browsing"]
  node_moderation["Moderation decisions"]
end

subgraph group_domain["Domain records"]
  node_users[("User records<br/>[User.php]")]
  node_project_model[("Project records<br/>[Project.php]")]
  node_project_files[("Project file records<br/>[ProjectFile.php]")]
  node_history[("Moderation history")]
end

subgraph group_ui["Inertia interface"]
  node_inertia_app["Vue Inertia app<br/>[app.js]"]
  node_layout["Role-based layout<br/>[AppLayout.vue]"]
  node_login_page["Login page<br/>[Login.vue]"]
  node_register_page["Registration page<br/>[Register.vue]"]
  node_dashboard_page["Dashboard page<br/>[Dashboard.vue]"]
  node_repository_page["Repository pages<br/>[Index.vue]"]
  node_create_page["Project upload page<br/>[Create.vue]"]
  node_moderation_page["Moderation page<br/>[Index.vue]"]
  node_app_view["Inertia HTML shell<br/>[app.blade.php]"]
end

node_visitor(("Visitor / user"))

node_visitor -->|"sends requests"| node_routes
node_routes -->|"dispatches auth"| node_auth
node_routes -->|"dispatches dashboard"| node_dashboard
node_routes -->|"dispatches project"| node_projects
node_routes -->|"dispatches moderation"| node_moderation
node_bootstrap -->|"registers alias"| node_role
node_bootstrap -->|"appends middleware"| node_inertia_mw
node_auth -->|"creates and authenticates"| node_users
node_dashboard -->|"queries projects"| node_project_model
node_dashboard -->|"counts users"| node_users
node_projects -->|"creates and queries"| node_project_model
node_projects -->|"stores file records"| node_project_files
node_moderation -->|"updates projects"| node_project_model
node_moderation -->|"records decision"| node_history
node_project_model -->|"belongs to owner"| node_users
node_project_model -->|"has many files"| node_project_files
node_project_model -->|"has moderation history"| node_history
node_inertia_app -->|"mounts in shell"| node_app_view
node_inertia_app -->|"resolves pages"| node_login_page
node_inertia_app -->|"resolves pages"| node_register_page
node_inertia_app -->|"resolves pages"| node_dashboard_page
node_inertia_app -->|"resolves pages"| node_repository_page
node_inertia_app -->|"resolves pages"| node_create_page
node_inertia_app -->|"resolves pages"| node_moderation_page
node_dashboard_page -->|"uses layout"| node_layout
node_repository_page -->|"uses layout"| node_layout
node_create_page -->|"uses layout"| node_layout
node_moderation_page -->|"uses layout"| node_layout
node_auth -->|"renders login"| node_login_page
node_auth -->|"renders registration"| node_register_page
node_dashboard -->|"renders dashboard"| node_dashboard_page
node_projects -->|"renders repository"| node_repository_page
node_projects -->|"renders upload page"| node_create_page
node_moderation -->|"renders moderation"| node_moderation_page

click node_routes "https://github.com/jmrckvr/olfu-capstones/blob/main/routes/web.php"
click node_bootstrap "https://github.com/jmrckvr/olfu-capstones/blob/main/bootstrap/app.php"
click node_role "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Middleware/EnsureRole.php"
click node_inertia_mw "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Middleware/HandleInertiaRequests.php"
click node_auth "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/AuthController.php"
click node_dashboard "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/DashboardController.php"
click node_projects "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/ProjectController.php"
click node_moderation "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/ModerationController.php"
click node_users "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/User.php"
click node_project_model "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/Project.php"
click node_project_files "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/ProjectFile.php"
click node_history "https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/ModerationHistory.php"
click node_inertia_app "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/app.js"
click node_layout "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Layouts/AppLayout.vue"
click node_login_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Auth/Login.vue"
click node_register_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Auth/Register.vue"
click node_dashboard_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Dashboard.vue"
click node_repository_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Repository/Index.vue"
click node_create_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Repository/Create.vue"
click node_moderation_page "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Moderation/Index.vue"
click node_app_view "https://github.com/jmrckvr/olfu-capstones/blob/main/resources/views/app.blade.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_routes,node_bootstrap,node_role,node_inertia_mw,node_visitor toneBlue
class node_auth,node_dashboard,node_projects,node_moderation toneAmber
class node_users,node_project_model,node_project_files,node_history toneMint
class node_inertia_app,node_layout,node_login_page,node_register_page,node_dashboard_page,node_repository_page,node_create_page,node_moderation_page,node_app_view toneRose
```

## Components

### Web entry

- [Web routes](https://github.com/jmrckvr/olfu-capstones/blob/main/routes/web.php): `routes/web.php`
- [Laravel middleware setup](https://github.com/jmrckvr/olfu-capstones/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Role middleware](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Middleware/EnsureRole.php): `app/Http/Middleware/EnsureRole.php`
- [Inertia middleware](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Middleware/HandleInertiaRequests.php): `app/Http/Middleware/HandleInertiaRequests.php`

### Project workflow

- [Authentication](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [Dashboard data](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Project submission and browsing](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/ProjectController.php): `app/Http/Controllers/ProjectController.php`
- [Moderation decisions](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Http/Controllers/ModerationController.php): `app/Http/Controllers/ModerationController.php`

### Domain records

- [User records](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/User.php): `app/Models/User.php`
- [Project records](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/Project.php): `app/Models/Project.php`
- [Project file records](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/ProjectFile.php): `app/Models/ProjectFile.php`
- [Moderation history](https://github.com/jmrckvr/olfu-capstones/blob/main/app/Models/ModerationHistory.php): `app/Models/ModerationHistory.php`

### Inertia interface

- [Vue Inertia app](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/app.js): `resources/js/app.js`
- [Role-based layout](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Layouts/AppLayout.vue): `resources/js/Layouts/AppLayout.vue`
- [Login page](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Auth/Login.vue): `resources/js/Pages/Auth/Login.vue`
- [Registration page](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Auth/Register.vue): `resources/js/Pages/Auth/Register.vue`
- [Dashboard page](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Dashboard.vue): `resources/js/Pages/Dashboard.vue`
- [Repository pages](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Repository/Index.vue): `resources/js/Pages/Repository/Index.vue`
- [Project upload page](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Repository/Create.vue): `resources/js/Pages/Repository/Create.vue`
- [Moderation page](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/js/Pages/Moderation/Index.vue): `resources/js/Pages/Moderation/Index.vue`
- [Inertia HTML shell](https://github.com/jmrckvr/olfu-capstones/blob/main/resources/views/app.blade.php): `resources/views/app.blade.php`

### Other components

- **Visitor / user**

## Connections

- Visitor / user → Web routes: sends requests (evidence: `routes/web.php`)
- Web routes → Authentication: dispatches auth (evidence: `routes/web.php`)
- Web routes → Dashboard data: dispatches dashboard (evidence: `routes/web.php`)
- Web routes → Project submission and browsing: dispatches project (evidence: `routes/web.php`)
- Web routes → Moderation decisions: dispatches moderation (evidence: `routes/web.php`)
- Laravel middleware setup → Role middleware: registers alias (evidence: `bootstrap/app.php`)
- Laravel middleware setup → Inertia middleware: appends middleware (evidence: `bootstrap/app.php`)
- Authentication → User records: creates and authenticates (evidence: `app/Http/Controllers/AuthController.php`)
- Dashboard data → Project records: queries projects (evidence: `app/Http/Controllers/DashboardController.php`)
- Dashboard data → User records: counts users (evidence: `app/Http/Controllers/DashboardController.php`)
- Project submission and browsing → Project records: creates and queries (evidence: `app/Http/Controllers/ProjectController.php`)
- Project submission and browsing → Project file records: stores file records (evidence: `app/Http/Controllers/ProjectController.php`)
- Moderation decisions → Project records: updates projects (evidence: `app/Http/Controllers/ModerationController.php`)
- Moderation decisions → Moderation history: records decision (evidence: `app/Http/Controllers/ModerationController.php`)
- Project records → User records: belongs to owner (evidence: `app/Models/Project.php`)
- Project records → Project file records: has many files (evidence: `app/Models/Project.php`)
- Project records → Moderation history: has moderation history (evidence: `app/Models/Project.php`)
- Vue Inertia app → Inertia HTML shell: mounts in shell (evidence: `resources/views/app.blade.php`)
- Vue Inertia app → Login page: resolves pages (evidence: `resources/js/app.js`)
- Vue Inertia app → Registration page: resolves pages (evidence: `resources/js/app.js`)
- Vue Inertia app → Dashboard page: resolves pages (evidence: `resources/js/app.js`)
- Vue Inertia app → Repository pages: resolves pages (evidence: `resources/js/app.js`)
- Vue Inertia app → Project upload page: resolves pages (evidence: `resources/js/app.js`)
- Vue Inertia app → Moderation page: resolves pages (evidence: `resources/js/app.js`)
- Dashboard page → Role-based layout: uses layout (evidence: `resources/js/Pages/Dashboard.vue`)
- Repository pages → Role-based layout: uses layout (evidence: `resources/js/Pages/Repository/Index.vue`)
- Project upload page → Role-based layout: uses layout (evidence: `resources/js/Pages/Repository/Create.vue`)
- Moderation page → Role-based layout: uses layout (evidence: `resources/js/Pages/Moderation/Index.vue`)
- Authentication → Login page: renders login (evidence: `app/Http/Controllers/AuthController.php`)
- Authentication → Registration page: renders registration (evidence: `app/Http/Controllers/AuthController.php`)
- Dashboard data → Dashboard page: renders dashboard (evidence: `app/Http/Controllers/DashboardController.php`)
- Project submission and browsing → Repository pages: renders repository (evidence: `app/Http/Controllers/ProjectController.php`)
- Project submission and browsing → Project upload page: renders upload page (evidence: `app/Http/Controllers/ProjectController.php`)
- Moderation decisions → Moderation page: renders moderation (evidence: `app/Http/Controllers/ModerationController.php`)
