# alancrozier/ai-business-management architecture

> Architecture diagram of the GitHub repository alancrozier/ai-business-management, 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/alancrozier/ai-business-management
- Repository: https://github.com/alancrozier/ai-business-management

## Overview

Lumon is an AI business analytics product: users enter through the web app, authenticate, and view business dashboards and forecasts. The backend provides account, data, prediction, dashboard, and Google Sheets routes, backed by SQLAlchemy models and ML services. The frontend dashboard’s tab components and the backend’s route-to-service wiring are supported by the source index; the exact frontend-to-backend transport is not shown in the excerpts, so that connection is marked unverified.

Main entry points: [`Lumon/backend/main.py`](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/main.py) (API entrypoint), [`Lumon/backend/database.py`](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/database.py) (SQLAlchemy database), [`Lumon/nexus-analytics/src/components/tabs`](https://github.com/alancrozier/ai-business-management/tree/main/Lumon/nexus-analytics/src/components/tabs) (Analytics tabs), [`Lumon/backend/routers/accounts.py`](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/accounts.py) (Account routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth["Sign-in<br/>[AuthPage.tsx]"]
  node_firebase(("Firebase Auth"))
  node_dashboard_ui["Dashboard page<br/>[DashboardPage.tsx]"]
  node_analytics_tabs["Analytics tabs"]
  node_kpi["KPI cards<br/>[KPICard.tsx]"]
  node_data_sources["Data sources<br/>[DataSourcesTab.tsx]"]
  node_settings["Settings<br/>[SettingsTab.tsx]"]
end

subgraph group_api["API workflows"]
  node_api_main["API entrypoint<br/>[main.py]"]
  node_accounts["Account routes<br/>[accounts.py]"]
  node_dashboard_api["Dashboard routes<br/>[dashboard.py]"]
  node_data_api["Data routes<br/>[data_router.py]"]
  node_predict_api["Prediction routes<br/>[predict.py]"]
  node_sheets_api["Sheets routes<br/>[sheets.py]"]
end

subgraph group_domain["Analytics services"]
  node_ml["ML predictions<br/>[ml_service.py]"]
  node_generator["Data generation<br/>[data_generator.py]"]
  node_sheets_service["Sheets integration<br/>[sheets_service.py]"]
  node_crypto["Credential encryption<br/>[crypto_service.py]"]
end

subgraph group_state["Data and integrations"]
  node_database[("SQLAlchemy database<br/>[database.py]")]
  node_dataset[("Business records<br/>[dataset_models.py]")]
  node_prediction_model[("Prediction records<br/>[prediction.py]")]
  node_account_model[("User accounts<br/>[user_account.py]")]
end

node_user(("Business user"))
node_google_sheets[("Google Sheets")]

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_auth
node_app -->|"routes to"| node_dashboard_ui
node_auth -->|"authenticates with"| node_firebase
node_dashboard_ui -->|"renders"| node_analytics_tabs
node_analytics_tabs -->|"renders"| node_kpi
node_analytics_tabs -->|"includes"| node_data_sources
node_analytics_tabs -->|"includes"| node_settings
node_dashboard_ui -.->|"requests data"| node_api_main
node_api_main -->|"registers"| node_accounts
node_api_main -->|"registers"| node_dashboard_api
node_api_main -->|"registers"| node_data_api
node_api_main -->|"registers"| node_predict_api
node_api_main -->|"registers"| node_sheets_api
node_api_main -->|"initializes"| node_database
node_api_main -->|"loads models"| node_ml
node_api_main -->|"seeds with"| node_generator
node_accounts -->|"queries"| node_database
node_accounts -->|"encrypts credentials"| node_crypto
node_accounts -->|"uses"| node_account_model
node_dashboard_api -->|"queries"| node_database
node_dashboard_api -->|"requests predictions"| node_ml
node_data_api -->|"generates records"| node_generator
node_data_api -->|"inserts and queries"| node_database
node_data_api -->|"persists"| node_dataset
node_predict_api -->|"requests predictions"| node_ml
node_predict_api -->|"queries"| node_database
node_predict_api -->|"stores predictions"| node_prediction_model
node_sheets_api -->|"requests sheet operations"| node_sheets_service
node_sheets_api -->|"requests predictions"| node_ml
node_sheets_api -->|"queries"| node_database
node_sheets_service -->|"loads credentials"| node_account_model
node_sheets_service -->|"decrypts credentials"| node_crypto
node_sheets_service -->|"reads and writes"| node_google_sheets

click node_app "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/App.tsx"
click node_auth "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/pages/AuthPage.tsx"
click node_dashboard_ui "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/pages/DashboardPage.tsx"
click node_analytics_tabs "https://github.com/alancrozier/ai-business-management/tree/main/Lumon/nexus-analytics/src/components/tabs"
click node_kpi "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/KPICard.tsx"
click node_data_sources "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/tabs/DataSourcesTab.tsx"
click node_settings "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/tabs/SettingsTab.tsx"
click node_api_main "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/main.py"
click node_accounts "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/accounts.py"
click node_dashboard_api "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/dashboard.py"
click node_data_api "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/data_router.py"
click node_predict_api "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/predict.py"
click node_sheets_api "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/sheets.py"
click node_ml "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/ml_service.py"
click node_generator "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/data_generator.py"
click node_sheets_service "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/sheets_service.py"
click node_crypto "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/crypto_service.py"
click node_database "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/database.py"
click node_dataset "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/dataset_models.py"
click node_prediction_model "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/prediction.py"
click node_account_model "https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/user_account.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_auth,node_firebase,node_dashboard_ui,node_analytics_tabs,node_kpi,node_data_sources,node_settings,node_user toneBlue
class node_api_main,node_accounts,node_dashboard_api,node_data_api,node_predict_api,node_sheets_api,node_google_sheets toneAmber
class node_ml,node_generator,node_sheets_service,node_crypto toneMint
class node_database,node_dataset,node_prediction_model,node_account_model toneRose
```

## Components

### Web application

- [App routing](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/App.tsx): `Lumon/nexus-analytics/src/App.tsx`
- [Sign-in](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/pages/AuthPage.tsx): `Lumon/nexus-analytics/src/pages/AuthPage.tsx`
- **Firebase Auth**
- [Dashboard page](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/pages/DashboardPage.tsx): `Lumon/nexus-analytics/src/pages/DashboardPage.tsx`
- [Analytics tabs](https://github.com/alancrozier/ai-business-management/tree/main/Lumon/nexus-analytics/src/components/tabs): `Lumon/nexus-analytics/src/components/tabs`
- [KPI cards](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/KPICard.tsx): `Lumon/nexus-analytics/src/components/KPICard.tsx`
- [Data sources](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/tabs/DataSourcesTab.tsx): `Lumon/nexus-analytics/src/components/tabs/DataSourcesTab.tsx`
- [Settings](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/nexus-analytics/src/components/tabs/SettingsTab.tsx): `Lumon/nexus-analytics/src/components/tabs/SettingsTab.tsx`

### API workflows

- [API entrypoint](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/main.py): `Lumon/backend/main.py`
- [Account routes](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/accounts.py): `Lumon/backend/routers/accounts.py`
- [Dashboard routes](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/dashboard.py): `Lumon/backend/routers/dashboard.py`
- [Data routes](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/data_router.py): `Lumon/backend/routers/data_router.py`
- [Prediction routes](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/predict.py): `Lumon/backend/routers/predict.py`
- [Sheets routes](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/routers/sheets.py): `Lumon/backend/routers/sheets.py`

### Analytics services

- [ML predictions](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/ml_service.py): `Lumon/backend/services/ml_service.py`
- [Data generation](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/data_generator.py): `Lumon/backend/services/data_generator.py`
- [Sheets integration](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/sheets_service.py): `Lumon/backend/services/sheets_service.py`
- [Credential encryption](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/services/crypto_service.py): `Lumon/backend/services/crypto_service.py`

### Data and integrations

- [SQLAlchemy database](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/database.py): `Lumon/backend/database.py`
- [Business records](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/dataset_models.py): `Lumon/backend/models/dataset_models.py`
- [Prediction records](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/prediction.py): `Lumon/backend/models/prediction.py`
- [User accounts](https://github.com/alancrozier/ai-business-management/blob/main/Lumon/backend/models/user_account.py): `Lumon/backend/models/user_account.py`

### Other components

- **Business user**
- **Google Sheets**

## Connections

- Business user → App routing: opens (evidence: `Lumon/nexus-analytics/src/App.tsx`)
- App routing → Sign-in: routes to (evidence: `Lumon/nexus-analytics/src/App.tsx`)
- App routing → Dashboard page: routes to (evidence: `Lumon/nexus-analytics/src/App.tsx`)
- Sign-in → Firebase Auth: authenticates with (evidence: `Lumon/nexus-analytics/src/pages/AuthPage.tsx`)
- Dashboard page → Analytics tabs: renders (evidence: `Lumon/nexus-analytics/src/pages/DashboardPage.tsx`)
- Analytics tabs → KPI cards: renders (evidence: `Lumon/nexus-analytics/src/components/tabs/SalesTab.tsx`)
- Analytics tabs → Data sources: includes (evidence: `Lumon/nexus-analytics/src/pages/DashboardPage.tsx`)
- Analytics tabs → Settings: includes (evidence: `Lumon/nexus-analytics/src/pages/DashboardPage.tsx`)
- Dashboard page → API entrypoint: requests data
- API entrypoint → Account routes: registers (evidence: `Lumon/backend/main.py`)
- API entrypoint → Dashboard routes: registers (evidence: `Lumon/backend/main.py`)
- API entrypoint → Data routes: registers (evidence: `Lumon/backend/main.py`)
- API entrypoint → Prediction routes: registers (evidence: `Lumon/backend/main.py`)
- API entrypoint → Sheets routes: registers (evidence: `Lumon/backend/main.py`)
- API entrypoint → SQLAlchemy database: initializes (evidence: `Lumon/backend/main.py`)
- API entrypoint → ML predictions: loads models (evidence: `Lumon/backend/main.py`)
- API entrypoint → Data generation: seeds with (evidence: `Lumon/backend/main.py`)
- Account routes → SQLAlchemy database: queries (evidence: `Lumon/backend/routers/accounts.py`)
- Account routes → Credential encryption: encrypts credentials (evidence: `Lumon/backend/routers/accounts.py`)
- Account routes → User accounts: uses (evidence: `Lumon/backend/routers/accounts.py`)
- Dashboard routes → SQLAlchemy database: queries (evidence: `Lumon/backend/routers/dashboard.py`)
- Dashboard routes → ML predictions: requests predictions (evidence: `Lumon/backend/routers/dashboard.py`)
- Data routes → Data generation: generates records (evidence: `Lumon/backend/routers/data_router.py`)
- Data routes → SQLAlchemy database: inserts and queries (evidence: `Lumon/backend/routers/data_router.py`)
- Data routes → Business records: persists (evidence: `Lumon/backend/routers/data_router.py`)
- Prediction routes → ML predictions: requests predictions (evidence: `Lumon/backend/routers/predict.py`)
- Prediction routes → SQLAlchemy database: queries (evidence: `Lumon/backend/routers/predict.py`)
- Prediction routes → Prediction records: stores predictions (evidence: `Lumon/backend/routers/predict.py`)
- Sheets routes → Sheets integration: requests sheet operations (evidence: `Lumon/backend/routers/sheets.py`)
- Sheets routes → ML predictions: requests predictions (evidence: `Lumon/backend/routers/sheets.py`)
- Sheets routes → SQLAlchemy database: queries (evidence: `Lumon/backend/routers/sheets.py`)
- Sheets integration → User accounts: loads credentials (evidence: `Lumon/backend/services/sheets_service.py`)
- Sheets integration → Credential encryption: decrypts credentials (evidence: `Lumon/backend/services/sheets_service.py`)
- Sheets integration → Google Sheets: reads and writes (evidence: `Lumon/backend/services/sheets_service.py`)
