How ayush-projects/gaidp-singularity-squad works
RuleSense is a Flask-based regulatory data profiling assistant. Users generate rulebooks from regulatory PDFs, validate transaction CSVs against those rules, and separately inspect anomaly results. The graph shows the documented rule-generation, validation, dashboard, and anomaly capabilities; implementation evidence is sampled and incomplete, so uncertain remediation and internal processing links are omitted.
Main entry points: rulebook_service.py Rulebook service · templates Flask templates · rule_generator_service.py Rule generator · anomaly_service.py Anomaly service
Components 17
Web interface
- Flask templates
code/src/backend/app/templates - Dashboard controller
code/src/backend/app/controllers/dashboard_controller.py - Rulebook controller
code/src/backend/app/controllers/rulebook_controller.py - Validation controller
code/src/backend/app/controllers/validation_controller.py - Anomaly controller
code/src/backend/app/controllers/anomaly_controller.py
Rulebook generation
- Rulebook service
code/src/backend/app/services/rulebook_service.py - PDF text extraction
code/src/backend/app/services/rulebook_service.py - Rule generator
code/src/backend/app/services/rule_generator_service.py - Gemini API
- Rulebook models
code/src/backend/app/models/rulebook.py - Rulebook files
code/src/data/rulebooks
Data validation
- CSV rule validation
code/src/backend/app/services/rulebook_service.py - Validation report
code/src/backend/app/services/rulebook_service.py
Anomaly detection
- Anomaly service
code/src/backend/app/services/anomaly_service.py - Isolation Forest model
code/src/backend/app/services/iso_model.pkl - Anomaly results
code/src/backend/app/services/anomaly_service.py
Other components
- Compliance user
Connections 20
- Compliance user → Flask templates: uses
- Flask templates → Rulebook controller: submits PDF
- Flask templates → Validation controller: submits CSV
- Flask templates → Anomaly controller: requests detection
- Flask templates → Dashboard controller: opens dashboard
- Rulebook controller → Rulebook service: creates rulebook
- Rulebook service → PDF text extraction: extracts text
- Rulebook service → Rule generator: generates rules
- Rule generator → Gemini API: requests extraction
- Rule generator → Rulebook models: builds rules
- Rulebook service → Rulebook files: writes metadata
- Rulebook service → Rulebook files: stores PDF
- Dashboard controller → Rulebook service: lists rulebooks
- Validation controller → Rulebook service: validates CSV
- Rulebook service → Rulebook files: reads rules
- Rulebook service → CSV rule validation: applies patterns
- CSV rule validation → Validation report: produces report
- Anomaly controller → Anomaly service: predicts anomalies
- Anomaly service → Isolation Forest model: loads model
- Anomaly service → Anomaly results: returns results