ADR 017: Analytics Tooling Standards

Status: Proposed | Date: 2025-07-28

Context

Organisations need simple, secure reporting that avoids complex JavaScript toolchains. Static reports reduce maintenance and security overhead.

• Quarto Documentation
• Evidence BI Documentation
• Government Digital Service Design Standards

Decision

Use Quarto for static reporting with Evidence BI for high-interactivity cases only.

Primary: Quarto Framework

• Static Reports: Markdown-based with embedded visualizations
• Multi-format: HTML, PDF outputs from single source
• Git Integration: Reports alongside code in version control
• Compliance Ready: Accessibility and professional formatting

Secondary: Evidence BI

• Limited Use: Only useful for interactive drilldown reporting (simpler to host than e.g. PowerBI)
• SQL-based: Minimal JavaScript complexity

Integration

• Data Sources: Connect via ADR 018: Database Patterns
• Deployment: Use ADR 016: Web Application Edge Protection for secure distribution

Consequences

Benefits

• Low Maintenance: Static reports reduce operational overhead
• Security: Reduced attack surface vs dynamic dashboards
• Git Integration: Version-controlled reports ensure consistency

Trade-offs

• Limited Interactivity: Static reports lack real-time exploration
• Learning Curve: Teams need Quarto knowledge