AshikDev.
Back to case study

Case Study · Project Planning

AI Commerce OS — Project Planning

The complete planning document behind AI Commerce OS — a multi-tenant SaaS platform that answers inbound calls with an AI voice agent, takes conversational orders over WhatsApp, automatically recovers missed calls into chat, and routes every order into a single dashboard.

Product
AI Commerce OS
Engagement
Fixed-price MVP / Pilot
Document
Proposal v1.0
Prepared by
SM Ashiqurzamman

01

Executive Summary

Small businesses that take a high volume of phone orders lose revenue every day to missed and unanswered calls. AI Commerce OS is a multi-tenant SaaS platform that answers inbound calls with an AI voice agent, takes and confirms orders over a conversational WhatsApp agent, automatically recovers missed calls into WhatsApp conversations, and routes every order into a single management dashboard.

The platform is delivered in clearly defined phases. Phase 1 is a focused, fixed-price MVP / pilot that proves the core value — answer calls, recover missed orders, manage them in one place. Phases 2 and 3 extend the MVP into a full commercial SaaS with loyalty, marketing automation, deeper AI memory, and enterprise capabilities, commissioned separately once the pilot succeeds.

No voice model is built from scratch. The system integrates proven voice AI platforms (Vapi / Retell) with the WhatsApp Business API and a custom backend and dashboard. The client owns all source code and all platform accounts.

ItemDetail
ProductAI Commerce OS — AI voice + WhatsApp order-taking SaaS
Phase 1 (this contract)Fixed-price MVP/pilot: voice AI, WhatsApp AI, missed-call recovery, order dashboard, multi-tenant roles
Phase 2Loyalty, marketing automation, analytics, advanced AI memory
Phase 3White-label, API, ERP/POS integrations, franchise & enterprise
Ownership100% client-owned code and accounts; full documentation and handover
Commercial modelFixed-price per phase, with optional maintenance retainer

02

Understanding the Problem

During peak hours, staff cannot answer every call. Each missed call is a potential lost order and a customer who may not call back. Static auto-replies do not solve this — a customer who reaches voicemail or an unanswered line rarely completes the order on their own.

The goal is therefore not only to answer more calls, but to actively recover the ones that are missed and to make ordering effortless across both voice and chat — while giving the business clear visibility and control over every order in one place.

What success looks like

  • Fewer missed orders — calls are answered by AI when staff cannot pick up.
  • Missed calls are recovered — the customer is reached on WhatsApp and finishes the order in chat.
  • One source of truth — orders from voice and WhatsApp land in the same dashboard.
  • A personal feel — the AI remembers returning customers and their usual orders.
  • Full ownership — the business runs the system itself, with clean code and documentation.

03

Solution Overview

AI Commerce OS is a multi-tenant platform. A single deployment serves many businesses (tenants), each fully isolated. The platform is sold as a subscription, with three operating roles:

Super-Admin

The platform owner. Manages all shops, subscriptions, billing, platform-wide usage and cost, and support.

Shop-Admin

The subscribing business owner. Manages their shop, branches, orders, customers, and their own plan.

Branch-Admin

A per-branch operator under a Shop-Admin. Manages orders and customers for a single branch only.

Tenant isolation: each shop's data — orders, customers, and AI memory — is strictly separated. One shop can never access another shop's data.

Core capabilities

Inbound AI Voice Agent

Answers calls, captures structured orders, reads back and confirms, recognises returning customers, stores transcript and recording, routes to branch, and transfers to a human for complex requests.

WhatsApp AI Agent

A genuinely conversational agent — not a static template — that greets, understands, captures or confirms an order, reads it back, and gets a clear confirmation. Works standalone and as the recovery destination for missed calls.

Missed-Call → WhatsApp Recovery

Detects missed, busy, or unanswered calls via the telephony layer. Automatically reaches the customer on WhatsApp so the order can be completed in chat. Supports callback request as alternative.

Order Management Dashboard

A single view of incoming orders from both voice and WhatsApp, tagged by channel. Order status pipeline, customer profiles, search, filter, export. Role-specific views.

Per-Shop AI Memory

Each shop's AI remembers its own customers — name, preferred language, favourite order, history — to make the experience feel personal and improve repeat business. Scoped per shop.

