# betterseqta/desqta architecture

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

- Interactive diagram: https://gitdiagram.com/betterseqta/desqta
- Repository: https://github.com/betterseqta/desqta

## Overview

##### Project type and purpose
- This is a cross-platform desktop/web application built with Svelte (frontend) and Rust/Tauri (backend) to provide an enhanced interface (“DesQTA”) for SEQTA data (assessments, timetables, messages, etc.).
- The README highlights UI features, session management, API integration with SEQTA, responsive design (Tailwind), and native operations via Tauri/Rust.

##### File structure
- Top-level “src” folder holds the Svelte code:
- app.html/css, components/, lib/services, lib/stores, routes/
- “static” holds themes, images, service worker.
- “src-tauri” is the Rust/Tauri backend:
- src (auth, filesystem, utilities),
- Tauri config files,
- gen/ for iOS & Android build scaffolding,
- docs/ contains architecture and data-flow markdowns.
- Config files: vite.config.js, svelte.config.js, tailwind.config.js, tsconfig.json.

##### Key architectural insights from README and docs
- Svelte-Kit handles routing and pages under src/routes.
- Component-based UI: reusable components in src/lib/components.
- Services layer in JS (authService, syncService, idbCache, etc.) abstracts data fetching and local caching.
- Tauri bridges JS ↔ Rust: native filesystem, session storage, analytics, cloud messaging.
- External SEQTA REST API is the primary data source.
- IndexedDB (via idb.ts/idbCache.ts) and local file system (Rust) are used for caching/persistence.

##### Main components
a. Frontend (Svelte):
- UI Components (src/lib/components)
- Route Handlers (src/routes)
- Services (JS): authService, syncService, notesService, weatherService, idbCache, etc.
- Local persistence: IndexedDB
b. Backend (Tauri/Rust):
- Tauri Core (Webview + IPC)
- Rust Modules: auth (login.rs), fs (desqta-fs), utils (analytics, logger, cloudmessaging, session, settings)
c. External Systems:
- SEQTA REST API
- Third-party APIs (Weather, News, Analytics)
d. Operating System / Device:
- Desktop (Windows/macOS/Linux)
- Mobile wrappers (iOS/Android scaffold via Tauri)

##### Relationships and interactions
- The Svelte frontend issues data requests via the services layer.
- Services either:
- Call SEQTA/third-party REST APIs (over HTTPS), or
- Communicate with Rust via Tauri commands (IPC) for file I/O, notifications, session storage, analytics events.
- Rust handlers perform native operations and return results to the JS layer.
- IndexedDB in the browser context caches API responses for offline use.
- The Tauri wrapper packages the app into native executables on each platform.

##### Architectural patterns & design principles
- Separation of concerns:
- UI (Components + Routes)
- Data access (Services + IPC)
- Persistence (IndexedDB + native file system)
- Micro-frontends style: each route is self-contained.
- Service-oriented: discrete JS services for each domain (auth, notes, weather, etc.).
- Hybrid native/web architecture via Tauri: Web UI + native modules.
- PWA elements: service worker in static/sw.js.

