ifixkart-admin/Backend/app/api/v1/routers/CronRouter.py
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

153 lines
5.6 KiB
Python

from fastapi import APIRouter, Depends, HTTPException, status
from sqlalchemy.orm import Session
from sqlalchemy import select
from typing import Dict, Any
from datetime import datetime, timedelta, timezone
from app.core.database.db_session import get_db
from app.models.OrderModel import Order
from app.models.WarrantyModel import Warranty
from app.schemas.NotificationGateway import EntityNotificationDispatchCreate
from app.models.ServiceModel import ServiceJob
from app.core.events.notification_events import dispatch_internal_notification
router = APIRouter(prefix="/api/v1/cron", tags=["Cron Scheduled Tasks"])
@router.post("/end-of-day-report")
def trigger_end_of_day_report(db: Session = Depends(get_db)):
"""
Generate End of Day report and trigger END_OF_DAY_REPORT internal notification.
Intended to be hit by an external cron job at closing time.
"""
# Calculate simple stats for today
today = datetime.utcnow().date()
start_of_day = datetime(today.year, today.month, today.day)
# Orders today
orders = db.execute(select(Order).where(Order.created_at >= start_of_day)).scalars().all()
revenue_orders = sum(float(o.final_amount) for o in orders if o.payment_status in ["PAYMENT_CAPTURED", "PAID"])
# Service jobs completed today
services_completed = db.execute(
select(ServiceJob).where(
ServiceJob.status.in_(["COMPLETED", "READY_FOR_DELIVERY", "DELIVERED"]),
ServiceJob.updated_at >= start_of_day
)
).scalars().all()
context = {
"report_date": today.strftime("%Y-%m-%d"),
"total_orders": len(orders),
"order_revenue": f"₹{revenue_orders:.2f}",
"services_completed": len(services_completed)
}
dispatch_internal_notification(
"END_OF_DAY_REPORT",
f"End of Day Report for {context['report_date']}: {len(orders)} orders (₹{revenue_orders:.2f}), {len(services_completed)} services completed.",
context=context
)
return {"message": "End of Day Report triggered successfully", "stats": context}
@router.post("/repair-sla-breach")
def check_repair_sla_breaches(db: Session = Depends(get_db)):
"""
Check for any service jobs that are breaching SLA (e.g., > 3 days open)
Intended to be hit daily.
"""
threshold_date = datetime.utcnow() - timedelta(days=3)
breaching_jobs = db.execute(
select(ServiceJob).where(
ServiceJob.status.not_in(["COMPLETED", "DELIVERED", "CLOSED", "READY_FOR_DELIVERY", "CANCELLED"]),
ServiceJob.created_at <= threshold_date
)
).scalars().all()
notified_count = 0
for job in breaching_jobs:
days_open = (datetime.utcnow() - job.created_at).days
dispatch_internal_notification(
"REPAIR_SLA_BREACH",
f"SLA Breach! Job {job.job_no} has been open for {days_open} days. Status: {job.status}",
context={"job_no": job.job_no, "days_open": days_open, "status": job.status}
)
notified_count += 1
return {"message": "SLA checks completed", "breaches_found": notified_count}
@router.post("/warranty-expiration")
def process_warranty_expiration(db: Session = Depends(get_db)):
"""
Check for warranties expiring in 7 days and send notifications.
Also expire warranties whose end_date has passed.
"""
now = datetime.now(timezone.utc)
warning_date = now + timedelta(days=7)
# 1. Notification Sweep
expiring_soon = db.execute(
select(Warranty).where(
Warranty.status == "ACTIVE",
Warranty.end_date <= warning_date,
Warranty.end_date > now,
Warranty.expiry_notification_sent == False
)
).scalars().all()
notified_count = 0
for warranty in expiring_soon:
# We assume _dispatch_bg_notification can be used for WARRANTY_EXPIRING_SOON
from app.api.v1.routers.AdminOrderRouter import _dispatch_bg_notification
# Here we could enqueue it
# For simplicity, we just dispatch internal or entity notification
# The frontend will need a template for WARRANTY_EXPIRING_SOON
dispatch_internal_notification(
"WARRANTY_EXPIRING_SOON",
f"Warranty {warranty.warranty_id} is expiring on {warranty.end_date.strftime('%Y-%m-%d')}",
context={
"warranty_id": warranty.warranty_id,
"reference_id": warranty.reference_id,
"end_date": warranty.end_date.strftime("%Y-%m-%d")
}
)
warranty.expiry_notification_sent = True
notified_count += 1
db.commit()
# 2. Expiration Sweep
expired_warranties = db.execute(
select(Warranty).where(
Warranty.status == "ACTIVE",
Warranty.end_date <= now
)
).scalars().all()
expired_count = 0
for warranty in expired_warranties:
warranty.status = "EXPIRED"
expired_count += 1
db.commit()
return {
"message": "Warranty expiration sweep completed",
"notified": notified_count,
"expired": expired_count
}
@router.post("/process-credit-maturity")
def trigger_credit_maturity_sweep(db: Session = Depends(get_db)):
"""
Process pending store credits whose return/claim window has passed.
Transitions verified PENDING credits to MATURED active balance.
"""
from app.services.CreditService import CreditService
result = CreditService.process_maturing_credits(db)
return {
"message": "Store credit maturity sweep completed",
"result": result
}