Skip to content

AI-Engineering-at/wiki

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

95 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Engineering Wiki

>_< AI Engineering Wiki

Die deutschsprachige Wissensdatenbank zu Agent Orchestration, Multi-Agent Systemen und DSGVO-konformem AI-Stack.

Next.js 14 Tailwind CSS Pages License DE EN

Live: wiki.ai-engineering.at


Inhaltsverzeichnis


Architektur

graph TD
    subgraph Browser
        A[Besucher]
    end

    subgraph Cloudflare
        B[Cloudflare Pages CDN]
    end

    subgraph Build["Next.js 14 Static Export"]
        C[App Router]
        D[MDX Content]
        E[Custom Components]
        F[Tailwind CSS]
    end

    subgraph Content["Content Layer"]
        G[DE: 54 Seiten]
        H[EN: 52 Seiten]
        I[PlantUML / Kroki Diagramme]
    end

    A -->|HTTPS| B
    B -->|Static HTML/JS| C
    C --> D
    C --> E
    C --> F
    D --> G
    D --> H
    E --> I
Loading
graph LR
    subgraph Kategorien
        K1[Grundlagen]
        K2[Tools]
        K3[Patterns]
        K4[Security]
        K5[Compliance]
        K6[Support]
    end

    subgraph Features
        F1[Suche]
        F2[Breadcrumbs]
        F3[Sidebar Navigation]
        F4[Artikel-Feedback]
        F5[Related Articles]
        F6[Produkt-CTAs]
    end

    K1 & K2 & K3 & K4 & K5 & K6 --> F1
    K1 & K2 & K3 & K4 & K5 & K6 --> F2
Loading

Content Overview

Kategorie DE EN Themen
Grundlagen 12 12 Agent Orchestration, Multi-Agent Systeme, Lokal vs Cloud, TCO
Tools 12 12 Docker, Ollama, RAG, n8n, Grafana, Proxmox, MCP Server
Patterns 8 8 Orchestration Patterns, Memory, Task Delegation, Safety Hooks
Security 6 6 API Keys, Firewall, Backup, Hardening
Compliance 10 10 DSGVO, EU AI Act, Transparenzpflichten, Datenschutz
Support 2 2 Troubleshooting, FAQ
Gesamt 54 52 106 Seiten

Tech Stack

Technologie Version Zweck
Next.js 14.2 App Router, Static Export
React 18 UI Components
Tailwind CSS 3.4 Styling (Blue/Slate Theme)
MDX 3.0 Markdown + JSX Content
TypeScript 5 Type Safety
PlantUML / Kroki Technische Diagramme*
Cloudflare Pages Hosting & CDN

*PlantUML-Diagramme werden client-seitig über kroki.io gerendert. Dabei wird die IP-Adresse des Nutzers an den Kroki-Server übermittelt.


Components

18 Custom Components in components/:

Component Beschreibung
SearchBar Volltextsuche ueber alle Artikel
Sidebar Kategorie-Navigation mit aktiver Markierung
Breadcrumbs Hierarchische Pfad-Navigation
Callout Info/Warning/Danger Hinweis-Boxen
KeyTakeaway Hervorgehobene Kern-Aussagen
ComparisonTable Vergleichstabellen (z.B. Lokal vs Cloud)
PlantUMLDiagram Statische PlantUML-Diagramme via Kroki
PlantUMLDynamic Client-seitige PlantUML-Diagramme
MermaidDiagram Statische Mermaid-Diagramme
MermaidDynamic Client-seitige Mermaid-Diagramme
CaseStudyBox Praxis-Beispiele und Case Studies
RelatedArticles Verwandte Artikel am Seitenende
ArticleFeedback Leser-Feedback pro Artikel
GlobalCta Produkt-Call-to-Action Banners
EditOnGithub Link zum Bearbeiten auf GitHub
SiteHeader Navigation mit Sprachwechsel DE/EN
SiteFooter Footer mit Links und Copyright
ClientLayout Client-seitiges Layout-Wrapper

Getting Started

# Repository klonen
git clone https://github.com/AI-Engineering-AT/wiki.git
cd wiki

# Abhaengigkeiten installieren
npm install

# Entwicklungsserver starten
npm run dev
# -> http://localhost:3000

Build

npm run build
# Static Export in out/

Lint

npm run lint

Deployment

Die Wiki wird als Static Export auf Cloudflare Pages deployt.

Voraussetzungen

  • Node.js 18+
  • Cloudflare Account mit Pages-Zugriff

Deploy-Ablauf

# 1. Build erstellen
npm run build

# 2. Deploy auf Cloudflare Pages
npx wrangler pages deploy out/

Cloudflare Pages Konfiguration

Setting Wert
Build command npm run build
Build output out/
Node.js version 18
Custom Domain wiki.ai-engineering.at

Neuen Artikel erstellen

1. Seite anlegen

Neue page.tsx in der passenden Kategorie erstellen:

app/grundlagen/mein-neuer-artikel/page.tsx    # Deutsch
app/en/grundlagen/mein-neuer-artikel/page.tsx  # Englisch

2. Metadata setzen

export const metadata = {
  title: 'Mein Artikel | AI Engineering Wiki',
  description: 'Kurze Beschreibung fuer SEO...',
}

3. Components nutzen

import { Callout } from '@/components/Callout'
import { KeyTakeaway } from '@/components/KeyTakeaway'
import { ComparisonTable } from '@/components/ComparisonTable'

4. Build testen

npm run build

5. Sprachen

Jeden Artikel in DE und EN erstellen. Die URL-Struktur ist identisch, EN-Artikel liegen unter /en/.


Projektstruktur

wiki/
├── app/
│   ├── globals.css              # Design Tokens (Blue/Slate Theme)
│   ├── layout.tsx               # Root Layout + DE Navigation
│   ├── page.tsx                 # Deutsche Startseite
│   ├── grundlagen/              # 12 Artikel
│   ├── tools/                   # 12 Artikel
│   ├── patterns/                # 8 Artikel
│   ├── security/                # 6 Artikel
│   ├── compliance/              # 10 Artikel
│   ├── support/                 # 2 Artikel
│   └── en/                      # Englische Versionen
│       ├── layout.tsx
│       ├── page.tsx
│       ├── grundlagen/          # 12 Articles
│       ├── tools/               # 12 Articles
│       ├── patterns/            # 8 Articles
│       ├── security/            # 6 Articles
│       ├── compliance/          # 10 Articles
│       └── support/             # 2 Articles
├── components/                  # 18 Custom Components
├── content/                     # MDX Content Files
├── lib/                         # Utility Functions
├── public/                      # Static Assets
├── tailwind.config.ts           # Tailwind Configuration
├── next.config.mjs              # Next.js Configuration
└── package.json

Lizenz

(c) 2026 AI Engineering — Alle Rechte vorbehalten.


Kontakt

About

AI Engineering Wiki — Enterprise Knowledge Base for AI, LLMs, Compliance & Self-Hosted Infrastructure

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors