Strict Runbook
Arogya Amritam Go-Live Runbook
Use this as the single execution order for bringing complete live DB data and operational readiness. Do not skip stage gates.
Version date: March 6, 2026
Critical Sequence
- - Entities -> Categories -> Products -> Users -> Batches -> Pricing -> Orders/POS -> Settlements -> Go-Live
- - Barcode tools are optional helper utilities; they are not the first setup step.
- - No orders/POS should go live until batch stock exists and QC status is aligned.
S0 • Tech Lead + Super Admin
Platform Readiness
Prerequisites
- - Production DB reachable
- - Render API deployed from latest commit
- - Vercel web/admin/pos env set
Execution Tasks
- - Set final `NEXT_PUBLIC_API_URL` in web/admin/pos builds.
- - Set backend env: DB, JWT, CORS, Razorpay, Twilio, SendGrid, Shiprocket, AWS S3.
- - Verify `OPTIONS` and authenticated API calls from admin and web domains.
Exit Evidence
- - `/api/health` responds OK
- - Admin login works
- - No CORS error in browser console
S1 • Super Admin + Ops
Master Data Foundation
Execution Tasks
- - Create Entity master first: Warehouses, Franchise Stores, Dealers, Vendors, Manufacturers.
- - Create Category master.
- - Create Product master (SKU, pricing, tax, HSN, GTIN where available).
- - Create Users and map operational users to correct entity codes.
Exit Evidence
- - Entity list complete
- - No duplicate SKU/GTIN
- - All required roles created and can log in
S2 • Ops + QC
Inventory Initialization
Execution Tasks
- - Upload opening batch stock per entity/product.
- - Set manufacturing date, expiry date, quantity, cost price for each batch.
- - Upload COA/lab report files and set QC status.
- - Validate FEFO readiness (non-expired stock available for selling).
Exit Evidence
- - Inventory page shows batches
- - Aging report is valid
- - QC upload URL opens correctly
S3 • Finance + Super Admin
Commercial Rules and Finance Setup
Execution Tasks
- - Load slab pricing (dealer/franchise quantity tiers).
- - Set credit limits and credit terms for entities.
- - Finalize royalty and settlement logic for franchise/dealer payouts.
- - Confirm invoice format and tax behavior.
Exit Evidence
- - Price calculations match approved sheet
- - Settlement draft generated correctly
- - Tax totals validated
S4 • Ops + Store Team
Operational Flow Validation
Execution Tasks
- - Run end-to-end dry run: product scan -> order create -> stock deduction -> order status updates.
- - Run inventory inward and adjustment scenarios.
- - Run returns/cancellations scenarios.
- - Run POS login and billing scenarios with mapped store users.
Exit Evidence
- - No negative stock
- - Order totals and ledger are correct
- - Role-based access behaves as expected
S5 • Tech + Ops
Integrations and Notifications Validation
Execution Tasks
- - Test Razorpay order create + verify + refund flow.
- - Test Twilio OTP send/verify.
- - Test SendGrid transactional emails.
- - Test Shiprocket shipment create/tracking (if enabled for go-live).
- - Test S3 file upload/delete/read for COA and docs.
Exit Evidence
- - Each provider test passes with real credentials
- - No fallback/mock behavior in production
S6 • Business Owner + Tech Lead
UAT and Sign-Off
Prerequisites
- - S5 complete (or approved exceptions)
Execution Tasks
- - Execute UAT checklist with business users for admin/web/pos.
- - Freeze approved product/entity/price data snapshot.
- - Capture formal sign-off with named approver and date.
Exit Evidence
- - Signed UAT approval
- - Known issues list accepted
- - Go-live date approved
S7 • Tech Lead
Production Cutover
Execution Tasks
- - Take final DB backup before switch.
- - Apply final env values and redeploy API + frontends.
- - Run smoke tests on production URLs.
- - Monitor logs/errors closely for first 24 hours.
Exit Evidence
- - All smoke tests pass
- - No high-severity errors
- - Business confirms live operations
