# webkawsar/express-prisma-app architecture

> Architecture diagram of the GitHub repository webkawsar/express-prisma-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webkawsar/express-prisma-app
- Repository: https://github.com/webkawsar/express-prisma-app

## Overview

##### Main System Components

A. Authentication Layer
- Passport.js integration
- JWT token management
- Session management with express-session
- CSRF protection

B. API Layer
- Auth routes (signup, signin, verification, password reset)
- User management routes (CRUD operations)
- Role-based access control

C. Database Layer
- PostgreSQL database
- Prisma ORM interface
- Migration management

D. Security & Middleware Layer
- Authentication middleware
- Permission middleware
- Validation middleware
- CORS handling

**[Client Requests]**
- ↓
**[Security Layer]**
- CORS
- CSRF Protection
- Express Session
- ↓
**[Authentication Layer]**
- Passport Local Strategy
- JWT Token Management
- ↓
**[API Routes Layer]**
- Auth Routes
- User Routes
- ↓
**[Controllers Layer]**
- Auth Controller
- Users Controller
- ↓
**[Middleware Layer]**
- Validators
- Permission Checks
- Protection Middleware
- ↓
**[Prisma ORM Layer]**
- ↓
**[PostgreSQL Database]**

##### Important Elements to Highlight

A. Role-Based Access Control Flow:
- Admin → Full access to all users
- Support → Access to normal users
- Users → Self-management only

B. Authentication Flow:
- Local authentication with Passport.js
- JWT token generation and verification
- Session management

C. Data Flow:
- Request validation
- Permission checking
- Database operations through Prisma

##### Specific Implementation Details

- The MVC-like pattern (routes → controllers → models)
- The middleware chain sequence
- The role of Prisma as the database interface
- The security layers (CORS, CSRF, Session management)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        CR[Client Requests]
    end

    subgraph Security
        SL[Security Layer]
        CORS[CORS Handler]
        CSRF[CSRF Protection]
        Session[Express Session]
    end

    subgraph Auth
        AL[Authentication Layer]:::auth
        Passport[Passport Local]:::auth
        JWT[JWT Management]:::auth
    end

    subgraph API
        Routes[API Routes Layer]:::api
        AuthRoutes[Auth Routes]:::api
        UserRoutes[User Routes]:::api
    end

    subgraph Controllers
        Ctrl[Controllers Layer]:::controller
        AuthCtrl[Auth Controller]:::controller
        UserCtrl[Users Controller]:::controller
    end

    subgraph Middleware
        MW[Middleware Layer]:::middleware
        Val[Validators]:::middleware
        Perm[Permission Checks]:::middleware
        Protect[Protection Middleware]:::middleware
    end

    subgraph Database
        PrismaORM[Prisma ORM Layer]:::db
        PostgreSQL[(PostgreSQL)]:::db
    end

    subgraph External
        Mail[Nodemailer]:::external
    end

    %% Flow
    CR --> SL
    SL --> CORS
    SL --> CSRF
    SL --> Session
    CORS & CSRF & Session --> AL
    AL --> Passport
    AL --> JWT
    Passport & JWT --> Routes
    Routes --> AuthRoutes
    Routes --> UserRoutes
    AuthRoutes & UserRoutes --> Ctrl
    Ctrl --> AuthCtrl
    Ctrl --> UserCtrl
    AuthCtrl & UserCtrl --> MW
    MW --> Val
    MW --> Perm
    MW --> Protect
    Val & Perm & Protect --> PrismaORM
    PrismaORM --> PostgreSQL
    AuthCtrl --> Mail

    %% Styling
    classDef auth fill:#a8d1ff
    classDef api fill:#90EE90
    classDef controller fill:#FFB6C1
    classDef middleware fill:#FFD700
    classDef db fill:#DDA0DD
    classDef external fill:#D3D3D3

    %% Click Events
    click AL "https://github.com/webkawsar/express-prisma-app/blob/main/middlewares/passportLocalAuth.js"
    click Passport "https://github.com/webkawsar/express-prisma-app/blob/main/config/passport.js"
    click JWT "https://github.com/webkawsar/express-prisma-app/blob/main/helpers/generateAuthToken.js"
    click AuthRoutes "https://github.com/webkawsar/express-prisma-app/blob/main/routes/authRoute.js"
    click UserRoutes "https://github.com/webkawsar/express-prisma-app/blob/main/routes/usersRoute.js"
    click AuthCtrl "https://github.com/webkawsar/express-prisma-app/blob/main/controllers/authController.js"
    click UserCtrl "https://github.com/webkawsar/express-prisma-app/blob/main/controllers/usersController.js"
    click PrismaORM "https://github.com/webkawsar/express-prisma-app/blob/main/lib/prisma.js"
    click PostgreSQL "https://github.com/webkawsar/express-prisma-app/blob/main/prisma/schema.prisma"
    click Protect "https://github.com/webkawsar/express-prisma-app/blob/main/middlewares/protect.js"
    click Perm "https://github.com/webkawsar/express-prisma-app/blob/main/middlewares/permission.js"
    click Val "https://github.com/webkawsar/express-prisma-app/tree/main/middlewares/validators"
    click Mail "https://github.com/webkawsar/express-prisma-app/blob/main/config/mailConfig.js"
```
