How zico-hubb/facial-recognition-access- works
FaceGate is a Flask facial-recognition access and attendance system. Its main workflow accepts student registration or a recognition image, detects and embeds faces, compares embeddings, and records successful access events in PostgreSQL; dashboard pages are documented as the way to view students and logs. The sampled Flask app implements its own recognition service and raw SQL access, distinct from the SQLAlchemy models and database configuration. The README describes a Next.js frontend, but the tree contains no frontend source to inspect, so that connection is documented but unverified.
Main entry points: app.py Flask API · database.py Database Configuration · camera.py Camera Demo · student.py Student Model
Components 14
Access API
- Flask API
backend/app.py - Student Registration
backend/app.py - Recognition Request
backend/app.py - Student And Log View
backend/app.py
Face Recognition
- Recognition Service
backend/app.py - Embedding Utilities
backend/face_recognition_util.py - Camera Demo
backend/camera.py
Persistence
- PostgreSQL
- Database Configuration
backend/core/database.py - Student Model
backend/models/student.py - Access Log Model
backend/models/log.py
Dashboard
- Web Dashboard
frontend
Other components
- Administrator
- Camera User
Connections 16
- Administrator → Student Registration: submits image
README.md - Student Registration → Flask API: posts to
README.md - Flask API → Recognition Service: detects and embeds
backend/app.py - Recognition Service → PostgreSQL: loads embeddings
backend/app.py - Student Registration → PostgreSQL: stores student
backend/app.py - Camera User → Recognition Request: submits frame
README.md - Recognition Request → Flask API: posts to
README.md - Flask API → Recognition Service: compares faces
backend/app.py - Flask API → PostgreSQL: writes access log
backend/app.py - Administrator → Student And Log View: requests records
README.md - Student And Log View → PostgreSQL: reads students and logs
backend/app.py - Web Dashboard → Student And Log View: displays results
README.md - Database Configuration → PostgreSQL: configures connection
backend/core/database.py - Student Model → Database Configuration: uses base
backend/models/student.py - Access Log Model → Database Configuration: uses base
backend/models/log.py - Camera Demo → Embedding Utilities: calls recognition helpers
backend/camera.py