# arnaudvalette/horn-blog architecture

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

- Interactive diagram: https://gitdiagram.com/arnaudvalette/horn-blog
- Repository: https://github.com/arnaudvalette/horn-blog

## Overview

##### Main System Components

a) Frontend Layer:
- Next.js Application (Client-side)
- Article Rendering System
- Navigation Components
- Interactive Components (GlitterNodes, TreeHandler)

b) Backend Layer:
- Next.js API Routes
- Org File Parser
- File System Integration
- Authentication System (for recompilation)

c) Data Layer:
- Org Files Storage
- Parsed Data Cache
- Static Assets (public/images)

##### Component Relationships

**[Client Browser] ←→ [Next.js Frontend]**
- ↓
**[Next.js API Routes (src/app/api/*)]**
- ↓
**[Org Parser System (src/utils/parser.ts)]**
- ↓
**[File System (data/ directory)]**

##### Detailed Component Breakdown

a) Frontend Components (Blue Rectangles):
- Main Layout (src/app/layout.tsx)
- Article Pages (src/app/article/[title]/page.tsx)
- Client Components (src/app/article/[title]/client-components/*)
- Navigation (src/app/components/Nav.tsx)

b) API Endpoints (Green Hexagons):
- Recompile API (/api/recompile)
- Sitemap API (/api/siteMap)

c) Core Services (Yellow Rectangles):
- Parser System (src/utils/parser.ts)
- Server Utilities (src/utils/server.ts)
- Date Utilities (src/utils/date.ts)

- Org Files (src/ressources/data.org)
- Parsed Data Cache (data/ directory)

##### Implementation Details

- Next.js 13+ App Router structure
- TypeScript implementation
- Server/Client component split
- Environmental configuration (.env)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Browser"]
        FrontendComponents["Frontend Components"]
    end

    subgraph "Next.js Application"
        MainLayout["Main Layout"]:::layout
        ArticlePages["Article Pages"]:::article
        Navigation["Navigation"]:::nav
        
        subgraph "Interactive Components"
            GlitterNodes["GlitterNodes"]:::client
            TreeHandler["TreeHandler"]:::client
            ReadingMode["ReadingMode"]:::client
        end

        subgraph "Tree Components"
            TreeRecurse["TreeRecurse"]:::component
            Nodes["Nodes"]:::component
        end

        subgraph "Client Utilities"
            ClientUtils["Utils"]:::utils
            DomUtils["DOM Utils"]:::utils
            Constants["Constants"]:::utils
        end
    end

    subgraph "API Layer"
        RecompileAPI["/api/recompile"]:::api
        SitemapAPI["/api/siteMap"]:::api
    end

    subgraph "Core Services"
        Parser["Parser System"]:::core
        ServerUtils["Server Utilities"]:::core
        DateUtils["Date Utilities"]:::core
        ParserInit["Parser Initialization"]:::core
    end

    subgraph "Data Storage"
        OrgFiles[("Org Files")]:::storage
        ParsedCache[("Parsed Data Cache")]:::storage
        StaticAssets[("Static Assets")]:::storage
    end

    %% Relationships
    Browser --> FrontendComponents
    FrontendComponents --> MainLayout
    FrontendComponents --> ArticlePages
    FrontendComponents --> Navigation
    
    ArticlePages --> GlitterNodes
    ArticlePages --> TreeHandler
    ArticlePages --> ReadingMode
    ArticlePages --> TreeRecurse
    ArticlePages --> Nodes

    GlitterNodes & TreeHandler & ReadingMode --> ClientUtils
    ClientUtils --> DomUtils
    ClientUtils --> Constants

    ArticlePages --> RecompileAPI
    ArticlePages --> SitemapAPI

    RecompileAPI & SitemapAPI --> Parser
    Parser --> ParserInit
    Parser --> ServerUtils
    Parser --> DateUtils

    Parser --> OrgFiles
    Parser --> ParsedCache
    ArticlePages --> StaticAssets

    %% Styles
    classDef layout fill:#e1f5fe,stroke:#01579b
    classDef article fill:#e8f5e9,stroke:#1b5e20
    classDef nav fill:#f3e5f5,stroke:#4a148c
    classDef client fill:#fff3e0,stroke:#e65100
    classDef component fill:#fce4ec,stroke:#880e4f
    classDef utils fill:#fffde7,stroke:#f57f17
    classDef api fill:#efebe9,stroke:#3e2723
    classDef core fill:#e0f2f1,stroke:#004d40
    classDef storage fill:#f3e5f5,stroke:#4a148c

    %% Click Events
    click MainLayout "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/layout.tsx"
    click ArticlePages "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/page.tsx"
    click Navigation "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/components/Nav.tsx"
    click GlitterNodes "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/GlitterNodes.tsx"
    click TreeHandler "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/TreeHandler.tsx"
    click ReadingMode "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/ReadingMode.tsx"
    click RecompileAPI "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/api/recompile/route.ts"
    click SitemapAPI "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/api/siteMap/route.ts"
    click Parser "https://github.com/ArnaudValette/horn-blog/blob/main/src/utils/parser.ts"
    click ParserInit "https://github.com/ArnaudValette/horn-blog/blob/main/src/utils/parserInit.ts"
    click ServerUtils "https://github.com/ArnaudValette/horn-blog/blob/main/src/utils/server.ts"
    click DateUtils "https://github.com/ArnaudValette/horn-blog/blob/main/src/utils/date.ts"
    click OrgFiles "https://github.com/ArnaudValette/horn-blog/blob/main/src/ressources/data.org"
    click ParsedCache "https://github.com/ArnaudValette/horn-blog/tree/main/data/"
    click TreeRecurse "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/components/TreeRecurse.tsx"
    click Nodes "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/components/Nodes.tsx"
    click ClientUtils "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/client-lib/utils.tsx"
    click DomUtils "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/client-lib/dom.ts"
    click Constants "https://github.com/ArnaudValette/horn-blog/blob/main/src/app/article/[title]/client-components/client-lib/const.ts"
```
