# saksham-goel1107/dionysus architecture

> Architecture diagram of the GitHub repository saksham-goel1107/dionysus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saksham-goel1107/dionysus
- Repository: https://github.com/saksham-goel1107/dionysus

## Overview

##### Project Type and Purpose
- Dionysus is a full-stack, enterprise-grade SaaS platform for GitHub analytics and team collaboration.
- It uses Next.js 14 (App Router), React (server + client components), a PostgreSQL database via Prisma, tRPC for type-safe RPC, and integrates AI (Google Gemini Pro, Assembly AI), auth (Clerk), payments (Stripe), media storage (Cloudinary), workflow automation (n8n), monitoring (Sentry & Arcjet), and CI/CD (GitHub Actions & Husky).

##### High-Level File-Structure Analysis
- Top-Level:
- prisma/ — database schema & migrations
- public/ — static assets (licenses, logos, media)
- src/app/ — Next.js App-Router routes, split into (protected) routes, admin, public pages, API under app/api
- src/components/ — shared UI and feature components (Shadcn UI, feedback, logo-generator, etc.)
- src/lib/ — core business logic (AI clients, GitHub loaders, Stripe, Cloudinary, email, rate-limit)
- src/server/ — server-side logic (database connection, tRPC routers)
- src/trpc/ — tRPC client & server glue
- src/hooks/, src/utils/, src/middleware.ts — support layers
- Config & Automation: Dockerfile, .github/workflows, Husky hooks, lint/prettier configs, environment encryption.

##### Architecture Insights from README
- Presentation Layer: Next.js SSR/SSG + React server/client components + TailwindCSS + shadcn/ui
- API Layer:
- Next.js API routes under src/app/api/ for REST endpoints
- tRPC server under src/trpc/server.ts routed via /api/trpc
- Business Logic: src/lib and src/server/api, implementing AI interaction, GitHub ingestion, billing, meetings, surveys.
- Data Layer: PostgreSQL (Prisma ORM), Redis (for rate-limiting), Cloudinary for media.
- External Services: Clerk (auth), Stripe (payments), Google Gemini & Assembly AI (AI features), n8n (workflow automation), Sentry & Arcjet (monitoring/security).
- Deployment & Infrastructure: Vercel Edge (serverless functions), multi-region DB failover, CDN caching.

a. Main Components (group by layer)
- Presentation Layer (Client browsers, mobile):
- Next.js pages & UI
- React Server Components
- Edge & CDN:
- Vercel Edge Network (caching static assets, SSR)
- Application Layer:
- Next.js serverless functions:
– REST API routes
– tRPC endpoints
- Middleware (rate-limit, logging, authentication guard)
- Business Logic Services:
- AI Service connectors (Gemini Pro, Assembly AI)
- GitHub API integration
- Billing & Payments service (Stripe + webhook handlers)
- Media & CDN (Cloudinary)
- Workflow Automation (n8n integration)
- Data Layer:
- PostgreSQL (Prisma)
- Redis (rate-limiting, session caching)
- External Integrations:
- Clerk (Auth & User Metadata)
- Sentry (Error Tracking)
- Arcjet (Security & Rate-limiting)
- n8n (Newsletter & workflow automation)
- GitHub (repository data)
b. Relationships & Data Flows
- Client → Vercel Edge (static files, SSR) → Next.js serverless →
- tRPC / REST endpoints → Business Logic → DB / Redis
- Business Logic → External AI & services → respond back
- Stripe webhooks → Next.js API → Business Logic → DB
- GitHub webhooks / OAuth flows → API → Business Logic
- n8n (external) ↔ Newsletter endpoints
- Monitoring: all layers send metrics/logs to Sentry & Arcjet
c. Architectural Patterns & Principles
- Layered architecture: presentation, API, business logic, data
- API-first, type-safe contracts (tRPC + TypeScript)
- Serverless microservices (function-per-route)
- Modular feature folders under src/app and src/lib
- Secure by design: middleware guards, rate-limiting, audit logging
d. Key Technologies & Frameworks
- Next.js (App Router), React 18, TailwindCSS, shadcn/ui
- tRPC, Prisma, PostgreSQL, Redis
- Clerk, Stripe, Cloudinary, n8n, Gemini Pro AI, Assembly AI
- Vercel Edge, GitHub Actions, Husky, Sentry, Arcjet

