RESTful HTTP API using Python Flask that allows users to manage their ecommerce platform.

• Create a user
• users can login
• user can logout
• Create an order

Add New Product Update a product See all users Create a user

GADGETGO is a robust, production-ready RESTful API for an e-commerce platform. It provides a complete backend solution for managing users, products, categories, orders, and payments. Built with Flask and SQLAlchemy, it features secure JWT authentication, role-based access control, and image handling.

• User Management: Registration, Login (JWT), Logout (Token Blacklist), Profile management.
• Product Catalog: CRUD operations for products and categories.
• Order Processing: Create, view, update, and cancel orders.
• Image Handling: Support for product images (via Pillow).
• Security: Password hashing (Bcrypt), JWT Authentication, Token Blacklisting.
• Database: SQLAlchemy ORM with SQLite (default) or PostgreSQL/MySQL support.
• Migrations: Database schema migrations using Flask-Migrate.
• Deployment Ready: Gunicorn configuration included.

• Framework: Flask
• Database: SQLAlchemy (ORM), SQLite (Dev)
• Authentication: PyJWT, Flask-Login
• Forms/Validation: Flask-WTF
• Utilities: Pillow (Images), Flask-Mail (Email), Flask-Migrate (DB Migrations)
• Server: Gunicorn

GADGETGO/
├── app/
│   └── v1/
│       ├── models/       # Database models (User, Product, Order)
│       ├── routes/       # API endpoints (Blueprints)
│       ├── utils/        # Helper functions (Auth, Tokens)
│       ├── templates/    # HTML templates (if using UI)
│       └── __init__.py   # App factory
├── instance/             # SQLite database location
├── migrations/           # Database migration scripts
├── config.py             # Configuration settings
├── run.py                # Entry point
├── requirements.txt      # Dependencies
└── README.md             # Documentation

• Python 3.8+
• Git

git clone https://github.com/GODSPE1/GADGETGO.git
cd GADGETGO

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

pip install -r requirements.txt

Create a .env file in the root directory:

export SECRET_KEY="your-super-secret-key"
export FLASK_APP=run.py
export FLASK_ENV=development

flask db init
flask db migrate -m "Initial migration"
flask db upgrade

Note: If you just want to run with the default setup, the app will create the DB on first run if configured in __init__.py.

flask run

The API will be available at http://127.0.0.1:5000.

Run the tests (if available) or use curl to test endpoints manually.

Example: Login

curl -X POST http://127.0.0.1:5000/auth/login \
     -H "Content-Type: application/json" \
     -d '{"username":"admin", "password":"password"}'

To run in production using Gunicorn:

gunicorn -w 4 -b 0.0.0.0:8000 run:app

1. Fork the project
2. Create your 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

Distributed under the MIT License. See LICENSE for more information.