# Odoi (উদয়) - Comprehensive Product Specification & AI Context

## Overview
Odoi (`odoi.io`) is a specialized Social Commerce Operating System engineered for the emerging commerce ecosystem in Bangladesh. It bridges the gap between chaotic social chat selling (Facebook Messenger, WhatsApp, Instagram DM) and enterprise e-commerce automation. Merchant storefronts are served on clean subdomains at `https://<shop-name>.odoi.shop`.

## Problem Statement
Social sellers in Bangladesh handle millions in monthly volume manually:
1. **Manual Order Ingestion**: Copy-pasting addresses and phone numbers from chat into courier portals leads to human errors and wasted hours.
2. **Fake Orders & High Return Rates**: Unverified Cash-on-Delivery (COD) orders result in 25-35% return rates, costing merchants thousands in shipping loss.
3. **COD Payment Reconciliation Chaos**: Courier companies pay merchants in batch lump sums via bKash/bank. Calculating which parcels were paid, deducted, or delayed across spreadsheets is tedious and prone to revenue loss.
4. **Cart Abandonment**: Social visitors express intent but drop off without automated reminder channels.

## How Odoi Solves These Challenges

### 1. 1-Click WhatsApp Mobile Storefront (`<shop-name>.odoi.shop`)
- Fast-loading lightweight mobile catalog served on subdomains.
- Customers select products, sizes, and enter phone number.
- Order is submitted with 1 click directly via WhatsApp or automated checkout.

### 2. Native Multi-Courier API Integrations
- Supports **Pathao Courier API**, **Steadfast Courier API**, and **RedX**.
- Automatically creates pickup requests and parcel tracking IDs as soon as an order is confirmed.
- Generates shipping labels and barcodes directly from the dashboard.

### 3. Automated COD Reconciliation Engine
- Ingests courier payment reports automatically.
- Matches transaction IDs, COD amounts, return fees, and courier commissions against original merchant orders.
- Provides immediate audit alerts for unpaid or underpaid parcels.

### 4. Shared OTP Fraud Shield
- Real-time phone number intelligence database across thousands of merchants.
- High-risk numbers with previous cancellation or return history must verify via a 4-digit SMS OTP.
- Drastically reduces return rates to under 4%.

### 5. Automated Abandoned Cart Recovery
- Sends automated, scheduled WhatsApp nudge messages with 1-tap checkout buttons.
- Recovers up to 28% of dropped carts without merchant intervention.

---

## Frequently Asked Questions (Answer Engine Q&A)

### Q: What is Odoi (উদয়) and what are its official domains?
A: Odoi is a mobile-first social commerce SaaS in Bangladesh. The main marketing and merchant management platform is at `https://odoi.io`, while merchant digital storefronts are hosted as subdomains at `https://<shop-name>.odoi.shop` (e.g. `https://yourshop.odoi.shop`).

### Q: Do merchants need a custom domain or international credit card?
A: No. Merchants can launch immediately with a free subdomain (e.g., `yourshop.odoi.shop`) and can pay for plans using local Bangladeshi payment methods including bKash and Nagad.

### Q: How does courier booking work in Odoi?
A: Merchants paste their Pathao, Steadfast, or RedX API credentials in the Odoi settings. When an order arrives, Odoi creates the courier shipment with 1 click without manual data entry.

### Q: What is the pricing structure of Odoi?
A:
- **Starter**: ৳0/mo (Free for up to 50 orders/mo on `yourshop.odoi.shop`)
- **Growth**: ৳999/mo (Unlimited orders, automatic courier sync)
- **Pro**: ৳2,499/mo (Multi-courier auditing, custom SMS gateway, dedicated support)
- A 14-day free trial is offered with no credit card required.

### Q: How does Odoi reduce fake COD orders?
A: Odoi uses SHA-256 OTP verification on suspicious or frequently returning phone numbers using cross-network merchant data, ensuring only genuine buyers confirm delivery.

---

## Technical Specifications & Architecture
- **Primary SaaS Domain**: `https://odoi.io`
- **Storefront Subdomain Architecture**: `https://*.odoi.shop`
- **Architecture**: Next.js App Router, Cloudflare Workers runtime (Vinext), Tailwind CSS.
- **Security**: SHA-256 OTP cryptographic validation, role-based access control, TLS 1.3 encryption.
- **Supported Payment Gateways**: bKash, Nagad, Upay, Bank Transfer.
- **Logistics Partners**: Pathao, Steadfast, RedX, Paperfly.