04

Technical Architecture

The architecture favours a single shared platform with strict logical isolation per tenant. This keeps operating costs and complexity low at MVP stage while remaining a true multi-tenant SaaS that can scale.

Customer → (Phone via Twilio → Vapi/Retell Voice AI) or (WhatsApp via Meta Cloud API)
    ↓
Backend API (NestJS) → Shared LLM with per-tenant context
    ↓
PostgreSQL (tenant-scoped) → Dashboard (Next.js)
LayerResponsibility
Marketing websitePublic site, SEO, plan information, lead capture and signup.
Dashboard appRole-based UI for Super-Admin, Shop-Admin, and Branch-Admin.
Backend APIAuth, tenancy, orders, customers, billing, webhooks, AI orchestration.
Voice AIVapi/Retell handle speech; function calls push structured orders to the backend.
WhatsApp AIBackend conversation state machine + LLM for natural chat ordering.
Data layerPostgreSQL with tenant_id isolation; Redis for queues and caching.
AI layerShared LLM with per-tenant system prompt and customer profile injected at runtime.

Multi-tenancy approach (MVP): a shared database and schema with a tenant_id column on every tenant-scoped table. Every backend query is automatically scoped to the authenticated user's shop and branch. At scale, the model can evolve toward separate schemas or databases per tenant — deliberately deferred to avoid operational overhead at MVP scale.

05

Technology Stack

Every choice is selected for reliability, maintainability, and full client ownership — no proprietary lock-in, and a single TypeScript language across front and back end.

LayerTechnologyWhy this choice
FrontendNext.js, React, TypeScript, Tailwind, shadcn/uiFast, modern, clean dashboards and marketing site from one codebase.
BackendNode.js + NestJS (TypeScript)Structured, modular backend; same language as the frontend, end to end.
DatabasePostgreSQLReliable relational store; clean tenant_id isolation.
ORMPrismaType-safe queries and clean migrations.
Cache / QueueRedis + BullMQSessions, rate limiting, and delayed jobs (e.g. timed follow-ups).
Voice AIVapi (primary) / Retell (alternative)Proven platforms integrated — no model built from scratch.
TelephonyTwilioPhone numbers, missed/unanswered-call detection, recording.
WhatsAppMeta WhatsApp Cloud APIOfficial, lowest-cost path; no reseller markup.
LLMOpenAI / Claude (cost-tiered)Cheaper model for routine orders; stronger model only when needed.
AI memory (MVP)PostgreSQL profile fieldsRemembers usual orders without the cost of a vector DB.
AuthJWT with role claimsStateless, secure, easy to extend.
Billing & PaymentsStripe + bKash / Nagad / SSLCommerzCard subscriptions via Stripe; POS + local gateways for regional payments.
HostingDocker + Coolify on client-owned VPSFull client ownership, no vendor lock-in, low cost at small scale.
MonitoringSentry + usage/cost loggingError tracking plus per-tenant usage metering.

06

Phased Delivery Plan

The platform is built in three phases. Each phase is a standalone, fixed-price contract delivering working value on its own. This protects the client's investment — the pilot proves the concept before any commitment to the larger build.

PhaseFocusOutcome
Phase 1 — MVP / PilotCore order-taking + recoveryA live, working system proving missed-order recovery for a real business.
Phase 2 — GrowthRetention + marketing + analyticsTools that increase repeat orders and revenue per shop.
Phase 3 — EnterpriseScale + integrations + resaleA full commercial SaaS ready for many clients and large accounts.

Phase 1 — MVP / Pilot

Objective: prove the core value on a fixed price.

Included

  • Inbound AI voice agent (Vapi/Retell + Twilio)
  • Conversational WhatsApp AI agent
  • Missed/unanswered-call → WhatsApp recovery + callback
  • Order dashboard (voice + WhatsApp, status, search, export)
  • Per-shop customer profile and memory (no vector DB)
  • Multi-tenant roles: Super / Shop / Branch admin
  • Basic subscription/plan assignment + usage logging
  • Lean marketing website
  • Telephony setup, transcripts, per-call logs
  • Full documentation and clean handover

