How alancrozier/ai-business-management works
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: main.py API entrypoint · database.py SQLAlchemy database · tabs Analytics tabs · accounts.py Account routes
Components 24
Web application
- App routing
Lumon/nexus-analytics/src/App.tsx - Sign-in
Lumon/nexus-analytics/src/pages/AuthPage.tsx - Firebase Auth
- Dashboard page
Lumon/nexus-analytics/src/pages/DashboardPage.tsx - Analytics tabs
Lumon/nexus-analytics/src/components/tabs - KPI cards
Lumon/nexus-analytics/src/components/KPICard.tsx - Data sources
Lumon/nexus-analytics/src/components/tabs/DataSourcesTab.tsx - Settings
Lumon/nexus-analytics/src/components/tabs/SettingsTab.tsx
API workflows
- API entrypoint
Lumon/backend/main.py - Account routes
Lumon/backend/routers/accounts.py - Dashboard routes
Lumon/backend/routers/dashboard.py - Data routes
Lumon/backend/routers/data_router.py - Prediction routes
Lumon/backend/routers/predict.py - Sheets routes
Lumon/backend/routers/sheets.py
Analytics services
- ML predictions
Lumon/backend/services/ml_service.py - Data generation
Lumon/backend/services/data_generator.py - Sheets integration
Lumon/backend/services/sheets_service.py - Credential encryption
Lumon/backend/services/crypto_service.py
Data and integrations
- SQLAlchemy database
Lumon/backend/database.py - Business records
Lumon/backend/models/dataset_models.py - Prediction records
Lumon/backend/models/prediction.py - User accounts
Lumon/backend/models/user_account.py
Other components
- Business user
- Google Sheets
Connections 34
- Business user → App routing: opens
Lumon/nexus-analytics/src/App.tsx - App routing → Sign-in: routes to
Lumon/nexus-analytics/src/App.tsx - App routing → Dashboard page: routes to
Lumon/nexus-analytics/src/App.tsx - Sign-in → Firebase Auth: authenticates with
Lumon/nexus-analytics/src/pages/AuthPage.tsx - Dashboard page → Analytics tabs: renders
Lumon/nexus-analytics/src/pages/DashboardPage.tsx - Analytics tabs → KPI cards: renders
Lumon/nexus-analytics/src/components/tabs/SalesTab.tsx - Analytics tabs → Data sources: includes
Lumon/nexus-analytics/src/pages/DashboardPage.tsx - Analytics tabs → Settings: includes
Lumon/nexus-analytics/src/pages/DashboardPage.tsx - Dashboard page → API entrypoint: requests data
- API entrypoint → Account routes: registers
Lumon/backend/main.py - API entrypoint → Dashboard routes: registers
Lumon/backend/main.py - API entrypoint → Data routes: registers
Lumon/backend/main.py - API entrypoint → Prediction routes: registers
Lumon/backend/main.py - API entrypoint → Sheets routes: registers
Lumon/backend/main.py - API entrypoint → SQLAlchemy database: initializes
Lumon/backend/main.py - API entrypoint → ML predictions: loads models
Lumon/backend/main.py - API entrypoint → Data generation: seeds with
Lumon/backend/main.py - Account routes → SQLAlchemy database: queries
Lumon/backend/routers/accounts.py - Account routes → Credential encryption: encrypts credentials
Lumon/backend/routers/accounts.py - Account routes → User accounts: uses
Lumon/backend/routers/accounts.py - Dashboard routes → SQLAlchemy database: queries
Lumon/backend/routers/dashboard.py - Dashboard routes → ML predictions: requests predictions
Lumon/backend/routers/dashboard.py - Data routes → Data generation: generates records
Lumon/backend/routers/data_router.py - Data routes → SQLAlchemy database: inserts and queries
Lumon/backend/routers/data_router.py - Data routes → Business records: persists
Lumon/backend/routers/data_router.py - Prediction routes → ML predictions: requests predictions
Lumon/backend/routers/predict.py - Prediction routes → SQLAlchemy database: queries
Lumon/backend/routers/predict.py - Prediction routes → Prediction records: stores predictions
Lumon/backend/routers/predict.py - Sheets routes → Sheets integration: requests sheet operations
Lumon/backend/routers/sheets.py - Sheets routes → ML predictions: requests predictions
Lumon/backend/routers/sheets.py - Sheets routes → SQLAlchemy database: queries
Lumon/backend/routers/sheets.py - Sheets integration → User accounts: loads credentials
Lumon/backend/services/sheets_service.py - Sheets integration → Credential encryption: decrypts credentials
Lumon/backend/services/sheets_service.py - Sheets integration → Google Sheets: reads and writes
Lumon/backend/services/sheets_service.py