# suspishes/cedevita architecture

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

- Interactive diagram: https://gitdiagram.com/suspishes/cedevita
- Repository: https://github.com/suspishes/cedevita

## Overview

##### Project type and purpose
- This is a full-stack e-commerce/blog site built with the T3 Stack (Next.js 13 App Router, TypeScript, Prisma, Tailwind CSS, MDX, server/client React components) plus a Stripe payment integration.
- It serves product pages (src/app/Izdelki), an MDX-powered blog (src/clanki + src/app/blog), a shopping cart (src/app/kosarica), contact form, about, services, references, etc.

##### File structure
- Top level
- next.config.js, tsconfig.json, package.json – Next.js + TypeScript config
- prisma/schema.prisma & start-database.sh – database schema & startup script
- public/ – static assets
- src/app/… – Next.js App Router folder: pages, API routes, shared components
- src/server/db.ts – Prisma client setup
- src/clanki/*.mdx – raw blog content
- mdx-components.tsx – custom MDX components
- Next.js conventions
- server components (default .tsx under src/app)
- client components (files importing "use client") under components/client.tsx
- API routes under src/app/api/create-payment-intent/route.ts

##### README for additional insights
- Confirms technologies: Next.js, Prisma, Tailwind, Drizzle (not currently in tree), tRPC (not evident in code), NextAuth (not evident).
- Suggests deployment targets: Vercel, Netlify, Docker.

##### Elements
- Browser / User Interface
- Next.js App Server (App Router)
- API Route / Payment Service
- Prisma Client / DB Layer
- Database (e.g. Postgres)
- MDX Content Loader
- External: Stripe
- Static Assets (public/)
- Request/response between browser ↔ Next.js
- Data fetch from Next.js → DB
- API call from browser → API route → Stripe
- MDX file read → Next.js → browser
- Frontend (blue)
- Server/API (green)
- Data store (orange)
- External services (purple)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Browser / React Client (CSR)"]:::frontend
        Tailwind["Tailwind CSS"]:::frontend
        GlobalCSS["Global Styles (globals.css)"]:::frontend
    end

    %% Next.js Server
    subgraph "Next.js Server (App Router)" 
        direction TB
        NextServer["Next.js App Server\n(App Router)"]:::server
        subgraph "App Router Modules"
            direction TB
            Izdelki["Product Pages (Izdelki)"]:::server
            BlogRoute["Blog Routes & Templates"]:::server
            Kosarica["Shopping Cart (Kosarica)"]:::server
            Kontakt["Contact Form (Kontakt)"]:::server
            MDXLoader["MDX Content Loader\n(mdx-components.tsx)"]:::server
            StaticAssets["Static Assets (public/)"]:::server
            PaymentAPI["Payment API Route\n(/api/create-payment-intent)"]:::server
        end
    end

    %% Content Files and Data Layer
    MDXRaw["Raw MDX Files\n(src/clanki/*.mdx)"]:::server
    DataAccess["Prisma Client / Data Access Layer\n(src/server/db.ts)"]:::server
    Database["Database Schema\n(prisma/schema.prisma)"]:::datastore
    Startup["DB Startup Script\n(start-database.sh)"]:::server

    %% External Services
    ExternalStripe["Stripe Payment Service"]:::external
    ExternalCDN["CDN / Public Assets"]:::external

    %% Connections
    Browser -->|"nav & data fetch"| NextServer
    Browser -->|"styles & utilities"| Tailwind
    Browser -->|"global CSS"| GlobalCSS
    NextServer -->|"serves modules"| Izdelki
    NextServer --> Izdelki
    NextServer --> BlogRoute
    NextServer --> Kosarica
    NextServer --> Kontakt
    NextServer --> MDXLoader
    NextServer --> StaticAssets
    NextServer --> PaymentAPI
    NextServer --> DataAccess
    NextServer --> ExternalCDN
    MDXRaw --> MDXLoader
    MDXLoader --> NextServer
    DataAccess --> Database
    Startup --> Database
    Browser -->|"initiate payment"| PaymentAPI
    PaymentAPI -->|"create intent"| ExternalStripe
    ExternalStripe --> PaymentAPI
    PaymentAPI --> Browser

    %% Click Events
    click NextServer "https://github.com/suspishes/cedevita/tree/main/src/app"
    click Izdelki "https://github.com/suspishes/cedevita/tree/main/src/app/Izdelki"
    click BlogRoute "https://github.com/suspishes/cedevita/tree/main/src/app/blog"
    click MDXRaw "https://github.com/suspishes/cedevita/tree/main/src/clanki"
    click Kosarica "https://github.com/suspishes/cedevita/tree/main/src/app/kosarica"
    click Kontakt "https://github.com/suspishes/cedevita/tree/main/src/app/kontakt"
    click PaymentAPI "https://github.com/suspishes/cedevita/blob/main/src/app/api/create-payment-intent/route.ts"
    click DataAccess "https://github.com/suspishes/cedevita/blob/main/src/server/db.ts"
    click Database "https://github.com/suspishes/cedevita/blob/main/prisma/schema.prisma"
    click Startup "https://github.com/suspishes/cedevita/blob/main/start-database.sh"
    click MDXLoader "https://github.com/suspishes/cedevita/blob/main/mdx-components.tsx"
    click StaticAssets "https://github.com/suspishes/cedevita/tree/main/public/"
    click Tailwind "https://github.com/suspishes/cedevita/blob/main/tailwind.config.ts"
    click GlobalCSS "https://github.com/suspishes/cedevita/blob/main/src/styles/globals.css"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef server fill:#90EE90,stroke:#333,stroke-width:1px
    classDef datastore fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D8BFD8,stroke:#333,stroke-width:1px
```
