PLDG Dashboard V0

A real-time analytics dashboard for tracking developer engagement, technical progress, and contribution metrics across the PLDG (Protocol Labs Developer Guild) program.

Features

• 📊 Real-time engagement metrics visualization
• 🤝 Tech partner collaboration tracking
• 📈 Technical progress monitoring
• 🏆 Top performer analytics
• 🤖 AI-powered insights generation
• 📑 Executive summary reporting
• 🔄 GitHub integration for issue tracking

Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS + shadcn/ui
• Charts: Recharts
• Data Processing: Lodash
• Validation: Zod
• API Integration:
  • Airtable API (Engagement Data)
  • GitHub GraphQL API (Issue Tracking)
  • Octokit REST API (Repository Data)

Getting Started

Clone the repository

Install dependencies:

npm install

Set up environment variables:

cp .env.example .env.local

Start the development server:

npm run dev

Project Structure

src/
├── app/              # Next.js app router
├── components/       # React components
│   ├── dashboard/   # Dashboard-specific components
│   └── ui/         # Reusable UI components
├── lib/             # Utility functions
│   ├── utils.ts    # General utilities
│   ├── validation.ts # Data validation
│   └── ai.ts       # AI processing
├── types/           # TypeScript type definitions
└── public/          # Static assets
    └── data/       # CSV data files

Data Flow

1. Data Sources:

   • Airtable: Weekly engagement surveys
   • GitHub: Issue tracking and project data

2. Processing Pipeline:

   • Raw data fetching
   • Data validation (Zod schemas)
   • Metric calculations
   • Insight generation

3. Real-time Updates:

   • Automatic refresh intervals
   • On-demand data updates
   • Error handling and retry logic

Contributing

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

MIT License

Known Limitations

1. Historical Data:

   • No persistent storage of historical status changes
   • GitHub status counts reset on page refresh
   • Limited trend analysis capabilities
   • Week-over-week comparisons reset on refresh

2. Real-time Constraints:

   • Data freshness limited by API rate limits
   • Snapshot-based metrics without historical context
   • Limited ability to track long-term patterns

Roadmap

Phase 1 (Current - MVP)

• ✅ Real-time dashboard with key metrics
• ✅ Airtable and GitHub integration
• ✅ Basic trend visualization
• ✅ AI-powered insights

Phase 2 (Planned)

1. Historical Data Storage

   • Implement database for metric persistence
   • Track status changes over time
   • Enable historical trend analysis
   • Add date-range filtering for all metrics

2. Enhanced Analytics

   • Long-term trend analysis
   • Predictive engagement metrics
   • Advanced collaboration patterns
   • Custom reporting periods

3. Performance Optimization

   • Implement data caching
   • Optimize API calls
   • Add pagination for large datasets
   • Improve load times

Phase 3 (Future)

1. Advanced Features

   • Custom metric definitions
   • Automated reporting
   • Integration with more data sources
   • Advanced AI analysis
   • Export capabilities for all metrics

2. User Experience

   • Customizable dashboards
   • Role-based access control
   • Mobile optimization
   • Real-time notifications