Dealer_Onboarding_Backend/docs/sla/README.md

1.6 KiB

SLA implementation tracking

This folder tracks SRS §9.4 SLA Configuration & Escalation Management against the codebase.

Document Purpose
IMPLEMENTATION_STATUS.md What is built vs SRS (by capability)
ONBOARDING_SLA_RULES.md Applicant steps vs internal SLA (Submitted, Questionnaire, etc.)
STAGE_CONFIGURATION_MATRIX.md Every approval stage vs SLA config row
PENDING_WORK.md Ordered backlog to reach full compliance

Source of truth (code)

Area Location
Activity catalog (all modules) backend/src/common/config/slaStageCatalog.ts
Seed script backend/scripts/seed-sla-configs.ts
Admin “Initialize defaults” API POST /api/master/sla-configs/initialize
Runtime engine backend/src/services/SLAService.ts
BullMQ worker backend/src/common/queues/sla.worker.ts (ENABLE_REDIS=true)
Stage sync on transition backend/src/common/utils/slaWorkflowSync.ts

Apply / refresh configuration

cd backend
npx tsx scripts/seed-sla-configs.ts

Or use Master → SLA Configuration → Initialize defaults in the UI.

Environment

Variable Effect
ENABLE_REDIS=true Runs SLA breach checker on schedule
DEBUG_SLA_FAST_MODE=true 1 hour TAT ≈ 1 minute (dev only)

DB note

If sla_tracking.metadata (or entityType / entityId) is missing on an older database, run:

npx tsx scripts/migrate-sla-tracking-schema.ts