# marblism-community/yrppvb-investnow architecture

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

- Interactive diagram: https://gitdiagram.com/marblism-community/yrppvb-investnow
- Repository: https://github.com/marblism-community/yrppvb-investnow

## Overview

##### Project type and purpose
- This is a full-stack SaaS dashboard built on Next.js (app router), TRPC, Prisma, and a custom “server” layer of libraries (email, payment, upload, OpenAI).
- The README calls it “In Marble We Trust” (Marblism dashboard) with development, build, and production instructions, plus Docker compose support.

##### File structure
- Top-level: configuration files (.env.template, Docker-Compose, tsconfig), models (ZModel files), Prisma schema & seed, public assets, scripts, package.json.
- src/app: Next.js app directory split into (authenticated) and (non-authenticated) pages and API routes under src/app/api (NextAuth, billing webhook, TRPC, file upload).
- src/core: shared client/server abstractions (authentication, configuration, database wrappers, TRPC client/server, hooks, helpers).
- src/designSystem: UI components, layouts, theme & provider code used by Next.js pages.
- src/server: pure-TS “service layer” – routers and specialized libraries for email, payment, upload, and OpenAI.

##### README for additional insights
- Authentication uses NextAuth, billing via Stripe webhooks, file uploads to private/public providers (AWS S3 or local).

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Layer
    subgraph "Client Browser" 
        Browser["Client Browser\n(React/Next.js)"]:::presentation
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        AppLayout["App Layout\nlayout.tsx/page.tsx/not-found.tsx"]:::presentation
        DesignSystem["UI Design System"]:::presentation
        AuthPages["Authenticated Pages"]:::presentation
        NonAuthPages["Non-Authenticated Pages"]:::presentation
    end

    %% API/Transport Layer
    subgraph "API & Transport Layer"
        NextAuthAPI["NextAuth Endpoint"]:::transport
        BillingWebhook["Stripe Billing Webhook"]:::transport
        TRPCAPI["TRPC API Endpoint"]:::transport
        UploadPrivate["Upload API (Private)"]:::transport
        UploadPublic["Upload API (Public)"]:::transport
    end

    %% Core Abstractions
    subgraph "Core Abstractions"
        AuthCore["Authentication & Configuration"]:::core
        DBCore["Database Wrappers & Prisma"]:::core
        TRPCCore["TRPC Client/Server Setup"]:::core
        HooksUtils["Hooks & Helpers"]:::core
    end

    %% Business Logic Layer
    subgraph "Business Logic Services"
        Routers["Business Logic Routers"]:::business
        EmailService["Email Service"]:::business
        PaymentService["Payment Service"]:::business
        UploadService["Upload Service"]:::business
        OpenAIService["OpenAI Service"]:::business
    end

    %% Database
    Database["Database\n(PostgreSQL via Prisma)"]:::db

    %% External Services
    subgraph "External Services"
        Stripe["Stripe"]:::external
        SMTP["SMTP / Mailjet"]:::external
        S3["AWS S3 / Local Storage"]:::external
        OpenAIExt["OpenAI API"]:::external
    end

    %% Project Config & Docs
    ProjectConfig["Project Config & Docker"]:::db
    DataModels["Data Models\n(ZModel Definitions)"]:::db
    Documentation["README & Scripts"]:::db

    %% Connections
    Browser -->|"HTTP/HTTPS"| AppLayout
    Browser -->|"HTTP/HTTPS"| AuthPages
    Browser -->|"HTTP/HTTPS"| NonAuthPages
    AppLayout --> DesignSystem
    AppLayout --> AuthPages
    AppLayout --> NonAuthPages
    AuthPages -->|"RPC calls"| TRPCAPI
    AuthPages -->|"Auth requests"| NextAuthAPI
    NonAuthPages -->|"RPC calls"| TRPCAPI
    NonAuthPages -->|"Auth requests"| NextAuthAPI
    TRPCAPI --> TRPCCore
    NextAuthAPI --> AuthCore
    UploadPrivate --> UploadService
    UploadPublic --> UploadService
    BillingWebhook --> PaymentService
    TRPCCore --> Routers
    AuthCore --> Routers
    Routers --> DBCore
    Routers --> EmailService
    Routers --> PaymentService
    Routers --> UploadService
    Routers --> OpenAIService
    EmailService --> SMTP
    PaymentService --> Stripe
    UploadService --> S3
    OpenAIService --> OpenAIExt
    DBCore --> Database
    ProjectConfig --> Documentation
    DataModels --> Routers

    %% Click Events
    click AuthPages "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/app/(authenticated)"
    click NonAuthPages "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/app/(non-authenticated)"
    click AppLayout "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/layout.tsx"
    click DesignSystem "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/designSystem"
    click NextAuthAPI "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click BillingWebhook "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/api/billing/webhook/stripe/route.ts"
    click TRPCAPI "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/api/trpc/[trpc]/route.ts"
    click UploadPrivate "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/api/upload/private/route.ts"
    click UploadPublic "https://github.com/marblism-community/yrppvb-investnow/blob/main/src/app/api/upload/public/route.ts"
    click AuthCore "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/authentication"
    click AuthCore "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/configuration"
    click DBCore "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/database"
    click DBCore "https://github.com/marblism-community/yrppvb-investnow/blob/main/prisma/schema.prisma"
    click DBCore "https://github.com/marblism-community/yrppvb-investnow/tree/main/prisma/seed"
    click TRPCCore "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/trpc"
    click HooksUtils "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/hooks/upload"
    click HooksUtils "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/core/helpers"
    click Routers "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/server/routers"
    click EmailService "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/server/libraries/email"
    click PaymentService "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/server/libraries/payment"
    click UploadService "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/server/libraries/upload"
    click OpenAIService "https://github.com/marblism-community/yrppvb-investnow/tree/main/src/server/libraries/openai"
    click ProjectConfig "https://github.com/marblism-community/yrppvb-investnow/blob/main/docker-compose.yml"
    click ProjectConfig "https://github.com/marblism-community/yrppvb-investnow/blob/main/.env.template"
    click ProjectConfig "https://github.com/marblism-community/yrppvb-investnow/blob/main/next.config.js"
    click DataModels "https://github.com/marblism-community/yrppvb-investnow/blob/main/models/*.zmodel"
    click Documentation "https://github.com/marblism-community/yrppvb-investnow/blob/main/README.md"
    click Documentation "https://github.com/marblism-community/yrppvb-investnow/blob/main/scripts/env.js"
    click Documentation "https://github.com/marblism-community/yrppvb-investnow/blob/main/scripts/format.models.js"

    %% Styles
    classDef presentation fill:#add8e6,stroke:#000
    classDef transport fill:#90ee90,stroke:#000
    classDef business fill:#ffa500,stroke:#000
    classDef core fill:#ffe4b5,stroke:#000
    classDef db fill:#d3d3d3,stroke:#000
    classDef external fill:#dda0dd,stroke:#000
```