Excluded (later phases)

  • • Loyalty, broadcast marketing, inventory, staff
  • • Vector-DB / RAG long-term memory
  • • White-label, ERP/POS, franchise tools
  • • Full self-serve billing lifecycle + multi-currency

Phase 2 — Growth

Turn the MVP into a platform that drives repeat business and revenue per shop.

  • • Loyalty system — points, tiers, coupons, cashback
  • • Marketing automation — WhatsApp broadcasts, AI campaign generator
  • • Advanced AI memory — vector DB (Qdrant) + RAG
  • • Customer CRM — LTV, complaints, notes, history
  • • Analytics — revenue, peak hours, retention, AI metrics
  • • Delivery operations — riders, zones, pickup
  • • Richer ordering — voice-note, images, payment links
  • • Inventory awareness — AI skips out-of-stock items

Phase 3 — Enterprise & Scale

Make the platform a full commercial SaaS for many clients and resellers.

  • • White-label per shop — logo, domain, branding
  • • Public REST API + webhooks
  • • ERP / POS / delivery integrations
  • • Franchise management for multi-location brands
  • • Full self-serve billing — trials, upgrades, annual, multi-currency
  • • Enterprise compliance — GDPR workflows, audit depth
  • • Scalability — schema-per-tenant, multi-region
  • • Employee management — staff, attendance, ratings

07

Unit-Cost Model & Service Pricing

AI voice and messaging carry a real per-use cost. Before subscription prices are set, the platform meters and models cost-to-serve per shop, so plans are always priced with margin. Figures are approximate mid-2026 rates; confirmed against live provider pricing at contract time.

7.1 Per-use cost to serve (per shop)

ServiceApprox. unit costNotes
Voice AI orchestration (Vapi)~$0.05 / minBase platform fee; STT, LLM, TTS billed on top.
Voice all-in (STT+LLM+TTS+telephony)~$0.13–$0.31 / minBlended live cost. Budget ~$0.20/min working average.
Retell (alternative)~$0.07+ / min baseBring-your-own-LLM; all-in ~$0.11–$0.15/min.
Twilio phone number~$1–$2 / monthOne number per shop/branch.
Twilio inbound minutes~$0.0085–$0.014 / minCountry-dependent; on top of voice AI.
WhatsApp service messagesFree in 24-hr window~1,000 free service conversations/mo.
WhatsApp utility template~$0.004–$0.045 / msgMissed-call follow-up & confirmations outside free window.
WhatsApp marketing template~$0.01–$0.14 / msgPromotions/broadcasts (Phase 2).
LLM tokens (WhatsApp turn)fractions of a cent / turnCost-tiered model (e.g. GPT-4o-mini).

Worked example — one busy shop, one month

1,000 AI calls × ~4 min × ~$0.20/min ≈ $800 voice; plus ~$15–$30 WhatsApp templates + LLM; plus ~$2 number rental. Roughly $820–$850/month for a busy single-branch shop. A lighter shop (200 calls) lands nearer $150–$200/month — exactly why the pilot measures real usage before plans are priced.

7.2 Suggested subscription plans

PlanApprox. price / moIncludes
Starter$39–$59WhatsApp AI only, single branch, ~1,000 messages, basic dashboard.
Growth$99–$149Voice + WhatsApp, up to 3 branches, memory, missed-call recovery, capped minutes.
Pro$249–$399Unlimited branches, full memory, higher caps, advanced analytics, priority support.
EnterpriseCustomWhite-label, API, franchise tools, dedicated support (Phase 3).

Usage caps matter: voice has real per-minute cost. Each plan includes a fair-use allowance, with overage billed per unit.

08

Build Services, Minimum Requirements & Setup

8.1 One-Time Build (Phase 1 MVP)

Work itemScopeWhat it covers
Multi-tenant backend + roles + DBincluded in MVPAuth, tenancy, Super/Shop/Branch roles, schema.
Order dashboard (3 roles)included in MVPLive orders, status pipeline, search, export.
Voice AI integrationincluded in MVPVapi/Retell + Twilio, order capture, transcripts.
WhatsApp AI agentincluded in MVPConversational ordering + missed-call recovery.
Customer memory (simple)included in MVPPer-shop profile and usual-order recall.
Lean marketing websiteincluded in MVPHome, features, pricing, demo, signup, contact.
Documentation & handoverincluded in MVPFull docs + walkthrough; client owns everything.
Total fixed Phase 1 priceconfirmed at contractQuoted as one fixed price after discovery call.

