# tier-1-club/fe-standard architecture

> Architecture diagram of the GitHub repository tier-1-club/fe-standard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tier-1-club/fe-standard
- Repository: https://github.com/tier-1-club/fe-standard

## Overview

##### Main Components

a. Application Layer:
- Next.js Application (Core)
- Home Module ((home) directory)
- Documentation Module (docs directory)
- Open Graph Image Generation (og directory)

b. Content Management:
- MDX Content Store (content directory)
- Documentation Content
- Blog Content
- Meta Configuration Files

c. Modular Architecture:
- AI Module (modules/ai)
- SEO Module (modules/seo)
- Teams Module (modules/teams)
- UI Module (modules/ui)
- Shared Components (shared directory)

d. Build & Deployment:
- Docker Container
- Nginx Server
- CI/CD Pipeline (GitHub Actions)

##### Relationships to Highlight

**[Client Browser] ←→ [Nginx Server]**
- ↓
**[Next.js Application] ←→ [Content Layer (MDX)]**
- ↓
**[Module Layer]**
- AI Services
- SEO Services
- UI Components
- Team Services
- ↓
**[Shared Components & Utilities]**

##### Important Architectural Patterns to Emphasize

- Module Pattern (based on the modules directory structure)
- Server Components vs Client Components
- Content Pipeline (MDX → Rendered Content)
- Performance Optimization Layer

##### Technical Stack Indicators

- Next.js
- Bun.sh Runtime
- Docker
- GitHub Actions
- MDX Processing
- Tailwind CSS

##### Specific Implementation Details

- Routing structure (app directory structure)
- Where AI search functionality integrates
- Documentation organization structure
- Performance optimization implementations

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph Infrastructure
        Nginx["Nginx Server"]:::server
        Docker["Docker Container"]:::infrastructure
        CICD["CI/CD Pipeline"]:::infrastructure
    end

    subgraph "Next.js Application"
        NextCore["Next.js Core"]:::core
        HomeModule["Home Module"]:::module
        DocsModule["Documentation Module"]:::module
        OGModule["Open Graph Generation"]:::module
    end

    subgraph "Content Layer"
        MDXStore["MDX Content Store"]:::content
        DocContent["Documentation Content"]:::content
        BlogContent["Blog Content"]:::content
        MetaConfig["Meta Configuration"]:::content
    end

    subgraph "Module Layer"
        AIModule["AI Services"]:::module
        SEOModule["SEO Services"]:::module
        TeamsModule["Team Services"]:::module
        UIModule["UI Components"]:::module
    end

    subgraph "Technical Features"
        PerfOpt["Performance Optimization"]:::feature
        Security["Security Layer"]:::feature
        SharedComp["Shared Components"]:::feature
    end

    %% Connections
    Browser <--> Nginx
    Nginx --> NextCore
    NextCore --> HomeModule
    NextCore --> DocsModule
    NextCore --> OGModule
    
    NextCore <--> MDXStore
    MDXStore --> DocContent
    MDXStore --> BlogContent
    MDXStore --> MetaConfig
    
    NextCore --> AIModule
    NextCore --> SEOModule
    NextCore --> TeamsModule
    NextCore --> UIModule
    
    AIModule & SEOModule & TeamsModule & UIModule --> SharedComp
    
    NextCore --> PerfOpt
    NextCore --> Security

    %% Click Events
    click NextCore "https://github.com/Tier-1-Club/fe-standard/tree/main/app"
    click HomeModule "https://github.com/Tier-1-Club/fe-standard/tree/main/app/(home)"
    click DocsModule "https://github.com/Tier-1-Club/fe-standard/tree/main/app/docs"
    click OGModule "https://github.com/Tier-1-Club/fe-standard/tree/main/app/og"
    click MDXStore "https://github.com/Tier-1-Club/fe-standard/tree/main/content"
    click DocContent "https://github.com/Tier-1-Club/fe-standard/tree/main/content/docs"
    click BlogContent "https://github.com/Tier-1-Club/fe-standard/tree/main/content/blog"
    click AIModule "https://github.com/Tier-1-Club/fe-standard/tree/main/modules/ai"
    click SEOModule "https://github.com/Tier-1-Club/fe-standard/tree/main/modules/seo"
    click TeamsModule "https://github.com/Tier-1-Club/fe-standard/tree/main/modules/teams"
    click UIModule "https://github.com/Tier-1-Club/fe-standard/tree/main/modules/ui"
    click SharedComp "https://github.com/Tier-1-Club/fe-standard/tree/main/shared/components"
    click Docker "https://github.com/Tier-1-Club/fe-standard/tree/main/deployment/Dockerfile"
    click Nginx "https://github.com/Tier-1-Club/fe-standard/blob/main/deployment/nginx.conf"
    click CICD "https://github.com/Tier-1-Club/fe-standard/tree/main/.github/workflows"
    click PerfOpt "https://github.com/Tier-1-Club/fe-standard/tree/main/content/docs/techniques/web/performance"
    click Security "https://github.com/Tier-1-Club/fe-standard/tree/main/content/docs/techniques/web/security"

    %% Styles
    classDef core fill:#2563eb,color:white
    classDef module fill:#3b82f6,color:white
    classDef content fill:#22c55e,color:white
    classDef server fill:#f97316,color:white
    classDef infrastructure fill:#ea580c,color:white
    classDef feature fill:#8b5cf6,color:white

    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Modules"]:::module
        L3["Content"]:::content
        L4["Server"]:::server
        L5["Infrastructure"]:::infrastructure
        L6["Features"]:::feature
    end
```
