# shruthiii5666/modelsml architecture

> Architecture diagram of the GitHub repository shruthiii5666/modelsml, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shruthiii5666/modelsml
- Repository: https://github.com/shruthiii5666/modelsml

## Overview

ApexMart combines an electronics storefront and session-aware recommendations with an admin monitoring view. The user path runs from browsing and cart events through the backend to recommendations ranked with purchase intent and brand trust; a separate behavioral-analysis pipeline produces trust scores. The graph also preserves the purchase-intent model and behavioral feature/scoring stages. Several backend and model connections are inferred only from imports or documented API behavior; those edges are dashed where the excerpts do not show the runtime call.

Main entry points: [`behavioral-analysis/src/pipeline.py`](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/pipeline.py) (Analysis Pipeline), [`behavioral-analysis/src/config.py`](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/config.py) (Analysis Settings), [`frontend/src/services/api.js`](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/services/api.js) (Frontend API Client), [`frontend/src/pages/StorePage.jsx`](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/pages/StorePage.jsx) (Store Browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Storefront"]
  node_app["App Router<br/>[App.jsx]"]
  node_store["Store Browser<br/>[StorePage.jsx]"]
  node_product["Product Cards<br/>[ProductCard.jsx]"]
  node_shelf["Recommendation Shelf"]
  node_context["Session and Cart<br/>[AppContext.jsx]"]
  node_dashboard["Admin Dashboard<br/>[DashboardPage.jsx]"]
  node_api["Frontend API Client<br/>[api.js]"]
end

subgraph group_backend["Application Backend"]
  node_backend_api["HTTP API<br/>[main.py]"]
  node_service["Catalog and Sessions<br/>[service.py]"]
end

subgraph group_recs["Recommendation Engine"]
  node_intent["Purchase Intent Model"]
  node_candidate["Candidate Generation"]
  node_integrator["Intent-Trust Integration"]
  node_ranking["Recommendation Ranking<br/>[ranking.py]"]
  node_rec_config["Recommendation Settings<br/>[config.py]"]
end

subgraph group_analysis["Behavioral Trust Analysis"]
  node_analysis_entry["Analysis Entry Point<br/>[main.py]"]
  node_pipeline["Analysis Pipeline<br/>[pipeline.py]"]
  node_loader["Clickstream Loader<br/>[data_loader.py]"]
  node_features["Behavioral Features"]
  node_preparation["Model Preparation"]
  node_anomaly["Anomaly Detection<br/>[anomaly_model.py]"]
  node_scoring["Brand Risk Scoring<br/>[scoring.py]"]
  node_trust["Brand Trust Scores<br/>[trust_score.py]"]
  node_analysis_config["Analysis Settings<br/>[config.py]"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_store
node_app -->|"routes to"| node_dashboard
node_store -->|"loads catalog"| node_api
node_store -->|"renders"| node_product
node_store -->|"renders"| node_shelf
node_shelf -->|"loads recommendations"| node_api
node_context -->|"logs events"| node_api
node_dashboard -->|"loads telemetry"| node_api
node_api -->|"requests endpoints"| node_backend_api
node_backend_api -.->|"delegates"| node_service
node_service -.->|"generates candidates"| node_candidate
node_service -.->|"integrates trust"| node_integrator
node_service -.->|"ranks results"| node_ranking
node_integrator -.->|"loads probabilities"| node_intent
node_integrator -.->|"loads trust scores"| node_trust
node_analysis_entry -->|"runs"| node_pipeline
node_pipeline -->|"loads events"| node_loader
node_pipeline -->|"builds features"| node_features
node_pipeline -->|"prepares model data"| node_preparation
node_pipeline -->|"trains and scores"| node_anomaly
node_pipeline -->|"aggregates risk"| node_scoring
node_pipeline -->|"calculates trust"| node_trust
node_pipeline -.->|"reads settings"| node_analysis_config
node_loader -->|"reads settings"| node_analysis_config
node_features -.->|"reads settings"| node_analysis_config
node_preparation -.->|"reads settings"| node_analysis_config
node_anomaly -.->|"reads settings"| node_analysis_config
node_scoring -.->|"reads settings"| node_analysis_config
node_trust -.->|"reads settings"| node_analysis_config

click node_app "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/App.jsx"
click node_store "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/pages/StorePage.jsx"
click node_product "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/components/ProductCard.jsx"
click node_shelf "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/components/RecommendationShelf.jsx"
click node_context "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/context/AppContext.jsx"
click node_dashboard "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_api "https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/services/api.js"
click node_backend_api "https://github.com/shruthiii5666/modelsml/blob/main/backend/main.py"
click node_service "https://github.com/shruthiii5666/modelsml/blob/main/backend/service.py"
click node_intent "https://github.com/shruthiii5666/modelsml/blob/main/user-intent/train_purchase_model.py"
click node_candidate "https://github.com/shruthiii5666/modelsml/blob/main/recommendation/candidate_generator.py"
click node_integrator "https://github.com/shruthiii5666/modelsml/blob/main/recommendation/trust_integrator.py"
click node_ranking "https://github.com/shruthiii5666/modelsml/blob/main/recommendation/ranking.py"
click node_rec_config "https://github.com/shruthiii5666/modelsml/blob/main/recommendation/config.py"
click node_analysis_entry "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/main.py"
click node_pipeline "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/pipeline.py"
click node_loader "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/data_loader.py"
click node_features "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/category_relative_features.py"
click node_preparation "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/model_preparation.py"
click node_anomaly "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/anomaly_model.py"
click node_scoring "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/scoring.py"
click node_trust "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/trust_score.py"
click node_analysis_config "https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_store,node_product,node_shelf,node_context,node_dashboard,node_api toneBlue
class node_backend_api,node_service toneAmber
class node_intent,node_candidate,node_integrator,node_ranking,node_rec_config toneMint
class node_analysis_entry,node_pipeline,node_loader,node_features,node_preparation,node_anomaly,node_scoring,node_trust,node_analysis_config toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Store Browser](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/pages/StorePage.jsx): `frontend/src/pages/StorePage.jsx`
- [Product Cards](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/components/ProductCard.jsx): `frontend/src/components/ProductCard.jsx`
- [Recommendation Shelf](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/components/RecommendationShelf.jsx): `frontend/src/components/RecommendationShelf.jsx`
- [Session and Cart](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [Admin Dashboard](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Frontend API Client](https://github.com/shruthiii5666/modelsml/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Application Backend

- [HTTP API](https://github.com/shruthiii5666/modelsml/blob/main/backend/main.py): `backend/main.py`
- [Catalog and Sessions](https://github.com/shruthiii5666/modelsml/blob/main/backend/service.py): `backend/service.py`

### Recommendation Engine

- [Purchase Intent Model](https://github.com/shruthiii5666/modelsml/blob/main/user-intent/train_purchase_model.py): `user-intent/train_purchase_model.py`
- [Candidate Generation](https://github.com/shruthiii5666/modelsml/blob/main/recommendation/candidate_generator.py): `recommendation/candidate_generator.py`
- [Intent-Trust Integration](https://github.com/shruthiii5666/modelsml/blob/main/recommendation/trust_integrator.py): `recommendation/trust_integrator.py`
- [Recommendation Ranking](https://github.com/shruthiii5666/modelsml/blob/main/recommendation/ranking.py): `recommendation/ranking.py`
- [Recommendation Settings](https://github.com/shruthiii5666/modelsml/blob/main/recommendation/config.py): `recommendation/config.py`

### Behavioral Trust Analysis

- [Analysis Entry Point](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/main.py): `behavioral-analysis/main.py`
- [Analysis Pipeline](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/pipeline.py): `behavioral-analysis/src/pipeline.py`
- [Clickstream Loader](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/data_loader.py): `behavioral-analysis/src/data_loader.py`
- [Behavioral Features](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/category_relative_features.py): `behavioral-analysis/src/category_relative_features.py`
- [Model Preparation](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/model_preparation.py): `behavioral-analysis/src/model_preparation.py`
- [Anomaly Detection](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/anomaly_model.py): `behavioral-analysis/src/anomaly_model.py`
- [Brand Risk Scoring](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/scoring.py): `behavioral-analysis/src/scoring.py`
- [Brand Trust Scores](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/trust_score.py): `behavioral-analysis/src/trust_score.py`
- [Analysis Settings](https://github.com/shruthiii5666/modelsml/blob/main/behavioral-analysis/src/config.py): `behavioral-analysis/src/config.py`

### Other components

- **Shopper**

## Connections

- Shopper → App Router: uses (evidence: `frontend/src/App.jsx`)
- App Router → Store Browser: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Admin Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Store Browser → Frontend API Client: loads catalog (evidence: `frontend/src/pages/StorePage.jsx`)
- Store Browser → Product Cards: renders (evidence: `frontend/src/pages/StorePage.jsx`)
- Store Browser → Recommendation Shelf: renders (evidence: `frontend/src/pages/StorePage.jsx`)
- Recommendation Shelf → Frontend API Client: loads recommendations (evidence: `frontend/src/components/RecommendationShelf.jsx`)
- Session and Cart → Frontend API Client: logs events (evidence: `frontend/src/context/AppContext.jsx`)
- Admin Dashboard → Frontend API Client: loads telemetry (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Frontend API Client → HTTP API: requests endpoints (evidence: `frontend/src/services/api.js`)
- HTTP API → Catalog and Sessions: delegates (evidence: `backend/main.py`)
- Catalog and Sessions → Candidate Generation: generates candidates
- Catalog and Sessions → Intent-Trust Integration: integrates trust (evidence: `backend/service.py`)
- Catalog and Sessions → Recommendation Ranking: ranks results (evidence: `backend/service.py`)
- Intent-Trust Integration → Purchase Intent Model: loads probabilities
- Intent-Trust Integration → Brand Trust Scores: loads trust scores
- Analysis Entry Point → Analysis Pipeline: runs (evidence: `behavioral-analysis/main.py`)
- Analysis Pipeline → Clickstream Loader: loads events (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Behavioral Features: builds features (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Model Preparation: prepares model data (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Anomaly Detection: trains and scores (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Brand Risk Scoring: aggregates risk (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Brand Trust Scores: calculates trust (evidence: `behavioral-analysis/src/pipeline.py`)
- Analysis Pipeline → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/pipeline.py`)
- Clickstream Loader → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/data_loader.py`)
- Behavioral Features → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/category_relative_features.py`)
- Model Preparation → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/model_preparation.py`)
- Anomaly Detection → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/anomaly_model.py`)
- Brand Risk Scoring → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/scoring.py`)
- Brand Trust Scores → Analysis Settings: reads settings (evidence: `behavioral-analysis/src/trust_score.py`)
