README.txt

Fraud Banking System v4 (Regenerated)
=====================================

This zip contains a ready-to-run **FastAPI backend** and **Angular 17 frontend**
for a fraud detection banking demo:

- JWT auth (register/login)
- Customer dashboard
- New transaction with fraud score + OTP (Twilio WhatsApp optional)
- KYC document upload + status
- Video KYC mock upload
- Corporate dashboard with risk distribution + fraud trend charts
- LLM-based fraud explanation endpoint (gpt-4.1 by default, via OPENAI_API_KEY)

Backend Quickstart
------------------
cd backend
python -m venv venv
venv\\Scripts\\activate   # or source venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
# edit DATABASE_URL, OPENAI_API_KEY, TWILIO_* as needed

# ensure your Postgres database exists and DATABASE_URL is correct

uvicorn app.main:app --reload --port 8000

Open http://localhost:8000/docs to see API.

Frontend Quickstart
-------------------
cd frontend
npm install
npm start

Open http://localhost:4200

Notes
-----
- LLM endpoint: POST /api/ml/explain-fraud
- Customer APIs under /api/customer
- Corporate dashboard under /api/corporate/dashboard