# eaglepython/ai-governance-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/eaglepython/ai-governance-portfolio
- Repository: https://github.com/eaglepython/ai-governance-portfolio

## Overview

##### Project type and purpose
- From the file tree (only README.md) and the README, this is not a code-intensive repo but a **portfolio/demonstration website** that showcases **three distinct, deployed AI governance systems**.
- Its purpose is to serve as a **central landing page** (likely published via GitHub Pages) that links to three production systems, each addressing a different AI-governance challenge for congressional/institutional oversight.

##### (minimal) file structure
- Top-level: README.md – no code directories, implying a **static documentation site**.
- Live links point at three external repos which together form the substantive applications.

##### README for additional insights
- Describes three stand-alone systems:
1. Healthcare LLM Governance Toolkit
2. Multi-LLM Orchestration Platform
3. AI Ethics Monitoring Dashboard
- Each has its own architecture (front-end, back-end, data store, external LLM vendors, monitoring).
- Emphasizes production metrics, vendor diversity, real-time monitoring, compliance.

##### Diagramming conventions
- Blue for Frontend/UI
- Green for Backend Services
- Orange for Data Stores
- Red for External Systems (LLM vendors, compliance engines)
- Rounded rectangles for services
- Clouds for external APIs

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global entities
    User["User (Congressional Staff)"]:::frontend
    Portfolio["Portfolio Website (Static Landing Page)"]:::frontend
    User --> Portfolio
    click Portfolio "https://github.com/eaglepython/ai-governance-portfolio/blob/main/README.md"

    %% System 1: Healthcare LLM Governance Toolkit
    subgraph "Healthcare LLM Governance Toolkit"
        H1_FE["Client UI"]:::frontend
        H1_API["API Gateway"]:::backend
        H1_BD["Bias Detection Service"]:::backend
        H1_HR["Hallucination Risk Scorer"]:::backend
        H1_DB["PostgreSQL DB"]:::datastore
        H1_LL["LLM Vendors"]:::external
    end
    Portfolio --> H1_FE
    H1_FE --> H1_API
    H1_API --> H1_BD
    H1_API --> H1_HR
    H1_BD --> H1_DB
    H1_HR --> H1_DB
    H1_BD --> H1_LL
    H1_HR --> H1_LL

    %% System 2: Multi-LLM Orchestration Platform
    subgraph "Multi-LLM Orchestration Platform"
        S2_FE["Client UI"]:::frontend
        S2_API["API Gateway"]:::backend
        S2_LB["Load Balancer & Failover"]:::backend
        S2_OR["Orchestration Service"]:::backend
        S2_DB["MongoDB"]:::datastore
        S2_LL["LLM Vendors"]:::external
    end
    Portfolio --> S2_FE
    S2_FE --> S2_API
    S2_API --> S2_LB
    S2_LB --> S2_OR
    S2_OR --> S2_DB
    S2_OR --> S2_LL

    %% System 3: AI Ethics Monitoring Dashboard
    subgraph "AI Ethics Monitoring Dashboard"
        S3_FE["Dashboard UI"]:::frontend
        S3_EP["Event Producer"]:::backend
        S3_SP["Stream Processor"]:::backend
        S3_DB2["Metrics DB (Redis)"]:::datastore
        S3_AM["Alert Manager"]:::backend
        S3_MM["Monitoring & Logging"]:::external
    end
    Portfolio --> S3_FE
    S3_EP --> S3_SP
    S3_SP --> S3_DB2
    S3_SP --> S3_FE
    S3_SP --> S3_AM
    S3_AM --> S3_MM

    %% Styles
    classDef frontend fill:#bbdefb,stroke:#333,stroke-width:1px
    classDef backend fill:#c8e6c9,stroke:#333,stroke-width:1px
    classDef datastore fill:#ffe0b2,stroke:#333,stroke-width:1px
    classDef external fill:#ffcccb,stroke:#333,stroke-width:1px
```
