# tbarondar/capynotes architecture

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

- Interactive diagram: https://gitdiagram.com/tbarondar/capynotes
- Repository: https://github.com/tbarondar/capynotes

## Overview

##### Main components
- Frontend (browser + Next.js App Router pages & React components)
- API Layer
– NextAuth “/api/auth” routes for authentication
– tRPC “/api/trpc” route handler
- Business Logic Layer (tRPC routers in server/routers)
- Data Access Layer (Prisma client connecting to PostgreSQL)
- Database (PostgreSQL)

##### Relationships and data flows
- Browser renders React components (app/, components/)
↓ uses tRPC client (app/_trpc/client.ts) and NextAuth client (auth.ts)
- tRPC client → Next.js API route /api/trpc → tRPC server (server/trpc.ts)
- NextAuth client ↔ NextAuth route handler (app/api/auth/[...nextauth]/route.ts)
- tRPC resolvers (server/routers/*.ts) call Prisma client (prisma/client.ts)
- Prisma client speaks to the Postgres database (schema in prisma/schema.prisma)

##### Architectural patterns
- Monorepo structure with clear separation:
– app/ for UI and API route handlers
– server/ for API router definitions and business logic
– prisma/ for schema and migrations
- tRPC for typesafe end-to-end RPCs
- NextAuth for session management
- Prisma ORM for database modeling and migrations

##### Call out major technologies and layers
- Next.js App Router, React, CSS Modules
- tRPC (client.ts, Provider.tsx, server/trpc.ts)
- NextAuth (app/api/auth route)
- Prisma ORM + migrations → PostgreSQL
- TypeScript for all layers

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend" 
        style Frontend fill:#D0E8FF,stroke:#333,stroke-width:1px
        Browser["Browser"] 
        UI["Next.js App Router\n(page.tsx, layout.tsx, globals.css)"] 
        Components["React Components\n(components/)"] 
        Store["Client-side State Store\ndata/store.ts"] 
        Types["Type Definitions\ndata/types.ts"] 
        Browser -->|renders| UI
        UI -->|uses| Components
        UI -->|reads/writes| Store
        UI -->|refs| Types
    end

    %% API Layer
    subgraph "API Layer"
        style API Layer fill:#D5FFE1,stroke:#333,stroke-width:1px
        NextAuthClient["NextAuth Client\n(auth.ts)"]
        TRPCClient["tRPC Client\n(client.ts, Provider.tsx,\nserverClient.ts)"]
        AuthRoute["NextAuth Route Handler\n(app/api/auth/[...nextauth]/route.ts)"]
        TRPCRoute["tRPC API Route\n(app/api/trpc/[trpc]/route.ts)"]
        UI -->|uses| TRPCClient
        UI -->|uses| NextAuthClient
        TRPCClient -->|calls| TRPCRoute
        NextAuthClient -->|calls| AuthRoute
        AuthRoute -->|responds| NextAuthClient
    end

    %% Business Logic Layer
    subgraph "Business Logic"
        style Business Logic fill:#FFE4B3,stroke:#333,stroke-width:1px
        TRPCServer["tRPC Server Init\n(server/trpc.ts)"]
        Routers["tRPC Routers\n(server/routers/)"]
        TRPCRoute -->|forwards| TRPCServer
        TRPCServer -->|uses| Routers
    end

    %% Data Access Layer
    subgraph "Data Access"
        style Data Access fill:#E4C7FF,stroke:#333,stroke-width:1px
        PrismaClient["Prisma Client\n(prisma/client.ts)"]
        Schema["Prisma Schema\n(prisma/schema.prisma)"]
        Migrations["Prisma Migrations\n(prisma/migrations/)"]
        Routers -->|queries| PrismaClient
        PrismaClient -->|reads/writes| Schema
        PrismaClient -->|applies| Migrations
    end

    %% Database
    subgraph "Database"
        style Database fill:#FFF4C1,stroke:#333,stroke-width:1px
        Postgres[(PostgreSQL DB)]
        PrismaClient -->|connects| Postgres
    end

    %% Click events
    click UI "https://github.com/tbarondar/capynotes/blob/main/app/page.tsx"
    click UI "https://github.com/tbarondar/capynotes/blob/main/app/layout.tsx"
    click UI "https://github.com/tbarondar/capynotes/blob/main/app/globals.css"
    click Components "https://github.com/tbarondar/capynotes/tree/main/components/"
    click Store "https://github.com/tbarondar/capynotes/blob/main/data/store.ts"
    click Types "https://github.com/tbarondar/capynotes/blob/main/data/types.ts"
    click NextAuthClient "https://github.com/tbarondar/capynotes/blob/main/auth.ts"
    click AuthRoute "https://github.com/tbarondar/capynotes/blob/main/app/api/auth/[...nextauth]/route.ts"
    click TRPCClient "https://github.com/tbarondar/capynotes/blob/main/app/_trpc/client.ts"
    click TRPCClient "https://github.com/tbarondar/capynotes/blob/main/app/_trpc/Provider.tsx"
    click TRPCClient "https://github.com/tbarondar/capynotes/blob/main/app/_trpc/serverClient.ts"
    click TRPCRoute "https://github.com/tbarondar/capynotes/blob/main/app/api/trpc/[trpc]/route.ts"
    click TRPCServer "https://github.com/tbarondar/capynotes/blob/main/server/trpc.ts"
    click Routers "https://github.com/tbarondar/capynotes/blob/main/server/routers/index.ts"
    click Routers "https://github.com/tbarondar/capynotes/tree/main/server/routers/"
    click PrismaClient "https://github.com/tbarondar/capynotes/blob/main/prisma/client.ts"
    click Schema "https://github.com/tbarondar/capynotes/blob/main/prisma/schema.prisma"
    click Migrations "https://github.com/tbarondar/capynotes/tree/main/prisma/migrations/"
```
