# carlo1090/interact_capstone_project architecture

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

- Interactive diagram: https://gitdiagram.com/carlo1090/interact_capstone_project
- Repository: https://github.com/carlo1090/interact_capstone_project

## Overview

InternTrack is an internship journal and progress-monitoring system with a Laravel backend and Vue portals for students, supervisors, coordinators, and administrators. The principal workflow is student intake and placement, followed by time and journal reporting and supervisor or coordinator review; administrative and reporting capabilities support those stages. The README describes mobile as deferred Expo scaffolding, so it is shown only as a limited client branch. Relationships are included only where the README or supplied source index/excerpts document them; unsampled features are represented without speculative call paths.

Main entry points: [`web/src/pages`](https://github.com/carlo1090/interact_capstone_project/tree/main/web/src/pages) (Vue portals), [`mobile/src/hooks/useAuth.ts`](https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/hooks/useAuth.ts) (Mobile auth), [`app/Http/Controllers/Student`](https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Student) (Student reporting), [`app/Models/Batch.php`](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/Batch.php) (Cohort)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web["Vue portals"]
  node_mobile["Expo app"]
  node_mobileauth["Mobile auth<br/>[useAuth.ts]"]
  node_apiclient["Mobile API client<br/>[api.ts]"]
  node_endpoints["Mobile endpoints<br/>[endpoints.ts]"]
  node_apitypes["Mobile API types<br/>[api.ts]"]
end

subgraph group_access["Access and administration"]
  node_auth["Authentication"]
  node_admin["Administration"]
end

subgraph group_placement["Intake and placement"]
  node_intake["Enrollment intake"]
  node_enrollment["Placement service"]
end

subgraph group_progress["Internship progress"]
  node_studentwork["Student reporting"]
  node_review["Journal review"]
  node_supervisor["Supervisor review"]
end

subgraph group_backend["Backend domain"]
  node_batch["Cohort<br/>[Batch.php]"]
  node_enrollmentdata["Student placement<br/>[BatchStudent.php]"]
  node_weeklylog["Weekly journals<br/>[WeeklyLog.php]"]
  node_user["User accounts<br/>[User.php]"]
  node_program["Programs<br/>[Program.php]"]
end

node_student(("Student"))
node_staff(("Staff users"))

node_student -->|"uses portal"| node_web
node_staff -->|"uses portal"| node_web
node_student -->|"uses app"| node_mobile
node_web -->|"authenticates"| node_auth
node_web -->|"uses API"| node_intake
node_web -->|"uses API"| node_studentwork
node_web -->|"uses API"| node_review
node_web -->|"uses API"| node_supervisor
node_web -->|"uses API"| node_admin
node_mobile -->|"uses hook"| node_mobileauth
node_mobileauth -->|"calls"| node_apiclient
node_mobileauth -->|"uses routes"| node_endpoints
node_mobileauth -->|"uses types"| node_apitypes
node_intake -->|"calls"| node_enrollment
node_enrollment -->|"creates placement"| node_enrollmentdata
node_enrollment -->|"resolves cohort"| node_batch
node_review -->|"queries"| node_weeklylog
node_studentwork -->|"manages reports"| node_weeklylog
node_studentwork -->|"resolves enrollment"| node_enrollmentdata
node_studentwork -->|"uses account"| node_user
node_batch -->|"belongs to"| node_program
node_enrollmentdata -->|"belongs to"| node_batch
node_weeklylog -->|"belongs to"| node_batch

click node_web "https://github.com/carlo1090/interact_capstone_project/tree/main/web/src/pages"
click node_mobile "https://github.com/carlo1090/interact_capstone_project/tree/main/mobile/app"
click node_mobileauth "https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/hooks/useAuth.ts"
click node_apiclient "https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/services/api.ts"
click node_endpoints "https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/services/endpoints.ts"
click node_apitypes "https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/types/api.ts"
click node_auth "https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Auth"
click node_admin "https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Admin"
click node_intake "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Http/Controllers/Coordinator/EnrollmentController.php"
click node_enrollment "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Services/EnrollmentService.php"
click node_studentwork "https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Student"
click node_review "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Http/Controllers/Coordinator/CoordinatorJournalReviewController.php"
click node_supervisor "https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Supervisor"
click node_batch "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/Batch.php"
click node_enrollmentdata "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/BatchStudent.php"
click node_weeklylog "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/WeeklyLog.php"
click node_user "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/User.php"
click node_program "https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/Program.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_web,node_mobile,node_mobileauth,node_apiclient,node_endpoints,node_apitypes,node_staff toneBlue
class node_auth,node_admin toneAmber
class node_intake,node_enrollment toneMint
class node_studentwork,node_review,node_supervisor toneRose
class node_batch,node_enrollmentdata,node_weeklylog,node_user,node_program,node_student toneIndigo
```

## Components

### User clients

- [Vue portals](https://github.com/carlo1090/interact_capstone_project/tree/main/web/src/pages): `web/src/pages`
- [Expo app](https://github.com/carlo1090/interact_capstone_project/tree/main/mobile/app): `mobile/app`
- [Mobile auth](https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/hooks/useAuth.ts): `mobile/src/hooks/useAuth.ts`
- [Mobile API client](https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/services/api.ts): `mobile/src/services/api.ts`
- [Mobile endpoints](https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/services/endpoints.ts): `mobile/src/services/endpoints.ts`
- [Mobile API types](https://github.com/carlo1090/interact_capstone_project/blob/main/mobile/src/types/api.ts): `mobile/src/types/api.ts`

### Access and administration

- [Authentication](https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [Administration](https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Admin): `app/Http/Controllers/Admin`

### Intake and placement

- [Enrollment intake](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Http/Controllers/Coordinator/EnrollmentController.php): `app/Http/Controllers/Coordinator/EnrollmentController.php`
- [Placement service](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Services/EnrollmentService.php): `app/Services/EnrollmentService.php`

### Internship progress

- [Student reporting](https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Student): `app/Http/Controllers/Student`
- [Journal review](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Http/Controllers/Coordinator/CoordinatorJournalReviewController.php): `app/Http/Controllers/Coordinator/CoordinatorJournalReviewController.php`
- [Supervisor review](https://github.com/carlo1090/interact_capstone_project/tree/main/app/Http/Controllers/Supervisor): `app/Http/Controllers/Supervisor`

### Backend domain

- [Cohort](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/Batch.php): `app/Models/Batch.php`
- [Student placement](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/BatchStudent.php): `app/Models/BatchStudent.php`
- [Weekly journals](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/WeeklyLog.php): `app/Models/WeeklyLog.php`
- [User accounts](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/User.php): `app/Models/User.php`
- [Programs](https://github.com/carlo1090/interact_capstone_project/blob/main/app/Models/Program.php): `app/Models/Program.php`

### Other components

- **Student**
- **Staff users**

## Connections

- Student → Vue portals: uses portal (evidence: `README.md`)
- Staff users → Vue portals: uses portal (evidence: `README.md`)
- Student → Expo app: uses app (evidence: `README.md`)
- Vue portals → Authentication: authenticates (evidence: `README.md`)
- Vue portals → Enrollment intake: uses API (evidence: `README.md`)
- Vue portals → Student reporting: uses API (evidence: `README.md`)
- Vue portals → Journal review: uses API (evidence: `README.md`)
- Vue portals → Supervisor review: uses API (evidence: `README.md`)
- Vue portals → Administration: uses API (evidence: `README.md`)
- Expo app → Mobile auth: uses hook (evidence: `mobile/src/hooks/useAuth.ts`)
- Mobile auth → Mobile API client: calls (evidence: `mobile/src/hooks/useAuth.ts`)
- Mobile auth → Mobile endpoints: uses routes (evidence: `mobile/src/hooks/useAuth.ts`)
- Mobile auth → Mobile API types: uses types (evidence: `mobile/src/hooks/useAuth.ts`)
- Enrollment intake → Placement service: calls (evidence: `app/Services/EnrollmentService.php`)
- Placement service → Student placement: creates placement (evidence: `app/Services/EnrollmentService.php`)
- Placement service → Cohort: resolves cohort (evidence: `app/Services/EnrollmentService.php`)
- Journal review → Weekly journals: queries (evidence: `app/Http/Controllers/Coordinator/CoordinatorJournalReviewController.php`)
- Student reporting → Weekly journals: manages reports (evidence: `app/Http/Controllers/Student/WeeklyLogController.php`)
- Student reporting → Student placement: resolves enrollment (evidence: `app/Http/Controllers/Student/WeeklyLogController.php`)
- Student reporting → User accounts: uses account (evidence: `app/Http/Controllers/Student/WeeklyLogController.php`)
- Cohort → Programs: belongs to (evidence: `app/Models/Batch.php`)
- Student placement → Cohort: belongs to (evidence: `app/Models/BatchStudent.php`)
- Weekly journals → Cohort: belongs to (evidence: `app/Models/WeeklyLog.php`)
