Analytics & Reporting
Responsibility
Section titled “Responsibility”Cross-domain Dashboards, PDF/CSV Reports, Exports, Predictive Analytics.
This support domain aggregates data from all core domains to produce analytics dashboards, scheduled and on-demand reports, and data exports. It is a consumer of data from Workforce Management, Productivity, Safety & Compliance, Worker Monitoring, and Asset Management.
Key Entities
Section titled “Key Entities”- Reports (PDF and CSV)
- Dashboards
- Export Jobs (background tasks)
- Download Tokens
Tech Stack
Section titled “Tech Stack”Report generation is implemented within the Angelis Backend FastAPI service:
- FastAPI background tasks — asynchronous report generation
- ReportLab — PDF generation
- Python csv module — CSV generation
- Azure Blob Storage — report file storage (containers:
admincenterreports,workerreports) - SAS URL generation (24-hour expiry) for secure report downloads
- JWT download tokens with automatic refresh on expiry
- i18n — locale-aware report headers, titles, and filename prefixes (Spanish/English)
Supported export types: Companies, Projects, Workers, Test Results, Licenses, Internal Users, Audit Logs.
Integrations
Section titled “Integrations”- Workforce Management — primary data source for most reports
- Productivity — project plan and task data for productivity reports
- Safety & Compliance — anomaly and compliance data for safety reports
- Worker Monitoring — presence and tracking data
- Asset Management — asset inventory and assignment data
- Notifications — once a report is ready, a notification is sent to the requesting user via SSE
- Identity & Access (ACL) — authenticated and authorized via CIAM/Keycloak