How quoc139/cnpm works
This repository is a Vietnamese sneaker storefront with a Vue frontend and Django REST backend. The main customer journey is browsing products, managing a cart and address, placing an order, and tracking it; separate branches cover account access, recommendations and engagement, exchanges, and staff administration. Backend services own transactional domain changes, while models represent persisted state. The source excerpts establish only some calls, so unsampled routes and subsystem wiring are represented cautiously or omitted.
Main entry points: orders/services.py Cart & checkout · client.ts HTTP client · models.py Products & stock · engagement/services.py Engagement services
Components 24
Storefront UI
- Auth flow
PHAMTRONGQUOC_24CT2/frontend/src/modules/auth/composables/useAuth.ts - Session state
PHAMTRONGQUOC_24CT2/frontend/src/modules/auth/stores/auth.ts - HTTP client
PHAMTRONGQUOC_24CT2/frontend/src/lib/http/client.ts - Product browsing
PHAMTRONGQUOC_24CT2/frontend/src/modules/catalog/pages/ProductsPage.vue - Cart
PHAMTRONGQUOC_24CT2/frontend/src/modules/cart/pages/CartPage.vue - Order tracking
PHAMTRONGQUOC_24CT2/frontend/src/modules/orders/pages/OrdersPage.vue - Exchange screens
PHAMTRONGQUOC_24CT2/frontend/src/modules/exchanges/pages/ExchangesPage.vue
Accounts
- Account services
PHAMTRONGQUOC_24CT2/Base_dijango/apps/accounts/services.py - User manager
PHAMTRONGQUOC_24CT2/Base_dijango/apps/accounts/managers.py - Users & addresses
PHAMTRONGQUOC_24CT2/Base_dijango/apps/accounts/models.py
Commerce
- Cart & checkout
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/services.py - Orders & carts
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/models.py - Payment handling
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/payments.py - Fulfillment
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/fulfillment.py
Catalog & Engagement
- Catalog services
PHAMTRONGQUOC_24CT2/Base_dijango/apps/catalog/services.py - Products & stock
PHAMTRONGQUOC_24CT2/Base_dijango/apps/catalog/models.py - Recommendations
PHAMTRONGQUOC_24CT2/Base_dijango/apps/catalog/recommendations.py - Engagement services
PHAMTRONGQUOC_24CT2/Base_dijango/apps/engagement/services.py - Reviews & loyalty
PHAMTRONGQUOC_24CT2/Base_dijango/apps/engagement/models.py
Operations
- Exchange lifecycle
PHAMTRONGQUOC_24CT2/Base_dijango/apps/exchanges/services.py - Exchange records
PHAMTRONGQUOC_24CT2/Base_dijango/apps/exchanges/models.py - Admin tools
PHAMTRONGQUOC_24CT2/frontend/src/modules/admin/pages/AdminProductsPage.vue
Other components
- Shopper
- Store staff
Connections 29
- Shopper → Auth flow: signs in
PHAMTRONGQUOC_24CT2/frontend/src/modules/auth/composables/useAuth.ts - Auth flow → Session state: sets session
PHAMTRONGQUOC_24CT2/frontend/src/modules/auth/composables/useAuth.ts - Auth flow → HTTP client: sends requests
- Shopper → Product browsing: browses
- Product browsing → HTTP client: loads products
- Shopper → Cart: manages cart
- Cart → HTTP client: submits changes
- Shopper → Order tracking: checks orders
- Order tracking → HTTP client: loads orders
- Shopper → Exchange screens: requests exchange
- Exchange screens → HTTP client: sends request
- User manager → Users & addresses: creates users
PHAMTRONGQUOC_24CT2/Base_dijango/apps/accounts/models.py - Account services → Users & addresses: updates accounts
PHAMTRONGQUOC_24CT2/Base_dijango/apps/accounts/services.py - Catalog services → Products & stock: updates catalog
PHAMTRONGQUOC_24CT2/Base_dijango/apps/catalog/services.py - Cart & checkout → Orders & carts: writes cart and orders
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/services.py - Cart & checkout → Products & stock: checks inventory
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/services.py - Cart & checkout → Users & addresses: locks user
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/services.py - Cart & checkout → Engagement services: uses voucher logic
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/services.py - Engagement services → Reviews & loyalty: records engagement
PHAMTRONGQUOC_24CT2/Base_dijango/apps/engagement/services.py - Engagement services → Products & stock: records product events
PHAMTRONGQUOC_24CT2/Base_dijango/apps/engagement/services.py - Engagement services → Orders & carts: checks order items
PHAMTRONGQUOC_24CT2/Base_dijango/apps/engagement/services.py - Recommendations → Products & stock: uses product data
- Payment handling → Orders & carts: tracks payment state
- Fulfillment → Cart & checkout: coordinates fulfillment
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/fulfillment.py - Fulfillment → Account services: uses account services
PHAMTRONGQUOC_24CT2/Base_dijango/apps/orders/fulfillment.py - Exchange lifecycle → Exchange records: updates exchanges
PHAMTRONGQUOC_24CT2/Base_dijango/apps/exchanges/services.py - Exchange lifecycle → Orders & carts: validates order
PHAMTRONGQUOC_24CT2/Base_dijango/apps/exchanges/services.py - Exchange lifecycle → Products & stock: reserves stock
PHAMTRONGQUOC_24CT2/Base_dijango/apps/exchanges/services.py - Store staff → Admin tools: manages store