KXKXRS / SHOP
View on GitHub ↗

Django commerce lab · interactive tour

Every click has a backend story.

KXRS is a full-stack e-commerce platform where customers browse a live catalog, sellers run their own stores, and the same domain model powers the REST API.

BROWSE
→ BUILD
→ SHIP

A small platform with a clear shape.

One repository connects storefront UI, seller workflows, API resources, authentication and PostgreSQL.

5.1Django core
16PostgreSQL in Docker
JWTCookie-based auth
RESTDRF + Swagger surface

Pick a role. Trace the flow.

The controls below are a visual map of the product boundary — not a static screenshot.

Customer journey

Discover products, keep the basket personal, and turn selected items into an order.

03core moves

Touch the storefront.

Filter the sample catalog and add products to a local basket. The counter is intentionally live.

Catalog preview

🛒 0 in basket

Click the architecture

5 layers
KXRS architecture map Click a layer to see what it owns. Browser UI Django REST API Models Data + media
Layer 01 / presentation

Browser UI

Django templates expose the customer catalog, basket, orders and seller profile in a familiar web flow.

A small API contract

The same store, ready to speak REST.

Authentication, products, baskets, users and orders are exposed under /api/. Swagger is available at /swagger/.

Browse API code ↗
GET /api/product/list/ProductListView
curl -H "Accept: application/json" \
  http://localhost:8000/api/product/list/

[
  {
    "name": "Product 1",
    "price": 100.00,
    "quantity_in_stock": 12,
    "is_active": true
  }
]