Clickdzpro1/ClickDz-FREE-SHOP-FULL-READY-Backend

Production-ready e-commerce backend for Algeria. 58 wilayas, 5 payment gateways (Chargily, SlickPay, Stripe, CCP, COD), 4 shipping providers, multi-vendor marketplace, loyalty program, gift cards, 2FA, Swagger docs, 22+ features. Node.js + Express + TypeScript + Prisma + Redis. # ClickDz FREE SHOP Backend A production-ready, open-source e-commerce backend built specifically for the **Algerian market**. Clone it, run `docker compose up`, and you have a fully functional shop with all 58 wilayas, 5 payment gateways, 4 courier integrations, multi-vendor marketplace, and a complete admin API with **22+ features**. > **Interactive API Docs**: Once running, visit `/api/docs` for full Swagger/OpenAPI documentation. ## Features ### Core Commerce - **Algeria-Ready**: All 58 wilayas + 1541 communes, DZD currency, Algerian phone format - **5 Payment Gateways**: Chargily (EDAHABIA/CIB), SlickPay, Stripe, CCP/BaridiMob, Cash on Delivery - **4 Shipping Providers**: Yalidine, ZR Express, EMS Poste Algerie, Maystro + Manual - **Full Auth System**: JWT with refresh token rotation, role-based access (Customer/Admin/Super Admin) - **Product Catalog**: Categories with tree structure, variants, images, search & filtering - **Order Management**: Full lifecycle (9 statuses), stock management, coupon system - **Admin Dashboard**: Revenue stats, customer management, order export (CSV), shipping rate management - **Trilingual**: Arabic, French, English on products and categories - **Review System**: Customer reviews with admin moderation ### Extended Features (22+) - **Wishlist**: Save products for later with add/remove/check/clear - **Notifications**: In-app notification system with mark-as-read - **Stock Alerts**: Subscribe to back-in-stock notifications - **Two-Factor Authentication (2FA)**: TOTP-based with QR code setup and backup codes - **Swagger/OpenAPI**: Interactive API docs at `/api/docs` with 28 endpoint groups - **Social Login**: Link/unlink social accounts (Google, Facebook, etc.) - **Product Recommendations**: "Also bought", similar products, personalized suggestions - **Returns & RMA**: Full return request lifecycle with admin management - **Gift Cards**: Purchase, redeem, check balance, transaction history - **Loyalty Program**: Points system wi …