dev.md

🛒 E-Commerce API (FastAPI)

🚀 Features

• 🔐 Authentication & Authorization (JWT)
• 📦 Product, Category & Image Management
• 🛒 Cart, Checkout & Orders
• 💳 Stripe Payment Integration
• 📊 Monitoring with Prometheus + Grafana
• 🐞 Logging & Error Tracking with Sentry
• 🧵 Background Tasks (Celery + Flower)
• 🧪 Full Testing Suite (pytest)
• 💅 Code Quality Tools: ruff, black, isort, mypy
• 🛡 Security Layers: bandit, detect-secrets, pip-audit, safety

---

📦 Dependencies

• aiofiles: Async file I/O
• aiosqlite: Async SQLite driver
• alembic: Database migrations
• argon2-cffi: Password hashing
• bandit: Security analysis
• black: Code formatter
• celery: Task queue system
• cryptography: Cryptographic library
• detect-secrets: Secret scanner
• fastapi: Web framework
• fastapi-mail: Email sending
• flower: Celery monitoring UI
• httpx: Async HTTP client
• isort: Import sorter
• loguru: Logging library
• mypy: Static type checker
• orjson: Fast JSON serialization
• passlib: Password hashing utilities
• pip-audit: Vulnerability scanner
• pre-commit: Git hooks manager
• prometheus-fastapi-instrumentator: Metrics exporter
• psycopg: PostgreSQL driver
• pydantic-settings: Config management
• pydantic: Data validation
• pyjwt: JWT handling
• pytest: Testing framework
• pytest-asyncio: Async tests
• pytest-cov: Coverage reports
• python-dotenv: Environment loader
• python-jose: JWT + Crypto
• python-multipart: Multipart form parser
• ruff: Linter & formatter
• safety: Security auditing
• sentry-sdk: Error tracking
• stripe: Payments API
• uvicorn: ASGI server

🚀 How to Run the Project

There are two ways to start the E-Commerce API:

1️⃣ Run with Docker (Recommended)

Make sure you have Docker and Docker Compose installed.

Start the project

docker compose up --build

Stop the project

docker compose down

The API will be available at:

http://localhost:8000

---

2️⃣ Run Locally with Uvicorn

1. Install dependencies

pip install -r requirements.txt

or (if using pyproject.toml)

uv pip install . # or use "uv sync"

2. Configure environment

Create .env file:

cp .env-example .env

Update your DB URL, secret keys, etc.

3. Run database migrations

alembic upgrade head

4. Start the server

uvicorn dev:app --app-dir src --host 0.0.0.0 --port 8000 --reload