Discord and GitHub bot: flows order sync based on amount of work was put into organization's public repositories

[konard]

Discord and GitHub bot: flows order sync based on amount of work

This pull request implements a comprehensive flows order sync system that automatically manages Discord roles based on the amount of work contributors put into the organization's public repositories.

🎯 Problem Solved

Manually managing Discord roles for contributors based on their GitHub activity was time-consuming and inconsistent. This solution automates the process by:

• Tracking real-time contribution metrics across all public repositories
• Calculating work scores based on different types of contributions
• Automatically syncing Discord roles to reflect contribution levels
• Providing transparent leaderboards and activity reports

⚡ Key Features

📊 Contribution Tracking

• Commits: Tracks code contributions (1.0 points each)
• Pull Requests: Tracks major code submissions (3.0 points each)
• Issues: Tracks problem reporting and feature requests (1.5 points each)
• Code Reviews: Tracks peer review activities (2.0 points each)

🏆 Role Tiers

Automatic role assignment based on work scores:

• 🥇 Contributor Legend (100+ points) - Gold role
• 🥈 Senior Contributor (50+ points) - Purple role
• 🥉 Active Contributor (20+ points) - Blue role
• 🏅 Contributor (5+ points) - Green role
• 👤 Member (0+ points) - Light grey role

🤖 Automation

• Triggered via GitHub issues with specific keywords
• Configurable time periods (default: 3 months)
• Automatic Discord role synchronization
• Contribution leaderboards posted to Discord channels

🛠 Implementation Details

Core Components

1. ContributionTrackingService

• Aggregates activity from all public repositories
• Calculates weighted work scores
• Ranks contributors and assigns positions

2. DiscordRoleSyncService

• Manages Discord bot connection and role operations
• Automatically creates and assigns role tiers
• Generates rich contribution reports with leaderboards

3. FlowsOrderSyncTrigger

• GitHub issue-based trigger system
• Configurable via issue body parameters
• Saves contribution data for historical analysis

Configuration Options

The bot now accepts additional command-line parameters:

--discord-bot-token <token>     # Discord bot token for role sync
--enable-flows-sync <true/false> # Enable/disable flows sync functionality

Usage Example

Create a GitHub issue titled "flows order sync" with optional configuration:

months = 6
discord_token = YOUR_BOT_TOKEN
discord_guild_id = YOUR_SERVER_ID
discord_channel_id = YOUR_CHANNEL_ID
sync_roles = true

The bot will:

1. 📈 Analyze 6 months of contribution data
2. 🔄 Update Discord roles based on work scores
3. 📊 Post a leaderboard to the specified Discord channel
4. 💾 Save historical contribution data
5. ✅ Close the issue with a status report

🧪 Testing

• ✅ Code compiles successfully with .NET 8
• ✅ All dependencies resolved (Discord.NET 3.15.3 added)
• ✅ Integration with existing bot architecture
• ✅ FileStorage compatibility for data persistence

📝 Future Enhancements

• Web dashboard for contribution visualization
• Configurable scoring weights per organization
• Integration with additional Git platforms
• Advanced metrics (code quality, review depth)
• Notification system for role changes

🔧 Technical Notes

• Uses Discord.NET library for Discord integration
• Maintains backward compatibility with existing triggers
• Follows existing codebase patterns and conventions
• Implements proper error handling and logging
• Stores data using the existing FileStorage system

---

Fixes #110

🤖 Generated with Claude Code