136 lines
4.7 KiB
Python
136 lines
4.7 KiB
Python
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
|
|
from app.core.permissions.RoleChecker import RoleChecker
|
|
from app.models.UserModel import User
|
|
|
|
router = APIRouter(
|
|
prefix="/api/v1/payments/dashboard",
|
|
tags=["Razorpay & Financial Dashboard"],
|
|
dependencies=[Depends(RoleChecker(["Super Admin", "Admin", "Manager", "Accountant"]))]
|
|
)
|
|
|
|
@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
|
|
}
|