# mehboob14/ai-governance-liz architecture

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

- Interactive diagram: https://gitdiagram.com/mehboob14/ai-governance-liz
- Repository: https://github.com/mehboob14/ai-governance-liz

## Overview

VerifyWise is an AI governance platform for managing compliance, assessments, risks, evidence, models, vendors, and AI use cases. Users work through the web client and server APIs; the server persists domain data and exposes product capabilities, while evaluation and AI services provide specialized assessment workflows. The README also documents an AI Advisor, AI detection, Shadow AI, and public trust-center capabilities. Several subsystem links are documented only at product level; unsampled internals and their wiring are not inferred here.

Main entry points: [`Servers/app.ts`](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/app.ts) (API server), [`Clients/src/App.tsx`](https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/App.tsx) (Web client), [`EvaluationModule/main.py`](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/main.py) (LLM evaluations), [`EvaluationModule/src/deepeval_engine/deepeval_evaluator.py`](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/deepeval_evaluator.py) (Evaluation engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Product experience"]
  node_client["Web client<br/>[App.tsx]"]
  node_tips["Entity guidance<br/>[useTipManager.ts]"]
  node_browser_storage[("Browser storage<br/>[storageService.ts]")]
end

subgraph group_governance["Governance operations"]
  node_file_controller["Evidence file API"]
  node_workflow_engine["Workflow engine<br/>[engine.ts]"]
  node_governance_features["Governance capabilities"]
  node_trust_center["AI Trust Center"]
end

subgraph group_platform["Server platform"]
  node_server["API server<br/>[app.ts]"]
end

subgraph group_intelligence["AI and evaluation"]
  node_advisor_rules["Advisor approvals<br/>[ruleEngine.ts]"]
  node_eval_module["LLM evaluations<br/>[main.py]"]
  node_eval_engine["Evaluation engine"]
  node_model_runner["Model runner<br/>[model_runner.py]"]
  node_gateway_client["Gateway client"]
  node_bias_audit["Bias audit<br/>[engine.py]"]
  node_additional_ai["AI detection, Shadow AI, Advisor"]
end

subgraph group_data["Persistence and evidence"]
  node_file_repository["File repository<br/>[file.repository.ts]"]
  node_file_model["File model<br/>[file.model.ts]"]
  node_database[("Application database<br/>[db.ts]")]
end

node_user(("Governance user"))

node_user -.->|"uses"| node_client
node_client -.->|"requests APIs"| node_server
node_client -.->|"shows guidance"| node_tips
node_tips -->|"reads and writes"| node_browser_storage
node_server -->|"routes file APIs"| node_file_controller
node_file_controller -->|"calls"| node_file_repository
node_file_repository -->|"queries"| node_database
node_file_repository -->|"uses model"| node_file_model
node_server -->|"checks health"| node_database
node_server -.->|"exposes workflows"| node_workflow_engine
node_server -.->|"exposes advisor"| node_advisor_rules
node_user -.->|"manages governance"| node_governance_features
node_user -.->|"views trust center"| node_trust_center
node_user -.->|"runs evaluations"| node_eval_module
node_eval_module -->|"invokes"| node_eval_engine
node_eval_module -->|"invokes"| node_model_runner
node_eval_engine -->|"uses"| node_model_runner
node_eval_engine -->|"calls"| node_gateway_client
node_user -.->|"audits bias"| node_bias_audit
node_user -.->|"uses AI features"| node_additional_ai

click node_client "https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/App.tsx"
click node_tips "https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/application/hooks/useTipManager.ts"
click node_browser_storage "https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/infrastructure/storage/storageService.ts"
click node_server "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/app.ts"
click node_file_controller "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/controllers/fileManager.ctrl.ts"
click node_workflow_engine "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/services/workflows/engine.ts"
click node_advisor_rules "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/advisor/approval/ruleEngine.ts"
click node_governance_features "https://github.com/mehboob14/ai-governance-liz/tree/develop/Clients/src/application/repository"
click node_trust_center "https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/application/repository/aiTrustCentre.repository.ts"
click node_eval_module "https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/main.py"
click node_eval_engine "https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/deepeval_evaluator.py"
click node_model_runner "https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/model_runner.py"
click node_gateway_client "https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/gateway_litellm_client.py"
click node_bias_audit "https://github.com/mehboob14/ai-governance-liz/blob/develop/EvalServer/src/engines/bias_audit/engine.py"
click node_file_repository "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/repositories/file.repository.ts"
click node_file_model "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/domain.layer/models/file/file.model.ts"
click node_database "https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/database/db.ts"
click node_additional_ai "https://github.com/mehboob14/ai-governance-liz/tree/develop/Clients/src/application/repository"

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_client,node_tips,node_browser_storage,node_user toneBlue
class node_file_controller,node_workflow_engine,node_governance_features,node_trust_center toneAmber
class node_server toneMint
class node_advisor_rules,node_eval_module,node_eval_engine,node_model_runner,node_gateway_client,node_bias_audit,node_additional_ai toneRose
class node_file_repository,node_file_model,node_database toneIndigo
```

## Components

### Product experience

- [Web client](https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/App.tsx): `Clients/src/App.tsx`
- [Entity guidance](https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/application/hooks/useTipManager.ts): `Clients/src/application/hooks/useTipManager.ts`
- [Browser storage](https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/infrastructure/storage/storageService.ts): `Clients/src/infrastructure/storage/storageService.ts`

### Governance operations

- [Evidence file API](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/controllers/fileManager.ctrl.ts): `Servers/controllers/fileManager.ctrl.ts`
- [Workflow engine](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/services/workflows/engine.ts): `Servers/services/workflows/engine.ts`
- [Governance capabilities](https://github.com/mehboob14/ai-governance-liz/tree/develop/Clients/src/application/repository): `Clients/src/application/repository`
- [AI Trust Center](https://github.com/mehboob14/ai-governance-liz/blob/develop/Clients/src/application/repository/aiTrustCentre.repository.ts): `Clients/src/application/repository/aiTrustCentre.repository.ts`

### Server platform

- [API server](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/app.ts): `Servers/app.ts`

### AI and evaluation

- [Advisor approvals](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/advisor/approval/ruleEngine.ts): `Servers/advisor/approval/ruleEngine.ts`
- [LLM evaluations](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/main.py): `EvaluationModule/main.py`
- [Evaluation engine](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/deepeval_evaluator.py): `EvaluationModule/src/deepeval_engine/deepeval_evaluator.py`
- [Model runner](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/model_runner.py): `EvaluationModule/src/deepeval_engine/model_runner.py`
- [Gateway client](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvaluationModule/src/deepeval_engine/gateway_litellm_client.py): `EvaluationModule/src/deepeval_engine/gateway_litellm_client.py`
- [Bias audit](https://github.com/mehboob14/ai-governance-liz/blob/develop/EvalServer/src/engines/bias_audit/engine.py): `EvalServer/src/engines/bias_audit/engine.py`
- [AI detection, Shadow AI, Advisor](https://github.com/mehboob14/ai-governance-liz/tree/develop/Clients/src/application/repository): `Clients/src/application/repository`

### Persistence and evidence

- [File repository](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/repositories/file.repository.ts): `Servers/repositories/file.repository.ts`
- [File model](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/domain.layer/models/file/file.model.ts): `Servers/domain.layer/models/file/file.model.ts`
- [Application database](https://github.com/mehboob14/ai-governance-liz/blob/develop/Servers/database/db.ts): `Servers/database/db.ts`

### Other components

- **Governance user**

## Connections

- Governance user → Web client: uses (evidence: `README.md`)
- Web client → API server: requests APIs
- Web client → Entity guidance: shows guidance
- Entity guidance → Browser storage: reads and writes (evidence: `Clients/src/application/hooks/useTipManager.ts`)
- API server → Evidence file API: routes file APIs (evidence: `Servers/app.ts`)
- Evidence file API → File repository: calls (evidence: `Servers/controllers/fileManager.ctrl.ts`)
- File repository → Application database: queries (evidence: `Servers/repositories/file.repository.ts`)
- File repository → File model: uses model (evidence: `Servers/repositories/file.repository.ts`)
- API server → Application database: checks health (evidence: `Servers/app.ts`)
- API server → Workflow engine: exposes workflows
- API server → Advisor approvals: exposes advisor
- Governance user → Governance capabilities: manages governance (evidence: `README.md`)
- Governance user → AI Trust Center: views trust center (evidence: `README.md`)
- Governance user → LLM evaluations: runs evaluations (evidence: `README.md`)
- LLM evaluations → Evaluation engine: invokes (evidence: `EvaluationModule/main.py`)
- LLM evaluations → Model runner: invokes (evidence: `EvaluationModule/main.py`)
- Evaluation engine → Model runner: uses (evidence: `EvaluationModule/src/deepeval_engine/deepeval_evaluator.py`)
- Evaluation engine → Gateway client: calls (evidence: `EvaluationModule/src/deepeval_engine/deepeval_evaluator.py`)
- Governance user → Bias audit: audits bias (evidence: `README.md`)
- Governance user → AI detection, Shadow AI, Advisor: uses AI features (evidence: `README.md`)
