How ihebm199/dcs_dental works
DCS Dental is a Tunisian dental and paramedical e-commerce platform. The main customer journey is browsing the catalogue, selecting products, and submitting an order; account access, promotions, and customer order tracking are related capabilities. Django REST Framework provides the backend API, with PostgreSQL-backed domain models and optional Celery email notifications. The README documents the main API areas, but sampled frontend pages do not establish their specific API calls, so those connections are marked unverified. Notification wiring is shown in the sampled backend sources.
Main entry points: urls.py Django REST API · tasks.py Email tasks · signals.py Notification signals · models.py Orders
Components 20
Storefront
- Web storefront
dcs_dental/frontend/app/page.tsx - Catalogue
dcs_dental/frontend/app/catalogue/page.tsx - Product detail
dcs_dental/frontend/app/produit/[slug]/page.tsx - Cart state
dcs_dental/frontend/components/cart-provider.tsx - Checkout
dcs_dental/frontend/app/checkout/page.tsx - Promotions page
dcs_dental/frontend/app/promotions/page.tsx - Order dashboard
dcs_dental/frontend/app/dashboard/page.tsx
Commerce API
- Django REST API
backend/config/urls.py - Product catalogue
backend/apps/products/models.py - Orders
backend/apps/orders/models.py - Promo codes
backend/apps/promotions/models.py - Order signals
backend/apps/orders/signals.py
Accounts
- Accounts and auth
backend/apps/accounts/views.py
Notifications
- Notification signals
backend/apps/notifications/signals.py - Email tasks
backend/apps/notifications/tasks.py - Email services
backend/apps/notifications/services.py - Newsletter subscribers
backend/apps/notifications/models.py - Celery worker
backend/config/celery.py
Other components
- Customer
- Email service
Connections 27
- Customer → Web storefront: browses
README.md - Web storefront → Catalogue: opens catalogue
README.md - Customer → Checkout: submits order
README.md - Checkout → Django REST API: API request
- Catalogue → Django REST API: catalogue request
- Product detail → Django REST API: product request
- Promotions page → Django REST API: promotion request
- Order dashboard → Django REST API: order request
- Django REST API → Product catalogue: serves catalogue
README.md - Django REST API → Orders: serves orders
README.md - Django REST API → Promo codes: serves promotions
README.md - Django REST API → Accounts and auth: serves accounts
README.md - Orders → Product catalogue: references products
backend/apps/orders/models.py - Orders → Promo codes: references promo code
backend/apps/orders/models.py - Order signals → Orders: observes changes
backend/apps/orders/signals.py - Order signals → Email tasks: dispatches tasks
backend/apps/orders/signals.py - Notification signals → Product catalogue: observes promotions
backend/apps/notifications/signals.py - Notification signals → Promo codes: observes publication
backend/apps/notifications/signals.py - Notification signals → Email tasks: dispatches tasks
backend/apps/notifications/signals.py - Email tasks → Orders: loads order
backend/apps/notifications/tasks.py - Email tasks → Product catalogue: loads product
backend/apps/notifications/tasks.py - Email tasks → Promo codes: loads promo
backend/apps/notifications/tasks.py - Email tasks → Email services: calls service
backend/apps/notifications/tasks.py - Email services → Newsletter subscribers: reads subscribers
backend/apps/notifications/services.py - Email services → Email service: sends mail
backend/apps/notifications/services.py - Celery worker → Email tasks: discovers tasks
backend/config/celery.py - Notification signals → Notification signals: registered at startup
backend/apps/notifications/apps.py