# wfflssyrup/internshipapplicationmonitoring architecture

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

## Overview

The repository is the Laravel REST backend for an internship-application monitor; the README also describes a Flutter client, but no frontend source tree is provided here. The main user journey creates an application, advances it through role-controlled review and placement, and records an audit timeline. A separate automation capability schedules reminders and escalations, summarizes the weekly pipeline, and supports coordinator recovery. The graph emphasizes backend behavior; unsampled feature details are included only where the README documents them.

Main entry points: [`backend/app/Http/Controllers/Api/V1/ApplicationController.php`](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/ApplicationController.php) (Application API), [`backend/app/Http/Controllers/Api/V1/AuthController.php`](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/AuthController.php) (Authentication), [`backend/app/Services/ApplicationWorkflowService.php`](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/ApplicationWorkflowService.php) (Workflow service), [`backend/routes/api.php`](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/routes/api.php) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_api_routes["API routes<br/>[api.php]"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_partner_lookup["Reviewer lookup"]
end

subgraph group_workflow["Application workflow"]
  node_application_api["Application API"]
  node_workflow_service["Workflow service"]
  node_status_rules["Status rules"]
end

subgraph group_automation["Automation operations"]
  node_automation_api["Automation API"]
  node_sweep_service["Sweep service"]
  node_job_service["Job service"]
  node_dispatcher["Job dispatcher"]
  node_scheduler["Scheduled commands"]
end

subgraph group_domain["Domain and persistence"]
  node_application_record[("Applications")]
  node_audit_log[("Status audit log")]
  node_user_record[("Users<br/>[User.php]")]
  node_automation_jobs[("Automation jobs<br/>[AutomationJob.php]")]
end

node_student(("Student"))
node_adviser(("Adviser"))
node_coordinator(("Coordinator"))
node_partner(("Partner reviewer"))
node_database[("MySQL / MariaDB")]
node_dispatch_service["Automation delivery endpoint"]

node_student -->|"signs in"| node_auth
node_adviser -->|"signs in"| node_auth
node_coordinator -->|"signs in"| node_auth
node_partner -->|"signs in"| node_auth
node_api_routes -->|"routes to"| node_auth
node_api_routes -->|"routes to"| node_application_api
node_api_routes -->|"routes to"| node_automation_api
node_api_routes -->|"routes to"| node_partner_lookup
node_auth -->|"authenticates"| node_user_record
node_student -->|"submits application"| node_application_api
node_adviser -->|"reviews application"| node_application_api
node_coordinator -->|"manages placement"| node_application_api
node_partner -->|"records interview"| node_application_api
node_application_api -->|"delegates create and transition"| node_workflow_service
node_application_api -->|"reads and updates"| node_application_record
node_workflow_service -->|"checks transitions"| node_status_rules
node_workflow_service -->|"creates and transitions"| node_application_record
node_workflow_service -->|"records transitions"| node_audit_log
node_workflow_service -->|"enqueues milestones"| node_job_service
node_partner_lookup -->|"queries reviewers"| node_user_record
node_coordinator -->|"runs and recovers jobs"| node_automation_api
node_automation_api -->|"runs sweep"| node_sweep_service
node_automation_api -->|"requeues and dispatches"| node_dispatcher
node_sweep_service -->|"scans pipeline"| node_application_record
node_sweep_service -->|"enqueues sweep jobs"| node_job_service
node_job_service -->|"creates idempotent jobs"| node_automation_jobs
node_dispatcher -->|"updates job state"| node_automation_jobs
node_dispatcher -->|"posts delivery request"| node_dispatch_service
node_scheduler -->|"runs scheduled sweep"| node_sweep_service
node_application_record -->|"persists records"| node_database
node_audit_log -.->|"persists audit entries"| node_database
node_user_record -.->|"persists accounts"| node_database
node_automation_jobs -->|"persists jobs"| node_database

click node_api_routes "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/routes/api.php"
click node_auth "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/AuthController.php"
click node_partner_lookup "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/PartnerReviewerController.php"
click node_application_api "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/ApplicationController.php"
click node_workflow_service "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/ApplicationWorkflowService.php"
click node_status_rules "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Support/ApplicationStatusMachine.php"
click node_application_record "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/InternshipApplication.php"
click node_audit_log "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/ApplicationStatusLog.php"
click node_user_record "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/User.php"
click node_automation_api "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/AutomationController.php"
click node_sweep_service "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationSweepService.php"
click node_job_service "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationJobService.php"
click node_dispatcher "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationDispatcherService.php"
click node_automation_jobs "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/AutomationJob.php"
click node_scheduler "https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Console/Commands/SweepIncompleteCommand.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_api_routes,node_auth,node_partner_lookup,node_partner toneBlue
class node_application_api,node_workflow_service,node_status_rules,node_database toneAmber
class node_automation_api,node_sweep_service,node_job_service,node_dispatcher,node_scheduler toneMint
class node_application_record,node_audit_log,node_user_record,node_automation_jobs toneRose
class node_student,node_adviser,node_coordinator,node_dispatch_service toneIndigo
```

## Components

### API and access

- [API routes](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Authentication](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/AuthController.php): `backend/app/Http/Controllers/Api/V1/AuthController.php`
- [Reviewer lookup](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/PartnerReviewerController.php): `backend/app/Http/Controllers/Api/V1/PartnerReviewerController.php`

### Application workflow

- [Application API](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/ApplicationController.php): `backend/app/Http/Controllers/Api/V1/ApplicationController.php`
- [Workflow service](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/ApplicationWorkflowService.php): `backend/app/Services/ApplicationWorkflowService.php`
- [Status rules](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Support/ApplicationStatusMachine.php): `backend/app/Support/ApplicationStatusMachine.php`

### Automation operations

- [Automation API](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Http/Controllers/Api/V1/AutomationController.php): `backend/app/Http/Controllers/Api/V1/AutomationController.php`
- [Sweep service](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationSweepService.php): `backend/app/Services/Automation/AutomationSweepService.php`
- [Job service](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationJobService.php): `backend/app/Services/Automation/AutomationJobService.php`
- [Job dispatcher](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Services/Automation/AutomationDispatcherService.php): `backend/app/Services/Automation/AutomationDispatcherService.php`
- [Scheduled commands](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Console/Commands/SweepIncompleteCommand.php): `backend/app/Console/Commands/SweepIncompleteCommand.php`

### Domain and persistence

- [Applications](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/InternshipApplication.php): `backend/app/Models/InternshipApplication.php`
- [Status audit log](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/ApplicationStatusLog.php): `backend/app/Models/ApplicationStatusLog.php`
- [Users](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`
- [Automation jobs](https://github.com/wfflssyrup/internshipapplicationmonitoring/blob/main/backend/app/Models/AutomationJob.php): `backend/app/Models/AutomationJob.php`

### Other components

- **Student**
- **Adviser**
- **Coordinator**
- **Partner reviewer**
- **MySQL / MariaDB**
- **Automation delivery endpoint**

## Connections

- Student → Authentication: signs in
- Adviser → Authentication: signs in
- Coordinator → Authentication: signs in
- Partner reviewer → Authentication: signs in
- API routes → Authentication: routes to (evidence: `backend/routes/api.php`)
- API routes → Application API: routes to (evidence: `backend/routes/api.php`)
- API routes → Automation API: routes to (evidence: `backend/routes/api.php`)
- API routes → Reviewer lookup: routes to (evidence: `backend/routes/api.php`)
- Authentication → Users: authenticates (evidence: `backend/app/Http/Controllers/Api/V1/AuthController.php`)
- Student → Application API: submits application
- Adviser → Application API: reviews application
- Coordinator → Application API: manages placement
- Partner reviewer → Application API: records interview
- Application API → Workflow service: delegates create and transition (evidence: `backend/app/Http/Controllers/Api/V1/ApplicationController.php`)
- Application API → Applications: reads and updates (evidence: `backend/app/Http/Controllers/Api/V1/ApplicationController.php`)
- Workflow service → Status rules: checks transitions (evidence: `backend/app/Services/ApplicationWorkflowService.php`)
- Workflow service → Applications: creates and transitions (evidence: `backend/app/Services/ApplicationWorkflowService.php`)
- Workflow service → Status audit log: records transitions (evidence: `backend/app/Services/ApplicationWorkflowService.php`)
- Workflow service → Job service: enqueues milestones (evidence: `backend/app/Services/ApplicationWorkflowService.php`)
- Reviewer lookup → Users: queries reviewers (evidence: `backend/app/Http/Controllers/Api/V1/PartnerReviewerController.php`)
- Coordinator → Automation API: runs and recovers jobs
- Automation API → Sweep service: runs sweep (evidence: `backend/app/Http/Controllers/Api/V1/AutomationController.php`)
- Automation API → Job dispatcher: requeues and dispatches (evidence: `backend/app/Http/Controllers/Api/V1/AutomationController.php`)
- Sweep service → Applications: scans pipeline (evidence: `backend/app/Services/Automation/AutomationSweepService.php`)
- Sweep service → Job service: enqueues sweep jobs (evidence: `backend/app/Services/Automation/AutomationSweepService.php`)
- Job service → Automation jobs: creates idempotent jobs (evidence: `backend/app/Services/Automation/AutomationJobService.php`)
- Job dispatcher → Automation jobs: updates job state (evidence: `backend/app/Services/Automation/AutomationDispatcherService.php`)
- Job dispatcher → Automation delivery endpoint: posts delivery request (evidence: `backend/app/Services/Automation/AutomationDispatcherService.php`)
- Scheduled commands → Sweep service: runs scheduled sweep
- Applications → MySQL / MariaDB: persists records (evidence: `backend/app/Models/InternshipApplication.php`)
- Status audit log → MySQL / MariaDB: persists audit entries
- Users → MySQL / MariaDB: persists accounts
- Automation jobs → MySQL / MariaDB: persists jobs
