# nati-13/docunexa- architecture

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

- Interactive diagram: https://gitdiagram.com/nati-13/docunexa-
- Repository: https://github.com/nati-13/docunexa-

## Overview

DocuNexa is a browser-based PDF and document workspace, with account, ad-free payment, support, and administration services alongside its core tools. The principal workflow is selecting a tool, loading a document, processing it in the browser, and receiving a downloadable result; the PDF Unit Cutter adds detection and review of textbook sections before slicing. The README documents the client-side model and tool capabilities, while sampled code confirms selected PDF-engine, authentication, payment-order, and admin data paths. Many tool implementations and UI connections were not sampled, so uncertain links are omitted.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/nati-13/docunexa-/blob/main/src/lib/supabase/server.ts) (Supabase data), [`src/app/api/auth`](https://github.com/nati-13/docunexa-/tree/main/src/app/api/auth) (Auth endpoints), [`src/app/api/payments/create-order/route.ts`](https://github.com/nati-13/docunexa-/blob/main/src/app/api/payments/create-order/route.ts) (Payment orders), [`src/app/api/admin/overview/route.ts`](https://github.com/nati-13/docunexa-/blob/main/src/app/api/admin/overview/route.ts) (Admin endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["PDF workspace"]
  node_toolui["PDF tool UI"]
  node_pdfengine["PDF engine<br/>[pdfEngine.ts]"]
  node_pdfreader["PDF reader<br/>[pdfReader.ts]"]
  node_download["Download contract"]
  node_cutterui["Unit Cutter UI<br/>[page.tsx]"]
  node_cutter["Unit detection<br/>[cutter.ts]"]
  node_detector["Structure detection"]
  node_toolengines["Specialist engines"]
end

subgraph group_accounts["Accounts and payments"]
  node_authui["Account UI<br/>[AuthContext.tsx]"]
  node_authapi["Auth endpoints"]
  node_authservice["Auth service<br/>[index.ts]"]
  node_supabase[("Supabase data<br/>[server.ts]")]
  node_paymentapi["Payment orders<br/>[route.ts]"]
  node_paymentlogic["Payment matching<br/>[bybit.ts]"]
end

subgraph group_operations["Platform operations"]
  node_adminapi["Admin endpoints<br/>[route.ts]"]
  node_adminauth["Admin authorization<br/>[auth.ts]"]
  node_support["Support<br/>[route.ts]"]
  node_telegram["Telegram bot<br/>[bot.ts]"]
  node_guard["API protection<br/>[apiGuard.ts]"]
end

subgraph group_discovery["Discovery and engagement"]
  node_catalog["Tool catalog<br/>[tools.ts]"]
  node_toolroute["Tool pages<br/>[page.tsx]"]
  node_analytics["Analytics<br/>[tracker.ts]"]
end

node_user(("User"))

node_user -->|"chooses tool"| node_catalog
node_catalog -.->|"opens tool"| node_toolroute
node_toolroute -.->|"presents tool"| node_toolui
node_toolui -.->|"processes locally"| node_pdfengine
node_pdfengine -->|"reads PDF"| node_pdfreader
node_pdfengine -->|"sanitizes filenames"| node_download
node_user -->|"opens cutter"| node_cutterui
node_cutterui -.->|"detects sections"| node_cutter
node_cutter -.->|"uses structure"| node_detector
node_toolui -.->|"runs tools"| node_toolengines
node_user -.->|"uses account"| node_authui
node_authui -->|"creates client"| node_supabase
node_authui -->|"requests session"| node_authapi
node_authapi -->|"validates email"| node_authservice
node_authapi -->|"creates account"| node_supabase
node_authapi -->|"guards requests"| node_guard
node_user -.->|"starts payment"| node_paymentapi
node_paymentapi -->|"reads profile, stores order"| node_supabase
node_paymentapi -->|"creates unique amount"| node_paymentlogic
node_paymentapi -->|"guards requests"| node_guard
node_adminapi -->|"requires admin"| node_adminauth
node_adminapi -->|"queries metrics"| node_supabase
node_adminapi -->|"gets summary"| node_analytics
node_user -.->|"submits request"| node_support
node_support -.->|"stores ticket"| node_supabase
node_support -.->|"notifies"| node_telegram

click node_catalog "https://github.com/nati-13/docunexa-/blob/main/src/config/tools.ts"
click node_toolroute "https://github.com/nati-13/docunexa-/blob/main/src/app/tools/%5Bslug%5D/page.tsx"
click node_toolui "https://github.com/nati-13/docunexa-/tree/main/src/components/tools"
click node_pdfengine "https://github.com/nati-13/docunexa-/blob/main/src/lib/pdfEngine.ts"
click node_pdfreader "https://github.com/nati-13/docunexa-/blob/main/src/lib/pdfReader.ts"
click node_download "https://github.com/nati-13/docunexa-/blob/main/src/lib/downloadContract.ts"
click node_cutterui "https://github.com/nati-13/docunexa-/blob/main/src/app/tools/pdf-unit-cutter/page.tsx"
click node_cutter "https://github.com/nati-13/docunexa-/blob/main/src/lib/cutter.ts"
click node_detector "https://github.com/nati-13/docunexa-/blob/main/src/lib/structureDetector.ts"
click node_toolengines "https://github.com/nati-13/docunexa-/tree/main/src/lib/tools"
click node_authui "https://github.com/nati-13/docunexa-/blob/main/src/context/AuthContext.tsx"
click node_authapi "https://github.com/nati-13/docunexa-/tree/main/src/app/api/auth"
click node_authservice "https://github.com/nati-13/docunexa-/blob/main/src/lib/auth/index.ts"
click node_supabase "https://github.com/nati-13/docunexa-/blob/main/src/lib/supabase/server.ts"
click node_paymentapi "https://github.com/nati-13/docunexa-/blob/main/src/app/api/payments/create-order/route.ts"
click node_paymentlogic "https://github.com/nati-13/docunexa-/blob/main/src/lib/payments/bybit.ts"
click node_adminapi "https://github.com/nati-13/docunexa-/blob/main/src/app/api/admin/overview/route.ts"
click node_adminauth "https://github.com/nati-13/docunexa-/blob/main/src/lib/admin/auth.ts"
click node_analytics "https://github.com/nati-13/docunexa-/blob/main/src/lib/analytics/tracker.ts"
click node_support "https://github.com/nati-13/docunexa-/blob/main/src/app/api/support/route.ts"
click node_telegram "https://github.com/nati-13/docunexa-/blob/main/src/lib/telegram/bot.ts"
click node_guard "https://github.com/nati-13/docunexa-/blob/main/src/lib/security/apiGuard.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_toolui,node_pdfengine,node_pdfreader,node_download,node_cutterui,node_cutter,node_detector,node_toolengines,node_user toneBlue
class node_authui,node_authapi,node_authservice,node_supabase,node_paymentapi,node_paymentlogic toneAmber
class node_adminapi,node_adminauth,node_support,node_telegram,node_guard toneMint
class node_catalog,node_toolroute,node_analytics toneRose
```

## Components

### PDF workspace

- [PDF tool UI](https://github.com/nati-13/docunexa-/tree/main/src/components/tools): `src/components/tools`
- [PDF engine](https://github.com/nati-13/docunexa-/blob/main/src/lib/pdfEngine.ts): `src/lib/pdfEngine.ts`
- [PDF reader](https://github.com/nati-13/docunexa-/blob/main/src/lib/pdfReader.ts): `src/lib/pdfReader.ts`
- [Download contract](https://github.com/nati-13/docunexa-/blob/main/src/lib/downloadContract.ts): `src/lib/downloadContract.ts`
- [Unit Cutter UI](https://github.com/nati-13/docunexa-/blob/main/src/app/tools/pdf-unit-cutter/page.tsx): `src/app/tools/pdf-unit-cutter/page.tsx`
- [Unit detection](https://github.com/nati-13/docunexa-/blob/main/src/lib/cutter.ts): `src/lib/cutter.ts`
- [Structure detection](https://github.com/nati-13/docunexa-/blob/main/src/lib/structureDetector.ts): `src/lib/structureDetector.ts`
- [Specialist engines](https://github.com/nati-13/docunexa-/tree/main/src/lib/tools): `src/lib/tools`

### Accounts and payments

- [Account UI](https://github.com/nati-13/docunexa-/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Auth endpoints](https://github.com/nati-13/docunexa-/tree/main/src/app/api/auth): `src/app/api/auth`
- [Auth service](https://github.com/nati-13/docunexa-/blob/main/src/lib/auth/index.ts): `src/lib/auth/index.ts`
- [Supabase data](https://github.com/nati-13/docunexa-/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Payment orders](https://github.com/nati-13/docunexa-/blob/main/src/app/api/payments/create-order/route.ts): `src/app/api/payments/create-order/route.ts`
- [Payment matching](https://github.com/nati-13/docunexa-/blob/main/src/lib/payments/bybit.ts): `src/lib/payments/bybit.ts`

### Platform operations

- [Admin endpoints](https://github.com/nati-13/docunexa-/blob/main/src/app/api/admin/overview/route.ts): `src/app/api/admin/overview/route.ts`
- [Admin authorization](https://github.com/nati-13/docunexa-/blob/main/src/lib/admin/auth.ts): `src/lib/admin/auth.ts`
- [Support](https://github.com/nati-13/docunexa-/blob/main/src/app/api/support/route.ts): `src/app/api/support/route.ts`
- [Telegram bot](https://github.com/nati-13/docunexa-/blob/main/src/lib/telegram/bot.ts): `src/lib/telegram/bot.ts`
- [API protection](https://github.com/nati-13/docunexa-/blob/main/src/lib/security/apiGuard.ts): `src/lib/security/apiGuard.ts`

### Discovery and engagement

- [Tool catalog](https://github.com/nati-13/docunexa-/blob/main/src/config/tools.ts): `src/config/tools.ts`
- [Tool pages](https://github.com/nati-13/docunexa-/blob/main/src/app/tools/%5Bslug%5D/page.tsx): `src/app/tools/[slug]/page.tsx`
- [Analytics](https://github.com/nati-13/docunexa-/blob/main/src/lib/analytics/tracker.ts): `src/lib/analytics/tracker.ts`

### Other components

- **User**

## Connections

- User → Tool catalog: chooses tool (evidence: `README.md`)
- Tool catalog → Tool pages: opens tool
- Tool pages → PDF tool UI: presents tool
- PDF tool UI → PDF engine: processes locally
- PDF engine → PDF reader: reads PDF (evidence: `src/lib/pdfEngine.ts`)
- PDF engine → Download contract: sanitizes filenames (evidence: `src/lib/pdfEngine.ts`)
- User → Unit Cutter UI: opens cutter (evidence: `README.md`)
- Unit Cutter UI → Unit detection: detects sections
- Unit detection → Structure detection: uses structure
- PDF tool UI → Specialist engines: runs tools
- User → Account UI: uses account
- Account UI → Supabase data: creates client (evidence: `src/context/AuthContext.tsx`)
- Account UI → Auth endpoints: requests session (evidence: `src/context/AuthContext.tsx`)
- Auth endpoints → Auth service: validates email (evidence: `src/app/api/auth/signup/route.ts`)
- Auth endpoints → Supabase data: creates account (evidence: `src/app/api/auth/signup/route.ts`)
- Auth endpoints → API protection: guards requests (evidence: `src/app/api/auth/signup/route.ts`)
- User → Payment orders: starts payment
- Payment orders → Supabase data: reads profile, stores order (evidence: `src/app/api/payments/create-order/route.ts`)
- Payment orders → Payment matching: creates unique amount (evidence: `src/app/api/payments/create-order/route.ts`)
- Payment orders → API protection: guards requests (evidence: `src/app/api/payments/create-order/route.ts`)
- Admin endpoints → Admin authorization: requires admin (evidence: `src/app/api/admin/overview/route.ts`)
- Admin endpoints → Supabase data: queries metrics (evidence: `src/app/api/admin/overview/route.ts`)
- Admin endpoints → Analytics: gets summary (evidence: `src/app/api/admin/overview/route.ts`)
- User → Support: submits request
- Support → Supabase data: stores ticket (evidence: `src/app/api/support/route.ts`)
- Support → Telegram bot: notifies (evidence: `src/app/api/support/route.ts`)
