# alibekhov/online-imzo architecture

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

- Interactive diagram: https://gitdiagram.com/alibekhov/online-imzo
- Repository: https://github.com/alibekhov/online-imzo

## Overview

DocuSign Telegram is a web app for preparing PDF signature requests and collecting signatures through Telegram or a web signing screen. Senders authenticate, upload or generate a sample PDF, place a signature field, and create a request with a QR/deep link; recipients submit a drawn signature and can download the signed PDF. The graph separates the React client, HTTP/API layer, signing services, and persistent data. README content was absent, so capabilities and flow are based on the source index and shown source excerpts; some client/server wiring is inferred from matching API routes.

Main entry points: [`src/App.tsx`](https://github.com/alibekhov/online-imzo/blob/main/src/App.tsx) (App shell), [`src/services/api.ts`](https://github.com/alibekhov/online-imzo/blob/main/src/services/api.ts) (API client), [`server/routes/signing.routes.ts`](https://github.com/alibekhov/online-imzo/blob/main/server/routes/signing.routes.ts) (Signing routes), [`server/db/index.ts`](https://github.com/alibekhov/online-imzo/blob/main/server/db/index.ts) (JSON database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App shell<br/>[App.tsx]"]
  node_auth_ui["Login and register"]
  node_dashboard["Document dashboard<br/>[Dashboard.tsx]"]
  node_upload["PDF upload<br/>[UploadModal.tsx]"]
  node_placement["Signature placement"]
  node_qr_ui["QR display<br/>[QRCodeModal.tsx]"]
  node_sign_ui["Signing screen"]
  node_audit_ui["Audit trail"]
  node_bot_status["Bot status"]
  node_auth_context["Session context<br/>[AuthContext.tsx]"]
end

subgraph group_http["HTTP API"]
  node_api_client["API client<br/>[api.ts]"]
  node_server_app["Express app<br/>[app.ts]"]
  node_route_index["API router<br/>[index.ts]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.ts]"]
  node_document_routes["Document routes<br/>[document.routes.ts]"]
  node_signing_routes["Signing routes<br/>[signing.routes.ts]"]
  node_telegram_routes["Telegram routes<br/>[telegram.routes.ts]"]
end

subgraph group_signing["Signing domain"]
  node_pdf_service["PDF processing<br/>[pdf.service.ts]"]
  node_qr_service["QR generation<br/>[qr.service.ts]"]
  node_telegram_service["Telegram integration"]
end

subgraph group_data["Data and identity"]
  node_auth_middleware["JWT authentication<br/>[auth.ts]"]
  node_database[("JSON database<br/>[index.ts]")]
end

node_sender(("Document sender"))
node_recipient(("Signer"))
node_telegram["Telegram platform"]

node_sender -->|"uses"| node_app
node_app -->|"renders"| node_auth_ui
node_app -->|"renders"| node_dashboard
node_app -->|"opens"| node_upload
node_app -->|"opens"| node_placement
node_app -->|"renders"| node_qr_ui
node_app -->|"renders"| node_sign_ui
node_app -->|"opens"| node_audit_ui
node_app -->|"opens"| node_bot_status
node_app -->|"wraps"| node_auth_context
node_auth_ui -->|"authenticates through"| node_auth_context
node_auth_context -->|"requests session"| node_api_client
node_dashboard -->|"loads documents"| node_api_client
node_upload -->|"uploads PDF"| node_api_client
node_placement -->|"creates request"| node_api_client
node_sign_ui -->|"submits signature"| node_api_client
node_audit_ui -->|"loads audit"| node_api_client
node_bot_status -->|"checks status"| node_api_client
node_api_client -.->|"sends HTTP requests"| node_server_app
node_server_app -->|"initializes"| node_database
node_server_app -->|"mounts API"| node_route_index
node_route_index -->|"registers"| node_auth_routes
node_route_index -->|"registers"| node_document_routes
node_route_index -->|"registers"| node_signing_routes
node_route_index -->|"registers"| node_telegram_routes
node_auth_routes -->|"reads and writes"| node_database
node_document_routes -->|"protects routes"| node_auth_middleware
node_signing_routes -->|"protects routes"| node_auth_middleware
node_auth_middleware -->|"looks up user"| node_database
node_document_routes -->|"reads and writes"| node_database
node_document_routes -->|"inspects and generates PDFs"| node_pdf_service
node_signing_routes -->|"reads and writes"| node_database
node_signing_routes -->|"generates signing QR"| node_qr_service
node_signing_routes -->|"places signature"| node_pdf_service
node_signing_routes -->|"validates Telegram data"| node_telegram_service
node_telegram_routes -->|"looks up request"| node_database
node_telegram_routes -->|"builds bot replies"| node_telegram_service
node_telegram_routes -->|"dispatches bot messages"| node_telegram
node_recipient -->|"opens signing link"| node_app
node_recipient -->|"uses bot or QR"| node_telegram

click node_app "https://github.com/alibekhov/online-imzo/blob/main/src/App.tsx"
click node_auth_ui "https://github.com/alibekhov/online-imzo/blob/main/src/components/auth/LoginRegisterModal.tsx"
click node_dashboard "https://github.com/alibekhov/online-imzo/blob/main/src/components/dashboard/Dashboard.tsx"
click node_upload "https://github.com/alibekhov/online-imzo/blob/main/src/components/upload/UploadModal.tsx"
click node_placement "https://github.com/alibekhov/online-imzo/blob/main/src/components/placement/SignaturePlacementEditor.tsx"
click node_qr_ui "https://github.com/alibekhov/online-imzo/blob/main/src/components/placement/QRCodeModal.tsx"
click node_sign_ui "https://github.com/alibekhov/online-imzo/blob/main/src/components/signing/TelegramSigningScreen.tsx"
click node_audit_ui "https://github.com/alibekhov/online-imzo/blob/main/src/components/audit/AuditTrailModal.tsx"
click node_bot_status "https://github.com/alibekhov/online-imzo/blob/main/src/components/telegram/TelegramBotStatusModal.tsx"
click node_auth_context "https://github.com/alibekhov/online-imzo/blob/main/src/context/AuthContext.tsx"
click node_api_client "https://github.com/alibekhov/online-imzo/blob/main/src/services/api.ts"
click node_server_app "https://github.com/alibekhov/online-imzo/blob/main/server/app.ts"
click node_route_index "https://github.com/alibekhov/online-imzo/blob/main/server/routes/index.ts"
click node_auth_routes "https://github.com/alibekhov/online-imzo/blob/main/server/routes/auth.routes.ts"
click node_document_routes "https://github.com/alibekhov/online-imzo/blob/main/server/routes/document.routes.ts"
click node_signing_routes "https://github.com/alibekhov/online-imzo/blob/main/server/routes/signing.routes.ts"
click node_telegram_routes "https://github.com/alibekhov/online-imzo/blob/main/server/routes/telegram.routes.ts"
click node_auth_middleware "https://github.com/alibekhov/online-imzo/blob/main/server/middleware/auth.ts"
click node_database "https://github.com/alibekhov/online-imzo/blob/main/server/db/index.ts"
click node_pdf_service "https://github.com/alibekhov/online-imzo/blob/main/server/services/pdf.service.ts"
click node_qr_service "https://github.com/alibekhov/online-imzo/blob/main/server/services/qr.service.ts"
click node_telegram_service "https://github.com/alibekhov/online-imzo/blob/main/server/services/telegram.service.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_auth_ui,node_dashboard,node_upload,node_placement,node_qr_ui,node_sign_ui,node_audit_ui,node_bot_status,node_auth_context toneBlue
class node_api_client,node_server_app,node_route_index,node_auth_routes,node_document_routes,node_signing_routes,node_telegram_routes toneAmber
class node_pdf_service,node_qr_service,node_telegram_service toneMint
class node_auth_middleware,node_database toneRose
class node_sender,node_recipient,node_telegram toneIndigo
```

## Components

### Web client

- [App shell](https://github.com/alibekhov/online-imzo/blob/main/src/App.tsx): `src/App.tsx`
- [Login and register](https://github.com/alibekhov/online-imzo/blob/main/src/components/auth/LoginRegisterModal.tsx): `src/components/auth/LoginRegisterModal.tsx`
- [Document dashboard](https://github.com/alibekhov/online-imzo/blob/main/src/components/dashboard/Dashboard.tsx): `src/components/dashboard/Dashboard.tsx`
- [PDF upload](https://github.com/alibekhov/online-imzo/blob/main/src/components/upload/UploadModal.tsx): `src/components/upload/UploadModal.tsx`
- [Signature placement](https://github.com/alibekhov/online-imzo/blob/main/src/components/placement/SignaturePlacementEditor.tsx): `src/components/placement/SignaturePlacementEditor.tsx`
- [QR display](https://github.com/alibekhov/online-imzo/blob/main/src/components/placement/QRCodeModal.tsx): `src/components/placement/QRCodeModal.tsx`
- [Signing screen](https://github.com/alibekhov/online-imzo/blob/main/src/components/signing/TelegramSigningScreen.tsx): `src/components/signing/TelegramSigningScreen.tsx`
- [Audit trail](https://github.com/alibekhov/online-imzo/blob/main/src/components/audit/AuditTrailModal.tsx): `src/components/audit/AuditTrailModal.tsx`
- [Bot status](https://github.com/alibekhov/online-imzo/blob/main/src/components/telegram/TelegramBotStatusModal.tsx): `src/components/telegram/TelegramBotStatusModal.tsx`
- [Session context](https://github.com/alibekhov/online-imzo/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`

### HTTP API

- [API client](https://github.com/alibekhov/online-imzo/blob/main/src/services/api.ts): `src/services/api.ts`
- [Express app](https://github.com/alibekhov/online-imzo/blob/main/server/app.ts): `server/app.ts`
- [API router](https://github.com/alibekhov/online-imzo/blob/main/server/routes/index.ts): `server/routes/index.ts`
- [Authentication routes](https://github.com/alibekhov/online-imzo/blob/main/server/routes/auth.routes.ts): `server/routes/auth.routes.ts`
- [Document routes](https://github.com/alibekhov/online-imzo/blob/main/server/routes/document.routes.ts): `server/routes/document.routes.ts`
- [Signing routes](https://github.com/alibekhov/online-imzo/blob/main/server/routes/signing.routes.ts): `server/routes/signing.routes.ts`
- [Telegram routes](https://github.com/alibekhov/online-imzo/blob/main/server/routes/telegram.routes.ts): `server/routes/telegram.routes.ts`

### Signing domain

- [PDF processing](https://github.com/alibekhov/online-imzo/blob/main/server/services/pdf.service.ts): `server/services/pdf.service.ts`
- [QR generation](https://github.com/alibekhov/online-imzo/blob/main/server/services/qr.service.ts): `server/services/qr.service.ts`
- [Telegram integration](https://github.com/alibekhov/online-imzo/blob/main/server/services/telegram.service.ts): `server/services/telegram.service.ts`

### Data and identity

- [JWT authentication](https://github.com/alibekhov/online-imzo/blob/main/server/middleware/auth.ts): `server/middleware/auth.ts`
- [JSON database](https://github.com/alibekhov/online-imzo/blob/main/server/db/index.ts): `server/db/index.ts`

### Other components

- **Document sender**
- **Signer**
- **Telegram platform**

## Connections

- Document sender → App shell: uses (evidence: `src/App.tsx`)
- App shell → Login and register: renders (evidence: `src/App.tsx`)
- App shell → Document dashboard: renders (evidence: `src/App.tsx`)
- App shell → PDF upload: opens (evidence: `src/App.tsx`)
- App shell → Signature placement: opens (evidence: `src/App.tsx`)
- App shell → QR display: renders (evidence: `src/App.tsx`)
- App shell → Signing screen: renders (evidence: `src/App.tsx`)
- App shell → Audit trail: opens (evidence: `src/App.tsx`)
- App shell → Bot status: opens (evidence: `src/App.tsx`)
- App shell → Session context: wraps (evidence: `src/App.tsx`)
- Login and register → Session context: authenticates through (evidence: `src/components/auth/LoginRegisterModal.tsx`)
- Session context → API client: requests session (evidence: `src/context/AuthContext.tsx`)
- Document dashboard → API client: loads documents (evidence: `src/components/dashboard/Dashboard.tsx`)
- PDF upload → API client: uploads PDF (evidence: `src/components/upload/UploadModal.tsx`)
- Signature placement → API client: creates request (evidence: `src/components/placement/SignaturePlacementEditor.tsx`)
- Signing screen → API client: submits signature (evidence: `src/components/signing/TelegramSigningScreen.tsx`)
- Audit trail → API client: loads audit (evidence: `src/components/audit/AuditTrailModal.tsx`)
- Bot status → API client: checks status (evidence: `src/components/telegram/TelegramBotStatusModal.tsx`)
- API client → Express app: sends HTTP requests
- Express app → JSON database: initializes (evidence: `server/app.ts`)
- Express app → API router: mounts API (evidence: `server/app.ts`)
- API router → Authentication routes: registers (evidence: `server/routes/index.ts`)
- API router → Document routes: registers (evidence: `server/routes/index.ts`)
- API router → Signing routes: registers (evidence: `server/routes/index.ts`)
- API router → Telegram routes: registers (evidence: `server/routes/index.ts`)
- Authentication routes → JSON database: reads and writes (evidence: `server/routes/auth.routes.ts`)
- Document routes → JWT authentication: protects routes (evidence: `server/routes/document.routes.ts`)
- Signing routes → JWT authentication: protects routes (evidence: `server/routes/signing.routes.ts`)
- JWT authentication → JSON database: looks up user (evidence: `server/middleware/auth.ts`)
- Document routes → JSON database: reads and writes (evidence: `server/routes/document.routes.ts`)
- Document routes → PDF processing: inspects and generates PDFs (evidence: `server/routes/document.routes.ts`)
- Signing routes → JSON database: reads and writes (evidence: `server/routes/signing.routes.ts`)
- Signing routes → QR generation: generates signing QR (evidence: `server/routes/signing.routes.ts`)
- Signing routes → PDF processing: places signature (evidence: `server/routes/signing.routes.ts`)
- Signing routes → Telegram integration: validates Telegram data (evidence: `server/routes/signing.routes.ts`)
- Telegram routes → JSON database: looks up request (evidence: `server/routes/telegram.routes.ts`)
- Telegram routes → Telegram integration: builds bot replies (evidence: `server/routes/telegram.routes.ts`)
- Telegram routes → Telegram platform: dispatches bot messages (evidence: `server/routes/telegram.routes.ts`)
- Signer → App shell: opens signing link (evidence: `src/App.tsx`)
- Signer → Telegram platform: uses bot or QR
