the data updates

Author: tarxemo

.env.example

@@ -10,7 +10,8 @@ DATABASE_URL=postgresql://username:password@localhost:5432/dbname
 REDIS_URL=redis://localhost:6379/0
 
 # GitHub API Configuration
-GITHUB_ACCESS_TOKEN=your_github_personal_access_token_here
+GITHUB_TOKEN=your_primary_token_here
+GITHUB_TOKENS=token1,token2,token3 # Comma-separated list for rotation
 GITHUB_CLIENT_ID=your_github_oauth_client_id
 GITHUB_CLIENT_SECRET=your_github_oauth_client_secret
 

README.md

@@ -1,153 +1,94 @@
-# GitHub Management Project
-
-A comprehensive Django-based application for managing GitHub repositories, users, and automating GitHub-related tasks. This project provides a robust backend with GraphQL API, task scheduling with Celery, and secure deployment configurations.
-
-## 🚀 Features
-
-- **GitHub Integration**: Interact with GitHub's API to manage repositories and user data
-- **Task Automation**: Schedule and manage background tasks with Celery
-- **GraphQL API**: Flexible and efficient data querying with Graphene-Django
-- **User Authentication**: Secure authentication system with JWT support
-- **Background Processing**: Asynchronous task processing with Redis and Celery
-- **REST API**: Traditional REST endpoints for compatibility
-- **Deployment Ready**: Includes deployment scripts for production environments
-
-  ---
-  # Example of the screenshoot
-  
-<img width="2562" height="1662" alt="image" src="https://github.com/user-attachments/assets/cfa10b06-9bdb-4a84-bfb0-4528a077e514" />
-
-## 🛠️ Tech Stack
-
-- **Backend**: Django 5.1.6
-- **Database**: PostgreSQL
-- **Task Queue**: Celery with Redis as broker
-- **Authentication**: JWT (JSON Web Tokens)
-- **API**: GraphQL (Graphene-Django) & REST
-- **Frontend**: (To be implemented or specify if exists)
-- **Deployment**: Gunicorn, Nginx, Let's Encrypt
-
-## 📦 Prerequisites
-
-- Python 3.8+
-- PostgreSQL
-- Redis
-- GitHub OAuth App credentials
-- Virtual environment (recommended)
-
-## 🚀 Getting Started
-
-### Environment Setup
-
-1. Clone the repository:
-   ```bash
-   git clone <repository-url>
-   cd RB
-   ```
-
-2. Create and activate a virtual environment:
-   ```bash
-   python -m venv venv
-   source venv/bin/activate  # On Windows: venv\Scripts\activate
-   ```
-
-3. Install dependencies:
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-4. Create a `.env` file in the project root with the following variables:
-   ```env
-   DEBUG=True
-   SECRET_KEY=your-secret-key-here
-   DATABASE_URL=postgres://user:password@localhost:5432/dbname
-   REDIS_URL=redis://localhost:6379/0
-   GITHUB_ACCESS_TOKEN=your-github-token
-   ```
-
-### Database Setup
-
-1. Create a PostgreSQL database
-2. Run migrations:
-   ```bash
-   python manage.py migrate
-   ```
-
-### Running the Application
-
-1. Start the development server:
-   ```bash
-   python manage.py runserver
-   ```
-
-2. Start Celery worker (in a new terminal):
-   ```bash
-   celery -A github_management_project worker -l info
-   ```
-
-3. Start Celery beat for scheduled tasks (in another terminal):
-   ```bash
-   celery -A github_management_project beat -l info
-   ```
-
-## 🔐 Environment Variables
-
-| Variable | Description | Required |
-|----------|-------------|----------|
-| `DEBUG` | Enable debug mode | Yes |
-| `SECRET_KEY` | Django secret key | Yes |
-| `DATABASE_URL` | Database connection URL | Yes |
-| `REDIS_URL` | Redis connection URL | Yes |
-| `GITHUB_ACCESS_TOKEN` | GitHub personal access token | Yes |
-| `ALLOWED_HOSTS` | Comma-separated list of allowed hosts | Yes |
-| `CORS_ALLOWED_ORIGINS` | Comma-separated list of allowed origins | No |
-
-## 🧪 Running Tests
-
-```bash
-python manage.py test
-```
+# 🚀 GitHub Management & Developer Hub
 
