Enhance README with real product content

RoadChain-SHA2048: ade6c750a49bf038
RoadChain-Identity: alexa@sovereign
RoadChain-Full: ade6c750a49bf0381264ddd634a52bc2faf9b464733114884edcef683a389381b9add3cfc6b0582047d34ca680edca7e85f16e82073787cf58185db81710446d2a0f3499f28dcc385008d522c08ccfea72e56f69c77cd3f2ecc0c38d2821b9f06c6fb3187469c46f79e56409d7cad46ce155d17ac66636bb9af1baab4980197ad02fe7c36b802e183730ed4295ed9b2161bbb11afe0f572261b880b239795822d796f35dc75178d3588bbb0aa710ae8e58f92d6599d1c1a7ed751a5ba35b97767730df5fa0763645c0ea7e59dad28ce15a6c37cb43efbeeae23d9d36c5989c6f683881046bb867349c1a3928bfc1c22772acc42cb4add5a133be3346560663e8

Author: blackboxprogramming

README.md

@@ -1,73 +1,69 @@
-<div align="center">
-<img src="https://images.blackroad.io/pixel-art/road-logo.png" alt="BlackRoad OS" width="80" />
-
 # RoadPay
 
-**Own your billing. D1 subscriptions, plans, invoices. Stripe is the card charger — you are the bank.**
-
-[![BlackRoad OS](https://img.shields.io/badge/BlackRoad_OS-Pave_Tomorrow-FF2255?style=for-the-badge&labelColor=000000)](https://blackroad.io)
-[![License](https://img.shields.io/badge/License-Proprietary-FF6B2B?style=for-the-badge&labelColor=000000)](./LICENSE)
-</div>
+Billing and subscription management. Stripe handles the cards. Your data stays in your database.
 
----
+**Live at [pay.blackroad.io](https://pay.blackroad.io)**
 
-## Architecture
-
-```
-User → RoadPay (D1) → Stripe (card processing only)
-         ↓
-    Plans, Invoices, Subscriptions
-    stored in YOUR database
-```
+## What It Does
 
-RoadPay is BlackRoad's own billing system. Stripe handles card charging — nothing else. All subscription logic, plan management, invoicing, and metering lives in D1 (Cloudflare's serverless SQL).
+RoadPay manages plans, subscriptions, invoices, and customer records. Stripe is used only for card processing. All billing logic and data live in D1.
 
 ## Plans
 
-| Plan | Price | Agents | Requests/Day | Support |
-|------|-------|--------|-------------|---------|
-| Starter | Free | 1 | 100 | Community |
-| Pro | $29/mo | 5 | 10K | Priority |
-| Team | $99/mo | 25 | 100K | Dedicated |
-| Enterprise | Custom | Unlimited | Unlimited | SLA |
-
-## Add-ons
-
-| Add-on | Price | Description |
-|--------|-------|-------------|
-| Extra TOPS | $19/mo | Additional AI compute |
-| Custom Models | $49/mo | Fine-tune your own |
-| Priority Inference | $9/mo | Skip the queue |
-| Dedicated Node | $149/mo | Your own Pi 5 |
+| Plan | Price | For |
+|------|-------|-----|
+| **Starter** | Free | Getting started, 1 agent, 100 req/day |
+| **Pro** | $29/mo | Individuals, 5 agents, 10K req/day |
+| **Team** | $99/mo | Small teams, 25 agents, 100K req/day |
+| **Enterprise** | Custom | Unlimited agents and requests, SLA |
 
 ## API
 
-```bash
-# Create checkout session
-curl -X POST https://roadpay.blackroad.io/api/checkout \
-  -H "Content-Type: application/json" \
-  -d '{"plan": "pro", "billing_cycle": "monthly"}'
-
-# Check subscription
-curl https://roadpay.blackroad.io/api/subscription \
-  -H "Authorization: Bearer $TOKEN"
-```
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/checkout` | POST | Create a checkout session for a plan |
+| `/api/subscription` | GET | Check current subscription status |
+| `/plans` | GET | List available plans and pricing |
+| `/customers` | GET/POST | Manage customer records |
+| `/invoices` | GET | View invoice history |
+| `/webhook` | POST | Stripe event receiver |
 
 ## Stack
 
-- **Runtime**: Cloudflare Workers
-- **Database**: D1 (SQLite at the edge)
+- **Runtime**: Cloudflare Worker
+- **Database**: D1 (customers, invoices, subscriptions)
 - **Payments**: Stripe (card processing only)
-- **Auth**: JWT via blackroad-auth
+- **Auth**: JWT tokens
 
-## Development
+## Deploy
 
 ```bash
 npm install
-npm run dev     # Wrangler dev server
-npm run deploy  # Deploy to Cloudflare
+npm run dev        # Local dev server
+npm run deploy     # Deploy to production
 ```
 
+Set Stripe keys:
+
+```bash
+wrangler secret put STRIPE_SECRET_KEY
+wrangler secret put STRIPE_WEBHOOK_SECRET
+```
+
+## How It Works
+
+1. Customer picks a plan and checks out
+2. RoadPay creates the Stripe subscription
+3. Invoice and subscription state is stored locally in D1
+4. Webhooks keep D1 in sync with Stripe events
+5. All queries (plan changes, invoices, status) hit your database, not Stripe
+
+Your customer records. Your invoice history. Your database. Stripe only touches the card.
+
+## License
+
+Proprietary. Copyright (c) 2024-2026 BlackRoad OS, Inc. All rights reserved.
+
 ---
 
-*Copyright (c) 2024-2026 BlackRoad OS, Inc. All rights reserved.*
+*Remember the Road. Pave Tomorrow.*