# publinchi/log_analyzer architecture

> Architecture diagram of the GitHub repository publinchi/log_analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/publinchi/log_analyzer
- Repository: https://github.com/publinchi/log_analyzer

## Overview

##### Project type and purpose
- This is a cross-platform Flutter application (“log_analyzer”) targeting mobile (Android/iOS), desktop (Linux/Windows) and web.
- Purpose: allow users to drop or load log files, parse/analyze them, present tables/charts in the UI, and optionally call an AI “analyzer” service (see ai_controller.dart) for deeper insights.

##### File structure
- Top-level “android”, “ios”, “linux”, “windows”, “web” directories contain platform-specific Flutter embedder code.
- The “lib” directory holds the Dart code:
- main.dart – application entry point
- controller/ – business-logic & state controllers
- model/ – data classes for log lines, tables, dropped files
- page/ – UI pages/screens (home, analyze, AI, error)
- widget/ – reusable UI components (drop zone, file list, FAB, etc.)
- config.yaml – likely external configuration for parsing rules.
- pubspec.yaml – Flutter & plugin dependencies.

##### README
- Minimal – boilerplate Flutter starter. No architecture description, so we infer MVVM-style separation:
UI (pages/widgets) ↔ Controllers (state & business logic) ↔ Models (data objects).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Platform Embedders
    subgraph "Platform Embedders"
        AndroidEmbedder["Android Embedder"]:::external
        iOSEmbedder["iOS Embedder"]:::external
        LinuxEmbedder["Linux Embedder"]:::external
        WindowsEmbedder["Windows Embedder"]:::external
        WebHost["Web Host"]:::external
    end

    %% Engine Layer
    FlutterEngine["Flutter Engine + Dart VM"]:::engine

    %% Application Layer
    subgraph "Application"
        subgraph "UI Layer"
            HomePage["Home Page"]:::ui
            AnalyzePage["Analyze Page"]:::ui
            AIPage["AI Page"]:::ui
            ErrorPage["Error Page"]:::ui
            DropzoneWidget["Drag & Drop Zone"]:::ui
            DragTargetWidget["Drag Target"]:::ui
            DroppedFileWidget["Dropped File List"]:::ui
            ExpandalbeFAB["Floating Action Button"]:::ui
            OpenLogsButton["Open Logs Button"]:::ui
        end

        subgraph "Controllers"
            BaseController["Base Controller"]:::controller
            HomeController["Home Controller"]:::controller
            AnalyzeController["Analyze Controller"]:::controller
            AIController["AI Controller"]:::controller
            ErrorController["Error Controller"]:::controller
        end

        subgraph "Models"
            DataTableModel["Data Table Model"]:::model
            DroppedFileModel["Dropped File Model"]:::model
            LogLineModel["Log Line Model"]:::model
        end
    end

    %% External Resources
    FileSystem["File System"]:::external
    Config["config.yaml"]:::external
    Pubspec["pubspec.yaml"]:::external
    ExternalAI["External AI Service"]:::external

    %% Connections
    AndroidEmbedder --> FlutterEngine
    iOSEmbedder --> FlutterEngine
    LinuxEmbedder --> FlutterEngine
    WindowsEmbedder --> FlutterEngine
    WebHost --> FlutterEngine

    FlutterEngine --> Application

    %% UI to Controllers
    HomePage -->|user events| HomeController
    AnalyzePage -->|user events| AnalyzeController
    AIPage -->|user events| AIController
    ErrorPage -->|user events| ErrorController
    DropzoneWidget -->|drop event| HomeController
    DragTargetWidget -->|drag events| HomeController
    DroppedFileWidget -->|select file| AnalyzeController
    ExpandalbeFAB -->|action| HomeController
    OpenLogsButton -->|open file| HomeController

    %% Controllers to Models and externals
    HomeController -->|parse files| DroppedFileModel
    AnalyzeController -->|transform| DataTableModel
    AIController -->|HTTP POST /analyze| ExternalAI
    ErrorController -->|handle| LogLineModel

    Controllers --> Config
    Controllers --> FileSystem

    %% Models to UI
    DroppedFileModel -->|data| DroppedFileWidget
    DataTableModel -->|data| AnalyzePage
    LogLineModel -->|data| ErrorPage

    %% Peripheral dependencies
    Pubspec --> Application

    %% Click Events
    click AndroidEmbedder "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/android/app/src/main/kotlin/com/example/log_analyzer/MainActivity.kt"
    click iOSEmbedder "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/ios/Runner/AppDelegate.swift"
    click LinuxEmbedder "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/linux/main.cc"
    click WindowsEmbedder "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/windows/runner/main.cpp"
    click WebHost "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/web/index.html"
    click HomePage "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/page/home_page.dart"
    click AnalyzePage "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/page/analyze_page.dart"
    click AIPage "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/page/ai_page.dart"
    click ErrorPage "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/page/error_page.dart"
    click DropzoneWidget "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/widget/dropzone_widget.dart"
    click DragTargetWidget "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/widget/drag_target_widget.dart"
    click DroppedFileWidget "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/widget/dropped_file_widget.dart"
    click ExpandalbeFAB "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/widget/expandalbe_fab.dart"
    click OpenLogsButton "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/widget/open_logs_button.dart"
    click AIController "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/controller/ai_controller.dart"
    click AnalyzeController "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/controller/analyze_controller.dart"
    click HomeController "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/controller/home_controller.dart"
    click ErrorController "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/controller/error_controller.dart"
    click BaseController "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/controller/controller.dart"
    click DataTableModel "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/model/data_table_model.dart"
    click DroppedFileModel "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/model/dropped_file.dart"
    click LogLineModel "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/lib/model/sp_line.dart"
    click Config "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/config.yaml"
    click Pubspec "https://github.com/publinchi/log_analyzer/blob/feature/improves_error_analyze/pubspec.yaml"

    %% Styles
    classDef ui fill:#8fcfff,stroke:#333,stroke-width:1px
    classDef controller fill:#a0ffa0,stroke:#333,stroke-width:1px
    classDef model fill:#fff18f,stroke:#333,stroke-width:1px
    classDef engine fill:#ccccff,stroke:#333,stroke-width:1px
    classDef external fill:#dddddd,stroke:#333,stroke-width:1px
```
