How donovan-nudrak/e_commerce works
Ecommerce API is a FastAPI service for customer shopping and administration. HTTP clients enter through the app, then use domain endpoints for account access, browsing, cart management, checkout, and order tracking; administrators also manage catalog and fulfillment. The documented order lifecycle reserves stock at creation and restores it on cancellation. The code follows router/service/repository/model layers, with PostgreSQL persistence, Redis-backed authentication tokens, and local image storage. Several service internals were not sampled, so those documented capabilities are shown without speculative internal call chains.
Main entry points: main.py FastAPI app · router.py Auth routes · dependencies.py Auth dependencies · customer_repository.py Customer repository
Components 28
API entry points
- FastAPI app
E_commerce/main.py
Shopping and orders
- Catalog routes
E_commerce/app/api/v1/products/router.py - Product service
E_commerce/app/services/product_service.py - Category routes
E_commerce/app/api/v1/categories/router.py - Category service
E_commerce/app/services/category_service.py - Cart routes
E_commerce/app/api/v1/cart/router.py - Cart service
E_commerce/app/services/cart_service.py - Order routes
E_commerce/app/api/v1/orders/router.py - Order lifecycle
E_commerce/app/services/order_service.py - Stock control
E_commerce/app/services/stock_service.py - Address routes
E_commerce/app/api/v1/addresses/router.py - Saved payments
E_commerce/app/api/v1/payments/router.py - Payment types
E_commerce/app/api/v1/payment_types/router.py
Accounts and access
- Auth routes
E_commerce/app/api/v1/auth/router.py - Auth service
E_commerce/app/services/auth_service.py - Auth dependencies
E_commerce/app/api/v1/auth/dependencies.py - User routes
E_commerce/app/api/v1/users/router.py - User service
E_commerce/app/services/user_service.py
Administration
- Admin routes
E_commerce/app/api/v1/admin/router.py - Admin service
E_commerce/app/services/admin_service.py
Persistence and integrations
- Product repository
E_commerce/app/repositories/product_repository.py - Customer repository
E_commerce/app/repositories/customer_repository.py - Order repository
E_commerce/app/repositories/order_repository.py - Cart repository
E_commerce/app/repositories/cart_repository.py - PostgreSQL
E_commerce/app/database/session.py - Redis tokens
E_commerce/app/core/redis.py - Local media
E_commerce/app/utils/storage.py
Other components
- HTTP client
Connections 44
- HTTP client → FastAPI app: sends requests
- FastAPI app → Auth routes: mounts routes
E_commerce/main.py - FastAPI app → User routes: mounts routes
E_commerce/main.py - FastAPI app → Catalog routes: mounts routes
E_commerce/main.py - FastAPI app → Category routes: mounts routes
E_commerce/main.py - FastAPI app → Cart routes: mounts routes
E_commerce/main.py - FastAPI app → Order routes: mounts routes
E_commerce/main.py - FastAPI app → Address routes: mounts routes
E_commerce/main.py - FastAPI app → Saved payments: mounts routes
E_commerce/main.py - FastAPI app → Payment types: mounts routes
E_commerce/main.py - FastAPI app → Admin routes: mounts routes
E_commerce/main.py - Auth routes → Auth service: invokes
E_commerce/app/api/v1/auth/router.py - Auth routes → User service: invokes
E_commerce/app/api/v1/auth/router.py - Auth routes → Redis tokens: gets client
E_commerce/app/api/v1/auth/router.py - Auth routes → Auth dependencies: uses dependency
E_commerce/app/api/v1/auth/router.py - Auth service → Customer repository: reads and writes
E_commerce/app/services/auth_service.py - Auth service → Redis tokens: stores tokens
E_commerce/app/services/auth_service.py - Auth dependencies → Customer repository: loads customer
E_commerce/app/api/v1/auth/dependencies.py - User routes → User service: invokes
E_commerce/app/api/v1/users/router.py - User service → Customer repository: uses repository
E_commerce/app/services/user_service.py - Catalog routes → Product service: invokes
E_commerce/app/api/v1/products/router.py - Product service → Product repository: uses repository
E_commerce/app/services/product_service.py - Product service → Local media: stores images
E_commerce/app/services/product_service.py - Category routes → Category service: invokes
E_commerce/app/api/v1/categories/router.py - Cart routes → Cart service: invokes
E_commerce/app/api/v1/cart/router.py - Cart service → Cart repository: uses repository
E_commerce/app/services/cart_service.py - Cart service → Product repository: checks products
E_commerce/app/services/cart_service.py - Order routes → Order lifecycle: invokes
E_commerce/app/api/v1/orders/router.py - Order lifecycle → Cart repository: reads cart
E_commerce/app/services/order_service.py - Order lifecycle → Order repository: uses repository
E_commerce/app/services/order_service.py - Order lifecycle → Stock control: controls stock
E_commerce/app/services/order_service.py - Address routes → Auth dependencies: requires customer
E_commerce/app/api/v1/addresses/router.py - Saved payments → Auth dependencies: requires customer
E_commerce/app/api/v1/payments/router.py - Admin routes → Admin service: invokes
E_commerce/app/api/v1/admin/router.py - Admin routes → Category service: invokes
E_commerce/app/api/v1/admin/router.py - Admin routes → Auth dependencies: requires admin
E_commerce/app/api/v1/admin/router.py - Admin service → Customer repository: uses repository
E_commerce/app/services/admin_service.py - Admin service → Order repository: uses repository
E_commerce/app/services/admin_service.py - Admin service → Product repository: uses repository
E_commerce/app/services/admin_service.py - Customer repository → PostgreSQL: queries database
- Order repository → PostgreSQL: queries database
- Product repository → PostgreSQL: queries database
- Cart repository → PostgreSQL: queries database
- FastAPI app → Local media: serves static files
E_commerce/main.py