-## 🚀 Deployment
+Transform your GitHub journey into an engaging experience. This platform isn't just a management tool—it's a social and gamified ecosystem designed to help developers showcase their growth, compete with peers, and discover new opportunities.
 
-### Production Setup
+---
 
-1. Set up a production-ready web server (Nginx recommended)
-2. Configure Gunicorn as the application server
-3. Set up SSL certificates (Let's Encrypt recommended)
-4. Use the deployment script:
-   ```bash
-   sudo ./deploy_django.sh
-   ```
+## 🌟 Key Features
 
-### Environment Configuration
+### 🏆 Unlock Achievements
+Get recognized for your hard work! Whether you're a "Star Magnet," a "Commit Machine," or a "Polyglot Programmer," our achievement system tracks your milestones across multiple tiers.
+- **Tiers**: Progress from Bronze to legendary Gold ranks.
+- **Showcase**: Display your hard-earned badges on your profile.
 
-For production, ensure these settings are properly configured:
-- `DEBUG=False`
-- Proper `ALLOWED_HOSTS`
-- Secure `SECRET_KEY`
-- Production database settings
-- Proper CORS configuration
+### 📊 Competitive Leaderboards
+See where you stand in the developer community. Our **Intelligence Score** algorithm ranks users fairly based on activity, impact, and influence.
+- **Global & Regional**: Compete globally or be the #1 in your country.
+- **Tech-Specific**: Find out if you're the top React developer in your region.
 
-## 🤝 Contributing
+### 🔍 Discovery & Matching
+Stop searching, start finding.
+- **Discovery Feed**: Get personalized recommendations for developers and trending repositories.
+- **Developer Match**: Connect with collaborators having complementary skills for your next project.
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
+### 📈 Personal Growth Analytics
+Watch your influence grow with daily snapshots of your progress.
+- **Trends**: Track followers, stars, and contribution streaks.
+- **Visual Insights**: Interactive charts showing your growth velocity.
 
-## 📄 License
+---
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
+## 📖 User Guide & Use Cases
 
-## 🙏 Acknowledgments
+### 1. Setting up your Profile
+To get the most out of the system, you first need to sync your GitHub data:
+- **Step 1**: Sign in using your GitHub account.
+- **Step 2**: Go to your **Profile** page.
+- **Step 3**: Click on "Sync GitHub Data" (or wait for the automatic daily sync) to fetch your repositories, stars, and languages.
 
-- Django and the Django community
-- Celery for task queue management
-- All open-source libraries used in this project
+### 2. Using GitHub Profile Trophies
+You can display your platform trophies directly on your GitHub README. 
+**Copy and paste the markdown below into your GitHub README.md:**
 
-## 📧 Contact
+```markdown
+[![GitHub Trophies](https://github.tarxemo.com/badges/YOUR_USERNAME/trophies/)](https://github.tarxemo.com/github/user/YOUR_USERNAME/)
+```
+*Replace `YOUR_USERNAME` with your actual GitHub username.*
+
+### 3. Climbing the Leaderboard
+Want to reach the top? The system calculates your **Intelligence Score** based on:
+- **Activity**: Recent commits and pull requests.
+- **Impact**: Total stars and forks on your repositories.
+- **Influence**: Your follower count and organization associations.
+Check the [Leaderboard](https://github.tarxemo.com/github/leaderboard/) daily to see your new rank!
+
+### 4. Discovering Collaborators
+Looking for someone to help with a Python project?
+- Go to the **Discovery** feed.
+- Look at the "Recommended Developers" section.
+- Click "Match" on a profile to see your compatibility score based on shared languages and interests.
+
+---
+
+## 🚀 Getting Started (Deployment)
+
+### 🛠️ Local Development Setup
+
+1.  **Clone & Install**:
+    ```bash
+    git clone <repository-url>
+    pip install -r requirements.txt
+    ```
+2.  **Environment**: Create a `.env` file with your `GITHUB_TOKEN` and database credentials.
+3.  **Migrate & Run**:
+    ```bash
+    python manage.py migrate
+    python manage.py runserver 9000
+    ```
+4.  **Celery Workers**:
+    ```bash
+    # Run in separate terminals
+    celery -A github_management_project worker -l info
+    celery -A github_management_project beat -l info
+    ```
+
+---
+
+## 📄 License
+This project is licensed under the MIT License.
 
+---
 
+## 🙏 Join the community
+Join us in building the ultimate developer ecosystem!
 Project Link: [https://github.tarxemo.com](https://github.tarxemo.com)

badges/migrations/0001_initial.py

@@ -0,0 +1,52 @@
+# Generated by Django 4.2.28 on 2026-02-09 08:27
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+import django.utils.timezone
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Achievement',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100, unique=True)),
+                ('slug', models.SlugField(max_length=100, unique=True)),
+                ('description', models.TextField()),
+                ('icon_name', models.CharField(help_text='Lucide icon name or CSS class', max_length=50)),
+                ('points', models.PositiveIntegerField(default=10)),
+                ('tier', models.CharField(choices=[('bronze', 'Bronze'), ('silver', 'Silver'), ('gold', 'Gold'), ('platinum', 'Platinum'), ('diamond', 'Diamond')], default='bronze', max_length=20)),
+                ('condition_type', models.CharField(help_text="e.g., 'followers_count', 'contributions'", max_length=50)),
+                ('condition_value', models.IntegerField()),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('is_active', models.BooleanField(default=True)),
+            ],
+            options={
+                'ordering': ['points'],
+            },
+        ),
+        migrations.CreateModel(
+            name='UserAchievement',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('earned_at', models.DateTimeField(default=django.utils.timezone.now)),
+                ('current_progress', models.IntegerField(default=0)),
+                ('is_unlocked', models.BooleanField(default=False)),
+                ('achievement', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='earned_by', to='badges.achievement')),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='achievements', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'ordering': ['-earned_at'],
+                'unique_together': {('user', 'achievement')},
+            },
+        ),
+    ]

