# varunprajapatii/pencraft_app architecture

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

- Interactive diagram: https://gitdiagram.com/varunprajapatii/pencraft_app
- Repository: https://github.com/varunprajapatii/pencraft_app

## Overview

##### Project Type and Purpose
- This is a full-stack blog website comprising:
- Frontend: React SPA built with Vite, TypeScript, Redux, Tailwind CSS
- Backend: Cloudflare Workers (Hono) serverless API in TypeScript
- Shared module (“common”): Zod schemas for validation
- Database: PostgreSQL (Aiven) with Prisma ORM
- Auth: JWT for user sign-up/sign-in and route protection

##### Main Components
a. Frontend
– React application (src/pages, src/components)
– Redux store (authSlice, userProfileSlice)
– Fetch wrappers/hooks calling `/api/v1/...` endpoints
– Static assets served by your hosting (e.g., Cloudflare Pages)
b. Backend (Cloudflare Workers)
– Entry point: src/index.ts, routes registered under `/api/v1/{auth|user|blog}`
– Routers: authRouter, userRouter, blogRouter
– Middleware for JWT verification and context injection
– Prisma client connects to PostgreSQL using schema.prisma migrations
– Zod validation imported from the common package
c. Shared “common” Package
– Published to npm, consumed by backend (and potentially by frontend)
d. Database
– PostgreSQL instance managed on Aiven
– Tables: User, Blog (formerly Post), UserRelation, etc.
– Prisma migrations directory tracks schema changes
e. External Services
– Cloudflare Workers runtime
– Aiven PostgreSQL
– Wrangler for deployment

##### Relationships & Data Flow
1. Browser → Frontend: User navigates, JS bundle loads.
2. Frontend → Backend: HTTP calls (fetch/XHR) to Cloudflare Workers endpoints under `/api/v1`.
- On protected routes, Authorization header carries JWT.
3. Backend Router → Middleware: JWT validated, userId added to context.
4. Backend → Validation: Incoming payloads validated against Zod schemas from common.
5. Backend → Database (Prisma): Queries/mutations (createUser, getBlogs, follow/unfollow).
6. Database → Backend → Frontend: JSON responses with typed data.
7. Frontend (Redux): Updates application state, triggers UI updates.

##### Architectural Patterns & Design Principles
- Separation of concerns: clear boundary between UI, API, data layer, and validation logic
- Serverless micro-API: each endpoint is stateless, deployed to Cloudflare Workers
- Shared contract: Zod schemas in “common” ensure type-safe validation across layers
- RESTful routing under `/api/v1/{resource}` namespace
- Atomic database migrations via Prisma
- Client-side state management using Redux

##### Essential Elements to Capture
- Frontend build and serve process (Vite → static assets)
- API gateway (Cloudflare Workers entry) and route grouping
- Middleware for authentication and Zod validation
- Business logic routers: auth, user, blog
- Prisma migrations and client interactions
- PostgreSQL schema and tables
- JWT flow: issuance on signup/signin, verification on protected endpoints
- Follow/unfollow transactions and clap operations

## Diagram (Mermaid)

```mermaid
flowchart TD
    browser["Browser"]:::client

    subgraph "Frontend (React + Vite + Tailwind + Redux)"
        FWSPAFR["Frontend SPA"]:::client
        entry["main.tsx\nvite.config.ts\nindex.html"]:::client
        pages["pages"]:::client
        comps["components"]:::client
        store["Redux Store\nstore.ts"]:::client
        authSlice["authSlice.ts"]:::client
        userSlice["userProfileSlice.ts"]:::client
        hooks["hooks.ts"]:::client
        styles["index.css\ntailwind.config.js"]:::client
    end

    subgraph "Backend (Cloudflare Workers API)"
        BEEntry["index.ts"]:::server
        mw["middleware.ts\n(JWT verification)"]:::server
        authRouter["auth.ts\n(signup/signin)"]:::server
        userRouter["user.ts\n(profile, follow/unfollow)"]:::server
        blogRouter["blog.ts\n(getBlogs, publish, clap)"]:::server
        prismaClient["Prisma Client"]:::server
        schemaPrisma["schema.prisma"]:::server
        migrations["migrations/"]:::server
        seed["seed.ts"]:::server
        wrangler["wrangler.toml"]:::server
    end

    common["Common Zod Schemas"]:::shared
    db["PostgreSQL (Aiven)"]:::db

    browser -->|"loads SPA"| FWSPAFR
    FWSPAFR -->|"HTTP /api/v1/*"| BEEntry
    BEEntry -->|"passes request"| mw
    mw -->|"routes to authRouter"| authRouter
    mw -->|"routes to userRouter"| userRouter
    mw -->|"routes to blogRouter"| blogRouter
    authRouter -->|"uses Zod schemas"| common
    userRouter -->|"uses Zod schemas"| common
    blogRouter -->|"uses Zod schemas"| common
    authRouter -->|"Prisma queries"| prismaClient
    userRouter -->|"Prisma queries"| prismaClient
    blogRouter -->|"Prisma queries"| prismaClient
    prismaClient -->|"schema definitions"| schemaPrisma
    prismaClient -->|"runs migrations"| migrations
    prismaClient -->|"connects"| db
    seed -->|"initial data"| db
    common -.->|"imported by"| BEEntry

    click FWSPAFR "https://github.com/varunprajapatii/pencraft_app/tree/main/frontend/"
    click entry "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/main.tsx"
    click entry "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/vite.config.ts"
    click entry "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/index.html"
    click pages "https://github.com/varunprajapatii/pencraft_app/tree/main/frontend/src/pages/"
    click comps "https://github.com/varunprajapatii/pencraft_app/tree/main/frontend/src/components/"
    click store "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/redux/store.ts"
    click authSlice "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/redux/slice/authSlice.ts"
    click userSlice "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/redux/slice/userProfileSlice.ts"
    click hooks "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/hooks/hooks.ts"
    click styles "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/src/index.css"
    click styles "https://github.com/varunprajapatii/pencraft_app/blob/main/frontend/tailwind.config.js"
    click BEEntry "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/src/index.ts"
    click mw "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/src/routes/middleware.ts"
    click authRouter "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/src/routes/auth.ts"
    click userRouter "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/src/routes/user.ts"
    click blogRouter "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/src/routes/blog.ts"
    click schemaPrisma "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/prisma/schema.prisma"
    click migrations "https://github.com/varunprajapatii/pencraft_app/tree/main/backend/prisma/migrations/"
    click seed "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/prisma/seed.ts"
    click wrangler "https://github.com/varunprajapatii/pencraft_app/blob/main/backend/wrangler.toml"
    click common "https://github.com/varunprajapatii/pencraft_app/blob/main/common/src/index.ts"

    classDef client fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef server fill:#90EE90,stroke:#333,stroke-width:1px
    classDef shared fill:#FFA500,stroke:#333,stroke-width:1px
    classDef db fill:#DDA0DD,stroke:#333,stroke-width:1px
```
