How ricardo-lun/servicetracker works
ServiceTracker is a desktop JavaFX application for tracking IT repair and maintenance tickets. Support staff register a device and its service, then manage assignment, status, activities, search, and service details; a report dialog generates a technical PDF. JSON files persist services and user credentials, while access is protected by username/password authentication. The README documents these capabilities; source excerpts verify the registration, service-management, persistence, and PDF paths. Other UI wiring and some controller behavior were not sampled, so those links are not inferred.
Main entry points: RegistroController.java Device registration · GestionController.java Ticket management · JsonService.java JSON persistence · PdfService.java PDF generation
Components 17
Access
- Application startup
src/main/java/mx/edu/buap/servicetracker/HelloApplication.java - Login controller
src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java - User authentication
src/main/java/mx/edu/buap/servicetracker/service/UserService.java - Password hashing
src/main/java/mx/edu/buap/servicetracker/util/SecurityUtils.java
Service workflow
- Device registration
src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java - Ticket management
src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java - Report dialog
src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java
Service data
- Device details
src/main/java/mx/edu/buap/servicetracker/model/Dispositivo.java - Service records
src/main/java/mx/edu/buap/servicetracker/model/Servicio.java - Repair activities
src/main/java/mx/edu/buap/servicetracker/model/Actividad.java - Service table rows
src/main/java/mx/edu/buap/servicetracker/model/ServicioTabla.java - User record
src/main/java/mx/edu/buap/servicetracker/model/Usuario.java
Persistence and reports
- In-memory services
src/main/java/mx/edu/buap/servicetracker/service/DatosSistema.java - JSON persistence
src/main/java/mx/edu/buap/servicetracker/service/JsonService.java - PDF generation
src/main/java/mx/edu/buap/servicetracker/service/PdfService.java - Technical report PDF
Other components
- Support staff
Connections 25
- Support staff → Login controller: signs in
README.md - Application startup → JSON persistence: loads services
src/main/java/mx/edu/buap/servicetracker/HelloApplication.java - Application startup → User authentication: initializes user
src/main/java/mx/edu/buap/servicetracker/HelloApplication.java - Login controller → User authentication: authenticates
src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java - User authentication → User record: reads credentials
src/main/java/mx/edu/buap/servicetracker/service/UserService.java - User authentication → Password hashing: hashes password
src/main/java/mx/edu/buap/servicetracker/service/UserService.java - Support staff → Device registration: registers device
README.md - Device registration → Device details: creates details
src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java - Device registration → Service records: creates ticket
src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java - Device registration → In-memory services: adds ticket
src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java - Device registration → JSON persistence: saves services
src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java - Support staff → Ticket management: updates and searches
README.md - Ticket management → In-memory services: reads and updates
src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java - Ticket management → JSON persistence: loads and saves
src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java - Ticket management → Service table rows: builds search rows
src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java - Ticket management → Repair activities: records activities
src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java - Support staff → Report dialog: requests report
README.md - Report dialog → PDF generation: generates report
src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java - Report dialog → JSON persistence: saves updated status
src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java - PDF generation → Technical report PDF: writes PDF
src/main/java/mx/edu/buap/servicetracker/service/PdfService.java - PDF generation → Service records: reads service data
src/main/java/mx/edu/buap/servicetracker/service/PdfService.java - PDF generation → Repair activities: reads activity list
src/main/java/mx/edu/buap/servicetracker/service/PdfService.java - JSON persistence → In-memory services: loads and saves list
src/main/java/mx/edu/buap/servicetracker/service/JsonService.java - Service records → Device details: holds device
src/main/java/mx/edu/buap/servicetracker/model/Servicio.java - Service records → Repair activities: holds activities
src/main/java/mx/edu/buap/servicetracker/model/Servicio.java