🏗️ System Architecture

High-Level Component Overview

This diagram shows the modular architecture with clear separation of concerns across CLI interface, core components, AI providers, and analysis tools.

graph TB
    subgraph "🖥️ CLI Interface"
        CLI[Makefile Targets]
    end
    
    subgraph "🎯 Main Controller" 
        BG[BewerbungGenerator]
    end
    
    subgraph "🔧 Core Components"
        ACF[AI Client Factory]
        TM[Template Manager]
        DG[Document Generator]
    end
    
    subgraph "🤖 AI Providers"
        CAC[Claude API Client]
        LAC[Llama/Ollama Client]  
        SC[Sample Content]
    end
    
    subgraph "📊 Analysis Tools"
        CA[Content Analysis]
        RT[Regeneration Testing]
        VA[Variants Analyzer]
    end
    
    CLI --> BG
    BG --> ACF
    BG --> TM
    BG --> DG
    
    ACF --> CAC
    ACF --> LAC
    ACF --> SC
    
    BG --> CA
    BG --> RT
    BG --> VA
    
    style CLI fill:#e1f5fe
    style BG fill:#e8f5e8
    style ACF fill:#fff3e0
    style TM fill:#fff3e0
    style DG fill:#fff3e0
    style CAC fill:#f3e5f5
    style LAC fill:#f3e5f5
    style SC fill:#f3e5f5
    style CA fill:#fce4ec
    style RT fill:#fce4ec
    style VA fill:#fce4ec
            

Component Layers:

🖥️ CLI Interface

• Makefile Targets: User-facing commands for generation, testing, and analysis

🎯 Main Controller

• BewerbungGenerator: Orchestrates the entire application generation process

🔧 Core Components

• AI Client Factory: Manages AI provider selection and fallback logic
• Template Manager: Handles Jinja2 template processing and variable substitution
• Document Generator: Converts templates to final documents and PDFs

🤖 AI Providers

• Claude API Client: Integration with Anthropic's Claude API
• Llama/Ollama Client: Local AI model integration for privacy
• Sample Content: Fallback static content provider

📊 Analysis Tools

• Content Analysis: Quality assessment and content comparison
• Regeneration Testing: Validates reproducibility of generated content
• Variants Analyzer: Compares outputs across different AI providers