- 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
153 lines
5.6 KiB
Python
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
|
|
}
|