# rez3x/portfolio-rejaka-main architecture

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

- Interactive diagram: https://gitdiagram.com/rez3x/portfolio-rejaka-main
- Repository: https://github.com/rez3x/portfolio-rejaka-main

## Overview

##### Project Type and Purpose
- This is a full-stack personal portfolio website built with Next.js (App Router) and TypeScript.
- Purpose: showcase projects, blog, resume; provide interactive features (guestbook, AI chatbot); handle user authentication and content management.

##### Main Components
a. Frontend (Next.js App)
- UI Components (src/components) – main page, blog, modals, terminal theme, shared controls
- Pages & Layouts (src/app) – homepage, blog pages, resume page, root layout
- Styling & Theming – Tailwind CSS, global CSS, dual theme logic (terminal vs soft)
- State Management – React Context (src/context/UserContext), custom hooks (src/hooks)
b. Backend/API (Next.js Serverless Routes)
- Authentication API – OAuth routes for Google, GitHub, Discord (src/app/api/auth/…)
- Guestbook API – CRUD for guestbook entries (src/app/api/guestbook)
- AI Chatbot API – voidBot endpoint integrating Google Gemini (src/app/api/voidBot)
- Utility Libraries – MongoDB client (src/lib/mongodb), markdown parsers, word filter (src/utils)
c. Data Storage
- MongoDB – collections for users and guestbook entries
- File-Based Content – markdown posts in public/blog/posts for blog articles
d. External Services
- OAuth Providers – Google, GitHub, Discord
- AI Service – Google Gemini API via @google/generative-ai
- CDN & Reverse Proxy – Cloudflare, Nginx
- Process Manager & Monitoring – PM2
e. Infrastructure & Deployment
- Nginx reverse proxy to Node/Next server on port 3000
- PM2 for app process, monitoring, auto-restart
- SSL via Let’s Encrypt
- DNS & caching via Cloudflare

##### Relationships and Data Flow
- User’s browser requests static assets & pages via CDN (Cloudflare) → Nginx → Next.js server.
- Frontend requests dynamic data:
- Calls API routes (auth, guestbook, voidBot) → Next.js server → interacts with MongoDB or external APIs → returns JSON.
- OAuth flow: browser ↔ OAuth provider ↔ API route ↔ database for session.
- AI Chatbot: frontend sends user prompt → /api/voidBot → Google Gemini API → filtering → response back to UI.
- Blog pages: static generation or SSR reads markdown files from public/blog/posts → renders article pages.

##### Architectural Patterns & Design Principles
- Separation of concerns: clear split between UI components, API logic, data layer
- “API route-per-feature” microservice style within Next.js
- Static vs dynamic rendering: markdown-backed blog posts served statically, dynamic API for user actions
- Theming abstraction: centralized context/hooks to switch UI themes
- Secure design: OAuth 2.0, cookie-based sessions, input filtering, content moderation pipeline

##### Technologies & Frameworks
- Frontend: Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS
- Backend: Node.js, Next.js API routes, MongoDB (native driver)
- Auth: OAuth2.0 (Google/GitHub/Discord)
- AI Integration: Google Gemini API
- Utilities: gray-matter, marked for markdown; custom profanity filter, command processor
- Deployment: Nginx, PM2, Cloudflare, Let’s Encrypt

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["User's Browser"]:::external
        UIComp["UI Components"]:::ui
        Pages["Pages & Layouts"]:::ui
        Styling["Styling & Theming"]:::ui
        State["State Management"]:::ui
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        AuthGroup["Authentication APIs"]:::backend
        GoogleAuth["Google OAuth API"]:::backend
        GitHubAuth["GitHub OAuth API"]:::backend
        DiscordAuth["Discord OAuth API"]:::backend
        GuestbookAPI["Guestbook API"]:::backend
        VoidBotAPI["AI Chatbot API"]:::backend
        Utilities["Utility Libraries"]:::backend
        MongoClient["MongoDB Client"]:::backend
        CmdProcessor["Command Processor"]:::backend
        ProfanityFilter["Profanity Filter"]:::backend
        DownloadUtils["Download Utils"]:::backend
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MongoDB["MongoDB Database"]:::data
        FileSystem["Markdown Posts"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Cloudflare["CDN (Cloudflare)"]:::external
        Nginx["Nginx Reverse Proxy"]:::external
        PM2["PM2 Process Manager"]:::external
        OAuthProviders["OAuth Providers"]:::external
        GeminiAPI["Google Gemini API"]:::external
    end

    %% Flow Connections
    Browser --> Cloudflare --> Nginx --> Nextjs["Next.js Server"]:::backend
    Nextjs --> UIComp
    Nextjs --> Pages
    Nextjs --> Styling
    Nextjs --> State

    UIComp -->|calls| GoogleAuth
    UIComp -->|calls| GitHubAuth
    UIComp -->|calls| DiscordAuth
    UIComp -->|calls| GuestbookAPI
    UIComp -->|calls| VoidBotAPI
    Pages -->|SSR/SSG| FileSystem

    GoogleAuth --> MongoClient --> MongoDB
    GitHubAuth --> MongoClient
    DiscordAuth --> MongoClient
    GuestbookAPI --> MongoClient
    VoidBotAPI --> GeminiAPI --> ProfanityFilter --> VoidBotAPI
    VoidBotAPI --> CmdProcessor
    VoidBotAPI --> DownloadUtils

    %% Click Events - Presentation Layer
    click UIComp "https://github.com/rez3x/portfolio-rejaka-main/tree/main/src/components"
    click Pages "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/layout.tsx"
    click Pages "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/page.tsx"
    click Pages "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/resume/layout.tsx"
    click Pages "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/resume/page.tsx"
    click Pages "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/blog/[slug]/page.tsx"
    click UIComp "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/FeminineLoader.tsx"
    click UIComp "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/Loader.tsx"
    click Styling "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/styles/globals.css"
    click Styling "https://github.com/rez3x/portfolio-rejaka-main/blob/main/postcss.config.mjs"
    click Styling "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/context/UserContext.tsx"
    click State "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/context/UserContext.tsx"
    click State "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/hooks/UseProfile.tsx"

    %% Click Events - API Layer
    click GoogleAuth "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/api/auth/google/route.ts"
    click GitHubAuth "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/api/auth/github/route.ts"
    click DiscordAuth "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/api/auth/discord/route.ts"
    click GuestbookAPI "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/api/guestbook/route.ts"
    click VoidBotAPI "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/app/api/voidBot/route.ts"
    click MongoClient "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/lib/mongodb.tsx"
    click CmdProcessor "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/utils/CommandProcessor.tsx"
    click ProfanityFilter "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/utils/wordFilter.tsx"
    click DownloadUtils "https://github.com/rez3x/portfolio-rejaka-main/blob/main/src/utils/downloadUtils.tsx"

    %% Click Events - Data Layer
    click FileSystem "https://github.com/rez3x/portfolio-rejaka-main/blob/main/public/blog/posts/*/index.md"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef backend fill:#d4edda,stroke:#333,stroke-width:1px
    classDef data fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef external fill:#e2e3e5,stroke:#333,stroke-width:1px
```
