# theintonerzero/cse3cap architecture

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

- Interactive diagram: https://gitdiagram.com/theintonerzero/cse3cap
- Repository: https://github.com/theintonerzero/cse3cap

## Overview

Alumable Reflection Diary is a student-owned learning record: students create gig- or sprint-linked reflections, attach evidence and self-score against an assigned competency framework; reviewers counter-score, with analytics and export supporting the lasting record. The graph shows the browser-to-API path, key reflection and assessment stages, framework management, and record/export components. Backend relationships are grounded in indexed controller references and excerpts; several frontend screens and backend features are represented at their exact tree paths but were not sampled, so their internal calls are not inferred.

Main entry points: [`api/routes/api.php`](https://github.com/theintonerzero/cse3cap/blob/dev/api/routes/api.php) (API routes), [`api/app/Http/Controllers/Api/V1/ReflectionController.php`](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ReflectionController.php) (Reflection endpoints), [`api/app/Models/Reflection.php`](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Models/Reflection.php) (Reflection records), [`web/src/app/routes.tsx`](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/app/routes.tsx) (Screen routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Diary interface"]
  node_app["App and session<br/>[App.tsx]"]
  node_routes["Screen routing<br/>[routes.tsx]"]
  node_diary["Diary screens"]
  node_entry["Entry stepper<br/>[EntryStepper.tsx]"]
  node_reviewui["Review queue<br/>[ReviewQueue.tsx]"]
  node_client["Typed API client<br/>[client.ts]"]
  node_session["Session provider"]
end

subgraph group_api["API boundary"]
  node_router["API routes<br/>[api.php]"]
end

subgraph group_reflection["Reflection workflow"]
  node_reflectionctl["Reflection endpoints"]
  node_entryctl["Entry endpoints"]
  node_evidencectl["Evidence endpoints"]
  node_creator["Reflection creation"]
  node_submitgate["Submission gate<br/>[SubmitGate.php]"]
  node_roles["Role resolution<br/>[RoleResolver.php]"]
end

subgraph group_assessment["Assessment tools"]
  node_queue["Review queue endpoint"]
  node_scores["Score endpoint"]
  node_scoring["Scoring rules<br/>[Scoring.php]"]
  node_analytics["Progress analytics"]
  node_frameworks["Framework endpoints"]
  node_frameworkedit["Framework editing"]
  node_assign["Framework assignment"]
end

subgraph group_record["Persistent record"]
  node_reflectionmodel[("Reflection records<br/>[Reflection.php]")]
  node_evidence[("Evidence records<br/>[Evidence.php]")]
  node_exports["Export endpoints"]
  node_exportjob["Export builder<br/>[BuildExport.php]"]
  node_renderer["PDF renderer<br/>[PdfRenderer.php]"]
end

node_student(("Student"))
node_reviewer(("Reviewer"))

node_student -->|"uses diary"| node_app
node_reviewer -->|"uses queue"| node_app
node_app -->|"wraps app"| node_session
node_app -->|"mounts routes"| node_routes
node_routes -->|"renders screens"| node_diary
node_routes -->|"renders stepper"| node_entry
node_routes -->|"renders queue"| node_reviewui
node_diary -.->|"requests data"| node_client
node_entry -.->|"requests data"| node_client
node_reviewui -->|"fetches queue"| node_client
node_client -->|"sends API requests"| node_router
node_router -->|"dispatches"| node_reflectionctl
node_router -->|"dispatches"| node_entryctl
node_router -->|"dispatches"| node_evidencectl
node_router -->|"dispatches"| node_queue
node_router -->|"dispatches"| node_scores
node_router -->|"dispatches"| node_analytics
node_router -->|"dispatches"| node_frameworks
node_router -->|"dispatches"| node_assign
node_reflectionctl -->|"creates via"| node_creator
node_reflectionctl -->|"submits via"| node_submitgate
node_reflectionctl -->|"resolves roles"| node_roles
node_reflectionctl -->|"reads and writes"| node_reflectionmodel
node_entryctl -->|"updates entries"| node_reflectionmodel
node_evidencectl -->|"creates records"| node_evidence
node_evidencectl -->|"checks reflection"| node_reflectionmodel
node_queue -->|"queries reviews"| node_reflectionmodel
node_scores -->|"applies rules"| node_scoring
node_scores -->|"checks reviewer"| node_roles
node_analytics -->|"queries progress"| node_reflectionmodel
node_frameworks -->|"edits via"| node_frameworkedit
node_assign -->|"assigns rubric"| node_frameworks
node_exports -->|"dispatches build"| node_exportjob
node_exportjob -->|"renders PDF"| node_renderer
node_analytics -.->|"visualizes radar"| node_student

click node_app "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/App.tsx"
click node_routes "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/app/routes.tsx"
click node_diary "https://github.com/theintonerzero/cse3cap/tree/dev/web/src/screens"
click node_entry "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/screens/EntryStepper.tsx"
click node_reviewui "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/screens/ReviewQueue.tsx"
click node_client "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/api/client.ts"
click node_session "https://github.com/theintonerzero/cse3cap/blob/dev/web/src/session/SessionProvider.tsx"
click node_router "https://github.com/theintonerzero/cse3cap/blob/dev/api/routes/api.php"
click node_reflectionctl "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ReflectionController.php"
click node_entryctl "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/EntryController.php"
click node_evidencectl "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/EvidenceController.php"
click node_creator "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/ReflectionCreator.php"
click node_submitgate "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/SubmitGate.php"
click node_roles "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/RoleResolver.php"
click node_queue "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ReviewQueueController.php"
click node_scores "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ScoreController.php"
click node_scoring "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/Scoring.php"
click node_analytics "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/AnalyticsController.php"
click node_frameworks "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/FrameworkController.php"
click node_frameworkedit "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/FrameworkEditing.php"
click node_assign "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php"
click node_reflectionmodel "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Models/Reflection.php"
click node_evidence "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Models/Evidence.php"
click node_exports "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ExportController.php"
click node_exportjob "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Jobs/BuildExport.php"
click node_renderer "https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Exports/PdfRenderer.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_app,node_routes,node_diary,node_entry,node_reviewui,node_client,node_session,node_reviewer toneBlue
class node_router toneAmber
class node_reflectionctl,node_entryctl,node_evidencectl,node_creator,node_submitgate,node_roles toneMint
class node_queue,node_scores,node_scoring,node_analytics,node_frameworks,node_frameworkedit,node_assign toneRose
class node_reflectionmodel,node_evidence,node_exports,node_exportjob,node_renderer,node_student toneIndigo
```

## Components

### Diary interface

- [App and session](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/App.tsx): `web/src/App.tsx`
- [Screen routing](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/app/routes.tsx): `web/src/app/routes.tsx`
- [Diary screens](https://github.com/theintonerzero/cse3cap/tree/dev/web/src/screens): `web/src/screens`
- [Entry stepper](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/screens/EntryStepper.tsx): `web/src/screens/EntryStepper.tsx`
- [Review queue](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/screens/ReviewQueue.tsx): `web/src/screens/ReviewQueue.tsx`
- [Typed API client](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/api/client.ts): `web/src/api/client.ts`
- [Session provider](https://github.com/theintonerzero/cse3cap/blob/dev/web/src/session/SessionProvider.tsx): `web/src/session/SessionProvider.tsx`

### API boundary

- [API routes](https://github.com/theintonerzero/cse3cap/blob/dev/api/routes/api.php): `api/routes/api.php`

### Reflection workflow

- [Reflection endpoints](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ReflectionController.php): `api/app/Http/Controllers/Api/V1/ReflectionController.php`
- [Entry endpoints](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/EntryController.php): `api/app/Http/Controllers/Api/V1/EntryController.php`
- [Evidence endpoints](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/EvidenceController.php): `api/app/Http/Controllers/Api/V1/EvidenceController.php`
- [Reflection creation](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/ReflectionCreator.php): `api/app/Services/ReflectionCreator.php`
- [Submission gate](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/SubmitGate.php): `api/app/Services/SubmitGate.php`
- [Role resolution](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/RoleResolver.php): `api/app/Services/RoleResolver.php`

### Assessment tools

- [Review queue endpoint](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ReviewQueueController.php): `api/app/Http/Controllers/Api/V1/ReviewQueueController.php`
- [Score endpoint](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ScoreController.php): `api/app/Http/Controllers/Api/V1/ScoreController.php`
- [Scoring rules](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/Scoring.php): `api/app/Services/Scoring.php`
- [Progress analytics](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/AnalyticsController.php): `api/app/Http/Controllers/Api/V1/AnalyticsController.php`
- [Framework endpoints](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/FrameworkController.php): `api/app/Http/Controllers/Api/V1/FrameworkController.php`
- [Framework editing](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Services/FrameworkEditing.php): `api/app/Services/FrameworkEditing.php`
- [Framework assignment](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php): `api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php`

### Persistent record

- [Reflection records](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Models/Reflection.php): `api/app/Models/Reflection.php`
- [Evidence records](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Models/Evidence.php): `api/app/Models/Evidence.php`
- [Export endpoints](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Http/Controllers/Api/V1/ExportController.php): `api/app/Http/Controllers/Api/V1/ExportController.php`
- [Export builder](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Jobs/BuildExport.php): `api/app/Jobs/BuildExport.php`
- [PDF renderer](https://github.com/theintonerzero/cse3cap/blob/dev/api/app/Exports/PdfRenderer.php): `api/app/Exports/PdfRenderer.php`

### Other components

- **Student**
- **Reviewer**

## Connections

- Student → App and session: uses diary (evidence: `README.md`)
- Reviewer → App and session: uses queue (evidence: `README.md`)
- App and session → Session provider: wraps app (evidence: `web/src/App.tsx`)
- App and session → Screen routing: mounts routes (evidence: `web/src/App.tsx`)
- Screen routing → Diary screens: renders screens (evidence: `web/src/app/routes.tsx`)
- Screen routing → Entry stepper: renders stepper (evidence: `web/src/app/routes.tsx`)
- Screen routing → Review queue: renders queue (evidence: `web/src/app/routes.tsx`)
- Diary screens → Typed API client: requests data (evidence: `web/src/screens/ReviewQueue.tsx`)
- Entry stepper → Typed API client: requests data
- Review queue → Typed API client: fetches queue (evidence: `web/src/screens/ReviewQueue.tsx`)
- Typed API client → API routes: sends API requests (evidence: `README.md`)
- API routes → Reflection endpoints: dispatches (evidence: `api/routes/api.php`)
- API routes → Entry endpoints: dispatches (evidence: `api/routes/api.php`)
- API routes → Evidence endpoints: dispatches (evidence: `api/routes/api.php`)
- API routes → Review queue endpoint: dispatches (evidence: `api/routes/api.php`)
- API routes → Score endpoint: dispatches (evidence: `api/routes/api.php`)
- API routes → Progress analytics: dispatches (evidence: `api/routes/api.php`)
- API routes → Framework endpoints: dispatches (evidence: `api/routes/api.php`)
- API routes → Framework assignment: dispatches (evidence: `api/routes/api.php`)
- Reflection endpoints → Reflection creation: creates via (evidence: `api/app/Http/Controllers/Api/V1/ReflectionController.php`)
- Reflection endpoints → Submission gate: submits via (evidence: `api/app/Http/Controllers/Api/V1/ReflectionController.php`)
- Reflection endpoints → Role resolution: resolves roles (evidence: `api/app/Http/Controllers/Api/V1/ReflectionController.php`)
- Reflection endpoints → Reflection records: reads and writes (evidence: `api/app/Http/Controllers/Api/V1/ReflectionController.php`)
- Entry endpoints → Reflection records: updates entries (evidence: `api/app/Http/Controllers/Api/V1/EntryController.php`)
- Evidence endpoints → Evidence records: creates records (evidence: `api/app/Http/Controllers/Api/V1/EvidenceController.php`)
- Evidence endpoints → Reflection records: checks reflection (evidence: `api/app/Http/Controllers/Api/V1/EvidenceController.php`)
- Review queue endpoint → Reflection records: queries reviews (evidence: `api/app/Http/Controllers/Api/V1/ReviewQueueController.php`)
- Score endpoint → Scoring rules: applies rules (evidence: `api/app/Http/Controllers/Api/V1/ScoreController.php`)
- Score endpoint → Role resolution: checks reviewer (evidence: `api/app/Http/Controllers/Api/V1/ScoreController.php`)
- Progress analytics → Reflection records: queries progress (evidence: `api/app/Http/Controllers/Api/V1/AnalyticsController.php`)
- Framework endpoints → Framework editing: edits via (evidence: `api/app/Http/Controllers/Api/V1/FrameworkController.php`)
- Framework assignment → Framework endpoints: assigns rubric (evidence: `api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php`)
- Export endpoints → Export builder: dispatches build (evidence: `api/app/Http/Controllers/Api/V1/ExportController.php`)
- Export builder → PDF renderer: renders PDF (evidence: `api/app/Jobs/BuildExport.php`)
- Progress analytics → Student: visualizes radar
