How heshamabdelazim/saas-clerk-postgresql-geminiai works
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: prisma.ts Application database · page.tsx Document workspace · documents/route.ts Document API · analyze/route.ts Analysis API
Components 17
App experience
- Sign-in and sign-up
app/(auth)/sign-in/[[...sign-in]]/page.tsx - Organization selection
app/(dashboard)/select-org/page.tsx - Organization dashboard
app/(dashboard)/[orgSlug]/page.tsx - Organization context
app/(dashboard)/[orgSlug]/layout.tsx
Document workflows
- Document workspace
app/(dashboard)/[orgSlug]/documents/page.tsx - Upload dialog
components/document/document-upload-dialog.tsx - Document card
components/document/Document-card.tsx - Analysis and file metadata
app/data/data.ts
Backend services
- Document API
app/api/documents/route.ts - Document detail API
app/api/documents/[documentId]/route.ts - Analysis API
app/api/analyze/route.ts - Organization API
app/api/organizations/route.ts - User synchronization
lib/sync-user.ts
Persistence and AI
- File blob storage
lib/blob.ts - Application database
lib/prisma.ts - Gemini analysis
lib/gemeni.ts
Other components
- Organization member
Connections 18
- 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
app/(dashboard)/[orgSlug]/page.tsx - Organization context → Application database: reads organization
app/(dashboard)/[orgSlug]/layout.tsx - Document workspace → Document API: fetches documents
app/(dashboard)/[orgSlug]/documents/page.tsx - Document workspace → Upload dialog: renders upload dialog
app/(dashboard)/[orgSlug]/documents/page.tsx - Document workspace → Document card: renders document cards
app/(dashboard)/[orgSlug]/documents/page.tsx - Upload dialog → Document API: uploads document
components/document/document-upload-dialog.tsx - Document workspace → Analysis API: requests analysis
- Document API → File blob storage: stores uploaded file
app/api/documents/route.ts - Document API → Application database: reads and writes documents
app/api/documents/route.ts - Document detail API → File blob storage: uses file storage
app/api/documents/[documentId]/route.ts - Document detail API → Application database: accesses documents
app/api/documents/[documentId]/route.ts - Analysis API → Application database: loads and updates document
app/api/analyze/route.ts - Analysis API → Gemini analysis: requests analysis
app/api/analyze/route.ts - Organization API → Application database: accesses organizations
app/api/organizations/route.ts - User synchronization → Application database: synchronizes user
lib/sync-user.ts