badges/migrations/__init__.py

@@ -0,0 +1,64 @@
+from django.db import models
+from django.conf import settings
+from django.utils import timezone
+
+class Achievement(models.Model):
+    """Definition of an achievement that can be earned by users."""
+    
+    name = models.CharField(max_length=100, unique=True)
+    slug = models.SlugField(max_length=100, unique=True)
+    description = models.TextField()
+    icon_name = models.CharField(max_length=50, help_text="Lucide icon name or CSS class")
+    points = models.PositiveIntegerField(default=10)
+    
+    class Tier(models.TextChoices):
+        BRONZE = 'bronze', 'Bronze'
+        SILVER = 'silver', 'Silver'
+        GOLD = 'gold', 'Gold'
+        PLATINUM = 'platinum', 'Platinum'
+        DIAMOND = 'diamond', 'Diamond'
+        
+    tier = models.CharField(
+        max_length=20,
+        choices=Tier.choices,
+        default=Tier.BRONZE
+    )
+    
+    # Conditions (simplified for now, logic will be in services)
+    condition_type = models.CharField(max_length=50, help_text="e.g., 'followers_count', 'contributions'")
+    condition_value = models.IntegerField()
+    
+    created_at = models.DateTimeField(auto_now_add=True)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        ordering = ['points']
+
+    def __str__(self):
+        return f"{self.name} ({self.tier})"
+
+class UserAchievement(models.Model):
+    """Relationship between a User and an Achievement they've earned."""
+    
+    user = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.CASCADE,
+        related_name='achievements'
+    )
+    achievement = models.ForeignKey(
+        Achievement,
+        on_delete=models.CASCADE,
+        related_name='earned_by'
+    )
+    earned_at = models.DateTimeField(default=timezone.now)
+    
+    # For tiered achievements that might have progress
+    current_progress = models.IntegerField(default=0)
+    is_unlocked = models.BooleanField(default=False)
+    
+    class Meta:
+        unique_together = ('user', 'achievement')
+        ordering = ['-earned_at']
+
+    def __str__(self):
+        return f"{self.user} - {self.achievement}"

badges/models.py

@@ -0,0 +1,23 @@
+import graphene
+from graphene_django import DjangoObjectType
+from .models import Achievement, UserAchievement
+
+class AchievementType(DjangoObjectType):
+    class Meta:
+        model = Achievement
+        fields = "__all__"
+
+class UserAchievementType(DjangoObjectType):
+    class Meta:
+        model = UserAchievement
+        fields = "__all__"
+
+class Query(graphene.ObjectType):
+    all_achievements = graphene.List(AchievementType)
+    user_achievements = graphene.List(UserAchievementType, username=graphene.String(required=True))
+    
+    def resolve_all_achievements(self, info):
+        return Achievement.objects.filter(is_active=True)
+        
+    def resolve_user_achievements(self, info, username):
+        return UserAchievement.objects.filter(user__github_username=username, is_unlocked=True)