# orvvney/report architecture

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

- Interactive diagram: https://gitdiagram.com/orvvney/report
- Repository: https://github.com/orvvney/report

## Overview

This is a Bitrix24-backed property-deal reporting web app. Users enter through the authentication gate (or directly when authentication is not configured), choose report periods and filters, and view deal, KPI, statistics, chart, and exhibition-comparison information. The server routes report requests to separate loaders; those loaders retrieve CRM data, enrich and aggregate it, and return report snapshots. The graph preserves documented report and exhibition capabilities, but unsampled UI/API wiring is shown only where indexed or marked unverified.

Main entry points: [`src/ui/App.vue`](https://github.com/orvvney/report/blob/main/src/ui/App.vue) (Report app), [`src/report/expo-load.cjs`](https://github.com/orvvney/report/blob/main/src/report/expo-load.cjs) (Exhibition loader), [`server.js`](https://github.com/orvvney/report/blob/main/server.js) (HTTP server), [`src/report/kpi.cjs`](https://github.com/orvvney/report/blob/main/src/report/kpi.cjs) (KPI calculations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web and authentication"]
  node_entrypoint["UI bootstrap<br/>[main.js]"]
  node_authgate["Authentication gate<br/>[AuthGate.vue]"]
  node_authui["Login guide<br/>[LoginGuide.vue]"]
end

subgraph group_server["Server and access"]
  node_authroutes["Auth endpoints<br/>[routes.cjs]"]
  node_authservice["Auth service<br/>[service.cjs]"]
  node_authconfig["Auth configuration<br/>[config.cjs]"]
  node_server["HTTP server<br/>[server.js]"]
end

subgraph group_crm["Bitrix24 integration"]
  node_config["Webhook configuration<br/>[config.cjs]"]
  node_client["CRM API client<br/>[client.cjs]"]
  node_deals["CRM deal retrieval<br/>[deals.cjs]"]
  node_details["Deal enrichment<br/>[details.cjs]"]
end

subgraph group_report["Report processing"]
  node_loader["Deal report loader<br/>[load.cjs]"]
  node_expoloader["Exhibition loader<br/>[expo-load.cjs]"]
  node_stages["Property stages"]
  node_filter["Deal filters<br/>[filter.cjs]"]
  node_period["Period calculations<br/>[period.cjs]"]
  node_kpi["KPI calculations<br/>[kpi.cjs]"]
  node_chart["Chart calculations<br/>[chart.cjs]"]
  node_histogram["Histogram calculations<br/>[histogram.cjs]"]
  node_statistics["Statistics calculations<br/>[statistics.cjs]"]
  node_selection["Exhibition selection<br/>[expo-selection.cjs]"]
  node_comparison["Exhibition comparison"]
end

subgraph group_ui["Report interface"]
  node_app["Report app<br/>[App.vue]"]
  node_periodui["Period controls<br/>[PeriodFilter.vue]"]
  node_rangeui["Range inputs<br/>[RangeInputs.vue]"]
  node_histui["Deal histogram<br/>[DealsHistogram.vue]"]
  node_kpiui["KPI chart<br/>[KpiChart.vue]"]
  node_statsui["Statistics panel"]
  node_dealsui["Deals table<br/>[DealsTable.vue]"]
  node_expo_ui["Exhibition view<br/>[ToonExpo.vue]"]
end

node_user(("Report user"))
node_bitrix{{"Bitrix24 CRM"}}

node_user -->|"opens app"| node_authgate
node_entrypoint -->|"mounts"| node_authgate
node_authgate -->|"renders"| node_app
node_authgate -->|"renders"| node_authui
node_authgate -.->|"requests auth"| node_authroutes
node_server -->|"mounts routes"| node_authroutes
node_authroutes -->|"verifies users"| node_authservice
node_server -->|"loads settings"| node_authconfig
node_app -.->|"requests reports"| node_server
node_server -->|"routes report"| node_loader
node_server -->|"routes exhibition"| node_expoloader
node_server -->|"routes stages"| node_stages
node_app -->|"renders controls"| node_periodui
node_app -->|"renders view"| node_expo_ui
node_app -->|"renders chart"| node_histui
node_app -->|"renders panel"| node_statsui
node_app -->|"renders table"| node_dealsui
node_periodui -->|"uses inputs"| node_rangeui
node_loader -->|"loads webhook"| node_config
node_loader -->|"retrieves deals"| node_deals
node_loader -->|"calculates totals"| node_filter
node_loader -->|"enriches deals"| node_details
node_expoloader -->|"loads webhook"| node_config
node_expoloader -->|"requests CRM data"| node_client
node_expoloader -->|"adds details"| node_details
node_expoloader -->|"selects records"| node_selection
node_expoloader -->|"compares deals"| node_comparison
node_client -->|"validates webhook"| node_config
node_client -->|"calls API"| node_bitrix
node_deals -->|"fetches records"| node_client
node_deals -->|"uses enrichment"| node_details
node_kpi -->|"filters deals"| node_filter
node_kpi -->|"uses periods"| node_period
node_kpi -->|"uses amounts"| node_chart
node_histogram -->|"filters deals"| node_filter
node_histogram -->|"uses periods"| node_period
node_statistics -->|"filters deals"| node_filter
node_histui -->|"calculates bins"| node_histogram
node_histui -->|"uses chart logic"| node_chart
node_histui -->|"uses KPI logic"| node_kpi
node_kpiui -->|"calculates KPIs"| node_kpi
node_statsui -->|"calculates stats"| node_statistics
node_statsui -->|"uses KPI logic"| node_kpi
node_expo_ui -->|"selects records"| node_selection

click node_entrypoint "https://github.com/orvvney/report/blob/main/src/ui/main.js"
click node_authgate "https://github.com/orvvney/report/blob/main/src/ui/AuthGate.vue"
click node_authui "https://github.com/orvvney/report/blob/main/src/ui/LoginGuide.vue"
click node_authroutes "https://github.com/orvvney/report/blob/main/src/auth/routes.cjs"
click node_authservice "https://github.com/orvvney/report/blob/main/src/auth/service.cjs"
click node_authconfig "https://github.com/orvvney/report/blob/main/src/auth/config.cjs"
click node_server "https://github.com/orvvney/report/blob/main/server.js"
click node_app "https://github.com/orvvney/report/blob/main/src/ui/App.vue"
click node_periodui "https://github.com/orvvney/report/blob/main/src/ui/PeriodFilter.vue"
click node_rangeui "https://github.com/orvvney/report/blob/main/src/ui/RangeInputs.vue"
click node_histui "https://github.com/orvvney/report/blob/main/src/ui/DealsHistogram.vue"
click node_kpiui "https://github.com/orvvney/report/blob/main/src/ui/KpiChart.vue"
click node_statsui "https://github.com/orvvney/report/blob/main/src/ui/StatisticsPanel.vue"
click node_dealsui "https://github.com/orvvney/report/blob/main/src/ui/DealsTable.vue"
click node_expo_ui "https://github.com/orvvney/report/blob/main/src/ui/ToonExpo.vue"
click node_loader "https://github.com/orvvney/report/blob/main/src/report/load.cjs"
click node_expoloader "https://github.com/orvvney/report/blob/main/src/report/expo-load.cjs"
click node_stages "https://github.com/orvvney/report/blob/main/src/report/property-stages.cjs"
click node_filter "https://github.com/orvvney/report/blob/main/src/report/filter.cjs"
click node_period "https://github.com/orvvney/report/blob/main/src/report/period.cjs"
click node_kpi "https://github.com/orvvney/report/blob/main/src/report/kpi.cjs"
click node_chart "https://github.com/orvvney/report/blob/main/src/report/chart.cjs"
click node_histogram "https://github.com/orvvney/report/blob/main/src/report/histogram.cjs"
click node_statistics "https://github.com/orvvney/report/blob/main/src/report/statistics.cjs"
click node_selection "https://github.com/orvvney/report/blob/main/src/report/expo-selection.cjs"
click node_comparison "https://github.com/orvvney/report/blob/main/src/report/expo-comparison.cjs"
click node_config "https://github.com/orvvney/report/blob/main/src/bitrix24/config.cjs"
click node_client "https://github.com/orvvney/report/blob/main/src/bitrix24/client.cjs"
click node_deals "https://github.com/orvvney/report/blob/main/src/bitrix24/deals.cjs"
click node_details "https://github.com/orvvney/report/blob/main/src/bitrix24/details.cjs"

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_entrypoint,node_authgate,node_authui,node_user toneBlue
class node_authroutes,node_authservice,node_authconfig,node_server toneAmber
class node_config,node_client,node_deals,node_details toneMint
class node_loader,node_expoloader,node_stages,node_filter,node_period,node_kpi,node_chart,node_histogram,node_statistics,node_selection,node_comparison toneRose
class node_app,node_periodui,node_rangeui,node_histui,node_kpiui,node_statsui,node_dealsui,node_expo_ui,node_bitrix toneIndigo
```

## Components

### Web and authentication

- [UI bootstrap](https://github.com/orvvney/report/blob/main/src/ui/main.js): `src/ui/main.js`
- [Authentication gate](https://github.com/orvvney/report/blob/main/src/ui/AuthGate.vue): `src/ui/AuthGate.vue`
- [Login guide](https://github.com/orvvney/report/blob/main/src/ui/LoginGuide.vue): `src/ui/LoginGuide.vue`

### Server and access

- [Auth endpoints](https://github.com/orvvney/report/blob/main/src/auth/routes.cjs): `src/auth/routes.cjs`
- [Auth service](https://github.com/orvvney/report/blob/main/src/auth/service.cjs): `src/auth/service.cjs`
- [Auth configuration](https://github.com/orvvney/report/blob/main/src/auth/config.cjs): `src/auth/config.cjs`
- [HTTP server](https://github.com/orvvney/report/blob/main/server.js): `server.js`

### Bitrix24 integration

- [Webhook configuration](https://github.com/orvvney/report/blob/main/src/bitrix24/config.cjs): `src/bitrix24/config.cjs`
- [CRM API client](https://github.com/orvvney/report/blob/main/src/bitrix24/client.cjs): `src/bitrix24/client.cjs`
- [CRM deal retrieval](https://github.com/orvvney/report/blob/main/src/bitrix24/deals.cjs): `src/bitrix24/deals.cjs`
- [Deal enrichment](https://github.com/orvvney/report/blob/main/src/bitrix24/details.cjs): `src/bitrix24/details.cjs`

### Report processing

- [Deal report loader](https://github.com/orvvney/report/blob/main/src/report/load.cjs): `src/report/load.cjs`
- [Exhibition loader](https://github.com/orvvney/report/blob/main/src/report/expo-load.cjs): `src/report/expo-load.cjs`
- [Property stages](https://github.com/orvvney/report/blob/main/src/report/property-stages.cjs): `src/report/property-stages.cjs`
- [Deal filters](https://github.com/orvvney/report/blob/main/src/report/filter.cjs): `src/report/filter.cjs`
- [Period calculations](https://github.com/orvvney/report/blob/main/src/report/period.cjs): `src/report/period.cjs`
- [KPI calculations](https://github.com/orvvney/report/blob/main/src/report/kpi.cjs): `src/report/kpi.cjs`
- [Chart calculations](https://github.com/orvvney/report/blob/main/src/report/chart.cjs): `src/report/chart.cjs`
- [Histogram calculations](https://github.com/orvvney/report/blob/main/src/report/histogram.cjs): `src/report/histogram.cjs`
- [Statistics calculations](https://github.com/orvvney/report/blob/main/src/report/statistics.cjs): `src/report/statistics.cjs`
- [Exhibition selection](https://github.com/orvvney/report/blob/main/src/report/expo-selection.cjs): `src/report/expo-selection.cjs`
- [Exhibition comparison](https://github.com/orvvney/report/blob/main/src/report/expo-comparison.cjs): `src/report/expo-comparison.cjs`

### Report interface

- [Report app](https://github.com/orvvney/report/blob/main/src/ui/App.vue): `src/ui/App.vue`
- [Period controls](https://github.com/orvvney/report/blob/main/src/ui/PeriodFilter.vue): `src/ui/PeriodFilter.vue`
- [Range inputs](https://github.com/orvvney/report/blob/main/src/ui/RangeInputs.vue): `src/ui/RangeInputs.vue`
- [Deal histogram](https://github.com/orvvney/report/blob/main/src/ui/DealsHistogram.vue): `src/ui/DealsHistogram.vue`
- [KPI chart](https://github.com/orvvney/report/blob/main/src/ui/KpiChart.vue): `src/ui/KpiChart.vue`
- [Statistics panel](https://github.com/orvvney/report/blob/main/src/ui/StatisticsPanel.vue): `src/ui/StatisticsPanel.vue`
- [Deals table](https://github.com/orvvney/report/blob/main/src/ui/DealsTable.vue): `src/ui/DealsTable.vue`
- [Exhibition view](https://github.com/orvvney/report/blob/main/src/ui/ToonExpo.vue): `src/ui/ToonExpo.vue`

### Other components

- **Report user**
- **Bitrix24 CRM**

## Connections

- Report user → Authentication gate: opens app
- UI bootstrap → Authentication gate: mounts (evidence: `src/ui/main.js`)
- Authentication gate → Report app: renders (evidence: `src/ui/AuthGate.vue`)
- Authentication gate → Login guide: renders (evidence: `src/ui/AuthGate.vue`)
- Authentication gate → Auth endpoints: requests auth
- HTTP server → Auth endpoints: mounts routes (evidence: `server.js`)
- Auth endpoints → Auth service: verifies users (evidence: `src/auth/routes.cjs`)
- HTTP server → Auth configuration: loads settings (evidence: `server.js`)
- Report app → HTTP server: requests reports
- HTTP server → Deal report loader: routes report (evidence: `server.js`)
- HTTP server → Exhibition loader: routes exhibition (evidence: `server.js`)
- HTTP server → Property stages: routes stages (evidence: `server.js`)
- Report app → Period controls: renders controls (evidence: `src/ui/App.vue`)
- Report app → Exhibition view: renders view (evidence: `src/ui/App.vue`)
- Report app → Deal histogram: renders chart (evidence: `src/ui/App.vue`)
- Report app → Statistics panel: renders panel (evidence: `src/ui/App.vue`)
- Report app → Deals table: renders table (evidence: `src/ui/App.vue`)
- Period controls → Range inputs: uses inputs (evidence: `src/ui/PeriodFilter.vue`)
- Deal report loader → Webhook configuration: loads webhook (evidence: `src/report/load.cjs`)
- Deal report loader → CRM deal retrieval: retrieves deals (evidence: `src/report/load.cjs`)
- Deal report loader → Deal filters: calculates totals (evidence: `src/report/load.cjs`)
- Deal report loader → Deal enrichment: enriches deals (evidence: `src/report/load.cjs`)
- Exhibition loader → Webhook configuration: loads webhook (evidence: `src/report/expo-load.cjs`)
- Exhibition loader → CRM API client: requests CRM data (evidence: `src/report/expo-load.cjs`)
- Exhibition loader → Deal enrichment: adds details (evidence: `src/report/expo-load.cjs`)
- Exhibition loader → Exhibition selection: selects records (evidence: `src/report/expo-load.cjs`)
- Exhibition loader → Exhibition comparison: compares deals (evidence: `src/report/expo-load.cjs`)
- CRM API client → Webhook configuration: validates webhook (evidence: `src/bitrix24/client.cjs`)
- CRM API client → Bitrix24 CRM: calls API (evidence: `src/bitrix24/client.cjs`)
- CRM deal retrieval → CRM API client: fetches records (evidence: `src/bitrix24/deals.cjs`)
- CRM deal retrieval → Deal enrichment: uses enrichment (evidence: `src/bitrix24/deals.cjs`)
- KPI calculations → Deal filters: filters deals (evidence: `src/report/kpi.cjs`)
- KPI calculations → Period calculations: uses periods (evidence: `src/report/kpi.cjs`)
- KPI calculations → Chart calculations: uses amounts (evidence: `src/report/kpi.cjs`)
- Histogram calculations → Deal filters: filters deals (evidence: `src/report/histogram.cjs`)
- Histogram calculations → Period calculations: uses periods (evidence: `src/report/histogram.cjs`)
- Statistics calculations → Deal filters: filters deals (evidence: `src/report/statistics.cjs`)
- Deal histogram → Histogram calculations: calculates bins (evidence: `src/ui/DealsHistogram.vue`)
- Deal histogram → Chart calculations: uses chart logic (evidence: `src/ui/DealsHistogram.vue`)
- Deal histogram → KPI calculations: uses KPI logic (evidence: `src/ui/DealsHistogram.vue`)
- KPI chart → KPI calculations: calculates KPIs (evidence: `src/ui/KpiChart.vue`)
- Statistics panel → Statistics calculations: calculates stats (evidence: `src/ui/StatisticsPanel.vue`)
- Statistics panel → KPI calculations: uses KPI logic (evidence: `src/ui/StatisticsPanel.vue`)
- Exhibition view → Exhibition selection: selects records (evidence: `src/ui/ToonExpo.vue`)
