How wasim-khans/msc-project-ml-webdev-phishingdetection works
Phishing URL Detection is a research project with a web prediction app and a reproducible model-comparison workflow. In the app, a user submits a URL and selects a model; the frontend calls the API, which extracts URL features, loads the selected model and returns a prediction for display and recent-session history. Separately, the ML workflow prepares main and external datasets, trains models, evaluates cross-dataset performance and produces a combined report. The graph includes documented stages whose implementation was not sampled; those links rely on the README rather than inspected script bodies.
Main entry points: HomePage.jsx Home page · prediction_controller.py Prediction routes · dependencies.py Service wiring · prediction_service.py Prediction service
Components 31
Web interface
- Home page
frontend/src/pages/HomePage.jsx - URL input
frontend/src/components/UrlAnalysisPanel.jsx - Prediction display
frontend/src/components/PredictionPanel.jsx - Recent results
frontend/src/components/ResultsHistorySection.jsx - Model insights
frontend/src/components/ModelInsightsPanel.jsx - Model state
frontend/src/hooks/useModelInfo.js - Prediction state
frontend/src/hooks/useUrlPrediction.js - History state
frontend/src/hooks/usePredictionHistory.js - Prediction API client
frontend/src/services/predictionApi.js - HTTP client
frontend/src/services/apiClient.js - Result formatters
frontend/src/lib/formatters.js - Feature metadata
frontend/src/lib/featureMetadata.js
Prediction API
- FastAPI app
backend/app/main.py - Prediction routes
backend/app/controllers/prediction_controller.py - API settings
backend/app/core/settings.py - Service wiring
backend/app/core/dependencies.py - API schemas
backend/app/schemas/prediction.py
Inference
- Prediction service
backend/app/services/prediction_service.py - Model repository
backend/app/repositories/model_repository.py - URL feature extraction
machine_learning/scripts/core/url_feature_extractor.py
ML experiments
- Main dataset preparation
machine_learning/scripts/1a_2_build_main_feature_dataset.py - External dataset preparation
machine_learning/scripts/1b_1_prepare_external_testing_datasets.py - Dataset splits
machine_learning/scripts/2_1_build_cross_dataset_splits.py - Main model training
machine_learning/scripts/1a_4_train_main_models.py - External model testing
machine_learning/scripts/1b_2_test_main_models_on_external_datasets.py - Cross-dataset config
machine_learning/scripts/helpers/cross_dataset_config.py - Cross-dataset training
machine_learning/scripts/helpers/cross_dataset_model_training.py - Cross-dataset evaluation
machine_learning/scripts/helpers/cross_dataset_evaluation.py
Research reporting
- Combined experiment report
machine_learning/scripts/build_all_experiments_combined_report.py - Project paths
machine_learning/scripts/helpers/project_paths.py
Other components
- User
Connections 36
- User → Home page: uses
README.md - Home page → URL input: renders
frontend/src/pages/HomePage.jsx - Home page → Prediction display: renders
frontend/src/pages/HomePage.jsx - Home page → Recent results: renders
frontend/src/pages/HomePage.jsx - Home page → Model state: loads model state
frontend/src/pages/HomePage.jsx - Home page → Prediction state: submits URL
frontend/src/pages/HomePage.jsx - Home page → History state: records prediction
frontend/src/pages/HomePage.jsx - Model state → Prediction API client: requests model info
frontend/src/hooks/useModelInfo.js - Prediction state → Prediction API client: requests prediction
frontend/src/hooks/useUrlPrediction.js - Home page → Model insights
- Prediction API client → HTTP client: uses HTTP client
frontend/src/services/predictionApi.js - User → FastAPI app: receives prediction
README.md - FastAPI app → Prediction routes: mounts routes
backend/app/main.py - FastAPI app → API settings: loads settings
backend/app/main.py - Prediction routes → Service wiring: resolves service
backend/app/controllers/prediction_controller.py - Prediction routes → API schemas: validates responses
backend/app/controllers/prediction_controller.py - Prediction routes → Prediction service: calls service
backend/app/controllers/prediction_controller.py - Service wiring → API settings: reads configuration
backend/app/core/dependencies.py - Service wiring → Model repository: constructs repository
backend/app/core/dependencies.py - Service wiring → Prediction service: constructs service
backend/app/core/dependencies.py - Prediction service → Model repository: loads model assets
backend/app/services/prediction_service.py - Prediction service → URL feature extraction: extracts features
backend/app/services/prediction_service.py - Home page → Result formatters
- Result formatters → Feature metadata: reads feature metadata
frontend/src/lib/formatters.js - Main dataset preparation → URL feature extraction: extracts URL features
README.md - Main dataset preparation → Dataset splits: prepares main data
README.md - External dataset preparation → Dataset splits: prepares external data
README.md - Dataset splits → Main model training: feeds training
README.md - Main model training → External model testing: tests trained models
README.md - Dataset splits → Cross-dataset training: feeds cross-dataset training
README.md - Cross-dataset config → Project paths: uses project paths
machine_learning/scripts/helpers/cross_dataset_config.py - Cross-dataset evaluation → Cross-dataset config: uses configuration
machine_learning/scripts/helpers/cross_dataset_evaluation.py - Cross-dataset evaluation → Cross-dataset training: uses training helpers
machine_learning/scripts/helpers/cross_dataset_evaluation.py - Cross-dataset training → Cross-dataset config: uses configuration
machine_learning/scripts/helpers/cross_dataset_model_training.py - Cross-dataset evaluation → Combined experiment report: produces experiment results
- Combined experiment report → Project paths: uses project paths
machine_learning/scripts/build_all_experiments_combined_report.py