How theintonerzero/cse3cap works
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.php API routes · ReflectionController.php Reflection endpoints · Reflection.php Reflection records · routes.tsx Screen routing
Components 28
Diary interface
- App and session
web/src/App.tsx - Screen routing
web/src/app/routes.tsx - Diary screens
web/src/screens - Entry stepper
web/src/screens/EntryStepper.tsx - Review queue
web/src/screens/ReviewQueue.tsx - Typed API client
web/src/api/client.ts - Session provider
web/src/session/SessionProvider.tsx
API boundary
- API routes
api/routes/api.php
Reflection workflow
- Reflection endpoints
api/app/Http/Controllers/Api/V1/ReflectionController.php - Entry endpoints
api/app/Http/Controllers/Api/V1/EntryController.php - Evidence endpoints
api/app/Http/Controllers/Api/V1/EvidenceController.php - Reflection creation
api/app/Services/ReflectionCreator.php - Submission gate
api/app/Services/SubmitGate.php - Role resolution
api/app/Services/RoleResolver.php
Assessment tools
- Review queue endpoint
api/app/Http/Controllers/Api/V1/ReviewQueueController.php - Score endpoint
api/app/Http/Controllers/Api/V1/ScoreController.php - Scoring rules
api/app/Services/Scoring.php - Progress analytics
api/app/Http/Controllers/Api/V1/AnalyticsController.php - Framework endpoints
api/app/Http/Controllers/Api/V1/FrameworkController.php - Framework editing
api/app/Services/FrameworkEditing.php - Framework assignment
api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php
Persistent record
- Reflection records
api/app/Models/Reflection.php - Evidence records
api/app/Models/Evidence.php - Export endpoints
api/app/Http/Controllers/Api/V1/ExportController.php - Export builder
api/app/Jobs/BuildExport.php - PDF renderer
api/app/Exports/PdfRenderer.php
Other components
- Student
- Reviewer
Connections 35
- Student → App and session: uses diary
README.md - Reviewer → App and session: uses queue
README.md - App and session → Session provider: wraps app
web/src/App.tsx - App and session → Screen routing: mounts routes
web/src/App.tsx - Screen routing → Diary screens: renders screens
web/src/app/routes.tsx - Screen routing → Entry stepper: renders stepper
web/src/app/routes.tsx - Screen routing → Review queue: renders queue
web/src/app/routes.tsx - Diary screens → Typed API client: requests data
web/src/screens/ReviewQueue.tsx - Entry stepper → Typed API client: requests data
- Review queue → Typed API client: fetches queue
web/src/screens/ReviewQueue.tsx - Typed API client → API routes: sends API requests
README.md - API routes → Reflection endpoints: dispatches
api/routes/api.php - API routes → Entry endpoints: dispatches
api/routes/api.php - API routes → Evidence endpoints: dispatches
api/routes/api.php - API routes → Review queue endpoint: dispatches
api/routes/api.php - API routes → Score endpoint: dispatches
api/routes/api.php - API routes → Progress analytics: dispatches
api/routes/api.php - API routes → Framework endpoints: dispatches
api/routes/api.php - API routes → Framework assignment: dispatches
api/routes/api.php - Reflection endpoints → Reflection creation: creates via
api/app/Http/Controllers/Api/V1/ReflectionController.php - Reflection endpoints → Submission gate: submits via
api/app/Http/Controllers/Api/V1/ReflectionController.php - Reflection endpoints → Role resolution: resolves roles
api/app/Http/Controllers/Api/V1/ReflectionController.php - Reflection endpoints → Reflection records: reads and writes
api/app/Http/Controllers/Api/V1/ReflectionController.php - Entry endpoints → Reflection records: updates entries
api/app/Http/Controllers/Api/V1/EntryController.php - Evidence endpoints → Evidence records: creates records
api/app/Http/Controllers/Api/V1/EvidenceController.php - Evidence endpoints → Reflection records: checks reflection
api/app/Http/Controllers/Api/V1/EvidenceController.php - Review queue endpoint → Reflection records: queries reviews
api/app/Http/Controllers/Api/V1/ReviewQueueController.php - Score endpoint → Scoring rules: applies rules
api/app/Http/Controllers/Api/V1/ScoreController.php - Score endpoint → Role resolution: checks reviewer
api/app/Http/Controllers/Api/V1/ScoreController.php - Progress analytics → Reflection records: queries progress
api/app/Http/Controllers/Api/V1/AnalyticsController.php - Framework endpoints → Framework editing: edits via
api/app/Http/Controllers/Api/V1/FrameworkController.php - Framework assignment → Framework endpoints: assigns rubric
api/app/Http/Controllers/Api/V1/FrameworkAssignmentController.php - Export endpoints → Export builder: dispatches build
api/app/Http/Controllers/Api/V1/ExportController.php - Export builder → PDF renderer: renders PDF
api/app/Jobs/BuildExport.php - Progress analytics → Student: visualizes radar