##### Final Recommendations
- Be exhaustive: capture each domain (chat, billing, meetings, admin, ai-chat, etc.)
- Critical non-functional aspects: rate-limiting, caching, monitoring
- Iterate with the team in a collaborative tool (e.g., the existing Eraser workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        P1["Next.js App Router\n(src/app/)"]:::presentation
        P2["UI Components\n(src/components/)"]:::presentation
        P3["Global Styles\n(src/styles/globals.css)"]:::presentation
        P4["Tailwind Config\n(tailwind.config.ts)"]:::presentation
    end

    subgraph "Edge & CDN"
        E1["Vercel Edge Network"]:::edge
    end

    subgraph "API Layer"
        subgraph "REST API"
            REST["Next.js API Routes\n(src/app/api/)"]:::api
        end
        subgraph "tRPC API"
            TRPCs["tRPC Server\n(src/trpc/server.ts)"]:::api
            TRPCr["tRPC Client\n(src/trpc/query-client.ts)"]:::api
        end
    end

    subgraph "Business Logic"
        BL1["AI Connectors\n- Gemini\n- Assembly AI"]:::business
        BL2["GitHub Integration"]:::business
        BL3["Billing & Payments"]:::business
        BL4["Media Storage"]:::business
        BL5["Surveys & Newsletters"]:::business
        BL6["Workflow Automation\n(n8n/)"]:::business
        BL7["Rate-Limiting"]:::business
        BL8["Authentication Guard"]:::business
    end

    subgraph "Data Layer"
        DB["PostgreSQL\n(prisma/schema.prisma)"]:::data
        REDIS["Redis\n(src/app/utils/redis.ts)"]:::data
    end

    subgraph "External Services"
        C1["Clerk Auth"]:::external
        C2["Stripe"]:::external
        C3["Cloudinary"]:::external
        C4["Google Gemini"]:::external
        C5["Assembly AI"]:::external
        C6["GitHub"]:::external
        C7["n8n"]:::external
        C8["Sentry & Arcjet"]:::external
    end

    %% Data Flows
    P1 -->|renders pages| E1
    P2 -->|components| E1
    P3 -->|styles| E1
    P4 -->|config| E1

    E1 -->|HTTP| REST
    E1 -->|tRPC call| TRPCs

    REST -->|POST /api/...| BL1
    REST -->|POST /api/...| BL2
    REST -->|POST /api/stripe/webhook| BL3
    REST -->|POST /api/survey/...| BL5
    REST -->|POST /api/newsletter/...| BL5

    TRPCs -->|RPC| BL1
    TRPCs -->|RPC| BL2
    TRPCs -->|RPC| BL3
    TRPCs -->|RPC| BL4
    TRPCs -->|RPC| BL5

    BL1 -->|queries| C4
    BL1 -->|queries| C5
    BL2 -->|OAuth/API| C6
    BL3 -->|payments/webhooks| C2
    BL4 -->|media| C3
    BL5 -->|workflows| C7
    BL6 -->|trigger| C7

    BL1 -->|read/write| DB
    BL2 -->|read/write| DB
    BL3 -->|read/write| DB
    BL5 -->|read/write| DB

    BL7 -->|cache| REDIS
    BL8 -->|guard| REST
    BL8 -->|guard| TRPCs

    %% Monitoring
    REST -->|logs/metrics| C8
    TRPCs -->|logs/metrics| C8
    BL1 -->|logs/metrics| C8
    DB -->|metrics| C8

    %% Click Events
    click P1 "https://github.com/saksham-goel1107/dionysus/tree/main/src/app/"
    click P2 "https://github.com/saksham-goel1107/dionysus/tree/main/src/components/"
    click P3 "https://github.com/saksham-goel1107/dionysus/blob/main/src/styles/globals.css"
    click P4 "https://github.com/saksham-goel1107/dionysus/blob/main/tailwind.config.ts"
    click REST "https://github.com/saksham-goel1107/dionysus/tree/main/src/app/api/"
    click TRPCs "https://github.com/saksham-goel1107/dionysus/blob/main/src/trpc/server.ts"
    click TRPCr "https://github.com/saksham-goel1107/dionysus/blob/main/src/trpc/query-client.ts"
    click BL1 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/gemini.ts"
    click BL1 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/assembly.ts"
    click BL2 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/github-loader.ts"
    click BL3 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/stripe.ts"
    click BL4 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/cloudinary.ts"
    click BL5 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/survey.ts"
    click BL6 "https://github.com/saksham-goel1107/dionysus/tree/main/n8n/"
    click BL7 "https://github.com/saksham-goel1107/dionysus/blob/main/src/lib/rate-limit.ts"
    click BL8 "https://github.com/saksham-goel1107/dionysus/blob/main/src/middleware.ts"
    click DB "https://github.com/saksham-goel1107/dionysus/blob/main/prisma/schema.prisma"
    click REDIS "https://github.com/saksham-goel1107/dionysus/blob/main/src/app/utils/redis.ts"
    click C1 "https://github.com/saksham-goel1107/dionysus/blob/main/src/app/ClerkProviderWithTheme.tsx"
    click C2 "https://github.com/saksham-goel1107/dionysus/tree/main/.github/workflows/"
    click C8 "https://github.com/saksham-goel1107/dionysus/blob/main/sentry.server.config.ts"

    %% Styles
    classDef presentation fill:#D0E8FF,stroke:#036,stroke-width:1px
    classDef edge fill:#E0F7FA,stroke:#006,stroke-width:1px
    classDef api fill:#C8E6C9,stroke:#256,stroke-width:1px
    classDef business fill:#FFE0B2,stroke:#D65,stroke-width:1px
    classDef data fill:#CFD8DC,stroke:#333,stroke-width:1px
    classDef external fill:#E1BEE7,stroke:#732,stroke-width:1px
```
