How zhu-j-faceonlive/face-attendance-system-java works
This Spring Boot backend serves employee enrollment, kiosk clock-in, attendance-log, and health endpoints. Enrollment extracts a face template and keeps it with the employee in memory. Clock-in checks passive liveness before extracting a probe and matching it against enrolled templates; only accepted matches produce timestamped records. The Java FaceEngine wrapper delegates biometric operations to a licensed on-premises JNI library. Relationships below follow the excerpted controller and service calls and README-documented SDK boundary; persistence is in-memory, not a database.
Main entry points: AttendanceService.java Attendance service · AttendanceController.java REST controller · FaceEngine.java Face engine wrapper · Employee.java Employee model
Components 10
REST API
- Spring Boot app
src/main/java/com/faceonlive/attendance/AttendanceApplication.java - REST controller
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java
Attendance workflow
- Attendance service
src/main/java/com/faceonlive/attendance/service/AttendanceService.java
Biometric engine
- Face engine wrapper
src/main/java/com/faceonlive/attendance/service/FaceEngine.java - FaceOnLive JNI SDK
In-memory state
- Employee templates
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Employee model
src/main/java/com/faceonlive/attendance/model/Employee.java - Attendance log
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance record
src/main/java/com/faceonlive/attendance/model/AttendanceRecord.java
Other components
- Kiosk / client
Connections 18
- Kiosk / client → REST controller: calls REST
README.md - Spring Boot app → Face engine wrapper: initializes
- REST controller → Attendance service: delegates enrollment
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - REST controller → Attendance service: delegates clock-in
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - REST controller → Attendance service: lists records
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - REST controller → Face engine wrapper: checks readiness
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - REST controller → Employee model: returns enrollment data
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - REST controller → Attendance record: returns clock-in data
src/main/java/com/faceonlive/attendance/controller/AttendanceController.java - Attendance service → Face engine wrapper: extracts template
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance service → Face engine wrapper: checks liveness
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance service → Face engine wrapper: matches templates
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Face engine wrapper → FaceOnLive JNI SDK: invokes JNI
README.md - Attendance service → Employee templates: stores and reads
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance service → Attendance log: appends and lists
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance service → Employee model: creates
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance service → Attendance record: creates
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Employee templates → Employee model: holds
src/main/java/com/faceonlive/attendance/service/AttendanceService.java - Attendance log → Attendance record: holds
src/main/java/com/faceonlive/attendance/service/AttendanceService.java