How sanskarbawniya/sih2026 works
This is a border-checkpoint/eKYC identity-screening application. An operator supplies an identity document and selfie; the dashboard submits them to the scan API, whose orchestrator runs extraction, validation and tamper analysis, then optional liveness, face matching and identity-graph checks, producing a composite risk result shown with graph alerts. The graph highlights those domain stages and the API/UI boundary. Some service implementations and UI components are unsampled, so links to them are limited to relationships explicitly shown in the route/orchestrator excerpts or README.
Main entry points: orchestrator.py Scan orchestrator · scan.py Scan and graph routes · Dashboard.tsx Screening dashboard · api.ts Frontend API client
Components 19
Screening UI
- Screening dashboard
frontend/src/pages/Dashboard.tsx - Document and selfie capture
frontend/src/components/UploadPanel.tsx - Frontend API client
frontend/src/api.ts - Scan results and panels
frontend/src/components/FullScanResults.tsx - Graph fraud panel
frontend/src/components/GraphFraudPanel.tsx
API and contracts
- FastAPI application
backend/app/main.py - Scan and graph routes
backend/app/routes/scan.py - Scan result contracts
backend/app/schemas/scan_result.py
Document and biometric analysis
- Scan orchestrator
backend/app/services/orchestrator.py - Document OCR
backend/app/services/ocr.py - Identity validation
backend/app/services/validation.py - ELA forensics
backend/app/services/forensics.py - Selfie liveness
backend/app/services/liveness.py - Face verification
backend/app/services/biometrics.py
Risk and identity graph
- Composite risk scoring
backend/app/services/risk_engine.py - Identity graph analysis
backend/app/services/graph.py
Runtime state
- Scan result cache
backend/app/services/scan_cache.py - Uploaded scan files
backend/app/config.py
Other components
- Checkpoint operator
Connections 22
- Checkpoint operator → Document and selfie capture: provides files
- Document and selfie capture → Screening dashboard: supplies inputs
frontend/src/pages/Dashboard.tsx - Screening dashboard → Frontend API client: requests liveness scan
frontend/src/pages/Dashboard.tsx - Frontend API client → Scan and graph routes: posts scan request
frontend/src/api.ts - Scan and graph routes → Scan orchestrator: runs scan
backend/app/routes/scan.py - FastAPI application → Scan and graph routes: registers routes
backend/app/main.py - Scan and graph routes → Uploaded scan files: saves uploads
backend/app/routes/scan.py - Scan orchestrator → Document OCR: extracts fields
backend/app/services/orchestrator.py - Scan orchestrator → Identity validation: validates fields
backend/app/services/orchestrator.py - Scan orchestrator → ELA forensics: analyzes tampering
backend/app/services/orchestrator.py - Scan orchestrator → Selfie liveness: checks liveness
backend/app/services/orchestrator.py - Scan orchestrator → Face verification: verifies face
backend/app/services/orchestrator.py - Scan orchestrator → Identity graph analysis: evaluates identity links
backend/app/services/orchestrator.py - Scan orchestrator → Composite risk scoring: computes risk
backend/app/services/orchestrator.py - Scan orchestrator → Scan result cache: reuses scan data
backend/app/services/orchestrator.py - Scan and graph routes → Identity graph analysis: reads graph status
backend/app/routes/scan.py - Scan and graph routes → Scan result cache: clears cache
backend/app/routes/scan.py - Scan and graph routes → Scan result contracts: returns scan result
backend/app/routes/scan.py - Frontend API client → Screening dashboard: returns scan result
frontend/src/pages/Dashboard.tsx - Screening dashboard → Scan results and panels: renders result
frontend/src/pages/Dashboard.tsx - Scan results and panels → Graph fraud panel: renders graph details
frontend/src/components/FullScanResults.tsx - Screening dashboard → Frontend API client: requests graph metadata
frontend/src/pages/Dashboard.tsx