# itzsupra13/origyn_ai architecture

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

- Interactive diagram: https://gitdiagram.com/itzsupra13/origyn_ai
- Repository: https://github.com/itzsupra13/origyn_ai

## Overview

##### Project type and purpose
- This is a full-stack Next.js application with TypeScript.
- It uses Prisma for database access, tRPC for type-safe RPC calls between client and server, and Inngest for background/event functions.
- UI components are organized under `src/components/ui` and domain modules under `src/modules`.

##### File structure
- Top-level directories:
- `src/app`: Next.js app-router pages and layout.
- `src/components`: shared presentational components (UI primitives).
- `src/modules`: domain-specific UI and server procedures for “projects” and “messages.”
- `src/trpc`: client & server setup and router definitions.
- `src/inngest`: background/event function client, utils, definitions.
- `src/lib`: reusable utilities, database client (`db.ts`).
- `prisma` + `generated/prisma`: schema, migrations, and generated Prisma client.
- `public`, `sandbox-templates`: static assets and Docker/TOML templates for sandboxing.
- Config/build files: `next.config.ts`, `tsconfig.json`, `postcss.config.mjs`, `eslint.config.mjs`, `package.json`.

##### README
- Confirms this is a Next.js app bootstrapped via `create-next-app`.
- Default instructions for local development and Vercel deployment.

##### Components
a. Frontend (Next.js App)
- `src/app`: routes, layouts, pages (e.g., `/projects/[projectId]`).
- `src/components` + `src/modules/*/ui`: UI primitives & domain views.
b. API layer (tRPC)
- Client: `src/trpc/client.tsx`, `src/trpc/query-client.ts`
- Server: API route at `src/app/api/trpc/[trpc]/route.ts`
- Routers: `src/trpc/routers/_app.ts` + domain routers in `src/modules/*/server/procedures.ts`.
c. Background/Event Functions (Inngest)
- API route at `src/app/api/inngest/route.ts`
- Function definitions in `src/inngest/functions.ts` and utilities.
d. Database (Prisma)
- Schema: `prisma/schema.prisma` + migrations
- Generated client: `generated/prisma/client.js` used by `src/lib/db.ts`
e. External services
- Vercel (deployment platform)
- Any other third-party integrations (e.g., external APIs if present)

##### Relationships & interactions
- Browser → Next.js Frontend
- User navigates pages under `src/app`.
- UI components render and call tRPC hooks for data.
- Frontend ↔ tRPC API
- tRPC client sends RPCs over the API route to server procedures.
- tRPC Server → Prisma Client
- RPC handlers in `src/modules/*/server` import `db` from `src/lib/db.ts` which uses Prisma.
- Inngest API → Inngest Functions
- Events posted to `/api/inngest` route → `src/inngest/functions.ts` workflows → may also call Prisma or external APIs.
- Prisma → Database
- Generated query engine (WASM / Node) executes against the SQL database.
- Deployment
- Vercel hosts Next.js, including API routes and Inngest serverless functions.

