59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
|
# Live Stripe mock UI test
|
||
|
|
|
||
|
|
Date: 2026-08-04
|
||
|
|
Environment: local Descrybe v2 (`WEB_ORIGIN=http://localhost:5174`, API `:8080`)
|
||
|
|
Demo user: `demo@descrybe.local` / `DemoPass123!` (Local Demo Co)
|
||
|
|
|
||
|
|
## Preconditions
|
||
|
|
|
||
|
|
- `STRIPE_MOCK=true` in root `.env` (API restarted after change)
|
||
|
|
- Migration `016_stripe_billing` applied (goose version 16+)
|
||
|
|
- Web + API running (`localhost:5174`, `localhost:8080/healthz`)
|
||
|
|
- Demo company starts on **Enterprise** (run seed-demo if unsure)
|
||
|
|
|
||
|
|
## Flow exercised
|
||
|
|
|
||
|
|
1. Browser login at `/login`
|
||
|
|
2. Open `/plans` — Enterprise marked **Current plan**; **Upgrade to Starter** visible
|
||
|
|
3. Click **Upgrade to Starter**
|
||
|
|
4. Mock Checkout assigns Starter + credits and redirects to
|
||
|
|
`/billing?checkout=success&mock=1&plan=starter`
|
||
|
|
5. Assert success copy includes **Plan updated** / **starter**; Plan details show **Starter**
|
||
|
|
6. Restore demo: `cd apps/api && go run ./cmd/seed-demo -postgres $env:DATABASE_URL`
|
||
|
|
7. Re-check `/billing` and `/plans` — **Enterprise**, **Unlimited**, no accidental leave on Starter
|
||
|
|
|
||
|
|
## Results
|
||
|
|
|
||
|
|
| Step | Result |
|
||
|
|
|------|--------|
|
||
|
|
| Stripe status (`GET /api/billing/stripe`) | `mock:true`, `configured:false` |
|
||
|
|
| Mock checkout API | `applied:true`, success URL with `mock=1&plan=starter` |
|
||
|
|
| UI Upgrade to Starter | Pass — redirect + success banner |
|
||
|
|
| seed-demo restore Enterprise | Pass — 1,000,000 credits / unlimited SKUs |
|
||
|
|
| Billing after restore | Pass — Enterprise, Unlimited, Compare plans |
|
||
|
|
| Plans after restore | Pass — Current plan on Enterprise; Upgrade CTAs on Starter/Growth/Business |
|
||
|
|
|
||
|
|
Artifacts: `artifacts/live-stripe-checkout.webp`, `artifacts/live-stripe-verify.webp` (+ `.report.json`).
|
||
|
|
|
||
|
|
## UI fixes from this pass
|
||
|
|
|
||
|
|
1. **Plans** — Enterprise subtitle no longer says “with Unlimited AI credits remaining” (redundant/confusing). Copy is now capacity-focused.
|
||
|
|
2. **Billing** — “Compare plans” was an `<a>` wrapping `<button>` (invalid nesting). Switched to `buttonClasses` on the anchor.
|
||
|
|
|
||
|
|
## Notes
|
||
|
|
|
||
|
|
- On Enterprise, Billing hides **Quick upgrade** (by design). Use `/plans` for self-serve mock upgrades.
|
||
|
|
- Mock Checkout on Local Demo Co **will** move the tenant off Enterprise. Always re-run `seed-demo` afterward.
|
||
|
|
- Do **not** leave the demo company on Starter.
|
||
|
|
- **Production:** real `STRIPE_SECRET_KEY`, publishable key, price IDs, and `STRIPE_WEBHOOK_SECRET` are **required** (see [stripe-setup.md](stripe-setup.md)). `STRIPE_MOCK=true` is local-only and is **not** a code blocker for staging as long as prod cutover sets real keys.
|
||
|
|
|
||
|
|
## Restore command
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
cd apps/api
|
||
|
|
# DATABASE_URL from repo `.env` (Postgres :5433)
|
||
|
|
go run ./cmd/seed-demo -postgres $env:DATABASE_URL -email demo@descrybe.local -password 'DemoPass123!' -also-email demo@descrybe.test
|
||
|
|
```
|
||
|
|
|
||
|
|
See also: [stripe-setup.md](stripe-setup.md), [demo-user.md](demo-user.md).
|