How avenidoearllouieo-art/cabinet works
TapTrack combines a Django REST API, a role-based web dashboard, and a standalone cabinet touchscreen with NFC hardware support. The main workflow is that administrators, instructors, and students use the dashboard to manage coursework and view records; the frontend sends API requests to Django, which applies domain logic and persists users, activities, submissions, and cabinet events. Separately, cabinet scans are verified by Django and recorded for the touchscreen workflow. The README documents these product areas; some subsystem links below are dashed because the relevant implementation was not sampled.
Main entry points: api.js API client · views.py REST endpoints · App.jsx Role routing · nfc_service.py NFC service
Components 22
Role-based Dashboard
- Role routing
frontend/src/App.jsx - Admin workspace
frontend/src/pages/admin - Instructor workspace
frontend/src/pages/instructor - Student workspace
frontend/src/pages/student - API client
frontend/src/services/api.js
Django API
- REST endpoints
backend/api/views.py - Role permissions
backend/api/permissions.py - API serialization
backend/api/serializers.py - Django administration
backend/api/admin.py - Student import
backend/api/student_import.py
Coursework Domain
- Domain records
backend/api/models.py - Activities and sections
frontend/src/pages/admin/Activities.jsx - Submission workflow
frontend/src/pages/admin/Submissions.jsx - Access log review
frontend/src/pages/admin/AccessLogs.jsx - Cabinet event review
frontend/src/pages/admin/CabinetEvents.jsx
Cabinet NFC
- Touchscreen workflow
cabinet/src/App.jsx - Scan result bridge
cabinet/src/services/nfc/scanResultBridge.js - Cabinet attendance
cabinet/src/services/cabinetAttendance.js - NFC service
pi_service/nfc_service.py - Reader adapters
pi_service/reader_adapters.py - Local scan event store
pi_service/nfc_service.py
Other components
- Dashboard users
Connections 24
- Dashboard users → Role routing: use
README.md - Role routing → Admin workspace: routes
frontend/src/App.jsx - Role routing → Instructor workspace: routes
frontend/src/App.jsx - Role routing → Student workspace: routes
frontend/src/App.jsx - Admin workspace → API client: requests
frontend/src/pages/admin/Sections.jsx - Instructor workspace → API client: requests
frontend/src/pages/instructor/InstructorSections.jsx - Student workspace → API client: requests
frontend/src/pages/student/StudentProfile.jsx - API client → REST endpoints: calls
README.md - REST endpoints → Role permissions: checks
backend/api/views.py - REST endpoints → API serialization: serializes
backend/api/views.py - REST endpoints → Domain records: reads/writes
backend/api/views.py - Django administration → Domain records: manages
backend/api/admin.py - Django administration → Student import: uses
backend/api/admin.py - Student import → Domain records: updates
backend/api/student_import.py - Activities and sections → API client: requests
- Submission workflow → API client: requests
- Access log review → API client: requests
- Cabinet event review → API client: requests
- Touchscreen workflow → Scan result bridge: polls/sends
cabinet/src/App.jsx - Touchscreen workflow → Cabinet attendance: uses
cabinet/src/App.jsx - NFC service → Reader adapters: uses
pi_service/nfc_service.py - NFC service → Local scan event store: persists
pi_service/nfc_service.py - NFC service → REST endpoints: verifies scans
- Scan result bridge → NFC service: exchanges scan results