# jzerom/taosync-cas architecture

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

- Interactive diagram: https://gitdiagram.com/jzerom/taosync-cas
- Repository: https://github.com/jzerom/taosync-cas

## Overview

TaoSync-CAS is a web-managed automation tool for moving video files through AList/OpenList-compatible engines, with duplicate avoidance based on file identity and the documented CAS filename workflow. Users configure source/destination jobs and storage, then run or schedule jobs and monitor tasks; the job controller dispatches requests into job and task services. The backend also provides engine management, storage discovery, user authentication, and notifications. The README documents the OpenList-CAS handoff, but the exact file-filtering and CAS matching implementation was not sampled, so that link is shown as documented rather than inferred from source.

Main entry points: [`controller/jobController.py`](https://github.com/jzerom/taosync-cas/blob/main/controller/jobController.py) (Job API), [`web/src/App.vue`](https://github.com/jzerom/taosync-cas/blob/main/web/src/App.vue) (Web application), [`service/syncJob/jobClient.py`](https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobClient.py) (Job execution), [`service/syncJob/jobService.py`](https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobService.py) (Job orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_webapp["Web application<br/>[App.vue]"]
  node_jobui["Job and task UI<br/>[desktop.vue]"]
  node_engineui["Engine UI<br/>[index.vue]"]
  node_notifyui["Notification UI<br/>[index.vue]"]
  node_settingsui["Settings UI<br/>[index.vue]"]
end

subgraph group_api["API and access"]
  node_server["Server startup<br/>[main.py]"]
  node_jobapi["Job API<br/>[jobController.py]"]
  node_auth["Request authentication<br/>[baseController.py]"]
  node_systemapi["System API"]
end

subgraph group_sync["Sync workflow"]
  node_jobservice["Job orchestration<br/>[jobService.py]"]
  node_jobclient["Job execution<br/>[jobClient.py]"]
  node_taskservice["Task tracking<br/>[taskService.py]"]
  node_jobdata[("Jobs and snapshots<br/>[jobMapper.py]")]
end

subgraph group_platform["Engines and services"]
  node_alistservice["AList management<br/>[alistService.py]"]
  node_alistclient["AList client<br/>[alistClient.py]"]
  node_engines["Engine selection<br/>[engineService.py]"]
  node_storage["Storage mounts<br/>[storageService.py]"]
  node_discovery["Storage discovery"]
  node_drivers["Storage drivers<br/>[base.py]"]
  node_mountdata[("Mount configuration<br/>[storageMapper.py]")]
  node_notify["Notifications<br/>[notifyService.py]"]
  node_userstore["User service<br/>[userService.py]"]
end

node_user(("User"))
node_openlist["OpenList-CAS"]

node_user -.->|"uses"| node_webapp
node_webapp -.->|"shows"| node_jobui
node_webapp -.->|"shows"| node_engineui
node_webapp -.->|"shows"| node_notifyui
node_webapp -.->|"shows"| node_settingsui
node_jobapi -->|"dispatches"| node_alistservice
node_jobapi -->|"dispatches"| node_storage
node_jobapi -->|"dispatches"| node_discovery
node_jobapi -->|"dispatches"| node_jobservice
node_jobapi -->|"dispatches"| node_taskservice
node_auth -->|"validates user"| node_userstore
node_jobservice -.->|"starts jobs"| node_jobclient
node_jobservice -.->|"uses mounts"| node_storage
node_jobservice -.->|"persists jobs"| node_jobdata
node_taskservice -.->|"reads task data"| node_jobdata
node_taskservice -.->|"requests alerts"| node_notify
node_alistservice -->|"gets clients"| node_engines
node_engines -->|"creates client"| node_alistclient
node_storage -->|"reads and writes"| node_mountdata
node_storage -->|"creates driver"| node_drivers
node_jobclient -.->|"scans source"| node_alistclient
node_jobclient -.->|"accesses storage"| node_drivers
node_openlist -.->|"returns processed files"| node_jobclient
node_jobclient -.->|"syncs videos"| node_openlist

click node_webapp "https://github.com/jzerom/taosync-cas/blob/main/web/src/App.vue"
click node_jobui "https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/home/desktop.vue"
click node_engineui "https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/engine/index.vue"
click node_notifyui "https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/notify/index.vue"
click node_settingsui "https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/setting/index.vue"
click node_server "https://github.com/jzerom/taosync-cas/blob/main/main.py"
click node_jobapi "https://github.com/jzerom/taosync-cas/blob/main/controller/jobController.py"
click node_auth "https://github.com/jzerom/taosync-cas/blob/main/controller/baseController.py"
click node_systemapi "https://github.com/jzerom/taosync-cas/blob/main/controller/systemController.py"
click node_jobservice "https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobService.py"
click node_jobclient "https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobClient.py"
click node_taskservice "https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/taskService.py"
click node_jobdata "https://github.com/jzerom/taosync-cas/blob/main/mapper/jobMapper.py"
click node_alistservice "https://github.com/jzerom/taosync-cas/blob/main/service/alist/alistService.py"
click node_alistclient "https://github.com/jzerom/taosync-cas/blob/main/service/alist/alistClient.py"
click node_engines "https://github.com/jzerom/taosync-cas/blob/main/service/engine/engineService.py"
click node_storage "https://github.com/jzerom/taosync-cas/blob/main/service/storage/storageService.py"
click node_discovery "https://github.com/jzerom/taosync-cas/blob/main/service/storage/discoveryService.py"
click node_drivers "https://github.com/jzerom/taosync-cas/blob/main/service/storage/drivers/base.py"
click node_mountdata "https://github.com/jzerom/taosync-cas/blob/main/mapper/storageMapper.py"
click node_notify "https://github.com/jzerom/taosync-cas/blob/main/service/notify/notifyService.py"
click node_userstore "https://github.com/jzerom/taosync-cas/blob/main/service/system/userService.py"

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_webapp,node_jobui,node_engineui,node_notifyui,node_settingsui,node_user toneBlue
class node_server,node_jobapi,node_auth,node_systemapi toneAmber
class node_jobservice,node_jobclient,node_taskservice,node_jobdata toneMint
class node_alistservice,node_alistclient,node_engines,node_storage,node_discovery,node_drivers,node_mountdata,node_notify,node_userstore toneRose
class node_openlist toneIndigo
```

## Components

### Web interface

- [Web application](https://github.com/jzerom/taosync-cas/blob/main/web/src/App.vue): `web/src/App.vue`
- [Job and task UI](https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/home/desktop.vue): `web/src/views/pages/home/desktop.vue`
- [Engine UI](https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/engine/index.vue): `web/src/views/pages/engine/index.vue`
- [Notification UI](https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/notify/index.vue): `web/src/views/pages/notify/index.vue`
- [Settings UI](https://github.com/jzerom/taosync-cas/blob/main/web/src/views/pages/setting/index.vue): `web/src/views/pages/setting/index.vue`

### API and access

- [Server startup](https://github.com/jzerom/taosync-cas/blob/main/main.py): `main.py`
- [Job API](https://github.com/jzerom/taosync-cas/blob/main/controller/jobController.py): `controller/jobController.py`
- [Request authentication](https://github.com/jzerom/taosync-cas/blob/main/controller/baseController.py): `controller/baseController.py`
- [System API](https://github.com/jzerom/taosync-cas/blob/main/controller/systemController.py): `controller/systemController.py`

### Sync workflow

- [Job orchestration](https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobService.py): `service/syncJob/jobService.py`
- [Job execution](https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/jobClient.py): `service/syncJob/jobClient.py`
- [Task tracking](https://github.com/jzerom/taosync-cas/blob/main/service/syncJob/taskService.py): `service/syncJob/taskService.py`
- [Jobs and snapshots](https://github.com/jzerom/taosync-cas/blob/main/mapper/jobMapper.py): `mapper/jobMapper.py`

### Engines and services

- [AList management](https://github.com/jzerom/taosync-cas/blob/main/service/alist/alistService.py): `service/alist/alistService.py`
- [AList client](https://github.com/jzerom/taosync-cas/blob/main/service/alist/alistClient.py): `service/alist/alistClient.py`
- [Engine selection](https://github.com/jzerom/taosync-cas/blob/main/service/engine/engineService.py): `service/engine/engineService.py`
- [Storage mounts](https://github.com/jzerom/taosync-cas/blob/main/service/storage/storageService.py): `service/storage/storageService.py`
- [Storage discovery](https://github.com/jzerom/taosync-cas/blob/main/service/storage/discoveryService.py): `service/storage/discoveryService.py`
- [Storage drivers](https://github.com/jzerom/taosync-cas/blob/main/service/storage/drivers/base.py): `service/storage/drivers/base.py`
- [Mount configuration](https://github.com/jzerom/taosync-cas/blob/main/mapper/storageMapper.py): `mapper/storageMapper.py`
- [Notifications](https://github.com/jzerom/taosync-cas/blob/main/service/notify/notifyService.py): `service/notify/notifyService.py`
- [User service](https://github.com/jzerom/taosync-cas/blob/main/service/system/userService.py): `service/system/userService.py`

### Other components

- **User**
- **OpenList-CAS**

## Connections

- User → Web application: uses (evidence: `README`)
- Web application → Job and task UI: shows
- Web application → Engine UI: shows
- Web application → Notification UI: shows
- Web application → Settings UI: shows
- Job API → AList management: dispatches (evidence: `controller/jobController.py`)
- Job API → Storage mounts: dispatches (evidence: `controller/jobController.py`)
- Job API → Storage discovery: dispatches (evidence: `controller/jobController.py`)
- Job API → Job orchestration: dispatches (evidence: `controller/jobController.py`)
- Job API → Task tracking: dispatches (evidence: `controller/jobController.py`)
- Request authentication → User service: validates user (evidence: `controller/baseController.py`)
- Job orchestration → Job execution: starts jobs (evidence: `service/syncJob/jobService.py`)
- Job orchestration → Storage mounts: uses mounts (evidence: `service/syncJob/jobService.py`)
- Job orchestration → Jobs and snapshots: persists jobs (evidence: `service/syncJob/jobService.py`)
- Task tracking → Jobs and snapshots: reads task data (evidence: `service/syncJob/taskService.py`)
- Task tracking → Notifications: requests alerts (evidence: `service/syncJob/taskService.py`)
- AList management → Engine selection: gets clients (evidence: `service/alist/alistService.py`)
- Engine selection → AList client: creates client (evidence: `service/engine/engineService.py`)
- Storage mounts → Mount configuration: reads and writes (evidence: `service/storage/storageService.py`)
- Storage mounts → Storage drivers: creates driver (evidence: `service/storage/storageService.py`)
- Job execution → AList client: scans source
- Job execution → Storage drivers: accesses storage
- OpenList-CAS → Job execution: returns processed files (evidence: `README`)
- Job execution → OpenList-CAS: syncs videos (evidence: `README`)
