How pritam-x11/forensai works
ForensAI is a forensic face-matching product with a React investigator interface, a Spring backend for authentication and evidence/results handling, and a FastAPI service for photo, sketch, and video analysis. The user workflow is to sign in, submit evidence, and review ranked, explainable candidate matches; investigator and facial-record capabilities are also represented. The AI routes and selected backend services are excerpted or indexed; relationships involving unsampled modules are omitted or marked unverified rather than inferred.
Main entry points: photo.py Photo analysis · sketch.py Sketch analysis · video.py Video analysis · main.py AI API router
Components 34
Investigator UI
- Forensic workspace
forensai-frontend/src/App.jsx
Backend services
- Spring application
forensaibackend/src/main/java/com/forensai/forensaibackend/ForensaibackendApplication.java - Authentication
forensaibackend/src/main/java/com/forensai/forensaibackend/controller/AuthController.java - JWT service
forensaibackend/src/main/java/com/forensai/forensaibackend/config/JwtService.java - Evidence handling
forensaibackend/src/main/java/com/forensai/forensaibackend/controller/EvidenceController.java - AI service client
forensaibackend/src/main/java/com/forensai/forensaibackend/service/AiServiceClient.java - Match result service
forensaibackend/src/main/java/com/forensai/forensaibackend/service/MatchingResultService.java - Match result repository
forensaibackend/src/main/java/com/forensai/forensaibackend/repository/MatchingResultRepository.java - Match result model
forensaibackend/src/main/java/com/forensai/forensaibackend/entity/MatchingResult.java - Investigator operations
forensaibackend/src/main/java/com/forensai/forensaibackend/controller/InvestigatorController.java - Facial records
forensaibackend/src/main/java/com/forensai/forensaibackend/controller/FacialRecordController.java
AI workflows
- AI API router
ai-service/main.py - Photo analysis
ai-service/routers/photo.py - Sketch analysis
ai-service/routers/sketch.py - Video analysis
ai-service/routers/video.py - Investigator route
ai-service/routers/investigator.py
Analysis and retrieval
- Face detection
ai-service/services/scrfd_service.py - Image preprocessing
ai-service/services/preprocessing_service.py - Face alignment
ai-service/services/face_alignment_service.py - Face quality
ai-service/services/face_quality_service.py - Identity features
ai-service/services/arcface_service.py - Visual features
ai-service/services/dinov3_service.py - Feature representation
ai-service/services/feature_layer_service.py - Evidence cues
ai-service/services/multi_cue_evidence_service.py - Quality weighting
ai-service/services/quality_weight_service.py - Uncertainty
ai-service/services/uncertainty_service.py - Identity retrieval
ai-service/services/identity_retrieval_service.py - FAISS index
ai-service/services/faiss_service.py - Visual retrieval
ai-service/services/visual_retrieval_service.py - Candidate gallery
ai-service/services/candidate_gallery_service.py - Candidate selection
ai-service/services/top_candidates_service.py - Evidence reranking
ai-service/services/evidence_reranking_service.py - Explainable results
ai-service/services/explainable_results_service.py
Other components
- Investigator
Connections 48
- Investigator → Forensic workspace: uses
- Forensic workspace → Spring application: calls API
- Spring application → AI API router: forwards analysis
- AI API router → Photo analysis: registers route
ai-service/main.py - AI API router → Investigator route: registers route
ai-service/main.py - AI API router → Video analysis: registers route
ai-service/main.py - AI API router → Sketch analysis: registers route
ai-service/main.py - Photo analysis → Image preprocessing: preprocesses
ai-service/routers/photo.py - Photo analysis → Face detection: detects faces
ai-service/routers/photo.py - Photo analysis → Face alignment: aligns faces
ai-service/routers/photo.py - Photo analysis → Face quality: scores quality
ai-service/routers/photo.py - Photo analysis → Identity features: extracts identity
ai-service/routers/photo.py - Photo analysis → Visual features: extracts visuals
ai-service/routers/photo.py - Photo analysis → Feature representation: builds features
ai-service/routers/photo.py - Photo analysis → Evidence cues: builds evidence
ai-service/routers/photo.py - Photo analysis → Quality weighting: weights quality
ai-service/routers/photo.py - Photo analysis → Uncertainty: calculates uncertainty
ai-service/routers/photo.py - Photo analysis → Identity retrieval: searches identities
ai-service/routers/photo.py - Photo analysis → Candidate selection: selects candidates
ai-service/routers/photo.py - Photo analysis → Evidence reranking: reranks matches
ai-service/routers/photo.py - Photo analysis → Explainable results: explains results
ai-service/routers/photo.py - Sketch analysis → Face detection: detects faces
ai-service/routers/sketch.py - Sketch analysis → Identity features: uses identity features
ai-service/routers/sketch.py - Sketch analysis → Face alignment: aligns faces
ai-service/routers/sketch.py - Sketch analysis → Visual features: uses visual features
ai-service/routers/sketch.py - Sketch analysis → Evidence cues: builds evidence
ai-service/routers/sketch.py - Sketch analysis → Quality weighting: weights quality
ai-service/routers/sketch.py - Sketch analysis → Uncertainty: calculates uncertainty
ai-service/routers/sketch.py - Sketch analysis → Identity retrieval: retrieves identities
ai-service/routers/sketch.py - Sketch analysis → Visual retrieval: retrieves visuals
ai-service/routers/sketch.py - Sketch analysis → Candidate selection: selects candidates
ai-service/routers/sketch.py - Sketch analysis → Evidence reranking: reranks matches
ai-service/routers/sketch.py - Video analysis → Face detection: detects faces
ai-service/routers/video.py - Video analysis → Identity features: extracts identity
ai-service/routers/video.py - Video analysis → Face alignment: aligns faces
ai-service/routers/video.py - Video analysis → Face quality: scores quality
ai-service/routers/video.py - Video analysis → Evidence cues: builds evidence
ai-service/routers/video.py - Video analysis → Quality weighting: weights quality
ai-service/routers/video.py - Video analysis → Uncertainty: calculates uncertainty
ai-service/routers/video.py - Video analysis → Identity retrieval: retrieves identities
ai-service/routers/video.py - Video analysis → Candidate selection: selects candidates
ai-service/routers/video.py - Video analysis → Evidence reranking: reranks matches
ai-service/routers/video.py - Video analysis → Explainable results: explains results
ai-service/routers/video.py - Identity retrieval → FAISS index: indexes vectors
ai-service/services/identity_retrieval_service.py - Visual retrieval → FAISS index: indexes vectors
ai-service/services/visual_retrieval_service.py - Photo analysis → Candidate gallery: loads candidates
ai-service/routers/photo.py - Sketch analysis → Candidate gallery: loads candidates
ai-service/routers/sketch.py - Video analysis → Candidate gallery: loads candidates
ai-service/routers/video.py