How art-maker-blip/phinmaed-slc-analytics works
PHINMAED is a role- and scope-limited student grade review application. The main workflow is to upload SIS grade CSVs, review and accept validated batches, calculate zone snapshots using approved rules, then view dashboards/reports and record deliberation or referrals. Administration manages users and reference data; audit records important actions. The graph emphasizes those domain stages and shared authorization. Some subsystem links are based on documented capabilities or indexed imports because their implementation excerpts were not provided.
Main entry points: database.ts PostgreSQL access · imports/server.ts Grade import batches · audit.ts Audit log · concerns/server.ts Concerns and referrals
Components 22
Access and platform
- Web interface
app/(protected)/layout.tsx - Sign-in
components/LoginForm.tsx - Sessions and identity
lib/auth.ts - Role and scope checks
lib/authorize.tsx - API request handling
lib/api.ts - PostgreSQL access
lib/database.ts
Grade analytics
- Grade import batches
lib/imports/server.ts - CSV parsing
lib/imports/csv.ts - Grade validation
lib/imports/grades.ts - Zone rule sets
lib/snapshots/server.ts - Zone classification
lib/zones.ts - Calculated snapshots
lib/snapshots/server.ts
Deliberation
- Concerns and referrals
lib/concerns/server.ts - Deliberation screens
features/deliberation/ConcernListPage.tsx
Reporting and audit
- Role dashboards
features/dashboard/DashboardPage.tsx - Results and summaries
lib/results/server.ts - Dashboard data
lib/results/dashboards.ts - Reports and export
features/reports/ReportsPage.tsx - Audit log
lib/audit.ts
Administration
- User administration
lib/admin/server.ts
Other components
- Staff user
- SIS grade file
Connections 31
- Staff user → Sign-in: signs in
- Sign-in → Sessions and identity: starts session
- Web interface → Role and scope checks: checks access
- Role and scope checks → Sessions and identity: loads identity
lib/authorize.tsx - Staff user → Web interface: uses
- Staff user → SIS grade file: provides grades
- SIS grade file → Grade import batches: uploads CSV
- Grade import batches → CSV parsing: parses file
lib/imports/server.ts - Grade import batches → Grade validation: validates grades
lib/imports/server.ts - Grade import batches → PostgreSQL access: stores batches
lib/imports/server.ts - Staff user → Grade import batches: reviews batch
- Staff user → Zone rule sets: configures rules
- Zone rule sets → Zone classification: supplies thresholds
lib/snapshots/server.ts - Staff user → Calculated snapshots: requests calculation
- Calculated snapshots → PostgreSQL access: writes results
lib/snapshots/server.ts - Staff user → Role dashboards: views dashboard
- Role dashboards → Results and summaries: loads results
app/(protected)/page.tsx - Role dashboards → Dashboard data: loads dashboard data
- Results and summaries → PostgreSQL access: queries snapshots
lib/results/server.ts - Staff user → Reports and export: views reports
- Reports and export → Results and summaries: loads report data
app/(protected)/reports/page.tsx - Staff user → Deliberation screens: reviews concerns
- Deliberation screens → Concerns and referrals: loads concerns
app/(protected)/deliberation/page.tsx - Concerns and referrals → PostgreSQL access: reads and updates
lib/concerns/server.ts - Staff user → User administration: manages users
- User administration → PostgreSQL access: updates records
lib/admin/server.ts - Sessions and identity → PostgreSQL access: reads sessions
lib/auth.ts - Grade import batches → Audit log: records actions
lib/imports/server.ts - Concerns and referrals → Audit log: records actions
lib/concerns/server.ts - User administration → Audit log: records actions
lib/admin/server.ts - Audit log → PostgreSQL access: writes log
lib/audit.ts