# vitalityv1nt/yandexdisk-dsm-app architecture

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

- Interactive diagram: https://gitdiagram.com/vitalityv1nt/yandexdisk-dsm-app
- Repository: https://github.com/vitalityv1nt/yandexdisk-dsm-app

## Overview

This Synology DSM package wraps the official Yandex Disk Linux client. The user sets up authorization and sync configuration over SSH; DSM service scripts manage the client, while the UI fetches status/log output and offers log clearing. Only the UI source was excerpted, so connections to service and CGI implementation are described only where the README or UI code supports them.

Main entry points: [`spk/package/ui/main.js`](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js) (DSM UI), [`spk/package/yandex-disk`](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/yandex-disk) (Yandex Disk client), [`spk/package/ui/scripts/status.cgi`](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/status.cgi) (Status endpoint), [`spk/package/ui/scripts/log.cgi`](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/log.cgi) (Log endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Initial setup"]
  node_setup_cli["Client setup"]
  node_config["Sync configuration"]
end

subgraph group_runtime["Disk runtime"]
  node_client["Yandex Disk client"]
  node_service["Service lifecycle"]
  node_cleaner["Log cleanup"]
  node_logger["Log handling"]
end

subgraph group_ui["DSM interface"]
  node_ui_app["DSM UI<br/>[main.js]"]
  node_status_cgi["Status endpoint<br/>[status.cgi]"]
  node_log_cgi["Log endpoint<br/>[log.cgi]"]
  node_clear_cgi["Clear endpoint<br/>[clear_log.cgi]"]
  node_status_result["Status display<br/>[main.js]"]
  node_log_result["Log display<br/>[main.js]"]
end

node_admin(("NAS administrator"))
node_yandex(("Yandex Disk"))

node_admin -->|"runs setup"| node_setup_cli
node_setup_cli -->|"writes settings"| node_config
node_service -.->|"manages service"| node_client
node_client -->|"syncs with"| node_yandex
node_ui_app -->|"fetches status"| node_status_cgi
node_ui_app -->|"fetches log"| node_log_cgi
node_ui_app -->|"posts clear"| node_clear_cgi
node_status_cgi -.->|"returns text"| node_status_result
node_log_cgi -.->|"returns text"| node_log_result
node_clear_cgi -.->|"clears logs"| node_logger
node_ui_app -->|"renders status"| node_status_result
node_ui_app -->|"renders log"| node_log_result

click node_client "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/yandex-disk"
click node_service "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/start-stop-status"
click node_cleaner "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/yandex-cleaner"
click node_logger "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/yandex-logger"
click node_ui_app "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js"
click node_status_cgi "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/status.cgi"
click node_log_cgi "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/log.cgi"
click node_clear_cgi "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/clear_log.cgi"
click node_status_result "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js"
click node_log_result "https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js"

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_setup_cli,node_config toneBlue
class node_client,node_service,node_cleaner,node_logger toneAmber
class node_ui_app,node_status_cgi,node_log_cgi,node_clear_cgi,node_status_result,node_log_result toneMint
class node_admin,node_yandex toneIndigo
```

## Components

### Initial setup

- **Client setup**
- **Sync configuration**

### Disk runtime

- [Yandex Disk client](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/yandex-disk): `spk/package/yandex-disk`
- [Service lifecycle](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/start-stop-status): `spk/scripts/start-stop-status`
- [Log cleanup](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/yandex-cleaner): `spk/scripts/yandex-cleaner`
- [Log handling](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/scripts/yandex-logger): `spk/scripts/yandex-logger`

### DSM interface

- [DSM UI](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js): `spk/package/ui/main.js`
- [Status endpoint](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/status.cgi): `spk/package/ui/scripts/status.cgi`
- [Log endpoint](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/log.cgi): `spk/package/ui/scripts/log.cgi`
- [Clear endpoint](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/scripts/clear_log.cgi): `spk/package/ui/scripts/clear_log.cgi`
- [Status display](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js): `spk/package/ui/main.js`
- [Log display](https://github.com/vitalityv1nt/yandexdisk-dsm-app/blob/main/spk/package/ui/main.js): `spk/package/ui/main.js`

### Other components

- **NAS administrator**
- **Yandex Disk**

## Connections

- NAS administrator → Client setup: runs setup (evidence: `README.md`)
- Client setup → Sync configuration: writes settings (evidence: `README.md`)
- Service lifecycle → Yandex Disk client: manages service
- Yandex Disk client → Yandex Disk: syncs with (evidence: `README.md`)
- DSM UI → Status endpoint: fetches status (evidence: `spk/package/ui/main.js`)
- DSM UI → Log endpoint: fetches log (evidence: `spk/package/ui/main.js`)
- DSM UI → Clear endpoint: posts clear (evidence: `spk/package/ui/main.js`)
- Status endpoint → Status display: returns text
- Log endpoint → Log display: returns text
- Clear endpoint → Log handling: clears logs
- DSM UI → Status display: renders status (evidence: `spk/package/ui/main.js`)
- DSM UI → Log display: renders log (evidence: `spk/package/ui/main.js`)
