Service Layer medium complexity backend
0
Dependencies
0
Dependents
2
Entities
0
Integrations

Description

Backend service that aggregates team-level activity, expense, and engagement data across coordinators and peer mentors within an organization. Applies filters, computes summary metrics, and produces on-screen payloads as well as CSV and PDF export artifacts.

Feature: Team Reports

team-report-service

Sources & reasoning

The area taxonomy lists Team Reports as a feature of admin-reporting, and the MVP scope for the Admin Web Portal explicitly includes activity overview and basic statistics - Team Reports is the in-portal aggregation surface that delivers this.

Responsibilities

  • Aggregate activity, expense, and engagement metrics scoped to an organization
  • Apply time period, role, association, and activity type filters to source data
  • Compute per-user breakdowns to support drill-down into coordinators and peer mentors
  • Generate CSV and PDF export artifacts from filtered report data
  • Enforce organization-admin authorization on every report query

Interfaces

getTeamReport(orgId, filters: ReportFilters): TeamReport
getUserBreakdown(orgId, userId, filters: ReportFilters): UserReport
exportTeamReport(orgId, filters: ReportFilters, format: 'csv' | 'pdf'): ExportArtifact

Related Data Entities (2)

Data entities managed by this component