How milesjdantonio/hokiebikerack works
HokieBikeRack combines a locally operating Arduino rack, a Spring Boot administration backend, and browser interfaces for rider, staff, police, and admin roles. The real Uno enrolls cards locally and reports events over serial; it does not connect to the backend. The principal demo workflow uses a simulated rack with the backend and dashboard. The browser firmware model separately runs the real firmware logic. Several backend controllers and frontend modules were not excerpted, so uncertain links are omitted or marked unverified.
Main entry points: main.cpp Arduino Rack · EventService.java Event Ingestion · api.js Browser API Client · AuditService.java Audit Log
Components 23
Rack Firmware
- Arduino Rack
firmware/src/main.cpp - Card Access
firmware/src/card_reader.cpp - EEPROM Cards
firmware/src/card_store.cpp - Lock & Feedback
firmware/src/lock.cpp - Tamper Detection
firmware/lib/hbr_logic/src/tamper_detector.h
Backend Services
- Rack Management
backend/src/main/java/edu/vt/hokiebikerack/racks/RackService.java - Device Authentication
backend/src/main/java/edu/vt/hokiebikerack/devices/DeviceAuthService.java - Event Ingestion
backend/src/main/java/edu/vt/hokiebikerack/events/EventService.java - Incident Workflow
backend/src/main/java/edu/vt/hokiebikerack/incidents/IncidentService.java - Rider & Cards
backend/src/main/java/edu/vt/hokiebikerack/riders/RiderService.java - Reports
backend/src/main/java/edu/vt/hokiebikerack/reports/ReportService.java
Browser Applications
- Role Dashboards
frontend/shared/console.js - Rider Interface
frontend/shared/rider.js - Campus Map
frontend/shared/map.js - Browser API Client
frontend/js/api.js
Simulation
- Firmware Model
firmware/model/model_api.cpp - Model Interface
frontend/model/app.js - Device Simulator
tools/device_simulator.py
Shared Services
- Audit Log
backend/src/main/java/edu/vt/hokiebikerack/audit/AuditService.java - PostgreSQL
Other components
- Rider
- Staff / Admin
- Police
Connections 30
- Rider → Arduino Rack: taps card
firmware/src/main.cpp - Arduino Rack → Card Access: polls reader
firmware/src/main.cpp - Arduino Rack → EEPROM Cards: checks / enrolls
firmware/src/main.cpp - Arduino Rack → Lock & Feedback: controls outputs
firmware/src/main.cpp - Arduino Rack → Tamper Detection: checks motion
firmware/src/main.cpp - Arduino Rack → Staff / Admin: prints serial events
README.md - Staff / Admin → Role Dashboards: uses dashboard
README.md - Police → Role Dashboards: uses dashboard
README.md - Rider → Rider Interface: uses rider view
README.md - Role Dashboards → Browser API Client: calls API client
frontend/shared/console.js - Rider Interface → Browser API Client: uses API client
- Role Dashboards → Campus Map: renders map
frontend/shared/console.js - Browser API Client → Rack Management: requests backend
- Browser API Client → Event Ingestion: requests backend
- Browser API Client → Rider & Cards: requests backend
- Device Simulator → Device Authentication: simulates rack
- Device Authentication → Event Ingestion: authenticates device
backend/src/main/java/edu/vt/hokiebikerack/devices/DeviceAuthService.java - Event Ingestion → Incident Workflow: publishes refusal
backend/src/main/java/edu/vt/hokiebikerack/events/EventService.java - Rack Management → Audit Log: records changes
backend/src/main/java/edu/vt/hokiebikerack/racks/RackService.java - Event Ingestion → Audit Log: records changes
backend/src/main/java/edu/vt/hokiebikerack/events/EventService.java - Incident Workflow → Audit Log: records changes
backend/src/main/java/edu/vt/hokiebikerack/incidents/IncidentService.java - Rider & Cards → Audit Log: records changes
backend/src/main/java/edu/vt/hokiebikerack/riders/RiderService.java - Rack Management → PostgreSQL: reads / writes
backend/src/main/java/edu/vt/hokiebikerack/racks/RackService.java - Event Ingestion → PostgreSQL: reads / writes
backend/src/main/java/edu/vt/hokiebikerack/events/EventService.java - Incident Workflow → PostgreSQL: reads / writes
backend/src/main/java/edu/vt/hokiebikerack/incidents/IncidentService.java - Rider & Cards → PostgreSQL: reads / writes
backend/src/main/java/edu/vt/hokiebikerack/riders/RiderService.java - Reports → PostgreSQL: queries reports
backend/src/main/java/edu/vt/hokiebikerack/reports/ReportService.java - Audit Log → PostgreSQL: stores audit entries
backend/src/main/java/edu/vt/hokiebikerack/audit/AuditService.java - Model Interface → Firmware Model: boots / steps
frontend/model/app.js - Firmware Model → Arduino Rack: runs firmware
firmware/model/model_api.cpp