Skip to content

UC-ADM-103: Impact Measurement & Reporting

1. Metadata

Property Value
ID UC-ADM-103
Actor HQ Administrator / CSR Reporting Officer
Trigger End of Month or End of Program Phase
Pre-conditions Raw data anonymized; Baseline and Endline data captured
Post-conditions PDF Impact Report generated; Stored in Cloud Storage
Side Effects Archive old logs; Reset school targets for the next phase

2. Description

The formal mechanism for generating audit-ready impact reports for donors, school boards, and government stakeholders.

3. Success Scenario

  1. Report Initiation: Admin selects "Generate Monthly Impact Report."
  2. Template Selection: Admin chooses between "Technical Audit" or "Stakeholder Summary."
  3. Comparative Analysis:
    • System performs a Baseline vs. Endline comparison of BMI percentiles.
    • System calculates the "Growth in Nutritional Knowledge" based on pre/post-video quiz results.
  4. Anonymization: System replaces Student Names with Unique IDs to ensure PII compliance.
  5. Generation: Backend invokes the PDF Generation service (e.g., Puppeteer/Chrome headless).
  6. Review & Distribution:
    • Admin reviews the PDF preview.
    • Admin clicks "Sign & Dispatch" to email the report to the Board.

4. Acceptance Criteria

  • [ ] Compliance: No student-identifiable data (Names, Photos) appears in the final PDF.
  • [ ] Formatting: Reports must include graphs and tables in a printable A4 format.
  • [ ] Integrity: Every figure in the report must be traceable back to a source dataset ID.

5. Report Logic

KPI Calculation
Knowledge Gain avg(end_quiz) - avg(baseline_quiz)
Program Reach active_users / total_enrolled_students
Health Improvement % students moving from Underweight to Optimal