How ammufeezzz/securelink works
SecureLink’s user workflow is authenticate, submit a URL for phishing analysis, then either receive an explanation for a blocked link or a short code for a safe link. Redirects use a cache-first lookup and record click analytics asynchronously. Separately, a training pipeline ingests and validates data, transforms features, and trains the model used by inference. The README documents frontend capabilities and integrations not fully shown in the sampled source; those links are cited to the README rather than treated as inspected implementation details.
Main entry points: main.py FastAPI endpoints · model_trainer.py Model trainer · training_pipeline.py Training orchestrator · App.jsx React app
Components 22
Web client
- React app
frontend/src/App.jsx - Login page
frontend/src/pages/LoginPage.jsx - Link dashboard
frontend/src/pages/Dashboard.jsx - API client
frontend/src/api.js
API serving
- FastAPI endpoints
app/main.py - JWT auth
app/main.py - Link and user storage
app/db.py - Redis cache and limits
app/cache.py - Encoding and security helpers
app/utils.py
Phishing detection
- URL feature extractor
networksecurity/utils/ml_utils/model/feature_extractor.py - Model loading utilities
networksecurity/utils/main_utils/utils.py
Model training
- Training entry point
main.py - Training orchestrator
networksecurity/pipeline/training_pipeline.py - Data ingestion
networksecurity/components/data_ingestion.py - Data validation
networksecurity/components/data_validation.py - Data transformation
networksecurity/components/data_transformation.py - Model trainer
networksecurity/components/model_trainer.py - Classification metrics
networksecurity/utils/ml_utils/metric/classification_metric.py - Model bundle
networksecurity/utils/ml_utils/model/estimator.py
Other components
- User / browser
- Training MongoDB
- MLflow / DagsHub
Connections 29
- User / browser → React app: uses
- React app → Login page: routes to
frontend/src/App.jsx - React app → Link dashboard: routes to
frontend/src/App.jsx - Login page → API client: requests auth
frontend/src/pages/LoginPage.jsx - Link dashboard → API client: requests links
frontend/src/pages/Dashboard.jsx - API client → FastAPI endpoints: calls API
- User / browser → FastAPI endpoints: follows short link
- FastAPI endpoints → JWT auth: checks identity
app/main.py - JWT auth → Link and user storage: reads users
app/main.py - JWT auth → Redis cache and limits: checks limits
app/main.py - FastAPI endpoints → URL feature extractor: extracts features
app/main.py - FastAPI endpoints → Model loading utilities: loads model
app/main.py - FastAPI endpoints → Encoding and security helpers: encodes and explains
app/main.py - FastAPI endpoints → Link and user storage: reads and writes links
app/main.py - FastAPI endpoints → Redis cache and limits: reads and fills cache
app/main.py - FastAPI endpoints → Link and user storage: records click counts
app/main.py - Training entry point → Training orchestrator: runs pipeline
main.py - Training orchestrator → Data ingestion: starts ingestion
networksecurity/pipeline/training_pipeline.py - Training orchestrator → Data validation: starts validation
networksecurity/pipeline/training_pipeline.py - Training orchestrator → Data transformation: starts transformation
networksecurity/pipeline/training_pipeline.py - Training orchestrator → Model trainer: starts training
networksecurity/pipeline/training_pipeline.py - Data ingestion → Training MongoDB: reads dataset
networksecurity/components/data_ingestion.py - Data validation → Data ingestion: validates artifacts
- Data transformation → Data validation: transforms artifacts
- Model trainer → Data transformation: trains from artifacts
- Model trainer → Classification metrics: scores classifier
networksecurity/components/model_trainer.py - Model trainer → Model bundle: packages model
networksecurity/components/model_trainer.py - Model trainer → MLflow / DagsHub: logs experiments
networksecurity/components/model_trainer.py - Model trainer → Model loading utilities: saves model
networksecurity/components/model_trainer.py