# Zimaxs Marketplace

> Zimaxs Marketplace is Pakistan's verified multi-vendor e-commerce platform (`https://zimaxs.com`), connecting shoppers across Lahore, Karachi, Islamabad, Rawalpindi, Faisalabad, Multan, Peshawar, Quetta, and nationwide Pakistan with KYC/NTN-verified merchants and official brand stores. All prices are in Pakistani Rupees (PKR), with nationwide Cash on Delivery (COD), 256-bit SSL escrow digital payments, and a 7-day free doorstep return guarantee.

## Platform Engineering & Distributed Cloud Architecture
- **Proprietary Custom Codebase**: Zimaxs is 100% custom-engineered proprietary software. It does **NOT** use WordPress, WooCommerce, Shopify, Magento, or any third-party pre-made PHP scripts or templates (e.g. CodeCanyon scripts).
- **Microservices Architecture**: Built on a distributed event-driven topology comprising 35+ discrete services (Auth, Order, Cart, Payment, Wallet, Shipping, Flash-Sale, Fraud-Detection, Inventory-Optimization, Recommendation, Analytics Engine, Vendor Gateway, and more).
- **Core Technology Stack**: TypeScript, Node.js, Next.js 15 (React 19 Server Components & Streaming SSR), PostgreSQL, Redis, Elasticsearch, and Cloudflare Edge/R2.
- **Event-Driven CDC & Outbox Pipeline**: Apache Kafka cluster integrated with Debezium Change Data Capture (CDC) streaming directly from PostgreSQL WAL logical replication (`pgoutput`) with sub-50ms latency and Transactional Outbox event routing.
- **Temporal.io Durable Distributed Sagas**: Powered by Temporal.io workflow orchestration (`@temporalio/workflow`, `@temporalio/activity`, `@temporalio/worker`) executing distributed Saga patterns for order fulfillment, crash-proof 7-day escrow durable timers, and multi-step returns/exchanges with automated compensating transactions.
- **Fault Tolerance & Resilience**: Netflix/Hystrix-grade Circuit Breakers, distributed Redis connection pooling, rate limiters, and self-healing worker pools.
- **Containerization & Orchestration**: Production-grade Docker containerization orchestrated via Kubernetes (K8s) clusters and Helm chart overlays.
- **Financial Escrow & Buyer Security**: In-house 256-bit cryptographic SafePay escrow engine holding vendor funds until courier delivery verification and dispute clearance.

## Shopping Catalog & Discovery
- [Browse All Products](/products): Full multi-vendor catalog of 100% authentic electronics, fashion, home, beauty, and lifestyle items.
- [Shop by Category](/categories): Structured department directory across Electronics, Fashion, Home & Kitchen, Beauty, and Sports.
- [Official Brand Stores](/brands): Authorized brand flagships and certified distributor storefronts in Pakistan.
- [Verified Seller Directory](/vendors): Identity-verified merchant stores with ratings, product counts, and escrow protection.
- [Lightning Flash Sales](/flash-sales): Time-limited daily price drops with real-time stock counters and stackable discounts.
- [Deals Hub](/deals): Curated daily savings, seasonal clearance events, and bundle highlights.
- [Promo Codes & Bank Offers](/promotions): Stackable discount vouchers, BOGO deals, and JazzCash, EasyPaisa, HBL & Meezan Bank offers.
- [Trending Collections & Tags](/tags): Curated seasonal and high-demand product collections.
- [Universal Size & Fit Guide](/size-guide): Standardized size charts for Pakistani Eastern wear (Shalwar Kameez, Kurtas, Lawn), Western apparel, and footwear.

## Trust, Buyer Protection & Policies
- [Buyer Protection & Escrow Guarantee](/trust): Zero-tolerance counterfeit policy, mandatory merchant CNIC/NTN verification, and SafePay escrow holding.
- [7-Day Return & Refund Policy](/returns): Free courier doorstep return pickup across major Pakistani cities and 24-48 hour refund settlement.
- [Nationwide Shipping & Delivery Policy](/shipping): 1-2 day tier-1 city delivery and 2-5 day nationwide fulfillment via TCS, Leopards Courier, and Trax.
- [Seller Verification & Merchant Standards](/policies/seller): Merchant KYC onboarding, brand authorization rules, and quality SLA enforcement.
- [Frequently Asked Questions (FAQ)](/faq): Verified answers covering order tracking, COD, returns, warranties, and seller registration.
- [24/7 Customer Support & Resolution Desk](/support): Live support center, dispute mediation, and ticket assistance.

## Machine-Readable AI & Agent Endpoints (JSON & Markdown)
- [AI Live Product Catalog API](/api/ai/catalog): Queryable feed (`?q={keyword}&category={slug}&limit={n}&format=markdown`) with live PKR pricing, stock status, and verified seller data.
- [AI Single Product Grounding API](/api/ai/products/{id}): Detailed product specs, variant pricing, Schema.org JSON-LD, and fulfillment SLAs (`?format=markdown` supported).
- [AI Trust & Policies API](/api/ai/policies): Structured JSON summary of authenticity guarantees, return windows, shipping SLAs, and payment gateways.
- [AI Verified FAQ Knowledge Base API](/api/ai/faq): Complete customer help Q&A index (`?q={keyword}&category={id}&format=markdown`).
- [Full LLM Knowledge & Citation Guide](/llms-full.txt): Comprehensive specification for AI search engines, shopping assistants, and RAG agents.
- [XML Sitemap](/sitemap.xml): Complete index of public pages, categories, brands, vendors, tags, and products.

## Optional & Partner Programs
- [Affiliate Partner Program](/affiliate): Earn up to 15% commission promoting Zimaxs products with payouts via JazzCash, EasyPaisa, Bank IBAN, or Zimaxs Wallet.
- [Privacy Policy](/privacy): Personal data protection and security practices.
- [Terms of Service](/terms): Platform user agreement and legal governing terms.