# ricardo-lun/servicetracker architecture

> Architecture diagram of the GitHub repository ricardo-lun/servicetracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ricardo-lun/servicetracker
- Repository: https://github.com/ricardo-lun/servicetracker

## Overview

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: [`src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java) (Device registration), [`src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java) (Ticket management), [`src/main/java/mx/edu/buap/servicetracker/service/JsonService.java`](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/JsonService.java) (JSON persistence), [`src/main/java/mx/edu/buap/servicetracker/service/PdfService.java`](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/PdfService.java) (PDF generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access"]
  node_app["Application startup"]
  node_login["Login controller"]
  node_userauth["User authentication<br/>[UserService.java]"]
  node_security["Password hashing<br/>[SecurityUtils.java]"]
end

subgraph group_workflow["Service workflow"]
  node_registration["Device registration"]
  node_management["Ticket management"]
  node_reportdialog["Report dialog"]
end

subgraph group_domain["Service data"]
  node_devices["Device details<br/>[Dispositivo.java]"]
  node_services["Service records<br/>[Servicio.java]"]
  node_activities["Repair activities<br/>[Actividad.java]"]
  node_tableview["Service table rows<br/>[ServicioTabla.java]"]
  node_userrecord["User record<br/>[Usuario.java]"]
end

subgraph group_storage["Persistence and reports"]
  node_serviceindex["In-memory services<br/>[DatosSistema.java]"]
  node_json[("JSON persistence<br/>[JsonService.java]")]
  node_pdf["PDF generation<br/>[PdfService.java]"]
  node_pdfoutput["Technical report PDF"]
end

node_staff(("Support staff"))

node_staff -->|"signs in"| node_login
node_app -->|"loads services"| node_json
node_app -->|"initializes user"| node_userauth
node_login -->|"authenticates"| node_userauth
node_userauth -->|"reads credentials"| node_userrecord
node_userauth -->|"hashes password"| node_security
node_staff -->|"registers device"| node_registration
node_registration -->|"creates details"| node_devices
node_registration -->|"creates ticket"| node_services
node_registration -->|"adds ticket"| node_serviceindex
node_registration -->|"saves services"| node_json
node_staff -->|"updates and searches"| node_management
node_management -->|"reads and updates"| node_serviceindex
node_management -->|"loads and saves"| node_json
node_management -->|"builds search rows"| node_tableview
node_management -->|"records activities"| node_activities
node_staff -->|"requests report"| node_reportdialog
node_reportdialog -->|"generates report"| node_pdf
node_reportdialog -->|"saves updated status"| node_json
node_pdf -->|"writes PDF"| node_pdfoutput
node_pdf -->|"reads service data"| node_services
node_pdf -->|"reads activity list"| node_activities
node_json -->|"loads and saves list"| node_serviceindex
node_services -->|"holds device"| node_devices
node_services -->|"holds activities"| node_activities

click node_app "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/HelloApplication.java"
click node_login "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java"
click node_userauth "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/UserService.java"
click node_security "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/util/SecurityUtils.java"
click node_registration "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java"
click node_management "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java"
click node_reportdialog "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java"
click node_devices "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Dispositivo.java"
click node_services "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Servicio.java"
click node_activities "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Actividad.java"
click node_tableview "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/ServicioTabla.java"
click node_serviceindex "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/DatosSistema.java"
click node_json "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/JsonService.java"
click node_userrecord "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Usuario.java"
click node_pdf "https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/PdfService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_login,node_userauth,node_security toneBlue
class node_registration,node_management,node_reportdialog toneAmber
class node_devices,node_services,node_activities,node_tableview,node_userrecord toneMint
class node_serviceindex,node_json,node_pdf,node_pdfoutput toneRose
class node_staff toneIndigo
```

## Components

### Access

- [Application startup](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/HelloApplication.java): `src/main/java/mx/edu/buap/servicetracker/HelloApplication.java`
- [Login controller](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java): `src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java`
- [User authentication](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/UserService.java): `src/main/java/mx/edu/buap/servicetracker/service/UserService.java`
- [Password hashing](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/util/SecurityUtils.java): `src/main/java/mx/edu/buap/servicetracker/util/SecurityUtils.java`

### Service workflow

- [Device registration](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java): `src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`
- [Ticket management](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java): `src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`
- [Report dialog](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java): `src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java`

### Service data

- [Device details](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Dispositivo.java): `src/main/java/mx/edu/buap/servicetracker/model/Dispositivo.java`
- [Service records](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Servicio.java): `src/main/java/mx/edu/buap/servicetracker/model/Servicio.java`
- [Repair activities](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Actividad.java): `src/main/java/mx/edu/buap/servicetracker/model/Actividad.java`
- [Service table rows](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/ServicioTabla.java): `src/main/java/mx/edu/buap/servicetracker/model/ServicioTabla.java`
- [User record](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/model/Usuario.java): `src/main/java/mx/edu/buap/servicetracker/model/Usuario.java`

### Persistence and reports

- [In-memory services](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/DatosSistema.java): `src/main/java/mx/edu/buap/servicetracker/service/DatosSistema.java`
- [JSON persistence](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/JsonService.java): `src/main/java/mx/edu/buap/servicetracker/service/JsonService.java`
- [PDF generation](https://github.com/ricardo-lun/servicetracker/blob/main/src/main/java/mx/edu/buap/servicetracker/service/PdfService.java): `src/main/java/mx/edu/buap/servicetracker/service/PdfService.java`
- **Technical report PDF**

### Other components

- **Support staff**

## Connections

- Support staff → Login controller: signs in (evidence: `README.md`)
- Application startup → JSON persistence: loads services (evidence: `src/main/java/mx/edu/buap/servicetracker/HelloApplication.java`)
- Application startup → User authentication: initializes user (evidence: `src/main/java/mx/edu/buap/servicetracker/HelloApplication.java`)
- Login controller → User authentication: authenticates (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/LoginController.java`)
- User authentication → User record: reads credentials (evidence: `src/main/java/mx/edu/buap/servicetracker/service/UserService.java`)
- User authentication → Password hashing: hashes password (evidence: `src/main/java/mx/edu/buap/servicetracker/service/UserService.java`)
- Support staff → Device registration: registers device (evidence: `README.md`)
- Device registration → Device details: creates details (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`)
- Device registration → Service records: creates ticket (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`)
- Device registration → In-memory services: adds ticket (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`)
- Device registration → JSON persistence: saves services (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/RegistroController.java`)
- Support staff → Ticket management: updates and searches (evidence: `README.md`)
- Ticket management → In-memory services: reads and updates (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`)
- Ticket management → JSON persistence: loads and saves (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`)
- Ticket management → Service table rows: builds search rows (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`)
- Ticket management → Repair activities: records activities (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/GestionController.java`)
- Support staff → Report dialog: requests report (evidence: `README.md`)
- Report dialog → PDF generation: generates report (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java`)
- Report dialog → JSON persistence: saves updated status (evidence: `src/main/java/mx/edu/buap/servicetracker/controller/ReporteDialogController.java`)
- PDF generation → Technical report PDF: writes PDF (evidence: `src/main/java/mx/edu/buap/servicetracker/service/PdfService.java`)
- PDF generation → Service records: reads service data (evidence: `src/main/java/mx/edu/buap/servicetracker/service/PdfService.java`)
- PDF generation → Repair activities: reads activity list (evidence: `src/main/java/mx/edu/buap/servicetracker/service/PdfService.java`)
- JSON persistence → In-memory services: loads and saves list (evidence: `src/main/java/mx/edu/buap/servicetracker/service/JsonService.java`)
- Service records → Device details: holds device (evidence: `src/main/java/mx/edu/buap/servicetracker/model/Servicio.java`)
- Service records → Repair activities: holds activities (evidence: `src/main/java/mx/edu/buap/servicetracker/model/Servicio.java`)
