feat: integrate business routes and update documentation

- Updated README with complete project structure, endpoints, and setup
- Integrated business routes into main.py (Paddle, onboarding, analytics, calculators, dashboard)
- Routes are optional with graceful fallback if not available

Author: kiku-jw

README.md

@@ -6,15 +6,6 @@ Reliability layer for API calls: retries, caching, dedup, circuit breakers.
 [![PyPI version](https://badge.fury.io/py/reliapi-sdk.svg)](https://pypi.org/project/reliapi-sdk/)
 [![Docker](https://img.shields.io/docker/v/kikudoc/reliapi?label=docker)](https://hub.docker.com/r/kikudoc/reliapi)
 
-## Installation
-
-- **Product Hunt**: [⭐ Support us on Product Hunt](https://www.producthunt.com/products/reliapi) - Help us reach more developers!
-- **RapidAPI**: [Try ReliAPI on RapidAPI](https://rapidapi.com/kikuai-lab-kikuai-lab-default/api/reliapi) - No installation required, use directly from RapidAPI
-- **NPM Package**: [reliapi-sdk](https://www.npmjs.com/package/reliapi-sdk) - `npm install reliapi-sdk`
-- **PyPI Package**: [reliapi-sdk](https://pypi.org/project/reliapi-sdk/) - `pip install reliapi-sdk`
-- **Docker Image**: [kikudoc/reliapi](https://hub.docker.com/r/kikudoc/reliapi) - `docker pull kikudoc/reliapi`
-- **CLI Package**: [reliapi-cli](https://pypi.org/project/reliapi-cli/) - `pip install reliapi-cli`
-
 ## Features
 
 - **Retries with Backoff** - Automatic retries with exponential backoff
@@ -24,69 +15,177 @@ Reliability layer for API calls: retries, caching, dedup, circuit breakers.
 - **Rate Limiting** - Built-in rate limiting per tier
 - **LLM Proxy** - Unified interface for OpenAI, Anthropic, Mistral
 - **Cost Control** - Budget caps and cost estimation
+- **Self-Service Onboarding** - Automated API key generation
+- **Paddle Payments** - Subscription management
 
-## Quick Start
+## Project Structure
 
-### Using RapidAPI (No Installation Required)
+```
+reliapi/
+├── core/                 # Core reliability components
+│   ├── cache.py          # Redis-based TTL cache
+│   ├── circuit_breaker.py
+│   ├── idempotency.py    # Request coalescing
+│   ├── retry.py          # Exponential backoff
+│   ├── rate_limiter.py   # Per-tenant rate limits
+│   ├── rate_scheduler.py # Token bucket algorithm
+│   ├── key_pool.py       # Multi-key management
+│   └── cost_estimator.py # LLM cost calculation
+├── app/
+│   ├── main.py           # FastAPI application
+│   ├── services.py       # Business logic
+│   ├── schemas.py        # Pydantic models
+│   └── routes/           # Business routes
+│       ├── paddle.py     # Payment processing
+│       ├── onboarding.py # Self-service signup
+│       ├── analytics.py  # Usage analytics
+│       ├── calculators.py# ROI/pricing calculators
+│       └── dashboard.py  # Admin dashboard
+├── adapters/
+│   └── llm/              # LLM provider adapters
+│       ├── openai.py
+│       ├── anthropic.py
+│       └── mistral.py
+├── config/               # Configuration loader
+├── metrics/              # Prometheus metrics
+├── examples/             # Code examples
+├── integrations/         # LangChain, LlamaIndex
+├── openapi/              # OpenAPI specs
+├── postman/              # Postman collection
+└── tests/                # Test suite
+```
 
-Try ReliAPI directly on [RapidAPI](https://rapidapi.com/kikuai-lab-kikuai-lab-default/api/reliapi) - no SDK installation needed. Just subscribe to the API and start making requests!
+## Quick Start
+
+### Using RapidAPI (No Installation)
 
-### Using the SDK
+Try ReliAPI directly on [RapidAPI](https://rapidapi.com/kikuai-lab-kikuai-lab-default/api/reliapi).
 
-**JavaScript/TypeScript:**
+### Self-Hosting with Docker
 
 ```bash
-npm install reliapi-sdk
+docker run -d -p 8000:8000 \
+  -e REDIS_URL="redis://localhost:6379/0" \
+  -e RELIAPI_CONFIG_PATH=/app/config.yaml \
+  kikudoc/reliapi:latest
 ```
 
-```typescript
-import { ReliAPI } from 'reliapi-sdk';
+### Local Development
 
-const client = new ReliAPI({
-  baseUrl: 'https://api.reliapi.dev',
-  apiKey: 'your-api-key'
-});
+```bash
+# Clone repository
+git clone https://github.com/KikuAI-Lab/reliapi.git
+cd reliapi
 
-// HTTP proxy with retries
-const response = await client.proxyHttp({
-  target: 'my-api',
-  method: 'GET',
-  path: '/users/123',
-  cache: 300  // cache for 5 minutes
-});
+# Create virtual environment
+python3 -m venv venv
+source venv/bin/activate
 
-// LLM proxy with idempotency
-const llmResponse = await client.proxyLlm({
-  target: 'openai',
-  model: 'gpt-4o-mini',
-  messages: [{ role: 'user', content: 'Hello!' }],
-  idempotencyKey: 'unique-key-123'
-});
+# Install dependencies
+pip install -r requirements.txt
+
+# Start Redis
+docker run -d -p 6379:6379 redis:7-alpine
+
+# Run server
+export REDIS_URL=redis://localhost:6379/0
+uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
+```
+
+## Configuration
+
+Create `config.yaml`:
+
+```yaml
+targets:
+  openai:
+    base_url: https://api.openai.com/v1
+    llm:
+      provider: openai
+      default_model: gpt-4o-mini
+      soft_cost_cap_usd: 0.10
+      hard_cost_cap_usd: 0.50
+    cache:
+      enabled: true
+      ttl_s: 3600
+    circuit:
+      error_threshold: 5
+      cooldown_s: 60
+    auth:
+      type: bearer_env
+      env_var: OPENAI_API_KEY
 ```
 
-**Python:**
+## API Endpoints
+
+### Core Proxy
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/proxy/http` | POST | Proxy any HTTP API with reliability |
+| `/proxy/llm` | POST | Proxy LLM requests with cost control |
+| `/healthz` | GET | Health check |
+| `/metrics` | GET | Prometheus metrics |
+
+### Business Routes
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/paddle/plans` | GET | List subscription plans |
+| `/paddle/checkout` | POST | Create checkout session |
+| `/paddle/webhook` | POST | Handle Paddle webhooks |
+| `/onboarding/start` | POST | Generate API key |
+| `/onboarding/quick-start` | GET | Get quick start guide |
+| `/onboarding/verify` | POST | Verify integration |
+| `/calculators/pricing` | POST | Calculate pricing |
+| `/calculators/roi` | POST | Calculate ROI |
+| `/dashboard/metrics` | GET | Usage metrics |
+
+## Environment Variables
 
 ```bash
-pip install reliapi-sdk
+# Required
+REDIS_URL=redis://localhost:6379/0
+
+# Optional
+RELIAPI_CONFIG_PATH=config.yaml
+RELIAPI_API_KEY=your-api-key
+CORS_ORIGINS=*
+LOG_LEVEL=INFO
+
+# LLM Providers
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+MISTRAL_API_KEY=...
+
+# Paddle (for payments)
+PADDLE_API_KEY=...
+PADDLE_VENDOR_ID=...
+PADDLE_WEBHOOK_SECRET=...
+PADDLE_ENVIRONMENT=sandbox
 ```
 
+## SDK Usage
+
+### Python
+
 ```python
 from reliapi_sdk import ReliAPI
 
 client = ReliAPI(
-    base_url="https://api.reliapi.dev",
+    base_url="https://reliapi.kikuai.dev",
     api_key="your-api-key"
 )
 
-# HTTP proxy with retries
+# HTTP proxy
 response = client.proxy_http(
     target="my-api",
     method="GET",
     path="/users/123",
     cache=300
 )
 
-# LLM proxy with idempotency
+# LLM proxy
 llm_response = client.proxy_llm(
     target="openai",
     model="gpt-4o-mini",
@@ -95,74 +194,42 @@ llm_response = client.proxy_llm(
 )
 ```
 
-### Using the CLI
+### JavaScript
 
-```bash
-pip install reliapi-cli
-```
-
-```bash
-# Check health
-reli ping
-
-# Make HTTP request
-reli request --method GET --url https://api.example.com/users
-
-# Make LLM request
-reli llm --target openai --message "Hello, world!"
-```
-
-### Using the GitHub Action
-
-```yaml
-- uses: KikuAI-Lab/reliapi@v1
-  with:
-    api-url: 'https://api.reliapi.dev'
-    api-key: ${{ secrets.RELIAPI_KEY }}
-    endpoint: '/proxy/http'
-    method: 'POST'
-    body: '{"target": "my-api", "method": "GET", "path": "/health"}'
-```
-
-## API Endpoints
-
-### HTTP Proxy
-
-```
-POST /proxy/http
-```
-
-Proxy any HTTP API with reliability layers.
+```typescript
+import { ReliAPI } from 'reliapi-sdk';
 
-### LLM Proxy
+const client = new ReliAPI({
+  baseUrl: 'https://reliapi.kikuai.dev',
+  apiKey: 'your-api-key'
+});
 
-```
-POST /proxy/llm
+const response = await client.proxyLlm({
+  target: 'openai',
+  model: 'gpt-4o-mini',
+  messages: [{ role: 'user', content: 'Hello!' }]
+});
 ```
 
-Proxy LLM requests with idempotency, caching, and cost control.
+## Testing
 
-### Health Check
+```bash
+# Run tests
+pytest
 
+# With coverage
+pytest --cov=reliapi --cov-report=html
 ```
-GET /healthz
-```
-
-Health check endpoint for monitoring.
 
-## Self-Hosting
+## Deployment
 
-```bash
-docker run -d -p 8000:8000 \
-  -e REDIS_URL="redis://localhost:6379/0" \
-  kikudoc/reliapi:latest
-```
+See [DEPLOYMENT.md](./docs/DEPLOYMENT.md) for production deployment guide.
 
 ## Documentation
 
 - [OpenAPI Spec](./openapi/openapi.yaml)
 - [Postman Collection](./postman/collection.json)
-- [Full Documentation](https://reliapi.kikuai.dev)
+- [Live Docs](https://reliapi.kikuai.dev/docs)
 
 ## License
 
@@ -172,4 +239,3 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 - GitHub Issues: https://github.com/KikuAI-Lab/reliapi/issues
 - Email: dev@kikuai.dev
-

app/main.py

@@ -1322,7 +1322,27 @@ async def rapidapi_status(request: Request):
     )
 
 
+# =============================================================================
+# Business Routes (Paddle, Onboarding, Analytics, Calculators, Dashboard)
+# =============================================================================
+
+# Import and register business routes
+try:
+    from reliapi.app.routes import paddle, onboarding, analytics, calculators, dashboard
+    
+    app.include_router(paddle.router)
+    app.include_router(onboarding.router)
+    app.include_router(analytics.router)
+    app.include_router(calculators.router)
+    app.include_router(dashboard.router)
+    
+    logger.info("Business routes registered: paddle, onboarding, analytics, calculators, dashboard")
+except ImportError as e:
+    logger.warning(f"Business routes not available: {e}")
+
+
 if __name__ == "__main__":
     import uvicorn
 
     uvicorn.run(app, host="0.0.0.0", port=8000)
+