# xenon110/ssl architecture

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

- Interactive diagram: https://gitdiagram.com/xenon110/ssl
- Repository: https://github.com/xenon110/ssl

## Overview

SSL is a financial analytics dashboard for company performance, cash flow, inventory, compliance, and related workflows, backed by Tally accounting data. The documented source excerpts show two ingestion paths: a background sync agent that reads Tally and writes records, and a web sync endpoint that also writes to Supabase. Analytics API routes query stored financial data and return results. The tree also shows dashboard pages and AI features, but their runtime connections are not demonstrated in the excerpts; those links are therefore omitted.

Main entry points: [`frontend/src/lib/supabase.ts`](https://github.com/xenon110/ssl/blob/main/frontend/src/lib/supabase.ts) (Supabase data), [`sync_agent/tally_client.py`](https://github.com/xenon110/ssl/blob/main/sync_agent/tally_client.py) (Tally connector), [`sync_agent/main.py`](https://github.com/xenon110/ssl/blob/main/sync_agent/main.py) (Background sync), [`sync_agent/fetch_dynamic_metrics.py`](https://github.com/xenon110/ssl/blob/main/sync_agent/fetch_dynamic_metrics.py) (Tally metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard interface"]
  node_dashboard_pages["Finance dashboards"]
  node_layout["App layout<br/>[AppLayout.tsx]"]
end

subgraph group_analytics["Financial analytics"]
  node_dashboard_api["Dashboard metrics<br/>[route.ts]"]
  node_universal_metrics["Universal metrics<br/>[route.ts]"]
  node_pnl_api["Profit and loss<br/>[route.ts]"]
  node_purchases_api["Purchases<br/>[route.ts]"]
  node_cash_flow_api["Cash flow<br/>[route.ts]"]
  node_compare_api["Company comparison<br/>[route.ts]"]
end

subgraph group_ingestion["Data ingestion"]
  node_sync_api["Web sync<br/>[route.ts]"]
  node_sync_agent["Background sync<br/>[main.py]"]
  node_queue_listener["Metrics queue<br/>[queue_listener.py]"]
  node_dynamic_metrics["Tally metrics"]
  node_tally_client["Tally connector<br/>[tally_client.py]"]
end

subgraph group_ai["AI assistance"]
  node_ai_analysis_api["AI analysis<br/>[route.ts]"]
  node_chat_api["AI chat<br/>[route.ts]"]
  node_cash_flow_ai["Cash flow AI<br/>[route.ts]"]
  node_sales_ai["Sales AI<br/>[route.ts]"]
end

node_user(("Finance user"))
node_supabase[("Supabase data<br/>[supabase.ts]")]
node_tally["Tally accounting"]

node_sync_api -->|"writes records"| node_supabase
node_sync_agent -->|"writes records"| node_supabase
node_sync_agent -->|"uses connector"| node_tally_client
node_tally_client -.->|"requests data"| node_tally
node_queue_listener -->|"requests metrics"| node_dynamic_metrics
node_dynamic_metrics -->|"uses connector"| node_tally_client
node_dashboard_api -->|"queries data"| node_supabase
node_universal_metrics -->|"queries data"| node_supabase
node_pnl_api -->|"queries data"| node_supabase
node_purchases_api -->|"queries data"| node_supabase
node_cash_flow_api -->|"queries data"| node_supabase
node_compare_api -->|"queries data"| node_supabase
node_user -.->|"views dashboards"| node_dashboard_pages

click node_dashboard_pages "https://github.com/xenon110/ssl/tree/main/frontend/src/app"
click node_layout "https://github.com/xenon110/ssl/blob/main/frontend/src/components/layout/AppLayout.tsx"
click node_dashboard_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/dashboard/route.ts"
click node_universal_metrics "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/universal-metrics/route.ts"
click node_pnl_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/pnl/route.ts"
click node_purchases_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/purchases/route.ts"
click node_cash_flow_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/cash-flow/route.ts"
click node_compare_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/compare/route.ts"
click node_ai_analysis_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/ai/analyze/route.ts"
click node_chat_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/chat/route.ts"
click node_cash_flow_ai "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/cash-flow/ai/route.ts"
click node_sales_ai "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/sales/ai/route.ts"
click node_sync_api "https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/sync/route.ts"
click node_sync_agent "https://github.com/xenon110/ssl/blob/main/sync_agent/main.py"
click node_queue_listener "https://github.com/xenon110/ssl/blob/main/sync_agent/queue_listener.py"
click node_dynamic_metrics "https://github.com/xenon110/ssl/blob/main/sync_agent/fetch_dynamic_metrics.py"
click node_tally_client "https://github.com/xenon110/ssl/blob/main/sync_agent/tally_client.py"
click node_supabase "https://github.com/xenon110/ssl/blob/main/frontend/src/lib/supabase.ts"

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_dashboard_pages,node_layout,node_user toneBlue
class node_dashboard_api,node_universal_metrics,node_pnl_api,node_purchases_api,node_cash_flow_api,node_compare_api,node_supabase toneAmber
class node_sync_api,node_sync_agent,node_queue_listener,node_dynamic_metrics,node_tally_client toneMint
class node_ai_analysis_api,node_chat_api,node_cash_flow_ai,node_sales_ai toneRose
class node_tally toneIndigo
```

## Components

### Dashboard interface

- [Finance dashboards](https://github.com/xenon110/ssl/tree/main/frontend/src/app): `frontend/src/app`
- [App layout](https://github.com/xenon110/ssl/blob/main/frontend/src/components/layout/AppLayout.tsx): `frontend/src/components/layout/AppLayout.tsx`

### Financial analytics

- [Dashboard metrics](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/dashboard/route.ts): `frontend/src/app/api/dashboard/route.ts`
- [Universal metrics](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/universal-metrics/route.ts): `frontend/src/app/api/universal-metrics/route.ts`
- [Profit and loss](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/pnl/route.ts): `frontend/src/app/api/pnl/route.ts`
- [Purchases](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/purchases/route.ts): `frontend/src/app/api/purchases/route.ts`
- [Cash flow](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/cash-flow/route.ts): `frontend/src/app/api/cash-flow/route.ts`
- [Company comparison](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/compare/route.ts): `frontend/src/app/api/compare/route.ts`

### Data ingestion

- [Web sync](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/sync/route.ts): `frontend/src/app/api/sync/route.ts`
- [Background sync](https://github.com/xenon110/ssl/blob/main/sync_agent/main.py): `sync_agent/main.py`
- [Metrics queue](https://github.com/xenon110/ssl/blob/main/sync_agent/queue_listener.py): `sync_agent/queue_listener.py`
- [Tally metrics](https://github.com/xenon110/ssl/blob/main/sync_agent/fetch_dynamic_metrics.py): `sync_agent/fetch_dynamic_metrics.py`
- [Tally connector](https://github.com/xenon110/ssl/blob/main/sync_agent/tally_client.py): `sync_agent/tally_client.py`

### AI assistance

- [AI analysis](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/ai/analyze/route.ts): `frontend/src/app/api/ai/analyze/route.ts`
- [AI chat](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/chat/route.ts): `frontend/src/app/api/chat/route.ts`
- [Cash flow AI](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/cash-flow/ai/route.ts): `frontend/src/app/api/cash-flow/ai/route.ts`
- [Sales AI](https://github.com/xenon110/ssl/blob/main/frontend/src/app/api/sales/ai/route.ts): `frontend/src/app/api/sales/ai/route.ts`

### Other components

- **Finance user**
- [Supabase data](https://github.com/xenon110/ssl/blob/main/frontend/src/lib/supabase.ts): `frontend/src/lib/supabase.ts`
- **Tally accounting**

## Connections

- Web sync → Supabase data: writes records (evidence: `frontend/src/app/api/sync/route.ts`)
- Background sync → Supabase data: writes records (evidence: `sync_agent/main.py`)
- Background sync → Tally connector: uses connector (evidence: `sync_agent/main.py`)
- Tally connector → Tally accounting: requests data
- Metrics queue → Tally metrics: requests metrics (evidence: `sync_agent/queue_listener.py`)
- Tally metrics → Tally connector: uses connector (evidence: `sync_agent/fetch_dynamic_metrics.py`)
- Dashboard metrics → Supabase data: queries data (evidence: `frontend/src/app/api/dashboard/route.ts`)
- Universal metrics → Supabase data: queries data (evidence: `frontend/src/app/api/universal-metrics/route.ts`)
- Profit and loss → Supabase data: queries data (evidence: `frontend/src/app/api/pnl/route.ts`)
- Purchases → Supabase data: queries data (evidence: `frontend/src/app/api/purchases/route.ts`)
- Cash flow → Supabase data: queries data (evidence: `frontend/src/app/api/cash-flow/route.ts`)
- Company comparison → Supabase data: queries data (evidence: `frontend/src/app/api/compare/route.ts`)
- Finance user → Finance dashboards: views dashboards
