# heshamabdelazim/saas-clerk-postgresql-geminiai architecture

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

- Interactive diagram: https://gitdiagram.com/heshamabdelazim/saas-clerk-postgresql-geminiai
- Repository: https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai

## Overview

This is a multi-tenant document-management app with organization dashboards and Gemini-powered document analysis. The main flow is organization members uploading files, browsing documents, requesting analysis, and viewing saved insights. The excerpts show upload and analysis API behavior, database access, and blob storage; the README is only the default Next.js template and documents no additional product capabilities. Some routes and client handlers were not sampled, so their links are omitted or marked unverified.

Main entry points: [`lib/prisma.ts`](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/prisma.ts) (Application database), [`app/(dashboard)/[orgSlug]/documents/page.tsx`](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/documents/page.tsx) (Document workspace), [`app/api/documents/route.ts`](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/documents/route.ts) (Document API), [`app/api/analyze/route.ts`](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/analyze/route.ts) (Analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_authpages["Sign-in and sign-up<br/>[page.tsx]"]
  node_orgselection["Organization selection<br/>[page.tsx]"]
  node_orgdashboard["Organization dashboard<br/>[page.tsx]"]
  node_orgshell["Organization context<br/>[layout.tsx]"]
end

subgraph group_documents["Document workflows"]
  node_docspage["Document workspace<br/>[page.tsx]"]
  node_uploader["Upload dialog"]
  node_doccard["Document card<br/>[Document-card.tsx]"]
  node_productdata["Analysis and file metadata<br/>[data.ts]"]
end

subgraph group_services["Backend services"]
  node_docapi["Document API<br/>[route.ts]"]
  node_docdetailapi["Document detail API<br/>[route.ts]"]
  node_analyzeapi["Analysis API<br/>[route.ts]"]
  node_orgapi["Organization API<br/>[route.ts]"]
  node_usersync["User synchronization<br/>[sync-user.ts]"]
end

subgraph group_data["Persistence and AI"]
  node_blobstore[("File blob storage<br/>[blob.ts]")]
  node_database[("Application database<br/>[prisma.ts]")]
  node_gemini["Gemini analysis<br/>[gemeni.ts]"]
end

node_member(("Organization member"))

node_member -->|"signs in"| node_authpages
node_member -->|"selects organization"| node_orgselection
node_member -->|"manages documents"| node_docspage
node_orgdashboard -->|"reads organization data"| node_database
node_orgshell -->|"reads organization"| node_database
node_docspage -->|"fetches documents"| node_docapi
node_docspage -->|"renders upload dialog"| node_uploader
node_docspage -->|"renders document cards"| node_doccard
node_uploader -->|"uploads document"| node_docapi
node_docspage -.->|"requests analysis"| node_analyzeapi
node_docapi -->|"stores uploaded file"| node_blobstore
node_docapi -->|"reads and writes documents"| node_database
node_docdetailapi -->|"uses file storage"| node_blobstore
node_docdetailapi -->|"accesses documents"| node_database
node_analyzeapi -->|"loads and updates document"| node_database
node_analyzeapi -->|"requests analysis"| node_gemini
node_orgapi -->|"accesses organizations"| node_database
node_usersync -->|"synchronizes user"| node_database

click node_authpages "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_orgselection "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/select-org/page.tsx"
click node_orgdashboard "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/page.tsx"
click node_orgshell "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/layout.tsx"
click node_docspage "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/documents/page.tsx"
click node_uploader "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/components/document/document-upload-dialog.tsx"
click node_doccard "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/components/document/Document-card.tsx"
click node_docapi "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/documents/route.ts"
click node_docdetailapi "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/documents/%5BdocumentId%5D/route.ts"
click node_analyzeapi "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/analyze/route.ts"
click node_orgapi "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/organizations/route.ts"
click node_usersync "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/sync-user.ts"
click node_blobstore "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/blob.ts"
click node_database "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/prisma.ts"
click node_gemini "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/gemeni.ts"
click node_productdata "https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/data/data.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_authpages,node_orgselection,node_orgdashboard,node_orgshell toneBlue
class node_docspage,node_uploader,node_doccard,node_productdata toneAmber
class node_docapi,node_docdetailapi,node_analyzeapi,node_orgapi,node_usersync toneMint
class node_blobstore,node_database,node_gemini toneRose
class node_member toneIndigo
```

## Components

### App experience

- [Sign-in and sign-up](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `app/(auth)/sign-in/[[...sign-in]]/page.tsx`
- [Organization selection](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/select-org/page.tsx): `app/(dashboard)/select-org/page.tsx`
- [Organization dashboard](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/page.tsx): `app/(dashboard)/[orgSlug]/page.tsx`
- [Organization context](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/layout.tsx): `app/(dashboard)/[orgSlug]/layout.tsx`

### Document workflows

- [Document workspace](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/(dashboard)/%5BorgSlug%5D/documents/page.tsx): `app/(dashboard)/[orgSlug]/documents/page.tsx`
- [Upload dialog](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/components/document/document-upload-dialog.tsx): `components/document/document-upload-dialog.tsx`
- [Document card](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/components/document/Document-card.tsx): `components/document/Document-card.tsx`
- [Analysis and file metadata](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/data/data.ts): `app/data/data.ts`

### Backend services

- [Document API](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/documents/route.ts): `app/api/documents/route.ts`
- [Document detail API](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/documents/%5BdocumentId%5D/route.ts): `app/api/documents/[documentId]/route.ts`
- [Analysis API](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/analyze/route.ts): `app/api/analyze/route.ts`
- [Organization API](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/app/api/organizations/route.ts): `app/api/organizations/route.ts`
- [User synchronization](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/sync-user.ts): `lib/sync-user.ts`

### Persistence and AI

- [File blob storage](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/blob.ts): `lib/blob.ts`
- [Application database](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/prisma.ts): `lib/prisma.ts`
- [Gemini analysis](https://github.com/heshamabdelazim/saas-clerk-postgresql-geminiai/blob/master/lib/gemeni.ts): `lib/gemeni.ts`

### Other components

- **Organization member**

## Connections

- Organization member → Sign-in and sign-up: signs in
- Organization member → Organization selection: selects organization
- Organization member → Document workspace: manages documents
- Organization dashboard → Application database: reads organization data (evidence: `app/(dashboard)/[orgSlug]/page.tsx`)
- Organization context → Application database: reads organization (evidence: `app/(dashboard)/[orgSlug]/layout.tsx`)
- Document workspace → Document API: fetches documents (evidence: `app/(dashboard)/[orgSlug]/documents/page.tsx`)
- Document workspace → Upload dialog: renders upload dialog (evidence: `app/(dashboard)/[orgSlug]/documents/page.tsx`)
- Document workspace → Document card: renders document cards (evidence: `app/(dashboard)/[orgSlug]/documents/page.tsx`)
- Upload dialog → Document API: uploads document (evidence: `components/document/document-upload-dialog.tsx`)
- Document workspace → Analysis API: requests analysis
- Document API → File blob storage: stores uploaded file (evidence: `app/api/documents/route.ts`)
- Document API → Application database: reads and writes documents (evidence: `app/api/documents/route.ts`)
- Document detail API → File blob storage: uses file storage (evidence: `app/api/documents/[documentId]/route.ts`)
- Document detail API → Application database: accesses documents (evidence: `app/api/documents/[documentId]/route.ts`)
- Analysis API → Application database: loads and updates document (evidence: `app/api/analyze/route.ts`)
- Analysis API → Gemini analysis: requests analysis (evidence: `app/api/analyze/route.ts`)
- Organization API → Application database: accesses organizations (evidence: `app/api/organizations/route.ts`)
- User synchronization → Application database: synchronizes user (evidence: `lib/sync-user.ts`)
