Skip to content

ProDev Nexus v1.0.0 - Initial Release

Latest
Latest

Choose a tag to compare

View all tags
@KingsCreatives KingsCreatives released this 02 Dec 19:04
· 6 commits to develop since this release
v1.0.0
13595d6

🎉 Release Overview

Excited to announce the first stable release of ProDev Nexus E-Commerce Backend - a production-grade, scalable API built for modern e-commerce platforms.

This release includes all core e-commerce functionality with enterprise-grade features including JWT authentication, asynchronous processing, atomic transactions, and full Docker containerization.

🚀 What's Included !

Core Features

Authentication & Authorization

  • JWT-based authentication with access/refresh token mechanism
  • Custom user model with role-based access control (Admin/Customer)
  • Secure password hashing and validation
  • Token refresh endpoint for seamless user experience

Product Management

  • Full CRUD operations for product catalog
  • Cloud-based image storage via Cloudinary integration
  • Soft-delete functionality for data retention
  • Advanced filtering by price, category, and stock availability
  • Admin-only product management endpoints

Shopping Cart

  • Real-time cart management
  • Automatic price calculation
  • Cart item quantity updates
  • Cart clearing functionality

Order Processing

  • Atomic order creation with transaction safety
  • Nested order items with automatic price snapshotting
  • Real-time stock adjustment with row-level locking
  • Order history and status tracking
  • Prevents overselling with inventory validation

Notifications System

  • Dual-channel notifications (In-App + Email)
  • Asynchronous email processing via Celery
  • Order confirmation emails
  • Background task queue for non-blocking operations

Infrastructure & DevOps

Containerization

  • Complete Docker Compose setup
  • Multi-service orchestration (Django, PostgreSQL, Redis, Celery)
  • Production-ready with Gunicorn/Nginx configuration
  • Environment-based configuration management

Database

  • PostgreSQL 15 with optimized queries
  • Database migrations included
  • Indexes on frequently queried fields
  • Referential integrity constraints

API Documentation

  • Interactive Swagger/OpenAPI documentation
  • Comprehensive endpoint descriptions
  • Request/response examples
  • Authentication flow documentation

Developer Experience

  • Dedicated landing page with project overview
  • Postman collection for API testing
  • Detailed setup instructions
  • Environment variable templates

📋 Technical Specifications

Stack:

  • Python 3.11
  • Django 5.0
  • Django REST Framework 3.14
  • PostgreSQL 15
  • Redis 7
  • Celery 5
  • Docker & Docker Compose

API Response Time: <200ms (excluding cold starts on free tier)

Deployment: Render (Free Tier) with auto-scaling support

🔧 Installation & Setup

Quick Start with Docker

# Clone the repository
git clone https://github.com/KingsCreatives/prodev-ecommerce-backend.git
cd prodev-ecommerce-backend

# Configure environment variables
cp .env.example .env
# Edit .env with your settings

# Start all services
docker-compose up --build

# Run migrations
docker-compose exec web python src/manage.py migrate

# Create superuser
docker-compose exec web python src/manage.py createsuperuser

Access the API at: http://localhost:8000/

🌐 Live Demo

Experience the API in action:

Note: First request may take up to 50 seconds due to free tier cold start.

📚 API Endpoints

Authentication

  • POST /api/auth/register/ - User registration
  • POST /api/auth/login/ - User login
  • POST /api/auth/token/refresh/ - Refresh access token
  • POST /api/auth/logout/ - User logout

Products

  • GET /api/products/ - List all products
  • POST /api/products/ - Create product (Admin only)
  • GET /api/products/{id}/ - Get product details
  • PUT /api/products/{id}/ - Update product (Admin only)
  • DELETE /api/products/{id}/ - Soft delete product (Admin only)

Cart

  • GET /api/carts/ - Get current cart
  • POST /api/carts/items/ - Add item to cart
  • PATCH /api/carts/items/{id}/ - Update cart item
  • DELETE /api/carts/items/{id}/ - Remove cart item

Orders

  • GET /api/orders/ - List user orders
  • POST /api/orders/ - Create order from cart
  • GET /api/orders/{id}/ - Get order details

Notifications

  • GET /api/notifications/ - List user notifications
  • PATCH /api/notifications/{id}/ - Mark as read

🎯 Use Cases

This backend is perfect for:

  • E-commerce MVPs and prototypes
  • Learning Django REST Framework best practices
  • Understanding async task processing with Celery
  • Studying production-ready API architecture
  • Building upon for custom e-commerce solutions

⚠️ Known Limitations

  • Free Tier Deployment: Cold start latency of up to 50 seconds after inactivity
  • Image Uploads: May timeout on free tier with large files (>5MB)
  • Email: Currently uses console backend in development (configure SMTP for production)

🗺️ Roadmap

Planned features for future releases:

v1.1.0 (Q1 2026)

  • Stripe/PayPal payment integration
  • Webhook handling for payment events
  • Order status transitions (Processing, Shipped, Delivered)

v1.2.0 (Q2 2026)

  • Product reviews and ratings
  • User wishlist functionality
  • Enhanced search with filters

v2.0.0 (Q3 2026)

  • Elasticsearch integration for full-text search
  • Product recommendations engine
  • Admin analytics dashboard
  • Multi-vendor support

📄 License

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

🙏 Acknowledgments

Built with ❤️ by KingsCreatives

Special thanks to:

  • Django & DRF communities
  • Render for free tier hosting

📞 Support

Assets 2
Loading