# shreyashmane-dev/xai-governance-platform_m architecture

> Architecture diagram of the GitHub repository shreyashmane-dev/xai-governance-platform_m, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shreyashmane-dev/xai-governance-platform_m
- Repository: https://github.com/shreyashmane-dev/xai-governance-platform_m

## Overview

This is an AI model trust and explainability platform: users upload models and datasets, evaluate predictive performance, inspect explanations and fairness, monitor drift, and manage governance, reports, and assistant workflows. The React application routes authenticated users into feature pages and calls a FastAPI API; backend route modules implement the domain endpoints, with artifact analysis, persistence, and authentication beneath them. The README also documents an in-memory evaluation microservice. Some subsystem links are omitted where sampled source does not establish the caller or transport.

Main entry points: [`backend/app/api/router.py`](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/router.py) (API router), [`backend/app/api/routes/analytics.py`](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/analytics.py) (Metrics analytics), [`backend/app/db/mongo.py`](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/db/mongo.py) (Database adapter), [`backend/app/services/shap_service.py`](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/shap_service.py) (SHAP explainability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web application"]
  node_web["React application<br/>[main.jsx]"]
  node_routes["Page routing<br/>[AppRouter.jsx]"]
  node_evaluation_ui["Evaluation workflow<br/>[EvaluatePage.jsx]"]
  node_api_client["API client<br/>[apiClient.js]"]
  node_eval_client["Evaluation client<br/>[evaluateService.js]"]
end

subgraph group_api["API and identity"]
  node_backend["FastAPI application<br/>[main.py]"]
  node_api_routes["API router<br/>[router.py]"]
  node_auth["Token verification<br/>[security.py]"]
end

subgraph group_analysis["Model analysis"]
  node_model_routes["Model registry<br/>[models.py]"]
  node_dataset_routes["Dataset intake<br/>[datasets.py]"]
  node_evaluation_routes["Evaluation endpoints<br/>[evaluations.py]"]
  node_analytics_routes["Metrics analytics<br/>[analytics.py]"]
  node_ml_engine["Metrics engine<br/>[ml_service.py]"]
  node_shap_engine["SHAP explainability<br/>[shap_service.py]"]
  node_artifact_loader["Artifact loading"]
  node_ml_microservice["In-memory evaluator<br/>[main.py]"]
end

subgraph group_trust["Trust operations"]
  node_governance["Governance scoring<br/>[governance.py]"]
  node_drift["Drift monitoring<br/>[drift.py]"]
  node_assistant["AI assistant"]
  node_reports["Reports center<br/>[report_service.py]"]
  node_audit["Audit logging<br/>[audit.py]"]
end

subgraph group_state["Persistence"]
  node_mongo_adapter["Database adapter<br/>[mongo.py]"]
  node_local_db[("Local JSON database<br/>[local_db.py]")]
  node_artifact_storage["Artifact storage<br/>[storage.py]"]
end

node_user(("Platform user"))
node_external_ai["OpenAI service"]

node_user -->|"uses"| node_web
node_web -->|"renders"| node_routes
node_routes -->|"routes to"| node_evaluation_ui
node_api_client -->|"requests API"| node_backend
node_eval_client -->|"calls"| node_api_client
node_backend -->|"mounts"| node_api_routes
node_api_routes -->|"dispatches"| node_model_routes
node_api_routes -->|"dispatches"| node_dataset_routes
node_api_routes -->|"dispatches"| node_evaluation_routes
node_api_routes -->|"dispatches"| node_analytics_routes
node_api_routes -->|"dispatches"| node_governance
node_api_routes -->|"dispatches"| node_drift
node_api_routes -->|"dispatches"| node_assistant
node_api_routes -->|"dispatches"| node_reports
node_analytics_routes -->|"reads"| node_mongo_adapter
node_analytics_routes -->|"verifies"| node_auth
node_analytics_routes -->|"computes metrics"| node_ml_engine
node_analytics_routes -->|"requests explanations"| node_shap_engine
node_analytics_routes -->|"loads artifacts"| node_artifact_loader
node_governance -->|"reads"| node_mongo_adapter
node_governance -->|"uses analysis"| node_ml_engine
node_drift -->|"reads"| node_mongo_adapter
node_assistant -.->|"uses AI proxy"| node_external_ai
node_mongo_adapter -->|"creates"| node_local_db
node_artifact_storage -->|"uses settings"| node_backend
node_shap_engine -->|"imports"| node_artifact_loader
node_shap_engine -->|"imports"| node_artifact_storage
node_evaluation_ui -.->|"submits evaluation"| node_eval_client
node_ml_microservice -.->|"evaluates uploads"| node_user

click node_web "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/main.jsx"
click node_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/router/AppRouter.jsx"
click node_evaluation_ui "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/pages/EvaluatePage.jsx"
click node_api_client "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/services/apiClient.js"
click node_eval_client "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/services/evaluateService.js"
click node_backend "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/main.py"
click node_api_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/router.py"
click node_auth "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/core/security.py"
click node_model_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/models.py"
click node_dataset_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/datasets.py"
click node_evaluation_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/evaluations.py"
click node_analytics_routes "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/analytics.py"
click node_ml_engine "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/ml_service.py"
click node_shap_engine "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/shap_service.py"
click node_artifact_loader "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/artifact_service.py"
click node_ml_microservice "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/ml-service/main.py"
click node_governance "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/governance.py"
click node_drift "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/drift.py"
click node_assistant "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/assistant_service.py"
click node_reports "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/report_service.py"
click node_audit "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/utils/audit.py"
click node_mongo_adapter "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/db/mongo.py"
click node_local_db "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/db/local_db.py"
click node_artifact_storage "https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/utils/storage.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_web,node_routes,node_evaluation_ui,node_api_client,node_eval_client,node_user toneBlue
class node_backend,node_api_routes,node_auth toneAmber
class node_model_routes,node_dataset_routes,node_evaluation_routes,node_analytics_routes,node_ml_engine,node_shap_engine,node_artifact_loader,node_ml_microservice toneMint
class node_governance,node_drift,node_assistant,node_reports,node_audit toneRose
class node_mongo_adapter,node_local_db,node_artifact_storage,node_external_ai toneIndigo
```

## Components

### Web application

- [React application](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Page routing](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/router/AppRouter.jsx): `frontend/src/router/AppRouter.jsx`
- [Evaluation workflow](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/pages/EvaluatePage.jsx): `frontend/src/pages/EvaluatePage.jsx`
- [API client](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/services/apiClient.js): `frontend/src/services/apiClient.js`
- [Evaluation client](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/frontend/src/services/evaluateService.js): `frontend/src/services/evaluateService.js`

### API and identity

- [FastAPI application](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/main.py): `backend/app/main.py`
- [API router](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/router.py): `backend/app/api/router.py`
- [Token verification](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/core/security.py): `backend/app/core/security.py`

### Model analysis

- [Model registry](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/models.py): `backend/app/api/routes/models.py`
- [Dataset intake](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/datasets.py): `backend/app/api/routes/datasets.py`
- [Evaluation endpoints](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/evaluations.py): `backend/app/api/routes/evaluations.py`
- [Metrics analytics](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/analytics.py): `backend/app/api/routes/analytics.py`
- [Metrics engine](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/ml_service.py): `backend/app/services/ml_service.py`
- [SHAP explainability](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/shap_service.py): `backend/app/services/shap_service.py`
- [Artifact loading](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/artifact_service.py): `backend/app/services/artifact_service.py`
- [In-memory evaluator](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/ml-service/main.py): `ml-service/main.py`

### Trust operations

- [Governance scoring](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/governance.py): `backend/app/api/routes/governance.py`
- [Drift monitoring](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/api/routes/drift.py): `backend/app/api/routes/drift.py`
- [AI assistant](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/assistant_service.py): `backend/app/services/assistant_service.py`
- [Reports center](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/services/report_service.py): `backend/app/services/report_service.py`
- [Audit logging](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/utils/audit.py): `backend/app/utils/audit.py`

### Persistence

- [Database adapter](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/db/mongo.py): `backend/app/db/mongo.py`
- [Local JSON database](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/db/local_db.py): `backend/app/db/local_db.py`
- [Artifact storage](https://github.com/shreyashmane-dev/xai-governance-platform_m/blob/main/backend/app/utils/storage.py): `backend/app/utils/storage.py`

### Other components

- **Platform user**
- **OpenAI service**

## Connections

- Platform user → React application: uses (evidence: `README.md`)
- React application → Page routing: renders (evidence: `frontend/src/main.jsx`)
- Page routing → Evaluation workflow: routes to (evidence: `frontend/src/router/AppRouter.jsx`)
- API client → FastAPI application: requests API (evidence: `frontend/src/services/apiClient.js`)
- Evaluation client → API client: calls (evidence: `frontend/src/services/evaluateService.js`)
- FastAPI application → API router: mounts (evidence: `backend/app/main.py`)
- API router → Model registry: dispatches (evidence: `backend/app/api/router.py`)
- API router → Dataset intake: dispatches (evidence: `backend/app/api/router.py`)
- API router → Evaluation endpoints: dispatches (evidence: `backend/app/api/router.py`)
- API router → Metrics analytics: dispatches (evidence: `backend/app/api/router.py`)
- API router → Governance scoring: dispatches (evidence: `backend/app/api/router.py`)
- API router → Drift monitoring: dispatches (evidence: `backend/app/api/router.py`)
- API router → AI assistant: dispatches (evidence: `backend/app/api/router.py`)
- API router → Reports center: dispatches (evidence: `backend/app/api/router.py`)
- Metrics analytics → Database adapter: reads (evidence: `backend/app/api/routes/analytics.py`)
- Metrics analytics → Token verification: verifies (evidence: `backend/app/api/routes/analytics.py`)
- Metrics analytics → Metrics engine: computes metrics (evidence: `backend/app/api/routes/analytics.py`)
- Metrics analytics → SHAP explainability: requests explanations (evidence: `backend/app/api/routes/analytics.py`)
- Metrics analytics → Artifact loading: loads artifacts (evidence: `backend/app/api/routes/analytics.py`)
- Governance scoring → Database adapter: reads (evidence: `backend/app/api/routes/governance.py`)
- Governance scoring → Metrics engine: uses analysis (evidence: `backend/app/api/routes/governance.py`)
- Drift monitoring → Database adapter: reads (evidence: `backend/app/api/routes/drift.py`)
- AI assistant → OpenAI service: uses AI proxy
- Database adapter → Local JSON database: creates (evidence: `backend/app/db/mongo.py`)
- Artifact storage → FastAPI application: uses settings (evidence: `backend/app/utils/storage.py`)
- SHAP explainability → Artifact loading: imports (evidence: `backend/app/services/shap_service.py`)
- SHAP explainability → Artifact storage: imports (evidence: `backend/app/services/shap_service.py`)
- Evaluation workflow → Evaluation client: submits evaluation
- In-memory evaluator → Platform user: evaluates uploads