##### Technologies, frameworks & libraries
- Frontend: SvelteKit, Tailwind CSS, Vite, TypeScript
- State & data: Svelte stores, IndexedDB (idb), localStorage, service worker
- Backend: Rust, Tauri, Cargo
- Build tools: pnpm/npm, GitHub Actions (build.yml, nightlybuild.yml)
- Platform scaffolding: Gradle/Kotlin for Android, Xcode project for iOS.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend (SvelteKit)"
        UI["UI Components"]:::frontend
        Routes["Route Handlers"]:::frontend
        subgraph "Services (JS)"
            AuthService["AuthService"]:::service
            SyncService["SyncService"]:::service
            NotesService["NotesService"]:::service
            WeatherService["WeatherService"]:::service
            CSSInjection["CSS Injection & Theme"]:::service
            ErrorService["ErrorService"]:::service
        end
        IndexedDB["IndexedDB Cache"]:::db
    end

    subgraph "Tauri/Rust Backend"
        TauriCore["Tauri Core / IPC"]:::tauri
        LibRs["Command Registration (lib.rs)"]:::tauri
        subgraph "Rust Modules"
            Login["login.rs"]:::rust
            FS["save.rs"]:::rust
            Analytics["analytics.rs"]:::rust
            CloudMsg["cloudmessaging.rs"]:::rust
            Logger["logger.rs"]:::rust
            NetGrab["netgrab.rs"]:::rust
            News["news.rs"]:::rust
            SEQTAConf["seqta_config.rs"]:::rust
            Session["session.rs"]:::rust
            Settings["settings.rs"]:::rust
            ThemeMgr["theme_manager.rs"]:::rust
            ToDo["todolist.rs"]:::rust
            Search["global_search.rs"]:::rust
        end
        subgraph "Mobile/Native Build"
            Android["Android Scaffold"]:::native
            Apple["iOS Scaffold"]:::native
            Icons["Application Icons"]:::native
            TauriConf["tauri.conf.json"]:::native
        end
    end

    subgraph "External Systems"
        SEQTAAPI["SEQTA REST API"]:::external
        WeatherAPI["Weather API"]:::external
        NewsAPI["News API"]:::external
        AnalyticsAPI["Analytics API"]:::external
    end

    subgraph "Deployment Targets"
        Windows["Windows (.exe)"]:::deployment
        Mac["macOS (.app)"]:::deployment
        Linux["Linux (.AppImage)"]:::deployment
        AndroidAPK["Android (APK)"]:::deployment
        iOSIPA["iOS (IPA)"]:::deployment
    end

    UI --> AuthService
    UI --> SyncService
    UI --> NotesService
    UI --> WeatherService
    UI --> CSSInjection
    UI --> ErrorService

    AuthService -->|HTTPS| SEQTAAPI
    SyncService -->|HTTPS| SEQTAAPI
    WeatherService -->|HTTPS| WeatherAPI
    NotesService -->|IndexedDB API| IndexedDB
    AuthService -->|IndexedDB API| IndexedDB
    SyncService -->|IndexedDB API| IndexedDB

    CSSInjection -->|IPC| TauriCore
    ErrorService -->|IPC| TauriCore
    SyncService -.->|IPC| TauriCore

    TauriCore --> LibRs
    LibRs --> Login
    LibRs --> FS
    LibRs --> Analytics
    LibRs --> CloudMsg
    LibRs --> Logger
    LibRs --> NetGrab
    LibRs --> News
    LibRs --> SEQTAConf
    LibRs --> Session
    LibRs --> Settings
    LibRs --> ThemeMgr
    LibRs --> ToDo
    LibRs --> Search

    Android -->|Scaffold| TauriCore
    Apple -->|Scaffold| TauriCore
    Icons -->|Resources| TauriCore
    TauriConf -.->|Config| TauriCore

    TauriCore --> Windows
    TauriCore --> Mac
    TauriCore --> Linux
    TauriCore --> AndroidAPK
    TauriCore --> iOSIPA

    click UI "https://github.com/betterseqta/desqta/tree/main/src/lib/components"
    click Routes "https://github.com/betterseqta/desqta/tree/main/src/routes"
    click AuthService "https://github.com/betterseqta/desqta/blob/main/src/lib/services/authService.ts"
    click SyncService "https://github.com/betterseqta/desqta/blob/main/src/lib/services/syncService.ts"
    click NotesService "https://github.com/betterseqta/desqta/blob/main/src/lib/services/notesService.ts"
    click WeatherService "https://github.com/betterseqta/desqta/blob/main/src/lib/services/weatherService.ts"
    click IndexedDB "https://github.com/betterseqta/desqta/blob/main/src/lib/services/idbCache.ts"
    click IndexedDB "https://github.com/betterseqta/desqta/blob/main/src/lib/services/idb.ts"
    click CSSInjection "https://github.com/betterseqta/desqta/blob/main/src/lib/services/cssInjectionService.ts"
    click CSSInjection "https://github.com/betterseqta/desqta/blob/main/src/lib/services/themeService.ts"
    click ErrorService "https://github.com/betterseqta/desqta/blob/main/src/lib/services/errorService.ts"
    click TauriCore "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/main.rs"
    click LibRs "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/lib.rs"
    click Login "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/auth/login.rs"
    click FS "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/desqta-fs/save.rs"
    click Analytics "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/analytics.ts"
    click CloudMsg "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/cloudmessaging.ts"
    click Logger "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/logger.ts"
    click NetGrab "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/netgrab.rs"
    click News "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/news.rs"
    click SEQTAConf "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/seqta_config.rs"
    click Session "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/session.ts"
    click Settings "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/settings.ts"
    click ThemeMgr "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/theme_manager.rs"
    click ToDo "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/utils/todolist.ts"
    click Search "https://github.com/betterseqta/desqta/blob/main/src-tauri/src/global_search.rs"
    click Android "https://github.com/betterseqta/desqta/tree/main/src-tauri/gen/android"
    click Apple "https://github.com/betterseqta/desqta/tree/main/src-tauri/gen/apple"
    click Icons "https://github.com/betterseqta/desqta/tree/main/src-tauri/icons"
    click TauriConf "https://github.com/betterseqta/desqta/blob/main/src-tauri/tauri.conf.json"
    click SEQTAAPI "https://github.com/betterseqta/desqta/blob/main/docs/architecture/data-flow.md"
    click WeatherAPI "https://github.com/betterseqta/desqta/blob/main/docs/architecture/data-flow.md"
    click NewsAPI "https://github.com/betterseqta/desqta/blob/main/docs/architecture/data-flow.md"
    click AnalyticsAPI "https://github.com/betterseqta/desqta/blob/main/docs/architecture/data-flow.md"
    click static/sw.js "https://github.com/betterseqta/desqta/blob/main/static/sw.js"

    classDef frontend fill:#D0E8FF,stroke:#0366d6
    classDef service fill:#E6FFEA,stroke:#28a745
    classDef db fill:#FFF5BA,stroke:#dbab09
    classDef tauri fill:#FFE5D0,stroke:#d9822b
    classDef rust fill:#FFE5D0,stroke:#d9822b
    classDef native fill:#FFE5D0,stroke:#d9822b,stroke-dasharray:2 2
    classDef external fill:#F0F0F0,stroke:#666
    classDef deployment fill:#E8E8E8,stroke:#444,stroke-dasharray:4 2
```
