# hhs7304/enterprise-intelligence-system architecture

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

- Interactive diagram: https://gitdiagram.com/hhs7304/enterprise-intelligence-system
- Repository: https://github.com/hhs7304/enterprise-intelligence-system

## Overview

This is a FastAPI enterprise-intelligence API. The principal workflow is a client request entering the application and being dispatched to a versioned router; the README highlights data collection, analytics and predictive capabilities, and real-time dashboards. Governance and authentication are also represented in the available tree. Source evidence is limited to the application entry point, so router registrations and configuration use are visible, but internal router-to-service, model, and data-store relationships are not established.

Main entry points: [`backend/app/main.py`](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/routers/analytics.py`](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/analytics.py) (Analytics routes), [`backend/app/routers/auth.py`](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/auth.py) (Authentication routes), [`backend/app/routers/dashboards.py`](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/dashboards.py) (Dashboard routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routing"]
  node_app["FastAPI application<br/>[main.py]"]
  node_analytics_router["Analytics routes<br/>[analytics.py]"]
  node_auth_router["Authentication routes<br/>[auth.py]"]
  node_dashboards_router["Dashboard routes<br/>[dashboards.py]"]
  node_sources_router["Data source routes<br/>[data_sources.py]"]
  node_governance_router["Governance routes<br/>[governance.py]"]
end

subgraph group_domain["Intelligence capabilities"]
end

subgraph group_services["Domain services"]
  node_analytics_service["Analytics service"]
  node_auth_service["Authentication service<br/>[auth_service.py]"]
  node_governance_service["Governance service"]
end

subgraph group_internal["Application internals"]
  node_models["Domain models<br/>[models.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_config["Application settings<br/>[config.py]"]
end

node_client(("API client"))

node_client -.->|"requests API"| node_app
node_app -->|"registers"| node_analytics_router
node_app -->|"registers"| node_auth_router
node_app -->|"registers"| node_dashboards_router
node_app -->|"registers"| node_sources_router
node_app -->|"registers"| node_governance_router
node_app -->|"reads settings"| node_config

click node_app "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/main.py"
click node_analytics_router "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/analytics.py"
click node_auth_router "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/auth.py"
click node_dashboards_router "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/dashboards.py"
click node_sources_router "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/data_sources.py"
click node_governance_router "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/governance.py"
click node_analytics_service "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/analytics_service.py"
click node_auth_service "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/auth_service.py"
click node_governance_service "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/governance_service.py"
click node_models "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/models.py"
click node_schemas "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/schemas.py"
click node_config "https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/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_analytics_router,node_auth_router,node_dashboards_router,node_sources_router,node_governance_router,node_client toneBlue
class node_analytics_service,node_auth_service,node_governance_service toneMint
class node_models,node_schemas,node_config toneRose
```

## Components

### API routing

- [FastAPI application](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Analytics routes](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/analytics.py): `backend/app/routers/analytics.py`
- [Authentication routes](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Dashboard routes](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/dashboards.py): `backend/app/routers/dashboards.py`
- [Data source routes](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/data_sources.py): `backend/app/routers/data_sources.py`
- [Governance routes](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/routers/governance.py): `backend/app/routers/governance.py`

### Domain services

- [Analytics service](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/analytics_service.py): `backend/app/services/analytics_service.py`
- [Authentication service](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Governance service](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/services/governance_service.py): `backend/app/services/governance_service.py`

### Application internals

- [Domain models](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/models.py): `backend/app/models.py`
- [API schemas](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/schemas.py): `backend/app/schemas.py`
- [Application settings](https://github.com/hhs7304/enterprise-intelligence-system/blob/main/backend/app/config.py): `backend/app/config.py`

### Other components

- **API client**

## Connections

- API client → FastAPI application: requests API
- FastAPI application → Analytics routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Authentication routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Dashboard routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Data source routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Governance routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Application settings: reads settings (evidence: `backend/app/main.py`)
