# emoo-ai/data-sync-tool architecture

> Architecture diagram of the GitHub repository emoo-ai/data-sync-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emoo-ai/data-sync-tool
- Repository: https://github.com/emoo-ai/data-sync-tool

## Overview

Emoo is a Tauri desktop client for syncing local files and folders into an Emoo AI knowledge base. Users configure API credentials and create per-task sync rules in the Vue interface; they can run tasks manually or on a schedule. The Rust backend scans and hashes local content, mirrors folder paths remotely, uploads changed documents, and records task state and logs. Major capabilities also include document permissions and optional launch-at-login. The sync engine excerpt is partial, so unsampled details are represented only where the README or source index supports them.

Main entry points: [`src-tauri/src/lib.rs`](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/lib.rs) (Tauri commands), [`src-tauri/src/sync_engine.rs`](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs) (Sync orchestration), [`src-tauri/src/emoo.rs`](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/emoo.rs) (Emoo API client), [`src/App.vue`](https://github.com/emoo-ai/data-sync-tool/blob/main/src/App.vue) (Task and settings UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_ui["Task and settings UI<br/>[App.vue]"]
end

subgraph group_backend["Application backend"]
  node_commands["Tauri commands<br/>[lib.rs]"]
  node_task_model["Task model<br/>[task.rs]"]
  node_configuration["Credentials and preferences<br/>[config.rs]"]
  node_scheduler["Scheduled runs<br/>[scheduler.rs]"]
  node_autostart["Launch at login<br/>[autostart.rs]"]
  node_state["Shared app state<br/>[state.rs]"]
end

subgraph group_sync["Sync workflow"]
  node_sync_engine["Sync orchestration<br/>[sync_engine.rs]"]
  node_file_scan["File scan and hashing<br/>[sync_engine.rs]"]
  node_folder_mirror["Remote folder mapping<br/>[sync_engine.rs]"]
  node_change_sync["Incremental document sync<br/>[sync_engine.rs]"]
  node_permissions["Document permissions<br/>[emoo.rs]"]
end

subgraph group_persistence["Local persistence"]
  node_database[("Task, file, and log storage<br/>[db.rs]")]
end

subgraph group_integrations["External integrations"]
  node_emoo_client["Emoo API client<br/>[emoo.rs]"]
end

node_user(("User"))
node_local_files["Local files and folders"]
node_emoo_service["Emoo knowledge base"]
node_object_storage["Object storage"]
node_operating_system["Operating system startup"]

node_user -->|"configures tasks"| node_ui
node_ui -->|"invokes commands"| node_commands
node_commands -->|"saves settings"| node_configuration
node_commands -->|"manages tasks"| node_database
node_commands -->|"starts manual sync"| node_sync_engine
node_scheduler -->|"loads due tasks"| node_database
node_scheduler -->|"starts scheduled sync"| node_sync_engine
node_commands -->|"starts loop"| node_scheduler
node_commands -->|"registers commands"| node_autostart
node_autostart -->|"sets startup"| node_operating_system
node_sync_engine -->|"scans and hashes"| node_file_scan
node_local_files -.->|"provides content"| node_file_scan
node_sync_engine -->|"resolves paths"| node_folder_mirror
node_folder_mirror -->|"finds or creates folders"| node_emoo_client
node_sync_engine -->|"syncs changed files"| node_change_sync
node_change_sync -->|"reads and records state"| node_database
node_change_sync -->|"uploads and replaces documents"| node_emoo_client
node_emoo_client -->|"calls knowledge API"| node_emoo_service
node_emoo_client -->|"uploads file bytes"| node_object_storage
node_change_sync -->|"applies task permissions"| node_permissions
node_permissions -->|"sets document access"| node_emoo_service
node_sync_engine -->|"uses shared state"| node_state
node_state -->|"holds client"| node_emoo_client
node_commands -->|"accepts task data"| node_task_model
node_database -->|"stores task records"| node_task_model
node_ui -->|"toggles startup"| node_autostart
node_ui -.->|"browses folders and tests connection"| node_emoo_client

click node_ui "https://github.com/emoo-ai/data-sync-tool/blob/main/src/App.vue"
click node_commands "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/lib.rs"
click node_task_model "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/task.rs"
click node_configuration "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/config.rs"
click node_scheduler "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/scheduler.rs"
click node_autostart "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/autostart.rs"
click node_state "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/state.rs"
click node_sync_engine "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs"
click node_file_scan "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs"
click node_folder_mirror "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs"
click node_change_sync "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs"
click node_permissions "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/emoo.rs"
click node_database "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/db.rs"
click node_emoo_client "https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/emoo.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_user toneBlue
class node_commands,node_task_model,node_configuration,node_scheduler,node_autostart,node_state,node_object_storage toneAmber
class node_sync_engine,node_file_scan,node_folder_mirror,node_change_sync,node_permissions toneMint
class node_database toneRose
class node_emoo_client,node_local_files,node_emoo_service,node_operating_system toneIndigo
```

## Components

### Desktop interface

- [Task and settings UI](https://github.com/emoo-ai/data-sync-tool/blob/main/src/App.vue): `src/App.vue`

### Application backend

- [Tauri commands](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Task model](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/task.rs): `src-tauri/src/task.rs`
- [Credentials and preferences](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/config.rs): `src-tauri/src/config.rs`
- [Scheduled runs](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/scheduler.rs): `src-tauri/src/scheduler.rs`
- [Launch at login](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/autostart.rs): `src-tauri/src/autostart.rs`
- [Shared app state](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/state.rs): `src-tauri/src/state.rs`

### Sync workflow

- [Sync orchestration](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs): `src-tauri/src/sync_engine.rs`
- [File scan and hashing](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs): `src-tauri/src/sync_engine.rs`
- [Remote folder mapping](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs): `src-tauri/src/sync_engine.rs`
- [Incremental document sync](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/sync_engine.rs): `src-tauri/src/sync_engine.rs`
- [Document permissions](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/emoo.rs): `src-tauri/src/emoo.rs`

### Local persistence

- [Task, file, and log storage](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/db.rs): `src-tauri/src/db.rs`

### External integrations

- [Emoo API client](https://github.com/emoo-ai/data-sync-tool/blob/main/src-tauri/src/emoo.rs): `src-tauri/src/emoo.rs`

### Other components

- **User**
- **Local files and folders**
- **Emoo knowledge base**
- **Object storage**
- **Operating system startup**

## Connections

- User → Task and settings UI: configures tasks (evidence: `README.md`)
- Task and settings UI → Tauri commands: invokes commands (evidence: `src/App.vue`)
- Tauri commands → Credentials and preferences: saves settings (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Task, file, and log storage: manages tasks (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Sync orchestration: starts manual sync (evidence: `src-tauri/src/lib.rs`)
- Scheduled runs → Task, file, and log storage: loads due tasks (evidence: `src-tauri/src/scheduler.rs`)
- Scheduled runs → Sync orchestration: starts scheduled sync (evidence: `src-tauri/src/scheduler.rs`)
- Tauri commands → Scheduled runs: starts loop (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Launch at login: registers commands (evidence: `src-tauri/src/lib.rs`)
- Launch at login → Operating system startup: sets startup (evidence: `src-tauri/src/autostart.rs`)
- Sync orchestration → File scan and hashing: scans and hashes (evidence: `src-tauri/src/sync_engine.rs`)
- Local files and folders → File scan and hashing: provides content (evidence: `README.md`)
- Sync orchestration → Remote folder mapping: resolves paths (evidence: `src-tauri/src/sync_engine.rs`)
- Remote folder mapping → Emoo API client: finds or creates folders (evidence: `src-tauri/src/sync_engine.rs`)
- Sync orchestration → Incremental document sync: syncs changed files (evidence: `src-tauri/src/sync_engine.rs`)
- Incremental document sync → Task, file, and log storage: reads and records state (evidence: `src-tauri/src/sync_engine.rs`)
- Incremental document sync → Emoo API client: uploads and replaces documents (evidence: `src-tauri/src/sync_engine.rs`)
- Emoo API client → Emoo knowledge base: calls knowledge API (evidence: `src-tauri/src/emoo.rs`)
- Emoo API client → Object storage: uploads file bytes (evidence: `src-tauri/src/emoo.rs`)
- Incremental document sync → Document permissions: applies task permissions (evidence: `src-tauri/src/sync_engine.rs`)
- Document permissions → Emoo knowledge base: sets document access (evidence: `src-tauri/src/emoo.rs`)
- Sync orchestration → Shared app state: uses shared state (evidence: `src-tauri/src/sync_engine.rs`)
- Shared app state → Emoo API client: holds client (evidence: `src-tauri/src/state.rs`)
- Tauri commands → Task model: accepts task data (evidence: `src-tauri/src/lib.rs`)
- Task, file, and log storage → Task model: stores task records (evidence: `src-tauri/src/db.rs`)
- Task and settings UI → Launch at login: toggles startup (evidence: `src/App.vue`)
- Task and settings UI → Emoo API client: browses folders and tests connection (evidence: `README.md`)
