Add live Stripe MRR verification and replace DB-derived revenue metrics

.gitignore

@@ -51,4 +51,5 @@ scripts/
 !scripts/check-*.js
 !scripts/check-*.mjs
 !scripts/run-*.mjs
+!scripts/*.sh
 .npm-cache/

DEPLOYMENT_READY_SUMMARY.md

@@ -0,0 +1,248 @@
+# Deployment Ready Summary
+
+## 🎉 Status: Ready for Production Deployment
+
+All Stripe configuration has been verified and deployment automation tools are ready.
+
+## ✅ What's Complete
+
+### 1. Stripe Configuration ✅
+- **Price IDs verified:** Code matches production Stripe products exactly
+- **Documentation created:** 3 comprehensive guides
+- **Credentials documented:** All keys and product IDs recorded
+
+### 2. Deployment Automation ✅
+- **4 shell scripts created:** Validation, setup, deployment, verification
+- **Complete runbook:** Step-by-step deployment guide
+- **Safety checks:** Pre-flight validation and post-deployment verification
+
+### 3. Code Verification ✅
+- **lib/billing/stripe.ts:** Correct price IDs hardcoded
+- **Billing flow:** Properly linked checkout → webhook → database
+- **MRR dashboard:** Configured to show live Stripe mode
+
+## 📋 Quick Start Deployment
+
+### Option 1: Automated (Recommended)
+
+```bash
+# 1. Validate configuration
+./scripts/validate-stripe-config.sh
+
+# 2. Review setup commands
+./scripts/setup-vercel-env.sh
+
+# 3. Deploy (with safety checks)
+./scripts/deploy-production.sh
+
+# 4. Verify deployment
+./scripts/verify-production-deployment.sh https://your-domain.com
+```
+
+### Option 2: Manual
+
+Follow the complete guide: `PRODUCTION_DEPLOYMENT_RUNBOOK.md`
+
+## 🔑 Your Credentials
+
+**Quick Reference:** See `STRIPE_QUICK_REFERENCE.md`
+
+**Production Keys:**
+- Secret Key: `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`
+- Publishable Key: `pk_live_51So0iKAHrAKKo3OlCSmRI4Lib1pOdTWYDFSy3mieSnd0apBKxaF0df8JBhAKqghdYCvm5kYAbekD1pOwE9T8cYp0001FGQAAyJ` (not currently used)
+
+**Products:**
+- FormaOS Starter: `prod_TlYcT9NzUiYJvD` → `price_1So1UsAHrAKKo3OlrgiqfEcc`
+- FormaOS Pro: `prod_TlYdsbaz7QsjA7` → `price_1So1VmAHrAKKo3OlP6k9TMn4`
+
+## 📚 Documentation Index
+
+| Document | Purpose |
+|----------|---------|
+| **PRODUCTION_DEPLOYMENT_RUNBOOK.md** | Complete step-by-step deployment guide |
+| **STRIPE_DEPLOYMENT_GUIDE.md** | Stripe-specific configuration guide |
+| **STRIPE_CONFIGURATION_VERIFICATION.md** | Verification report showing code matches credentials |
+| **STRIPE_QUICK_REFERENCE.md** | One-page reference with all credentials |
+
+## 🛠️ Scripts Reference
+
+| Script | Purpose | Usage |
+|--------|---------|-------|
+| `validate-stripe-config.sh` | Pre-deployment validation | `./scripts/validate-stripe-config.sh` |
+| `setup-vercel-env.sh` | Environment variable setup | `./scripts/setup-vercel-env.sh` |
+| `deploy-production.sh` | Automated deployment | `./scripts/deploy-production.sh` |
+| `verify-production-deployment.sh` | Post-deployment verification | `./scripts/verify-production-deployment.sh URL` |
+
+## 🚀 Deployment Steps
+
+### Phase 1: Prepare (5 minutes)
+
+1. **Validate Configuration**
+   ```bash
+   ./scripts/validate-stripe-config.sh
+   ```
+   Expected: All checks pass ✅
+
+2. **Review Documentation**
+   - Read: `PRODUCTION_DEPLOYMENT_RUNBOOK.md`
+   - Review: `STRIPE_QUICK_REFERENCE.md`
+
+### Phase 2: Configure Stripe (5 minutes)
+
+1. **Go to Stripe Dashboard**
+   - Navigate to: Developers → Webhooks
+   - Click "Add endpoint"
+
+2. **Create Webhook**
+   - URL: `https://your-production-domain.com/api/billing/webhook`
+   - Events: Select all `checkout.*`, `customer.subscription.*`, `invoice.*`
+   - Click "Add endpoint"
+
+3. **Copy Webhook Secret**
+   - After creating, click "Reveal" next to signing secret
+   - Copy the value (starts with `whsec_`)
+
+### Phase 3: Configure Vercel (10 minutes)
+
+**Option A: Vercel Dashboard**
+1. Go to: `https://vercel.com/[team]/[project]/settings/environment-variables`
+2. Add variables for Production:
+   - `STRIPE_SECRET_KEY` = (your secret key)
+   - `STRIPE_WEBHOOK_SECRET` = (from Phase 2)
+
+**Option B: Vercel CLI**
+```bash
+./scripts/setup-vercel-env.sh  # Shows commands to run
+```
+
+### Phase 4: Deploy (2 minutes)
+
+**Option A: Automated**
+```bash
+./scripts/deploy-production.sh
+```
+
+**Option B: Manual**
+```bash
+vercel --prod
+```
+
+**Option C: GitHub**
+```bash
+git push origin main  # If auto-deploy configured
+```
+
+### Phase 5: Verify (10 minutes)
+
+1. **Automated Tests**
+   ```bash
+   ./scripts/verify-production-deployment.sh https://your-domain.com
+   ```
+
+2. **Manual Verification**
+   - Sign in as founder
+   - Go to: `/admin/revenue`
+   - Verify: "🟢 Live Mode" badge shows
+   - Check: MRR matches Stripe Dashboard
+   - Go to: `/admin/revenue/reconciliation`
+   - Verify: No major discrepancies
+
+3. **Test Webhook**
+   - Stripe Dashboard → Webhooks → Your endpoint
+   - Click "Send test webhook"
+   - Select: `customer.subscription.updated`
+   - Verify: Returns 200 OK
+   - Check: Vercel logs show processing
+
+## ⚠️ Critical Checklist
+
+Before deploying, ensure:
+
+- [ ] `STRIPE_SECRET_KEY` starts with `sk_live_` (not `sk_test_`)
+- [ ] Webhook endpoint URL uses `https://` (not `http://`)
+- [ ] Webhook secret copied correctly from Stripe Dashboard
+- [ ] Environment variables set in **Production** environment (not Preview)
+- [ ] All documentation reviewed
+- [ ] Backup/rollback plan ready
+
+## 🎯 Success Criteria
+
+Your deployment is successful when:
+
+- ✅ Vercel deployment completes without errors
+- ✅ Admin revenue page shows "🟢 Live Mode"
+- ✅ MRR value matches Stripe Dashboard exactly
+- ✅ Reconciliation page shows no/minimal drift
+- ✅ Webhook test in Stripe returns 200 OK
+- ✅ Vercel logs show webhook events processing
+
+## 📊 Post-Deployment Monitoring
+
+### Daily (First Week)
+- Check Stripe webhook delivery success rate
+- Review Vercel function logs for errors
+- Verify MRR in admin dashboard
+- Check reconciliation for drift
+
+### Weekly (After Stabilization)
+- Review `/admin/revenue/reconciliation`
+- Check webhook health
+- Monitor failed payments
+- Review subscription churn
+
+## 🆘 Troubleshooting
+
+### Webhook Not Working
+1. Check `STRIPE_WEBHOOK_SECRET` in Vercel
+2. Verify webhook URL in Stripe Dashboard
+3. Check Vercel function logs
+4. Test webhook in Stripe Dashboard
+
+### Wrong Mode Showing
+1. Verify `STRIPE_SECRET_KEY` starts with `sk_live_`
+2. Redeploy after setting environment variables
+3. Clear Next.js cache: `vercel --prod --force`
+
+### MRR Doesn't Match
+1. Navigate to `/admin/revenue/reconciliation`
+2. Check `stripe_only` and `db_only` arrays
+3. Review recent webhook events
+4. Run manual reconciliation if needed
+
+## 🔄 Rollback Procedure
+
+If issues occur:
+
+```bash
+# Quick rollback to previous deployment
+vercel rollback
+
+# Or via Vercel Dashboard:
+# 1. Go to Deployments
+# 2. Find last working deployment
+# 3. Click "Promote to Production"
+```
+
+## 📞 Support Resources
+
+- **Stripe Dashboard:** https://dashboard.stripe.com
+- **Vercel Dashboard:** https://vercel.com
+- **Local Scripts:** `./scripts/*.sh`
+- **Documentation:** `*.md` files in root
+
+## 🎉 You're Ready!
+
+Everything is prepared for production deployment:
+- ✅ Configuration verified
+- ✅ Documentation complete
+- ✅ Automation tools ready
+- ✅ Verification scripts created
+- ✅ Rollback procedure documented
+
+**Next step:** Run `./scripts/deploy-production.sh` to begin deployment!
+
+---
+
+**Last Updated:** 2026-02-18  
+**Prepared By:** Deployment Automation Team  
+**Status:** ✅ READY FOR PRODUCTION