How eliansimanca/control-de-asistencia works
This is a Spring-based employee attendance API. Its main workflow accepts a card UID, validates the card and employee, determines entry versus exit from the latest attendance record, and saves a timestamped record. Separate API controllers manage employees and cards and query attendance by employee or date. The repositories provide the persistence access layer; the supplied files show JPA entities and repository interfaces, but do not identify a configured database. Relationships below are limited to calls, routes, and entity associations visible in the excerpts.
Main entry points: AttendanceController.java Attendance intake · Marcacion.java Attendance record · EmpleadoRepository.java Employee repository · MarcacionController.java Attendance queries
Components 13
HTTP API
- Attendance intake
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance queries
src/main/java/com/asistencia/controller/MarcacionController.java - Employee management
src/main/java/com/asistencia/controller/EmpleadoController.java - Card management
src/main/java/com/asistencia/controller/TarjetaController.java
Attendance
- Scan request
src/main/java/com/asistencia/dto/AttendanceRequest.java - Attendance record
src/main/java/com/asistencia/entity/Marcacion.java - Entry or exit
src/main/java/com/asistencia/entity/TipoMarcacion.java
Employees and Cards
- Employee
src/main/java/com/asistencia/entity/Empleado.java - Access card
src/main/java/com/asistencia/entity/Tarjeta.java
Persistence Layer
- Employee repository
src/main/java/com/asistencia/repository/EmpleadoRepository.java - Card repository
src/main/java/com/asistencia/repository/TarjetaRepository.java - Attendance repository
src/main/java/com/asistencia/repository/MarcacionRepository.java
Other components
- API client
Connections 20
- API client → Attendance intake: submits scan
src/main/java/com/asistencia/controller/AttendanceController.java - API client → Attendance queries: queries records
src/main/java/com/asistencia/controller/MarcacionController.java - API client → Employee management: manages employees
src/main/java/com/asistencia/controller/EmpleadoController.java - API client → Card management: manages cards
src/main/java/com/asistencia/controller/TarjetaController.java - Attendance intake → Scan request: accepts
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance intake → Card repository: looks up card
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance intake → Attendance repository: reads and saves
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance intake → Attendance record: creates
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance intake → Entry or exit: sets type
src/main/java/com/asistencia/controller/AttendanceController.java - Attendance queries → Employee repository: looks up employee
src/main/java/com/asistencia/controller/MarcacionController.java - Attendance queries → Attendance repository: queries records
src/main/java/com/asistencia/controller/MarcacionController.java - Employee management → Employee repository: manages records
src/main/java/com/asistencia/controller/EmpleadoController.java - Card management → Employee repository: looks up employee
src/main/java/com/asistencia/controller/TarjetaController.java - Card management → Card repository: manages records
src/main/java/com/asistencia/controller/TarjetaController.java - Employee repository → Employee: persists
src/main/java/com/asistencia/repository/EmpleadoRepository.java - Card repository → Access card: persists
src/main/java/com/asistencia/repository/TarjetaRepository.java - Attendance repository → Attendance record: persists
src/main/java/com/asistencia/repository/MarcacionRepository.java - Attendance record → Employee: references
src/main/java/com/asistencia/entity/Marcacion.java - Attendance record → Entry or exit: uses
src/main/java/com/asistencia/entity/Marcacion.java - Access card → Employee: assigned to
src/main/java/com/asistencia/entity/Tarjeta.java