How saroop7/anti-tamper-vault works
This repository implements a Raspberry Pi vault access-control system with a web monitor and registration console, backed by a Node API and PostgreSQL. The main workflow is a person requests access at the device; the Pi checks biometric and time-window conditions, controls the lock, and reports events for the web ledger. A second workflow queues enrollment from the registration page, captures biometrics on the Pi, and records the completed enrollment. Source excerpts and index references support the main links; unsampled hardware-alert and blockchain behavior is shown only where references support it.
Main entry points: access_control.py Access control loop · tamper_monitor.py Tamper monitoring · index.js HTTP API · enrollment_worker.py Enrollment worker
Components 28
Web console
- Box monitor
frontend/src/pages/BoxMonitor.jsx - User registrations
frontend/src/pages/UserRegistrations.jsx - Live updates
frontend/src/lib/liveUpdates.js - Console components
frontend/src/components
API and records
- HTTP API
backend/src/index.js - Event ledger routes
backend/routes/events.js - User routes
backend/routes/users.js - Enrollment routes
backend/routes/enrollments.js - Enrollment request routes
backend/routes/enrollmentRequests.js - PostgreSQL records
backend/db.js - SSE notifications
backend/sse.js - Ledger anchoring
backend/anchor.js
Vault device
- Access control loop
pi/access_control.py - Biometric checks
pi/fingerprint_auth.py - Face authentication
pi/face_auth.py - Access time window
pi/time_window.py - Lock and GPIO
pi/gpio_io.py - Tamper monitoring
pi/tamper_monitor.py - Device display
pi/tft_display.py - Clock service
pi/rtc_clock.py - Device configuration
pi/config.py - Event reporting
pi/backend_client.py
Biometric enrollment
- Enrollment worker
pi/enrollment_worker.py - Biometric capture
pi/enrollment_logic.py - Enrollment console
frontend/src/pages/UserRegistrations.jsx
Other components
- Vault operator
- Vault sensors
- SMS alert service
Connections 43
- Vault operator → Box monitor: views ledger
frontend/src/pages/BoxMonitor.jsx - Vault operator → User registrations: manages enrollment
frontend/src/pages/UserRegistrations.jsx - Box monitor → HTTP API: fetches events
frontend/src/pages/BoxMonitor.jsx - User registrations → HTTP API: requests records
frontend/src/pages/UserRegistrations.jsx - Box monitor → Live updates: subscribes
frontend/src/pages/BoxMonitor.jsx - User registrations → Live updates: subscribes
frontend/src/pages/UserRegistrations.jsx - Box monitor → Console components: renders
frontend/src/pages/BoxMonitor.jsx - User registrations → Console components: renders
frontend/src/pages/UserRegistrations.jsx - HTTP API → Event ledger routes: routes to
backend/src/index.js - HTTP API → User routes: routes to
backend/src/index.js - HTTP API → Enrollment routes: routes to
backend/src/index.js - HTTP API → Enrollment request routes: routes to
backend/src/index.js - Event ledger routes → PostgreSQL records: reads and writes
backend/routes/events.js - Event ledger routes → Ledger anchoring: anchors records
backend/routes/events.js - Event ledger routes → SSE notifications: broadcasts changes
backend/routes/events.js - User routes → PostgreSQL records: reads and writes
backend/routes/users.js - Enrollment routes → PostgreSQL records: reads and writes
backend/routes/enrollments.js - Enrollment routes → SSE notifications: broadcasts changes
backend/routes/enrollments.js - Enrollment request routes → PostgreSQL records: queues and updates
backend/routes/enrollmentRequests.js - Enrollment request routes → SSE notifications: broadcasts changes
backend/routes/enrollmentRequests.js - Enrollment worker → Enrollment request routes: polls and reports
pi/enrollment_worker.py - Enrollment worker → Biometric capture: runs capture
pi/enrollment_worker.py - Biometric capture → Enrollment routes: submits enrollment
pi/enrollment_logic.py - Enrollment console → Enrollment request routes: queues and cancels
frontend/src/pages/UserRegistrations.jsx - Enrollment console → Enrollment routes: loads enrollments
frontend/src/pages/UserRegistrations.jsx - Access control loop → Biometric checks: checks fingerprint
pi/access_control.py - Access control loop → Face authentication: checks face
pi/access_control.py - Access control loop → Access time window: checks schedule
pi/access_control.py - Access control loop → Lock and GPIO: controls lock
pi/access_control.py - Access control loop → Tamper monitoring: checks tamper
pi/access_control.py - Access control loop → Device display: updates display
pi/access_control.py - Biometric checks → Vault sensors: reads biometrics
- Tamper monitoring → Vault sensors: reads tamper state
- Tamper monitoring → Event reporting: logs events
pi/tamper_monitor.py - Event reporting → Event ledger routes: posts events
pi/backend_client.py - Tamper monitoring → SMS alert service: sends alerts
pi/tamper_monitor.py - Access control loop → Clock service: reads time
pi/access_control.py - Access control loop → Device configuration: uses settings
pi/access_control.py - Tamper monitoring → Clock service: reads time
pi/tamper_monitor.py - Tamper monitoring → Device display: updates display
pi/tamper_monitor.py - Enrollment worker → Device display: shows status
pi/enrollment_worker.py - Enrollment worker → Clock service: timestamps status
pi/enrollment_worker.py - Enrollment worker → Device configuration: uses settings
pi/enrollment_worker.py