# piqlincrypto-a11y/inoutappcommittest architecture

> Architecture diagram of the GitHub repository piqlincrypto-a11y/inoutappcommittest, 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/piqlincrypto-a11y/inoutappcommittest
- Repository: https://github.com/piqlincrypto-a11y/inoutappcommittest

## Overview

InOut Finance is a desktop personal-finance app: users record and organize transactions, manage passive income/expense assets, and review balances, analytics, and exports. The UI routes requests through the web API or Electron IPC to domain services, repositories, and local SQLite; Telegram offers a second interaction channel over the same services. The graph preserves the documented page and integration branches, but unsampled page/store wiring is not inferred. Edges reflect only shown imports, calls, or explicit entry-point routing.

Main entry points: [`src/App.tsx`](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/App.tsx) (Workspace shell), [`src/main/ipc.ts`](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main/ipc.ts) (IPC handlers), [`src/web-api.ts`](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/web-api.ts) (Web API bridge), [`src/telegram/bot.ts`](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/telegram/bot.ts) (Telegram bot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Finance workspace"]
  node_app["Workspace shell<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[dashboard.tsx]"]
  node_transactions["Transactions<br/>[transactions.tsx]"]
  node_categories["Categories<br/>[categories.tsx]"]
  node_passive["Passive assets<br/>[passive-income.tsx]"]
  node_analytics["Analytics<br/>[analytics.tsx]"]
  node_search["Transaction search<br/>[search.tsx]"]
  node_settings["Settings<br/>[settings.tsx]"]
end

subgraph group_domain["Finance services"]
  node_asset_service["Asset service<br/>[asset-service.ts]"]
  node_category_service["Category service"]
  node_transaction_service["Transaction service"]
  node_dashboard_service["Dashboard aggregation"]
  node_settings_service["Settings service"]
  node_export_service["Import and export<br/>[export-service.ts]"]
end

subgraph group_storage["Local persistence"]
  node_sqlite[("SQLite database<br/>[client.ts]")]
  node_transaction_repo["Transaction repository"]
  node_asset_repo["Asset repository"]
  node_category_repo["Category repository"]
  node_settings_repo["Settings repository"]
end

subgraph group_runtime["Desktop runtime"]
  node_renderer["Renderer startup<br/>[main.tsx]"]
  node_web_api["Web API bridge<br/>[web-api.ts]"]
  node_main_process["Electron main process<br/>[index.ts]"]
  node_ipc["IPC handlers<br/>[ipc.ts]"]
  node_preload["Preload bridge<br/>[index.ts]"]
end

subgraph group_channels["Other channels"]
  node_telegram["Telegram bot<br/>[bot.ts]"]
end

node_user(("Finance user"))
node_telegram_service["Telegram platform"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_transactions
node_app -->|"routes to"| node_categories
node_app -->|"routes to"| node_passive
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_settings
node_renderer -->|"renders"| node_app
node_renderer -->|"initializes"| node_web_api
node_transactions -.->|"uses"| node_web_api
node_categories -.->|"uses"| node_web_api
node_passive -.->|"uses"| node_web_api
node_dashboard -.->|"uses"| node_web_api
node_analytics -.->|"uses"| node_web_api
node_search -.->|"uses"| node_web_api
node_settings -.->|"uses"| node_web_api
node_main_process -->|"registers"| node_ipc
node_main_process -->|"starts"| node_telegram
node_preload -.->|"exposes calls"| node_ipc
node_web_api -.->|"dispatches"| node_ipc
node_ipc -->|"dispatches"| node_transaction_service
node_ipc -->|"dispatches"| node_category_service
node_ipc -->|"dispatches"| node_asset_service
node_ipc -->|"dispatches"| node_dashboard_service
node_ipc -->|"dispatches"| node_settings_service
node_ipc -->|"dispatches"| node_export_service
node_transaction_service -->|"delegates to"| node_transaction_repo
node_asset_service -->|"delegates to"| node_asset_repo
node_category_service -->|"delegates to"| node_category_repo
node_settings_service -->|"delegates to"| node_settings_repo
node_dashboard_service -->|"queries"| node_transaction_service
node_dashboard_service -->|"queries"| node_asset_service
node_transaction_repo -->|"reads and writes"| node_sqlite
node_asset_repo -->|"reads and writes"| node_sqlite
node_category_repo -->|"reads and writes"| node_sqlite
node_settings_repo -->|"reads and writes"| node_sqlite
node_export_service -->|"imports and exports"| node_sqlite
node_telegram_service -->|"sends commands"| node_telegram
node_telegram -->|"calls"| node_transaction_service
node_telegram -->|"calls"| node_category_service
node_telegram -->|"calls"| node_asset_service
node_telegram -->|"calls"| node_settings_service
node_telegram -->|"calls"| node_export_service
node_telegram -->|"calls"| node_dashboard_service

click node_app "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/App.tsx"
click node_dashboard "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/dashboard.tsx"
click node_transactions "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/transactions.tsx"
click node_categories "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/categories.tsx"
click node_passive "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/passive-income.tsx"
click node_analytics "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/analytics.tsx"
click node_search "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/search.tsx"
click node_settings "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/settings.tsx"
click node_asset_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/asset-service.ts"
click node_category_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/category-service.ts"
click node_transaction_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/transaction-service.ts"
click node_dashboard_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/dashboard-service.ts"
click node_settings_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/settings-service.ts"
click node_export_service "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/export-service.ts"
click node_sqlite "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/client.ts"
click node_transaction_repo "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/transaction-repository.ts"
click node_asset_repo "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/asset-repository.ts"
click node_category_repo "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/category-repository.ts"
click node_settings_repo "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/settings-repository.ts"
click node_renderer "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main.tsx"
click node_web_api "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/web-api.ts"
click node_main_process "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main/index.ts"
click node_ipc "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main/ipc.ts"
click node_preload "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/preload/index.ts"
click node_telegram "https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/telegram/bot.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_app,node_dashboard,node_transactions,node_categories,node_passive,node_analytics,node_search,node_settings,node_user toneBlue
class node_asset_service,node_category_service,node_transaction_service,node_dashboard_service,node_settings_service,node_export_service toneAmber
class node_sqlite,node_transaction_repo,node_asset_repo,node_category_repo,node_settings_repo toneMint
class node_renderer,node_web_api,node_main_process,node_ipc,node_preload toneRose
class node_telegram,node_telegram_service toneIndigo
```

## Components

### Finance workspace

- [Workspace shell](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/App.tsx): `src/App.tsx`
- [Dashboard](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/dashboard.tsx): `src/pages/dashboard.tsx`
- [Transactions](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/transactions.tsx): `src/pages/transactions.tsx`
- [Categories](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/categories.tsx): `src/pages/categories.tsx`
- [Passive assets](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/passive-income.tsx): `src/pages/passive-income.tsx`
- [Analytics](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/analytics.tsx): `src/pages/analytics.tsx`
- [Transaction search](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/search.tsx): `src/pages/search.tsx`
- [Settings](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/pages/settings.tsx): `src/pages/settings.tsx`

### Finance services

- [Asset service](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/asset-service.ts): `src/services/asset-service.ts`
- [Category service](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/category-service.ts): `src/services/category-service.ts`
- [Transaction service](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/transaction-service.ts): `src/services/transaction-service.ts`
- [Dashboard aggregation](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/dashboard-service.ts): `src/services/dashboard-service.ts`
- [Settings service](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/settings-service.ts): `src/services/settings-service.ts`
- [Import and export](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/services/export-service.ts): `src/services/export-service.ts`

### Local persistence

- [SQLite database](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/client.ts): `src/db/client.ts`
- [Transaction repository](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/transaction-repository.ts): `src/db/repositories/transaction-repository.ts`
- [Asset repository](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/asset-repository.ts): `src/db/repositories/asset-repository.ts`
- [Category repository](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/category-repository.ts): `src/db/repositories/category-repository.ts`
- [Settings repository](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/db/repositories/settings-repository.ts): `src/db/repositories/settings-repository.ts`

### Desktop runtime

- [Renderer startup](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main.tsx): `src/main.tsx`
- [Web API bridge](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/web-api.ts): `src/web-api.ts`
- [Electron main process](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main/index.ts): `src/main/index.ts`
- [IPC handlers](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/main/ipc.ts): `src/main/ipc.ts`
- [Preload bridge](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/preload/index.ts): `src/preload/index.ts`

### Other channels

- [Telegram bot](https://github.com/piqlincrypto-a11y/inoutappcommittest/blob/main/src/telegram/bot.ts): `src/telegram/bot.ts`

### Other components

- **Finance user**
- **Telegram platform**

## Connections

- Finance user → Workspace shell: uses (evidence: `src/App.tsx`)
- Workspace shell → Dashboard: routes to (evidence: `src/App.tsx`)
- Workspace shell → Transactions: routes to (evidence: `src/App.tsx`)
- Workspace shell → Categories: routes to (evidence: `src/App.tsx`)
- Workspace shell → Passive assets: routes to (evidence: `src/App.tsx`)
- Workspace shell → Analytics: routes to (evidence: `src/App.tsx`)
- Workspace shell → Transaction search: routes to (evidence: `src/App.tsx`)
- Workspace shell → Settings: routes to (evidence: `src/App.tsx`)
- Renderer startup → Workspace shell: renders (evidence: `src/main.tsx`)
- Renderer startup → Web API bridge: initializes (evidence: `src/main.tsx`)
- Transactions → Web API bridge: uses
- Categories → Web API bridge: uses
- Passive assets → Web API bridge: uses
- Dashboard → Web API bridge: uses
- Analytics → Web API bridge: uses
- Transaction search → Web API bridge: uses
- Settings → Web API bridge: uses
- Electron main process → IPC handlers: registers (evidence: `src/main/index.ts`)
- Electron main process → Telegram bot: starts (evidence: `src/main/index.ts`)
- Preload bridge → IPC handlers: exposes calls
- Web API bridge → IPC handlers: dispatches
- IPC handlers → Transaction service: dispatches (evidence: `src/main/ipc.ts`)
- IPC handlers → Category service: dispatches (evidence: `src/main/ipc.ts`)
- IPC handlers → Asset service: dispatches (evidence: `src/main/ipc.ts`)
- IPC handlers → Dashboard aggregation: dispatches (evidence: `src/main/ipc.ts`)
- IPC handlers → Settings service: dispatches (evidence: `src/main/ipc.ts`)
- IPC handlers → Import and export: dispatches (evidence: `src/main/ipc.ts`)
- Transaction service → Transaction repository: delegates to (evidence: `src/services/transaction-service.ts`)
- Asset service → Asset repository: delegates to (evidence: `src/services/asset-service.ts`)
- Category service → Category repository: delegates to (evidence: `src/services/category-service.ts`)
- Settings service → Settings repository: delegates to (evidence: `src/services/settings-service.ts`)
- Dashboard aggregation → Transaction service: queries (evidence: `src/services/dashboard-service.ts`)
- Dashboard aggregation → Asset service: queries (evidence: `src/services/dashboard-service.ts`)
- Transaction repository → SQLite database: reads and writes (evidence: `src/db/repositories/transaction-repository.ts`)
- Asset repository → SQLite database: reads and writes (evidence: `src/db/repositories/asset-repository.ts`)
- Category repository → SQLite database: reads and writes (evidence: `src/db/repositories/category-repository.ts`)
- Settings repository → SQLite database: reads and writes (evidence: `src/db/repositories/settings-repository.ts`)
- Import and export → SQLite database: imports and exports (evidence: `src/services/export-service.ts`)
- Telegram platform → Telegram bot: sends commands (evidence: `src/telegram/bot.ts`)
- Telegram bot → Transaction service: calls (evidence: `src/telegram/bot.ts`)
- Telegram bot → Category service: calls (evidence: `src/telegram/bot.ts`)
- Telegram bot → Asset service: calls (evidence: `src/telegram/bot.ts`)
- Telegram bot → Settings service: calls (evidence: `src/telegram/bot.ts`)
- Telegram bot → Import and export: calls (evidence: `src/telegram/bot.ts`)
- Telegram bot → Dashboard aggregation: calls (evidence: `src/telegram/bot.ts`)
