How siddharth2024-bot/shield works
SHIELD (CrimeSentinel) accepts transaction details and produces a district prediction and ranked ATM watchlist. The API’s /predict and /demo routes invoke the prediction pipeline; the pipeline predicts districts, scores ATMs in each, and returns an alert report. Separate modules generate synthetic case and ATM data and train the district model. The dashboard and rule-based explainer are present, but the excerpts do not establish how either connects to the API or prediction flow; the README is empty.
Main entry points: predicttrace.py Prediction Pipeline · atm_scorer.py ATM Risk Scoring · main.py SHIELD API · generate_atm_database.py ATM Data Generator
Components 14
User Interface
- Dashboard
Frontend/shield_dashboard.html - SHIELD API
API/main.py
Prediction and Risk
- Prediction Pipeline
Pipeline/predicttrace.py - District Prediction
Pipeline/predicttrace.py - ATM Risk Scoring
Pipeline/atm_scorer.py - Rule-Based Explainer
Pipeline/explainer.py
Data and Model
- Case Data Generator
Data/generate_fraud_cases.py - ATM Data Generator
Data/generate_atm_database.py - Fraud Cases
Data/fraud_cases.csv - ATM Master Data
Data/atm_master.csv - ATM Activity
Data/atm_activity.csv - Model Training
Model/train_model.py - Model and Encoders
Model
Other components
- Analyst
Connections 14
- Analyst → Dashboard: uses
- Dashboard → SHIELD API: calls API
- Analyst → SHIELD API: submits transaction
API/main.py - SHIELD API → Prediction Pipeline: runs prediction
API/main.py - Prediction Pipeline → District Prediction: predicts districts
Pipeline/predicttrace.py - Prediction Pipeline → ATM Risk Scoring: ranks ATMs
Pipeline/predicttrace.py - Case Data Generator → Fraud Cases: writes cases
Data/generate_fraud_cases.py - ATM Data Generator → ATM Master Data: writes master
Data/generate_atm_database.py - ATM Data Generator → ATM Activity: writes activity
Data/generate_atm_database.py - Model Training → Fraud Cases: reads cases
Model/train_model.py - Model Training → Model and Encoders: saves model
Model/train_model.py - District Prediction → Model and Encoders: loads model
Pipeline/predicttrace.py - ATM Risk Scoring → ATM Master Data: reads ATM data
Pipeline/atm_scorer.py - ATM Risk Scoring → ATM Activity: reads history
Pipeline/atm_scorer.py