Jasper reports integration

[corypride]

Added full PDF report generation capability for user usage transcripts uses endpoint to generate PDF reports showing resident activity, program participation, and platform usage metrics, also added subreport tables showing program enrollment, class attendance, and completion status.

📁 Files Added/Modified:

Core Service Implementation:

• backend/src/jasper/jasper_service.go - New service for PDF generation using JasperReports
• backend/src/handlers/user_handler.go - used existing handler for PDF generation endpoint integration

Jasper Templates:

• backend/src/templates/user_usage_report.jrxml - Main report template with logo, user info, and usage metrics
• backend/src/templates/user_usage_programs_subreport.jrxml - Subreport for detailed program participation data
• Compiled .jasper files for both templates

Infrastructure & Dependencies:

• backend/go.mod - Added github.com/evertonvps/go-jasper dependency
• backend/Dockerfile - Updated to include Java 17 JRE and JasperStarter setup
• jasperstarter/ directory - Complete JasperStarter 3.6.2 distribution with all required libraries

🔧 Technical Implementation Details:

Report Features:

• Professional PDF layout with UnlockED branding and logo
• User information display (name, ID, facility, date range)
• Platform usage metrics (total time spent, logins, resources accessed)
• Program participation tables with attendance percentages
• Date formatting and localization support
• Error handling for missing program data

Data Processing:

• JSON data source integration with Go backend
• Temporary file management for JSON data and logo images
• Automatic cleanup of temporary files
• Subreport integration for program details
• Attendance percentage calculations

🐳 Docker Infrastructure:

• Multi-stage build (Go builder + Java runtime)
• Eclipse Temurin JRE 17 Alpine base image
• JasperStarter 3.6.2 integration
• Proper path setup and wrapper scripts
• SSL certificates and timezone info preservation

📊 Jasper Studio Version Compatibility:

Critical Note: As you mentioned, this implementation specifically addresses UUID compatibility issues:

• Compatible Version: Jaspersoft® Studio 6.21.5 (Visual Designer for JasperReports 6.21.5)
• Issue Avoided: Version 7.. had UUID compatibility problems that would cause compilation/runtime errors
• Template Header: All JRXML files are tagged with "Created with Jaspersoft Studio version 6.21.5.final using JasperReports Library version 6.21.5-74d586df47b25dbd05bd0957999819196e59934a"

🔗 Integration Points:

• User handler integration for /users/{id}/usage-report endpoint
• Database queries for user data, program participation, and activity metrics
• JSON data transformation for JasperReports consumption
• Error handling and logging throughout the process

📝 Testing & Cleanup:

• Comprehensive logging for debugging Jasper compilation and processing
• Temporary file cleanup with proper error handling
• Fallback mechanisms for template processing
• Structured logging for monitoring and troubleshooting

This implementation provides a complete, production-ready JasperReports solution that's specifically designed to work with the 6.21.5 version to avoid the UUID compatibility issues you encountered with version 7.

[carddev81]

Works good and the report looks great. Made some comments and suggestions

[carddev81]

Looks good and tested good. Hopefully we can build from this template, this is great!! We can figure out how to automate the compile process during build time :)

[CK-7vn]

Mostly little stuff, good job man! Quite the ticket to undertake, not going to lie, glad I didn't have to do it!

[CK-7vn]

Just two small things, that I must have missed yesterday. Sorry.

[CK-7vn]

Nits, that aren't a big deal. Nice.