# f43nd1r/acrarium architecture

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

- Interactive diagram: https://gitdiagram.com/f43nd1r/acrarium
- Repository: https://github.com/f43nd1r/acrarium

## Overview

##### Main Components Identification

The system consists of these primary components:
- Frontend (Vaadin-based UI)
- Backend (Spring Boot application)
- Database (MySQL)
- REST API Interface
- Authentication/Security Layer
- Report Processing System

##### Component Relationships

- ACRA clients → REST API endpoints
- Web browsers → Vaadin UI
- UI components → Backend services
- Services → Repositories
- Repositories → Database

##### Technical Details

Annotations showing:
- Spring Boot components
- Kotlin as primary language
- Vaadin framework
- JOOQ for database access
- Liquibase for database migrations

##### Additional Elements

- Configuration management
- Device management
- Bug tracking system
- Report analysis tools
- Statistical analysis components

- The separation between frontend and backend
- The security architecture
- The report processing pipeline
- The data flow from ACRA clients to storage
- The administrative interface structure

This system design should reflect Acrarium's role as a professional-grade crash reporting system with emphasis on security, scalability, and user interface components.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph Clients
        AC[ACRA Clients]
        WB[Web Browsers]
    end

    %% Application Layer
    subgraph "Frontend Layer"
        VUI["Vaadin UI"]:::frontend
        TM["Theme Management"]:::frontend
        I18N["I18n Support"]:::frontend
        CL["Component Library"]:::frontend
    end

    subgraph "Backend Layer"
        BA["Backend Application"]:::backend
        
        subgraph "API & Security"
            REST["REST API Interface"]:::api
            SEC["Security Layer"]:::security
        end
        
        subgraph "Core Services"
            RPS["Report Processing Service"]:::service
            MS["Mail Service"]:::service
            AS["Avatar Service"]:::service
            NS["Navigation System"]:::service
        end
    end

    %% Persistence Layer
    subgraph "Data Access Layer"
        AR["App Repository"]:::repo
        BR["Bug Repository"]:::repo
        RR["Report Repository"]:::repo
        UR["User Repository"]:::repo
    end

    %% Database Layer
    DB[(MySQL Database)]:::database
    LM["Liquibase Migrations"]:::database

    %% Relationships
    AC --> REST
    WB --> VUI
    VUI --> BA
    REST --> RPS
    SEC --> BA
    BA --> RPS
    BA --> MS
    BA --> AS
    BA --> NS
    RPS --> AR
    RPS --> BR
    RPS --> RR
    MS --> UR
    AR --> DB
    BR --> DB
    RR --> DB
    UR --> DB
    LM --> DB

    %% Styling
    classDef frontend fill:#3498db
    classDef backend fill:#2ecc71
    classDef security fill:#f1c40f
    classDef service fill:#27ae60
    classDef repo fill:#e67e22
    classDef database fill:#8e44ad
    classDef api fill:#e74c3c

    %% Click Events
    click BA "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/BackendApplication.kt"
    click VUI "https://github.com/F43nd1r/Acrarium/tree/master/acrarium/src/main/kotlin/com/faendir/acra/ui/"
    click REST "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/rest/RestApiInterface.kt"
    click SEC "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/security/BasicSecurityConfiguration.kt"
    click RPS "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/domain/ReportService.kt"
    click MS "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/domain/MailService.kt"
    click AS "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/domain/AvatarService.kt"
    click AR "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/persistence/app/AppRepository.kt"
    click BR "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/persistence/bug/BugRepository.kt"
    click RR "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/persistence/report/ReportRepository.kt"
    click UR "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/persistence/user/UserRepository.kt"
    click NS "https://github.com/F43nd1r/Acrarium/tree/master/acrarium/src/main/kotlin/com/faendir/acra/navigation/"
    click I18N "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/kotlin/com/faendir/acra/i18n/I18NConfiguration.kt"
    click LM "https://github.com/F43nd1r/Acrarium/blob/master/acrarium/src/main/resources/db/db.changelog-master.yml"
```