8.2 Third-party accounts & minimum setup

ServiceMin. to startNotes
Twilio (telephony)~$20 credit + numberAccount verification; ~$1–$2/mo per number.
Vapi or Retell (voice AI)~$10–$20 creditStandard developer signup; pay-as-you-go.
Meta WhatsApp Cloud API$0 to startBusiness verification + phone number; free tier covers initial usage.
LLM provider (OpenAI / Claude)~$10 creditAPI key with a small prepaid balance.
VPS (hosting)~$10–$30 / monthStandard Linux VPS for app, DB, queues.
Domain name~$10–$15 / yearRegistered under client ownership.
Stripe (subscriptions)$0 to startStandard verification; pay-as-you-go fees.

8.3 Approx. monthly platform overhead

ItemApprox. cost / moNotes
VPS hosting$10–$30Single VPS comfortably runs the MVP and pilot.
Domain~$1Annual fee, amortised.
Sentry / monitoring$0–$26Free tier sufficient at pilot scale.
Backups & object storage$1–$5DB snapshots and call recording storage.
Email (transactional)$0–$10Password resets, receipts, alerts.

Minimum to launch the pilot: verified Twilio + one number, Vapi/Retell account, verified Meta WhatsApp Business account, LLM API key with credit, one VPS, a domain. Upfront out-of-pocket to go live (ex. development) is roughly $50–$120 plus per-use charges.

09

Delivery Process

Work proceeds through a clear, repeatable sequence with regular check-ins.

  1. 1

    Discovery

    Confirm languages, order flows, branches, and pilot business details.

  2. 2

    Audit & setup

    Provision accounts (Twilio, Vapi/Retell, Meta, LLM, hosting) under client ownership.

  3. 3

    Build

    Implement data model, roles, dashboards, and AI channels in the build order below.

  4. 4

    Review

    Demo each milestone; gather and apply feedback.

  5. 5

    Pilot

    Run the live system with the pilot business; capture usage and cost data.

  6. 6

    Handover

    Documentation, walkthrough, and full transfer of code and accounts.

Phase 1 build order

  1. 01Multi-tenant database schema, authentication, and role system.
  2. 02Order dashboard for all three roles, validated with test orders.
  3. 03Twilio + voice AI integration — voice orders flowing into the dashboard.
  4. 04WhatsApp Cloud API + conversation agent — chat orders into the same dashboard.
  5. 05Missed-call → WhatsApp recovery, tightening the two channels together.
  6. 06Customer memory wired into both voice and WhatsApp.
  7. 07Lean marketing site, plan assignment, and pilot launch.

10

Ownership, Security & Compliance

Ownership & handover

Client owns 100% of source code and all platform accounts. Full documentation and walkthrough enable the client to run and maintain the system independently.

Security

Hashed passwords, JWT authentication, role-based access on every endpoint. Strict tenant scoping — a Branch-Admin cannot see other branches; a Shop-Admin cannot see other shops. Recordings and transcripts stored with per-shop scoping and access logging.

Compliance (MVP-level)

Recording-consent notice in the voice greeting. Respect for WhatsApp's 24-hour service window and approved templates. Basic customer-data deletion; full GDPR workflows scheduled for a later phase.

11

Commercials & Engagement

Engagement model: fixed-price, paid contract per phase. Phase 1 (MVP / Pilot) is contracted now. Phases 2 and 3 are optional and commissioned separately once the pilot demonstrates value.

ItemDetail
Phase 1 scopeAs defined in section 6.1
Phase 1 priceFixed — confirmed after discovery call
Payment structureMilestone-based across the Phase 1 build
Phase 2 & 3Separate fixed-price contracts, optional
MaintenanceOptional monthly retainer

Next step

A short discovery call to confirm languages, order flows, branch setup, and the pilot business — after which the fixed Phase 1 price and milestone schedule are finalised and work can begin.

Hire on Upwork
Back to case study

Document: AI Commerce OS Proposal v1.0 · Prepared by SM Ashiqurzamman