# mounibnemmiche/cpst-notion-cms architecture

> Architecture diagram of the GitHub repository mounibnemmiche/cpst-notion-cms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mounibnemmiche/cpst-notion-cms
- Repository: https://github.com/mounibnemmiche/cpst-notion-cms

## Overview

##### Main Components

a) Client-Side Layer:
- Next.js Frontend Components (from /components directory)
- Pages (from /pages directory)
- Styles (global, notion, and prism themes)

b) Server-Side Layer:
- API Routes (from /api directory)
- Library Functions (from /lib directory)

c) External Services:
- Notion API (as CMS)
- Netlify (deployment platform)

**[Client Layer]**
- ↕
**[Server Layer]**
- ↕
**[External Services]**

##### Detailed Component Breakdown

Client Layer (Top):
- Sub-components:
- Page Components (/pages)
- Reusable Components (/components)
- Styling Modules (CSS)

Server Layer (Middle):
- Tweet Processing
- Preview Image Generation
- Search Functionality
- Sitemap/Robots.txt Generation
- Notion Integration Utils
- Page Resolution
- Site Configuration
- Database Operations

External Services (Bottom):
- Notion API (CMS)
- Netlify (Hosting/Deployment)

##### Connection Flows

- Client-to-Server interactions (API calls)
- Server-to-Notion API communication
- Data flow between components

##### Data Flow Highlights

Emphasize:
- Content fetching flow from Notion
- Page rendering pipeline
- Search functionality
- Image preview generation

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        FE[Frontend Layer]
        COMP[Components]
        PAGES[Pages]
        STYLES[Styles]
        
        COMP --> |Contains| PH[PageHead]
        COMP --> |Contains| EP[ErrorPage]
        COMP --> |Contains| NP[NotionPage]
        COMP --> |Contains| LD[Loading]
        
        PAGES --> |Contains| MP[Main Page]
        PAGES --> |Contains| DP["Dynamic Pages [pageId]"]
        PAGES --> |Contains| E404[404 Page]
        
        STYLES --> |Contains| GS[Global Styles]
        STYLES --> |Contains| NS[Notion Styles]
        STYLES --> |Contains| PT[Prism Theme]
    end
    
    subgraph Server
        API[API Routes]
        LIB[Library Functions]
        
        API --> |Contains| TP["Tweet Processing"]
        API --> |Contains| PIG["Preview Image"]
        API --> |Contains| SF["Search Function"]
        API --> |Contains| SEO["Sitemap/Robots"]
        
        LIB --> |Contains| NI[Notion Integration]
        LIB --> |Contains| PR[Page Resolution]
        LIB --> |Contains| SC[Site Config]
        LIB --> |Contains| DB[Database Ops]
        LIB --> |Contains| ACL[Access Control]
        LIB --> |Contains| TD[Type Definitions]
    end
    
    subgraph External
        NOTION[Notion API]:::external
        NETLIFY[Netlify]:::external
    end
    
    FE --> API
    API --> LIB
    LIB --> NOTION
    FE --> NETLIFY
    
    %% Click Events
    click COMP "https://github.com/MounibNemmiche/CPST-Notion-CMS/tree/main/components"
    click PH "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/components/PageHead.tsx"
    click EP "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/components/ErrorPage.tsx"
    click NP "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/components/NotionPage.tsx"
    click LD "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/components/Loading.tsx"
    
    click PAGES "https://github.com/MounibNemmiche/CPST-Notion-CMS/tree/main/pages"
    click MP "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/pages/index.tsx"
    click DP "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/pages/[pageId].tsx"
    click E404 "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/pages/404.tsx"
    
    click TP "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/api/get-tweet-ast/[tweetId].ts"
    click PIG "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/api/create-preview-image.ts"
    click SF "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/api/search-notion.ts"
    click SEO "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/api/sitemap.xml.ts"
    
    click NI "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/lib/notion.ts"
    click PR "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/lib/resolve-notion-page.ts"
    click DB "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/lib/db.ts"
    click ACL "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/lib/acl.ts"
    click TD "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/lib/types.ts"
    
    click GS "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/styles/global.css"
    click NS "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/styles/notion.css"
    click PT "https://github.com/MounibNemmiche/CPST-Notion-CMS/blob/main/styles/prism-theme.css"
    
    %% Styling
    classDef external fill:#FFA500,stroke:#FF8C00
    classDef client fill:#87CEEB,stroke:#4682B4
    classDef server fill:#90EE90,stroke:#228B22
    
    class Client client
    class Server server
    class External external
    
    %% Legend
    subgraph Legend
        L1[Client Components]:::client
        L2[Server Components]:::server
        L3[External Services]:::external
    end
```
