Devsplug Server

A Django-based platform for coding challenges with social features and gamification.

🌟 Features

• Structured Learning Paths

  • Categorized challenges
  • Prerequisites system
  • Estimated completion times
  • Attachments and resources
  • Progress tracking

• Coding Challenges

  • Multiple difficulty levels
  • Point-based rewards
  • Solution submissions
  • Code documentation
  • Test cases and templates

• Progress Tracking

  • Category-based progress
  • Completion statistics
  • Achievement titles
  • Learning path progress
  • Recent activity

• Social Features

  • Follow other developers
  • Like/dislike solutions
  • Comment on submissions
  • Private/public solutions

🛠️ Tech Stack

• Django 3.2+
• Django REST Framework
• JWT Authentication
• PostgreSQL
• AWS S3 Compatible Storage
• Custom Test Runner

🚀 Quick Start

1. Clone the repository:

git clone https://github.com/yourusername/devsplug-server.git
cd devsplug-server

2. Set up virtual environment:

python -m venv env
source env/bin/activate  # Linux/Mac
env\Scripts\activate     # Windows

3. Install dependencies:

pip install -r requirements.txt

4. Configure environment variables: Copy .env.example to .env and update the values:

   DEBUG=True
   SECRET_KEY=your-secret-key
   DB_NAME=devsplug
   DB_USER=postgres
   ...
   

5. Run migrations:

python manage.py migrate

6. Load sample data (optional):

python manage.py populate_challenges

7. Start the server:

python manage.py runserver

🧪 Testing

Run the test suite:

python manage.py test

Example test output:

================================================================================
📊 Test Execution Report
================================================================================

📁 authentication.tests
--------------------------------------------------------------------------------
✅ test_user_login
   📝 Test user login with valid credentials
   📥 Response:
      • Status: Success
      • Data: {'access_token': 'Received'}

✅ test_follow_user
   📝 Test that a user can successfully follow another user
   📥 Response:
      • Status: Created Successfully
...

📚 Documentation

For detailed documentation about:

• API Endpoints
• Models & Database Schema
• Testing Infrastructure
• Development Guidelines

See Documentation.md

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Write tests for your changes
4. Commit your changes (git commit -m 'Add some AmazingFeature')
5. Push to the branch (git push origin feature/AmazingFeature)
6. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Authors

• asbilim - Initial work - GitHub

🙏 Acknowledgments

• Django community
• All contributors
• Open source community