igny8/TEST_ENDPOINTS.md

Backend API Endpoints - Test Results

Test Date: December 5, 2025 Backend URL: http://localhost:8011

✅ WORKING ENDPOINTS

Billing API Endpoints

Endpoint	Method	Status	Notes
/api/v1/billing/invoices/	GET	✅ 401	Auth required (correct)
/api/v1/billing/payments/	GET	✅ 401	Auth required (correct)
/api/v1/billing/credit-packages/	GET	✅ 401	Auth required (correct)
/api/v1/billing/transactions/	GET	✅ 401	Auth required (correct)
/api/v1/billing/transactions/balance/	GET	✅ 401	Auth required (correct)
/api/v1/billing/admin/stats/	GET	✅ 401	Auth required (correct)

Account Endpoints

Endpoint	Method	Status	Notes
/api/v1/account/settings/	GET	✅ 401	Auth required (correct)
/api/v1/account/settings/	PATCH	✅ 401	Auth required (correct)
/api/v1/account/team/	GET	✅ 401	Auth required (correct)
/api/v1/account/usage/analytics/	GET	✅ 401	Auth required (correct)

❌ ISSUES FIXED

Frontend API Path Alignment

Problem: Frontend must always call the canonical /api/v1/billing/... endpoints (no /v2 alias).

Files Fixed:

• frontend/src/services/billing.api.ts – ensured all billing calls use /v1/billing/...

Changes:

// Before:
fetchAPI('/billing/invoices/')

// After:
fetchAPI('/v1/billing/invoices/')

Component Export Issues

Problem: PricingPlan type export conflict

File Fixed:

• frontend/src/components/ui/pricing-table/index.tsx

Change:

// Before:
export { PricingPlan };

// After:
export type { PricingPlan };

Missing Function Issues

Problem: submitManualPayment doesn't exist, should be createManualPayment

File Fixed:

• frontend/src/pages/account/PurchaseCreditsPage.tsx

Change:

// Import changed:
import { submitManualPayment } from '...'  // ❌
import { createManualPayment } from '...'  // ✅

// Usage changed:
await submitManualPayment({...})  // ❌
await createManualPayment({...})  // ✅

📝 PAGES STATUS

Account Pages

Page	Route	Status	Backend API
Account Settings	/account/settings	✅ Ready	/v1/account/settings/
Team Management	/account/team	✅ Ready	/v1/account/team/
Usage Analytics	/account/usage	✅ Ready	/v1/account/usage/analytics/
Purchase Credits	/account/purchase-credits	✅ Ready	/v1/billing/credit-packages/

Billing Pages

Page	Route	Status	Backend API
Credits Overview	/billing/credits	✅ Ready	/v1/billing/transactions/balance/
Transactions	/billing/transactions	✅ Ready	/v1/billing/transactions/
Usage	/billing/usage	✅ Ready	/v1/billing/transactions/
Plans	/settings/plans	✅ Ready	/v1/auth/plans/

Admin Pages

Page	Route	Status	Backend API
Admin Dashboard	/admin/billing	⏳ Partial	/v1/billing/admin/stats/
Billing Management	/admin/billing	⏳ Partial	Multiple endpoints

🔧 URL STRUCTURE

Correct URL Pattern

Frontend calls: /v1/billing/invoices/
                ↓
API Base URL:   https://api.igny8.com/api
                ↓
Full URL:       https://api.igny8.com/api/v1/billing/invoices/
                ↓
Backend route:  /api/v1/billing/ → igny8_core.business.billing.urls

API Base URL Detection

// frontend/src/services/api.ts
const API_BASE_URL = getApiBaseUrl();

// Returns:
// - localhost:3000 → http://localhost:8011/api
// - Production → https://api.igny8.com/api

✅ BUILD STATUS

cd /data/app/igny8/frontend
npm run build
# ✅ built in 10.87s

🧪 TESTING CHECKLIST

Backend Tests

• Invoices endpoint exists (401 auth required)
• Payments endpoint exists (401 auth required)
• Credit packages endpoint exists (401 auth required)
• Transactions endpoint exists (401 auth required)
• Balance endpoint exists (401 auth required)
• Account settings endpoint exists (401 auth required)
• Team management endpoint exists (401 auth required)
• Usage analytics endpoint exists (401 auth required)

Frontend Tests

• Build completes without errors
• All API imports resolve correctly
• Component exports work correctly
• Pages load in browser (requires authentication)
• API calls work with auth token
• Data displays correctly

🚀 NEXT STEPS

1. Test with Authentication

   • Login to app
   • Navigate to each page
   • Verify data loads correctly

2. Test User Flows

   • Purchase credits flow
   • View transactions
   • Manage team members
   • Update account settings

3. Test Admin Features

   • View billing stats
   • Approve/reject payments
   • Configure credit costs

4. Missing Features

   • Stripe payment integration (webhook handlers exist, UI integration pending)
   • PDF invoice generation
   • Email notifications
   • Subscription management UI

📚 DOCUMENTATION

For Users

• All account and billing pages accessible from sidebar
• Credit balance visible on Credits page
• Purchase credits via credit packages
• View transaction history
• Manage team members

For Developers

• Backend: Django REST Framework ViewSets
• Frontend: React + TypeScript + Vite
• API calls: Centralized in services/billing.api.ts
• Auth: JWT tokens in localStorage
• Multi-tenancy: Account-based access control