# shrimqy/sekia architecture

> Architecture diagram of the GitHub repository shrimqy/sekia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shrimqy/sekia
- Repository: https://github.com/shrimqy/sekia

## Overview

##### Main Components

a. Mobile Application Architecture:
- Presentation Layer (UI)
- Main screens (Home, Devices, Settings, Sync)
- Compose UI components
- Domain Layer
- Use cases and business logic
- Repository interfaces
- Data Layer
- Repository implementations
- Local database
- Network services

b. Core Services:
- Network Service
- Notification Service
- Screen Mirror Service
- File Transfer Handler
- Media Handler
- Message Handler

c. External Connections:
- Windows PC Client (Seki)
- Network Communication (WebSocket)
- Network Service Discovery (mDNS)

**┌─────────────────────────────────────────────────────────┐**
- Presentation Layer                      │
- ┌─────────────┐ ┌─────────────┐ ┌─────────────┐       │
- Home Screen │ │Device Screen│ │Settings etc.│       │
- ┘ └─────────────┘ └─────────────┘       │
- ┤
- Domain Layer                         │
- ┌─────────────┐ ┌─────────────┐ ┌─────────────┐       │
- Use Cases  │ │ Repository  │ │   Models    │       │
- Interfaces  │ │             │       │
- ┘ └─────────────┘ └─────────────┘       │
- ┤
- Data Layer                          │
- ┌─────────────┐ ┌─────────────┐ ┌─────────────┐       │
- Repository │ │  Database   │ │  Network    │       │
- Impl     │ │             │ │  Services   │       │
- ┘ └─────────────┘ └─────────────┘       │
- ┘

##### Connection Types

→ Data flow direction
⟷ Two-way communication
- - - Optional/conditional flow

##### Implementation Details

- Dependency injection points (Hilt/Dagger)
- Coroutine scope management
- Navigation graph structure
- Database schema
- WebSocket communication protocol

##### External Integration Points

- Windows PC client connection
- Network service discovery
- File system access
- Media control interface
- Notification listener service

Remember to:
- Notes for critical architectural decisions
- Document performance considerations
- Security checkpoints

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef presentation fill:#3498db,stroke:#2980b9,color:white
    classDef domain fill:#2ecc71,stroke:#27ae60,color:white
    classDef data fill:#f1c40f,stroke:#f39c12,color:black
    classDef service fill:#9b59b6,stroke:#8e44ad,color:white
    classDef external fill:#e74c3c,stroke:#c0392b,color:white

    %% Presentation Layer
    subgraph PresentationLayer["Presentation Layer"]
        UI["Main UI"]
        HomeScreen["Home Screen"]
        DevicesScreen["Devices Screen"]
        SettingsScreen["Settings Screen"]
        SyncScreen["Sync Screen"]
        NavGraphs["Navigation Graphs"]
    end

    %% Domain Layer
    subgraph DomainLayer["Domain Layer"]
        RepoInterfaces["Repository Interfaces"]
        DomainModels["Domain Models"]
        UseCases["Use Cases"]
    end

    %% Data Layer
    subgraph DataLayer["Data Layer"]
        RepoImpl["Repository Implementations"]
        Database["Local Database"]
        CommonModels["Common Models"]
    end

    %% Core Services
    subgraph CoreServices["Core Services"]
        NetworkService["Network Service"]
        NotificationService["Notification Service"]
        ScreenMirrorService["Screen Mirror Service"]
        FileTransferHandler["File Transfer Handler"]
        MediaHandler["Media Handler"]
        MessageHandler["Message Handler"]
    end

    %% External Components
    PCClient["Windows PC Client"]:::external
    WebSocket["WebSocket Communication"]:::external
    MDNS["mDNS Discovery"]:::external

    %% Dependency Injection
    DIModules["DI Modules"]

    %% Connections
    UI --> HomeScreen & DevicesScreen & SettingsScreen & SyncScreen
    UI --> NavGraphs
    HomeScreen & DevicesScreen & SettingsScreen & SyncScreen --> UseCases
    UseCases --> RepoInterfaces
    RepoInterfaces --> RepoImpl
    RepoImpl --> Database
    RepoImpl --> CoreServices
    CoreServices --> WebSocket
    WebSocket --> PCClient
    NetworkService --> MDNS
    DIModules --> CoreServices & RepoImpl
    DomainModels <--> CommonModels

    %% Click Events
    click UI "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/presentation/"
    click HomeScreen "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/presentation/home/"
    click DevicesScreen "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/presentation/devices/"
    click SettingsScreen "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/presentation/settings/"
    click SyncScreen "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/presentation/sync/"
    click RepoInterfaces "https://github.com/shrimqy/Sekia/tree/master/core/domain/src/main/java/komu/seki/domain/repository/"
    click DomainModels "https://github.com/shrimqy/Sekia/tree/master/core/domain/src/main/java/komu/seki/domain/models/"
    click RepoImpl "https://github.com/shrimqy/Sekia/tree/master/core/data/src/main/java/komu/seki/data/repository/"
    click Database "https://github.com/shrimqy/Sekia/tree/master/core/data/src/main/java/komu/seki/data/database/"
    click CommonModels "https://github.com/shrimqy/Sekia/tree/master/core/common/src/main/java/komu/seki/common/models/"
    click NetworkService "https://github.com/shrimqy/Sekia/blob/master/app/src/main/java/com/komu/sekia/services/NetworkService.kt"
    click NotificationService "https://github.com/shrimqy/Sekia/blob/master/core/data/src/main/java/komu/seki/data/services/NotificationService.kt"
    click ScreenMirrorService "https://github.com/shrimqy/Sekia/blob/master/core/data/src/main/java/komu/seki/data/services/ScreenMirrorService.kt"
    click FileTransferHandler "https://github.com/shrimqy/Sekia/blob/master/core/data/src/main/java/komu/seki/data/handlers/FileTranferHandler.kt"
    click MediaHandler "https://github.com/shrimqy/Sekia/blob/master/core/data/src/main/java/komu/seki/data/handlers/MediaHandler.kt"
    click MessageHandler "https://github.com/shrimqy/Sekia/blob/master/core/data/src/main/java/komu/seki/data/handlers/MessageHandler.kt"
    click NavGraphs "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/sekia/navigation/graphs/"
    click DIModules "https://github.com/shrimqy/Sekia/tree/master/app/src/main/java/com/komu/sekia/di/"

    %% Style Applications
    class UI,HomeScreen,DevicesScreen,SettingsScreen,SyncScreen,NavGraphs presentation
    class RepoInterfaces,DomainModels,UseCases domain
    class RepoImpl,Database,CommonModels data
    class NetworkService,NotificationService,ScreenMirrorService,FileTransferHandler,MediaHandler,MessageHandler service
```
