5.0 Distribution Tracking & Dashboards - FatinaAlTaherr/HopeConnect GitHub Wiki

Overview

The dashboard system provides tailored views for donors and orphanages to track donations, impact, and performance metrics.

Donor Dashboard

DonorDashboardController

Personalized donor analytics.

• Endpoints:
  • GET /dashboard/donor/summary:
    • Total donated amount
    • Donation count statistics
    • Recent donation list
  • GET /dashboard/donor/updates:
    • All updates for donor's contributions
  • GET /dashboard/donor/impact:
    • Category-based impact breakdown
    • Supported orphanage count

DTOs

DonorSummaryDTO

• totalDonated: Lifetime contribution sum
• totalDonations: All-time count
• completedDonations: Successful donations
• recentDonations: Latest 5 contributions

RecentDonationDTO

• id: Donation reference
• category: Donation purpose
• amount: Contribution value
• status: Current state
• date: When given

Orphanage Dashboard

OrphanageDashboardController

Orphanage-specific analytics.

• Endpoints:
  • GET /dashboard/orphanage/summary:
    • Total funds received
    • Donation volume metrics
    • Recent donations list
    • Average rating
  • GET /dashboard/orphanage/category:
    • Category-based funding breakdown
  • POST /dashboard/orphanage/updates:
    • Add progress updates for donors

DTOs

DonationSummaryDTO

• id: Donation reference
• donorName: Contributor identity
• amount: Donation value
• category: Funding purpose
• date: When received

DonationUpdateResponseDTO

• message: Confirmation text
• title: Update headline
• description: Detailed content
• imageUrl: Visual reference

Workflows

Donor Experience

1. View personalized dashboard
2. Track individual donations
3. See impact metrics
4. Receive updates on contributions
5. Submit orphanage reviews

Orphanage Experience

1. Monitor donation intake
2. Categorize funding sources
3. Provide donor updates
4. Track delivery statuses
5. Manage donor relationships

Security

• All endpoints require authentication
• Donor views restricted to own data
• Orphanage views restricted to own organization
• Role-based access control enforced