Uma Musume Fan Count Manager - Discord Bot
📊 Overview
A professional Discord bot designed to manage and track fan counts for Uma Musume clubs. The bot automatically syncs data from chronogenen.net and provides detailed statistics, leaderboards, and comprehensive member management tools.

⭐ Key Features
🔄 Automatic Data Synchronization
Daily Auto-sync: Bot automatically updates fan count data from chronogenen.net around 10:15-10:20 AM UTC daily
Smart Caching System: Intelligent caching system with 24-hour TTL, automatic refresh and disk persistence for reliability
Google Sheets Integration: Direct integration with Google Sheets, supporting retry logic and exponential backoff for stable connections
Offline Mode: Operates with local cache when internet connection is lost
📈 Statistics & Leaderboards
Detailed Leaderboard: Display member rankings by total fans, daily fans, surplus/deficit
2 Club Modes Support: Competitive (with quota) and Casual (no quota)
Member Statistics: View detailed individual member stats with daily fan growth charts
Multiple Sorting Options: Sort by various criteria (total fans, daily, surplus, etc.)
🔍 Search & Discovery
Search Club: Search and view data for any club on chronogenen.net
Club Request System: Users can request new clubs to be added to the tracking system with admin approval workflow
Autocomplete: Smart club and member name suggestions when entering commands
👥 Club Management (Admin)
Club Creation: Automatically create new clubs from API or import from Excel files
Member Management: Add/remove members, update quotas, manage member lists
Club Configuration: Set quota, webhook URL, club type, and other settings
Excel Import/Export: Import data from Excel files, export for backup
🔔 Notifications & Webhooks
Discord Webhook Integration: Send fan count update notifications via webhook
Change Log Channel: Automatically log all configuration changes to dedicated channel
Request Notifications: Admins receive notifications for new club requests
🛡️ Permission System
God Mode: Highest level admin, not restricted by channel limitations
Admin Roles: Support multiple admin roles with full permissions
Channel Restrictions: Limit bot to operate only in allowed channels
Multi-Server Support: Manage multiple allowed channels across different servers
💾 Backup & Reliability
Disk Persistence: Cache saved to disk, automatic restore on bot restart
Retry Mechanism: Automatic retry with exponential backoff on network errors
Error Handling: Comprehensive error handling, fallback to cache when Google Sheets unavailable
Update Detection: Automatically detect and invalidate cache when new updates available
🔧 System Commands
Cache Management: Clear cache, view cache stats, warm cache
Bot Restart: Restart bot with notification
Library Upgrade: Automatically upgrade dependencies and restart
Health Check: Monitor bot status, uptime, connection health
🎯 Use Cases
For Members:

View personal ranking and stats
Compare progress with other members
Search for other club information
Request new clubs to be added to system
For Club Admins:

Manage member lists and quotas
Monitor daily club performance
Receive notifications via webhook
Export/Import Excel data
For System Admins:

Manage multiple clubs across servers
Configure permissions and channels
Monitor system health
Handle club requests
📊 Data Sources
Primary: chronogenen.net API
Storage: Google Sheets with service account authentication
Cache: Local disk cache for reliability
🌟 Highlights
✅ High uptime with offline mode support
✅ Fast response time thanks to smart caching
✅ Scalable with multiple clubs and members
✅ User-friendly with autocomplete and beautiful embeds
✅ Secure with detailed permission system
✅ Regular updates and maintenance
The bot is designed to run 24/7, automatically handle edge cases, and provide the best experience for both users and admins.

Votando em Mambo the Omniscient

Quer nos ajudar?