Can I vibe code Maxio?

1. SYSTEM OVERVIEW
Build a custom subscription billing engine and usage tracking API using Next.js, Node.js, PostgreSQL (Prisma ORM), and Stripe API. The system manages recurring plans, meters usage events, and generates monthly customer invoices.

2. DATA MODEL & ARCHITECTURE
- Subscription Plans: ID, Name, Billing Interval (Monthly/Annual), Base Fee (Cents), Included Usage Units, Overage Rate (Cents per Unit).
- Subscriptions: ID, Customer ID, Plan ID, Status (Active, Past Due, Canceled), Current Period Start/End, Payment Method ID.
- Usage Events: ID, Subscription ID, Metric Name, Event Value, Timestamp, Idempotency Key.
- Invoices: ID, Subscription ID, Total Amount (Cents), Status (Draft, Paid, Failed), Line Items (JSON), Issued At.

3. CORE FUNCTIONALITY & LOGIC
- Ingest metered events via API endpoint (/v1/telemetry) with strict rate limiting and duplicate event filtering using Idempotency Keys.
- Implement a scheduled background worker (BullMQ/Redis) running nightly to calculate current period usage subtotals against plan limits.
- Integrate Stripe Webhooks for subscription status synchronization (invoice.payment_succeeded, invoice.payment_failed, customer.subscription.updated).
- Build automated dunning logic: Send email notifications upon payment failure, retry payments at 3, 7, and 14 days, and degrade account access if unpaid.
- Provide a React-based portal for end-users to view past invoices, update credit cards, and switch billing tiers.

4. FAILURE MODES & EDGE CASES TO HANDLE
- Idempotency handling on usage event ingestion to prevent double-billing during retry storms.
- Floating point safety: Use integer calculations (cents/micros) for all pricing calculations.
- Mid-cycle subscription upgrades: Calculate prorated base fees based on days remaining in the billing period.

5. OUT OF SCOPE
- ASC 606 / IFRS 15 automated revenue recognition schedules and deferred revenue accounting.
- Bi-directional enterprise ERP synchronizations (NetSuite, QuickBooks, SAP).
- Automated global tax calculation engines (Avalara / TaxJar integration).

$ each button prefixes agent-specific run instructions · build your own product, never copy proprietary code, trademarks or designs