##### Architectural patterns & principles
- Monorepo-style organization: separation of UI, domain modules, API, and infra.
- Clean layering:
- Presentation (Next.js + UI components)
- Application/API (tRPC routers & handlers)
- Domain logic (server procedures in modules)
- Persistence (Prisma + DB)
- Background/event processing (Inngest)
- Type safety end-to-end (TypeScript + tRPC + Prisma types).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend Layer"
        Browser["Browser"]:::frontend
        NextJS["Next.js Frontend\n(src/app)"]:::frontend
        UIPrimitives["UI Primitives\n(src/components/ui)"]:::frontend
        DomainUI["Projects UI\n(src/modules/projects/ui)"]:::frontend
    end

    subgraph "API Layer"
        TRPCClient["tRPC Client\n(src/trpc/client.tsx,\nquery-client.ts,\ninit.ts)"]:::api
        TRPCRoute["tRPC API Route\n(src/app/api/trpc/[trpc]/route.ts)"]:::api
        TRPCRouter["tRPC Router\n(src/trpc/routers/_app.ts)"]:::api
        ProjectsProc["Projects Procedures\n(src/modules/projects/server/procedures.ts)"]:::api
        MessagesProc["Messages Procedures\n(src/modules/messages/server/procedures.ts)"]:::api
    end

    subgraph "Background / Async"
        InngestRoute["Inngest API Route\n(src/app/api/inngest/route.ts)"]:::background
        InngestFuncs["Inngest Functions\n(src/inngest/functions.ts)"]:::background
        InngestClient["Inngest Client & Utils\n(src/inngest/client.ts,\nutils.ts)"]:::background
    end

    subgraph "Persistence Layer"
        PrismaClient["Prisma Client\n(generated/prisma)\nvia src/lib/db.ts"]:::db
        DB["SQL Database"]:::db
    end

    subgraph "Deployment / External"
        Vercel["Vercel"]:::external
    end

    Browser -->|"HTTP"| NextJS
    NextJS -->|"renders uses"| UIPrimitives
    NextJS -->|"renders uses"| DomainUI
    NextJS -->|"RPC calls"| TRPCClient

    TRPCClient -->|"HTTP RPC"| TRPCRoute
    TRPCRoute -->|"routes to"| TRPCRouter
    TRPCRouter -->|"handles Projects"| ProjectsProc
    TRPCRouter -->|"handles Messages"| MessagesProc
    ProjectsProc -->|"DB query"| PrismaClient
    MessagesProc -->|"DB query"| PrismaClient

    NextJS -->|"Event POST"| InngestRoute
    InngestRoute -->|"triggers"| InngestFuncs
    InngestFuncs -->|"uses client"| InngestClient
    InngestFuncs -->|"DB query"| PrismaClient

    PrismaClient -->|"executes SQL"| DB

    Vercel -. hosts .-> NextJS
    Vercel -. hosts .-> TRPCRoute
    Vercel -. hosts .-> InngestRoute

    click NextJS "https://github.com/itzsupra13/origyn_ai/tree/main/src/app"
    click UIPrimitives "https://github.com/itzsupra13/origyn_ai/tree/main/src/components/ui"
    click DomainUI "https://github.com/itzsupra13/origyn_ai/tree/main/src/modules/projects/ui"
    click ProjectsProc "https://github.com/itzsupra13/origyn_ai/blob/main/src/modules/projects/server/procedures.ts"
    click MessagesProc "https://github.com/itzsupra13/origyn_ai/blob/main/src/modules/messages/server/procedures.ts"
    click TRPCClient "https://github.com/itzsupra13/origyn_ai/blob/main/src/trpc/client.tsx"
    click TRPCRoute "https://github.com/itzsupra13/origyn_ai/blob/main/src/app/api/trpc/[trpc]/route.ts"
    click TRPCRouter "https://github.com/itzsupra13/origyn_ai/blob/main/src/trpc/routers/_app.ts"
    click InngestRoute "https://github.com/itzsupra13/origyn_ai/blob/main/src/app/api/inngest/route.ts"
    click InngestFuncs "https://github.com/itzsupra13/origyn_ai/blob/main/src/inngest/functions.ts"
    click InngestClient "https://github.com/itzsupra13/origyn_ai/blob/main/src/inngest/client.ts"
    click PrismaClient "https://github.com/itzsupra13/origyn_ai/blob/main/src/lib/db.ts"

    classDef frontend fill:#E0F7FA,stroke:#0288D1,stroke-width:1px
    classDef api fill:#E8F5E9,stroke:#2E7D32,stroke-width:1px
    classDef background fill:#FFF3E0,stroke:#F57C00,stroke-width:1px
    classDef db fill:#ECEFF1,stroke:#546E7A,stroke-width:1px
    classDef external fill:#F3E5F5,stroke:#6A1B9A,stroke-width:1px
```
