How asantemaicenne/fake-job-detection-system works
This is an AI platform for detecting fraudulent job advertisements. Its principal workflow accepts and validates a posting, persists it, engineers NLP and heuristic features, produces a fraud prediction with explanations, and stores results for review and querying. Separate branches cover model training, human feedback, authentication, and Prometheus observability. The graph uses README-documented capabilities where implementation excerpts are incomplete; those links are cited to the README rather than implying unsampled code was inspected.
Main entry points: analysis.py Analysis API · main.py FastAPI Gateway · trainer.py Model Trainer · extractors.py Feature Engineering
Components 21
API and Security
- FastAPI Gateway
src/api/main.py - Analysis API
src/api/endpoints/analysis.py - JWT and RBAC
src/api/middleware/auth.py
Detection Pipeline
- Job Validation
src/data/schemas/models.py - Feature Engineering
src/features/extractors.py - XAI and HITL
src/models/ethics/safeguards.py
Model Lifecycle
- Fraud Inference
src/models/inference - Model Trainer
src/models/training/trainer.py - Training Preprocessing
src/models/training/preprocessing.py - Training Workflow
scripts/train_model.py - Model Metrics
src/models/evaluation/metrics.py - Model Artifacts
src/models/artifacts
Data Management
- Database Repository
src/data/repositories/database.py - MongoDB
- Raw Postings
src/data/repositories/database.py - Feature Records
src/data/repositories/database.py - Prediction Records
src/data/repositories/database.py - Review Feedback
src/data/repositories/database.py
Operations
- Metrics Middleware
src/api/middleware/metrics.py - Prometheus
configs/prometheus.yml
Other components
- API Client
Connections 23
- API Client → FastAPI Gateway: submits requests
README.md - FastAPI Gateway → Analysis API: routes analysis
README.md - FastAPI Gateway → JWT and RBAC: issues tokens
src/api/main.py - Analysis API → JWT and RBAC: checks roles
src/api/endpoints/analysis.py - Analysis API → Job Validation: validates postings
src/api/endpoints/analysis.py - Analysis API → Raw Postings: stores postings
src/api/endpoints/analysis.py - Analysis API → Feature Engineering: generates features
src/api/endpoints/analysis.py - Feature Engineering → Job Validation: builds feature records
src/features/extractors.py - Feature Engineering → Raw Postings: queries posting history
src/features/extractors.py - Analysis API → Feature Records: stores features
src/api/endpoints/analysis.py - Analysis API → Fraud Inference: scores features
README.md - Analysis API → XAI and HITL: routes uncertain cases
src/api/endpoints/analysis.py - Analysis API → Prediction Records: stores predictions
src/api/endpoints/analysis.py - Analysis API → Review Feedback: stores review labels
README.md - Analysis API → Prediction Records: queries results
README.md - Training Workflow → Model Trainer: runs tuning
scripts/train_model.py - Training Workflow → Feature Engineering: uses feature extraction
scripts/train_model.py - Model Trainer → Training Preprocessing: builds pipeline
src/models/training/trainer.py - Model Trainer → Model Artifacts: persists model
src/models/training/trainer.py - Model Trainer → Model Metrics: evaluates model
- Database Repository → MongoDB: connects and indexes
src/data/repositories/database.py - Metrics Middleware → Prometheus: exports metrics
README.md - FastAPI Gateway → Metrics Middleware: instruments requests
README.md