feat: Add Vite dev server ports to CORS and create frontend readiness checklist

Author: mytherapy-coding

FRONTEND_READY_CHECKLIST.md

@@ -0,0 +1,185 @@
+# Backend Readiness Checklist for Frontend Integration
+
+## ✅ CORS Configuration
+
+**Status**: ✅ READY
+
+- CORS middleware configured in `app/main.py`
+- Allowed origins include:
+  - `http://localhost:5173` (Vite default)
+  - `http://localhost:5174` (Vite alternative)
+  - `http://localhost:3000` (Static server)
+  - `http://localhost:3001` (CRA/Next.js)
+  - `https://mytherapy-coding.github.io` (GitHub Pages)
+
+**To add production frontend domain:**
+Edit `app/core/config.py` and add your frontend URL to `ALLOWED_ORIGINS`.
+
+## ✅ API Endpoints
+
+**Status**: ✅ READY
+
+All 14 endpoints are available:
+
+### System Endpoints
+- ✅ `GET /v1/health` - Health check
+- ✅ `GET /v1/info` - Service info
+- ✅ `POST /v1/echo` - Echo test
+
+### TVM Endpoints
+- ✅ `POST /v1/tvm/future-value` - Future value calculation
+- ✅ `POST /v1/tvm/present-value` - Present value calculation
+- ✅ `POST /v1/tvm/annuity-payment` - Annuity payment calculation
+
+### Mortgage Endpoints
+- ✅ `POST /v1/mortgage/payment` - Monthly payment
+- ✅ `POST /v1/mortgage/amortization-schedule` - Full schedule
+- ✅ `POST /v1/mortgage/summary` - Summary with totals
+- ✅ `POST /v1/mortgage/with-extra-payments` - Extra payments impact
+
+### Bond Endpoints
+- ✅ `POST /v1/bond/yield` - Yield to maturity
+- ✅ `POST /v1/bond/price` - Price from yield
+
+### XIRR Endpoints
+- ✅ `POST /v1/xirr` - XIRR calculation
+- ✅ `POST /v1/xirr/explain` - XIRR with metadata
+
+## ✅ Error Handling
+
+**Status**: ✅ READY
+
+- Unified error response format:
+  ```json
+  {
+    "ok": false,
+    "error": {
+      "code": "ERROR_CODE",
+      "message": "Human-readable message",
+      "details": []
+    }
+  }
+  ```
+
+- All endpoints return consistent format
+- Validation errors return 422 with details
+- Business logic errors return 400 with specific codes
+
+## ✅ Response Format
+
+**Status**: ✅ READY
+
+All successful responses follow:
+```json
+{
+  "ok": true,
+  "result_field": value
+}
+```
+
+## ✅ API Base URL
+
+**Production**: `https://financial-calculations-api.onrender.com`
+
+**Local Development**: `http://localhost:8000` (when running locally)
+
+## ✅ Documentation
+
+**Status**: ✅ READY
+
+- Swagger UI: `/docs` endpoint
+- OpenAPI spec: `/openapi.json`
+- Client documentation in `README.md`
+- All endpoints documented with examples
+
+## ✅ Testing
+
+**Status**: ✅ READY
+
+- 91+ tests covering all endpoints
+- Error handling tested
+- Edge cases covered
+- Integration tests included
+
+## 🔧 Frontend Integration Steps
+
+### 1. Create API Client
+
+```javascript
+const API_BASE = import.meta.env.VITE_API_BASE || 
+  'https://financial-calculations-api.onrender.com';
+
+async function apiRequest(endpoint, options = {}) {
+  const url = `${API_BASE}${endpoint}`;
+  const response = await fetch(url, {
+    headers: {
+      'Content-Type': 'application/json',
+      ...options.headers,
+    },
+    ...options,
+    body: options.body ? JSON.stringify(options.body) : undefined,
+  });
+  
+  const data = await response.json();
+  
+  if (!data.ok) {
+    throw new Error(data.error?.message || 'API request failed');
+  }
+  
+  return data;
+}
+```
+
+### 2. Example: Mortgage Summary
+
+```javascript
+async function calculateMortgageSummary(principal, rate, years) {
+  return apiRequest('/v1/mortgage/summary', {
+    method: 'POST',
+    body: {
+      principal,
+      annual_rate: rate / 100, // Convert % to decimal
+      years,
+    },
+  });
+}
+```
+
+### 3. Error Handling
+
+```javascript
+try {
+  const result = await calculateMortgageSummary(300000, 4, 30);
+  console.log('Monthly payment:', result.monthly_payment);
+} catch (error) {
+  console.error('API Error:', error.message);
+  // Show user-friendly error message
+}
+```
+
+## ⚠️ Important Notes
+
+1. **Rate Format**: All rates must be decimals (0.04 = 4%, not 4)
+2. **Amount Limits**: Maximum amount is 1e12 (1 trillion)
+3. **Date Format**: Use `YYYY-MM-DD` for dates (XIRR endpoints)
+4. **Timeouts**: Solver endpoints (bond yield, XIRR) have 5-second timeout
+5. **CORS**: Make sure your frontend origin is in `ALLOWED_ORIGINS`
+
+## 🚀 Ready for Frontend!
+
+Your backend is **100% ready** for frontend integration. All endpoints are:
+- ✅ Documented
+- ✅ Tested
+- ✅ CORS-enabled
+- ✅ Error-handled
+- ✅ Production-ready
+
+## Next Steps
+
+1. Create frontend repository
+2. Set up React/Vue project
+3. Create API client service
+4. Build UI components
+5. Connect to backend API
+6. Test integration
+7. Deploy frontend

app/core/config.py

@@ -11,6 +11,14 @@
     # Local static client (python -m http.server 3000)
     "http://localhost:3000",
     "http://127.0.0.1:3000",
+    # Vite dev server (default ports)
+    "http://localhost:5173",
+    "http://127.0.0.1:5173",
+    "http://localhost:5174",
+    "http://127.0.0.1:5174",
+    # Create React App / Next.js dev servers
+    "http://localhost:3001",
+    "http://127.0.0.1:3001",
     # GitHub Pages for this project
     "https://mytherapy-coding.github.io",
 ]