# benoiteirik/theochrone-mobile architecture

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

- Interactive diagram: https://gitdiagram.com/benoiteirik/theochrone-mobile
- Repository: https://github.com/benoiteirik/theochrone-mobile

## Overview

##### Main Components

a. Frontend Layer:
- Nuxt 3 Application Core
- Pages (fest, index, martyrologe, mass, settings)
- Components (Layout, Nav, UI components)
- Stores (using Pinia - fest, martyrologe, mass, nav, search)
- Vue Components Structure
- Asset Management System

b. Mobile Integration Layer:
- Capacitor Bridge
- Native Android Implementation
- Platform-specific Features

c. State Management:
- Pinia Stores
- Composables Layer

d. Utility Services:
- Image Handling
- Settings Management
- Internet Status Monitoring
- Back Button Handling

**┌─ Client Layer ─────────────────────┐**
- ┌─ UI Components ───┐              │
- Layout          │              │
- Navigation      │ ┌─ Pages ─┐  │
- UI Elements     │ │ - Fest  │  │
- ┘ │ - Mass   │  │
- etc.   │  │
- ┘  │
- Application Core ────────────────┤
- ┌─ State Management ┐            │
- Pinia Stores      │            │
- ┘            │
- ┌─ Composables ────┐             │
- Settings       │             │
- Image Viewer   │             │
- Internet Status│             │
- ┘             │
- Platform Bridge ────────────────┤
- Capacitor                        │
- Native Layer ──────────────────┤
- Android Implementation           │
- ┘

##### Important Elements to Highlight

- Bidirectional data flow between stores and components
- Capacitor plugins integration points
- Relationship between composables and components
- Asset management flow
- Build/deployment pipeline

##### Specific Implementation Details

- Vue Calendar plugin integration
- How image resources are managed across different screen densities
- How the martyrologe and fest features interact
- Settings persistence flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client["Client Layer"]
        direction TB
        subgraph UI["UI Components"]
            direction TB
            Layout["Layout Components"]
            Nav["Navigation Components"]
            UiElements["UI Elements"]
        end
        
        subgraph Pages["Pages"]
            direction TB
            Fest["Fest Page"]
            Mass["Mass Page"]
            Martyrologe["Martyrologe Page"]
            Settings["Settings Page"]
        end
    end

    subgraph Core["Application Core"]
        direction TB
        subgraph StateManagement["State Management"]
            direction TB
            FestStore["Fest Store"]
            MassStore["Mass Store"]
            NavStore["Navigation Store"]
            SearchStore["Search Store"]
            MartyrologeStore["Martyrologe Store"]
        end

        subgraph Composables["Composables"]
            direction TB
            ImageViewer["Image Viewer"]
            SettingsManager["Settings Management"]
            InternetStatus["Internet Status"]
            BackButton["Back Button Handler"]
        end
    end

    subgraph Platform["Platform Layer"]
        direction TB
        CapacitorBridge["Capacitor Bridge"]
        AndroidImpl["Android Implementation"]
    end

    subgraph Assets["Asset Management"]
        direction TB
        PublicAssets["Public Assets"]
        StyleAssets["Styling Assets"]
        ImageResources["Image Resources"]
    end

    %% Relationships
    UI --> Pages
    Pages --> StateManagement
    StateManagement --> Composables
    Composables --> Platform
    Platform --> AndroidImpl
    Assets --> UI
    Assets --> Pages

    %% Click Events
    click Layout "https://github.com/BenoitEirik/theochrone-mobile/tree/main//components/Layout"
    click Nav "https://github.com/BenoitEirik/theochrone-mobile/tree/main//components/Nav"
    click UiElements "https://github.com/BenoitEirik/theochrone-mobile/tree/main//components/Ui"
    click Fest "https://github.com/BenoitEirik/theochrone-mobile/blob/main//pages/fest.vue"
    click Mass "https://github.com/BenoitEirik/theochrone-mobile/blob/main//pages/mass.vue"
    click Martyrologe "https://github.com/BenoitEirik/theochrone-mobile/blob/main//pages/martyrologe.vue"
    click Settings "https://github.com/BenoitEirik/theochrone-mobile/blob/main//pages/settings.vue"
    click FestStore "https://github.com/BenoitEirik/theochrone-mobile/blob/main//stores/fest.ts"
    click MassStore "https://github.com/BenoitEirik/theochrone-mobile/blob/main//stores/mass.ts"
    click NavStore "https://github.com/BenoitEirik/theochrone-mobile/blob/main//stores/nav.ts"
    click SearchStore "https://github.com/BenoitEirik/theochrone-mobile/blob/main//stores/search.ts"
    click MartyrologeStore "https://github.com/BenoitEirik/theochrone-mobile/blob/main//stores/martyrologe.ts"
    click ImageViewer "https://github.com/BenoitEirik/theochrone-mobile/blob/main//composables/imageViewer.ts"
    click SettingsManager "https://github.com/BenoitEirik/theochrone-mobile/blob/main//composables/settings.ts"
    click InternetStatus "https://github.com/BenoitEirik/theochrone-mobile/blob/main//composables/internetStatus.ts"
    click BackButton "https://github.com/BenoitEirik/theochrone-mobile/blob/main//composables/backButton.ts"
    click CapacitorBridge "https://github.com/BenoitEirik/theochrone-mobile/blob/main//capacitor.config.json"
    click AndroidImpl "https://github.com/BenoitEirik/theochrone-mobile/blob/main//android/app/src/main/java/com/benoiteirik/theochrone/MainActivity.java"
    click PublicAssets "https://github.com/BenoitEirik/theochrone-mobile/tree/main//public"
    click StyleAssets "https://github.com/BenoitEirik/theochrone-mobile/tree/main//assets/css"
    click ImageResources "https://github.com/BenoitEirik/theochrone-mobile/tree/main//public/images"

    %% Styling
    classDef frontend fill:#3498db,color:white
    classDef state fill:#2ecc71,color:white
    classDef platform fill:#e67e22,color:white
    classDef native fill:#e74c3c,color:white
    classDef utility fill:#9b59b6,color:white
    classDef assets fill:#f1c40f,color:black

    class UI,Pages,Layout,Nav,UiElements,Fest,Mass,Martyrologe,Settings frontend
    class StateManagement,FestStore,MassStore,NavStore,SearchStore,MartyrologeStore state
    class Platform,CapacitorBridge platform
    class AndroidImpl native
    class Composables,ImageViewer,SettingsManager,InternetStatus,BackButton utility
    class Assets,PublicAssets,StyleAssets,ImageResources assets
```
