from fastapi import APIRouter, Depends, Query, HTTPException from sqlalchemy.orm import Session from sqlalchemy import func, desc from typing import Dict, Any, List, Optional from datetime import datetime, timezone from app.core.database.db_session import get_db from app.core.config.Config import settings import app.models.db_base from app.models.PaymentLedgerModel import PaymentLedger from app.models.OrderModel import Order router = APIRouter( prefix="/api/v1/payments/dashboard", tags=["Razorpay & Financial Dashboard"] ) @router.get("/metrics") def get_payment_metrics( days: int = Query(30, ge=1, le=365), db: Session = Depends(get_db) ): """Aggregate financial KPIs, payment statuses, and revenue ingestion.""" # 1. Total Net Ingested from Captured Payments total_ingested = db.query(func.coalesce(func.sum(PaymentLedger.amount), 0)).filter( PaymentLedger.status.in_(["CAPTURED", "PAID", "COMPLETED"]) ).scalar() # 2. Status counts status_counts = db.query( PaymentLedger.status, func.count(PaymentLedger.payment_id).label("count"), func.coalesce(func.sum(PaymentLedger.amount), 0).label("total_amount") ).group_by(PaymentLedger.status).all() summary_by_status = { "CAPTURED": {"count": 0, "amount": 0.0}, "PENDING": {"count": 0, "amount": 0.0}, "FAILED": {"count": 0, "amount": 0.0}, "REFUNDED": {"count": 0, "amount": 0.0}, } for row in status_counts: st = row.status.upper() if row.status else "PENDING" if st in summary_by_status: summary_by_status[st] = { "count": int(row.count), "amount": float(row.total_amount) } # 3. Provider breakdown (Razorpay vs Cash vs POS) provider_counts = db.query( PaymentLedger.provider, func.count(PaymentLedger.payment_id).label("count"), func.coalesce(func.sum(PaymentLedger.amount), 0).label("total_amount") ).group_by(PaymentLedger.provider).all() provider_breakdown = [ { "provider": row.provider or "RAZORPAY", "count": int(row.count), "amount": float(row.total_amount) } for row in provider_counts ] return { "status": "success", "gateway": "Razorpay", "key_id": settings.RAZORPAY_KEY_ID, "environment": "Test" if "test" in settings.RAZORPAY_KEY_ID.lower() else "Live", "total_net_ingested": float(total_ingested), "status_summary": summary_by_status, "provider_breakdown": provider_breakdown, "is_enabled": settings.RAZORPAY_ENABLED } @router.get("/transactions") def get_transactions_ledger( page: int = Query(1, ge=1), limit: int = Query(25, ge=1, le=100), status: Optional[str] = None, provider: Optional[str] = None, search: Optional[str] = None, db: Session = Depends(get_db) ): """Paginated payment transaction ledger with order correlation.""" query = db.query(PaymentLedger) if status: query = query.filter(PaymentLedger.status == status.upper()) if provider: query = query.filter(PaymentLedger.provider == provider.upper()) if search: query = query.filter( (PaymentLedger.transaction_ref.ilike(f"%{search}%")) | (PaymentLedger.razorpay_order_id.ilike(f"%{search}%")) ) total_count = query.count() offset = (page - 1) * limit payments = query.order_by(desc(PaymentLedger.created_at)).offset(offset).limit(limit).all() # Pre-fetch correlated orders order_ids = [p.order_id for p in payments if p.order_id] orders_map = {} if order_ids: orders = db.query(Order).filter(Order.order_id.in_(order_ids)).all() orders_map = {o.order_id: o for o in orders} items = [] for p in payments: order = orders_map.get(p.order_id) items.append({ "payment_id": p.payment_id, "order_id": p.order_id, "order_no": order.order_no if order else "N/A", "amount": float(p.amount), "currency": p.currency or "INR", "provider": p.provider, "status": p.status, "transaction_ref": p.transaction_ref or "N/A", "razorpay_order_id": p.razorpay_order_id or "N/A", "created_at": p.created_at.isoformat() if p.created_at else None }) return { "status": "success", "page": page, "limit": limit, "total": total_count, "data": items, "transactions": items }