# e2ee-aks/vcs architecture

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

- Interactive diagram: https://gitdiagram.com/e2ee-aks/vcs
- Repository: https://github.com/e2ee-aks/vcs

## Overview

This repository implements a mobile-oriented personal productivity and media app, with a browser UI, Android integrations, and a Node server that emulates Google Apps Script services. The main workflow is user interaction in an app view, API handling in the server, and a feature result from local or connected services. Documented source comments describe messaging, media search/playback, calls, file transfer, and PDF conversion. The README is empty; unsampled feature wiring is therefore shown only where the source index supports it, and uncertain links are omitted.

Main entry points: [`server.js`](https://github.com/e2ee-aks/vcs/blob/main/server.js) (API server), [`app.js`](https://github.com/e2ee-aks/vcs/blob/main/app.js) (App shell), [`sp-server.js`](https://github.com/e2ee-aks/vcs/blob/main/sp-server.js) (Music search), [`yt-server.js`](https://github.com/e2ee-aks/vcs/blob/main/yt-server.js) (YouTube search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["App interface"]
  node_app["App shell<br/>[app.js]"]
  node_whatsapp_ui["WhatsApp chats<br/>[wa-view.js]"]
  node_telegram_ui["Telegram chats<br/>[tg-view.js]"]
  node_music_ui["Music browser<br/>[sp-server.js]"]
  node_youtube_ui["YouTube browser<br/>[yt-server.js]"]
  node_ftp_ui["FTP transfer<br/>[ftp-view.js]"]
  node_website_ui["Websites<br/>[websites-view.js]"]
  node_status_ui["Status view<br/>[status-view.js]"]
end

subgraph group_server["Server runtime"]
  node_server["API server<br/>[server.js]"]
  node_gas["Apps Script shim<br/>[gas-shim.js]"]
  node_store[("Google store<br/>[google-store.js]")]
  node_live["Live monitor<br/>[live-monitor.js]"]
end

subgraph group_connect["Connected services"]
  node_wa_backend["WhatsApp service<br/>[wa-server.js]"]
  node_tg_backend["Telegram service<br/>[tg-server.js]"]
  node_sites["Sites service<br/>[sites-server.js]"]
  node_spotify["Music search<br/>[sp-server.js]"]
  node_youtube["YouTube search<br/>[yt-server.js]"]
  node_rtc["Call signaling<br/>[rtc-server.js]"]
  node_push["Push notifications<br/>[fcm.js]"]
end

subgraph group_tools["Phone tools"]
  node_pdf_tools["PDF conversion<br/>[pdf2pics-view.js]"]
  node_attendance["Attendance reminders"]
end

node_user(("App user"))
node_google(("Google services"))
node_firebase(("Firebase Cloud Messaging"))
node_android(("Android host"))

node_user -->|"uses"| node_app
node_app -.->|"opens view"| node_whatsapp_ui
node_app -.->|"opens view"| node_telegram_ui
node_app -.->|"opens view"| node_ftp_ui
node_app -.->|"opens view"| node_website_ui
node_app -.->|"opens view"| node_status_ui
node_user -.->|"converts files"| node_pdf_tools
node_user -.->|"sets reminders"| node_attendance
node_whatsapp_ui -->|"requests status"| node_server
node_server -->|"routes requests"| node_wa_backend
node_server -->|"routes requests"| node_tg_backend
node_server -->|"routes requests"| node_sites
node_server -->|"routes requests"| node_spotify
node_server -->|"routes requests"| node_youtube
node_server -->|"routes requests"| node_rtc
node_server -->|"routes requests"| node_push
node_server -->|"uses runtime"| node_gas
node_gas -.->|"loads sheets"| node_store
node_server -->|"monitors requests"| node_live
node_wa_backend -->|"serves chat data"| node_whatsapp_ui
node_tg_backend -.->|"serves chat data"| node_telegram_ui
node_spotify -.->|"provides search"| node_music_ui
node_youtube -.->|"provides search"| node_youtube_ui
node_spotify -.->|"queries Spotify API"| node_google
node_youtube -->|"queries YouTube API"| node_google
node_push -->|"sends notifications"| node_firebase
node_rtc -->|"signals transfer"| node_ftp_ui
node_android -.->|"hosts app"| node_app

click node_app "https://github.com/e2ee-aks/vcs/blob/main/app.js"
click node_whatsapp_ui "https://github.com/e2ee-aks/vcs/blob/main/wa-view.js"
click node_telegram_ui "https://github.com/e2ee-aks/vcs/blob/main/tg-view.js"
click node_music_ui "https://github.com/e2ee-aks/vcs/blob/main/sp-server.js"
click node_youtube_ui "https://github.com/e2ee-aks/vcs/blob/main/yt-server.js"
click node_ftp_ui "https://github.com/e2ee-aks/vcs/blob/main/ftp-view.js"
click node_website_ui "https://github.com/e2ee-aks/vcs/blob/main/websites-view.js"
click node_status_ui "https://github.com/e2ee-aks/vcs/blob/main/status-view.js"
click node_pdf_tools "https://github.com/e2ee-aks/vcs/blob/main/pdf2pics-view.js"
click node_attendance "https://github.com/e2ee-aks/vcs/blob/main/attendance-reminder.js"
click node_server "https://github.com/e2ee-aks/vcs/blob/main/server.js"
click node_gas "https://github.com/e2ee-aks/vcs/blob/main/gas-shim.js"
click node_store "https://github.com/e2ee-aks/vcs/blob/main/google-store.js"
click node_live "https://github.com/e2ee-aks/vcs/blob/main/live-monitor.js"
click node_wa_backend "https://github.com/e2ee-aks/vcs/blob/main/wa-server.js"
click node_tg_backend "https://github.com/e2ee-aks/vcs/blob/main/tg-server.js"
click node_sites "https://github.com/e2ee-aks/vcs/blob/main/sites-server.js"
click node_spotify "https://github.com/e2ee-aks/vcs/blob/main/sp-server.js"
click node_youtube "https://github.com/e2ee-aks/vcs/blob/main/yt-server.js"
click node_rtc "https://github.com/e2ee-aks/vcs/blob/main/rtc-server.js"
click node_push "https://github.com/e2ee-aks/vcs/blob/main/fcm.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_app,node_whatsapp_ui,node_telegram_ui,node_music_ui,node_youtube_ui,node_ftp_ui,node_website_ui,node_status_ui,node_user toneBlue
class node_server,node_gas,node_store,node_live toneAmber
class node_wa_backend,node_tg_backend,node_sites,node_spotify,node_youtube,node_rtc,node_push toneMint
class node_pdf_tools,node_attendance toneRose
class node_google,node_firebase,node_android toneIndigo
```

## Components

### App interface

- [App shell](https://github.com/e2ee-aks/vcs/blob/main/app.js): `app.js`
- [WhatsApp chats](https://github.com/e2ee-aks/vcs/blob/main/wa-view.js): `wa-view.js`
- [Telegram chats](https://github.com/e2ee-aks/vcs/blob/main/tg-view.js): `tg-view.js`
- [Music browser](https://github.com/e2ee-aks/vcs/blob/main/sp-server.js): `sp-server.js`
- [YouTube browser](https://github.com/e2ee-aks/vcs/blob/main/yt-server.js): `yt-server.js`
- [FTP transfer](https://github.com/e2ee-aks/vcs/blob/main/ftp-view.js): `ftp-view.js`
- [Websites](https://github.com/e2ee-aks/vcs/blob/main/websites-view.js): `websites-view.js`
- [Status view](https://github.com/e2ee-aks/vcs/blob/main/status-view.js): `status-view.js`

### Server runtime

- [API server](https://github.com/e2ee-aks/vcs/blob/main/server.js): `server.js`
- [Apps Script shim](https://github.com/e2ee-aks/vcs/blob/main/gas-shim.js): `gas-shim.js`
- [Google store](https://github.com/e2ee-aks/vcs/blob/main/google-store.js): `google-store.js`
- [Live monitor](https://github.com/e2ee-aks/vcs/blob/main/live-monitor.js): `live-monitor.js`

### Connected services

- [WhatsApp service](https://github.com/e2ee-aks/vcs/blob/main/wa-server.js): `wa-server.js`
- [Telegram service](https://github.com/e2ee-aks/vcs/blob/main/tg-server.js): `tg-server.js`
- [Sites service](https://github.com/e2ee-aks/vcs/blob/main/sites-server.js): `sites-server.js`
- [Music search](https://github.com/e2ee-aks/vcs/blob/main/sp-server.js): `sp-server.js`
- [YouTube search](https://github.com/e2ee-aks/vcs/blob/main/yt-server.js): `yt-server.js`
- [Call signaling](https://github.com/e2ee-aks/vcs/blob/main/rtc-server.js): `rtc-server.js`
- [Push notifications](https://github.com/e2ee-aks/vcs/blob/main/fcm.js): `fcm.js`

### Phone tools

- [PDF conversion](https://github.com/e2ee-aks/vcs/blob/main/pdf2pics-view.js): `pdf2pics-view.js`
- [Attendance reminders](https://github.com/e2ee-aks/vcs/blob/main/attendance-reminder.js): `attendance-reminder.js`

### Other components

- **App user**
- **Google services**
- **Firebase Cloud Messaging**
- **Android host**

## Connections

- App user → App shell: uses
- App shell → WhatsApp chats: opens view
- App shell → Telegram chats: opens view
- App shell → FTP transfer: opens view
- App shell → Websites: opens view
- App shell → Status view: opens view
- App user → PDF conversion: converts files
- App user → Attendance reminders: sets reminders
- WhatsApp chats → API server: requests status (evidence: `wa-view.js`)
- API server → WhatsApp service: routes requests (evidence: `server.js`)
- API server → Telegram service: routes requests (evidence: `server.js`)
- API server → Sites service: routes requests (evidence: `server.js`)
- API server → Music search: routes requests (evidence: `server.js`)
- API server → YouTube search: routes requests (evidence: `server.js`)
- API server → Call signaling: routes requests (evidence: `server.js`)
- API server → Push notifications: routes requests (evidence: `server.js`)
- API server → Apps Script shim: uses runtime (evidence: `server.js`)
- Apps Script shim → Google store: loads sheets
- API server → Live monitor: monitors requests (evidence: `server.js`)
- WhatsApp service → WhatsApp chats: serves chat data (evidence: `wa-view.js`)
- Telegram service → Telegram chats: serves chat data
- Music search → Music browser: provides search (evidence: `sp-server.js`)
- YouTube search → YouTube browser: provides search (evidence: `yt-server.js`)
- Music search → Google services: queries Spotify API
- YouTube search → Google services: queries YouTube API (evidence: `yt-server.js`)
- Push notifications → Firebase Cloud Messaging: sends notifications (evidence: `fcm.js`)
- Call signaling → FTP transfer: signals transfer (evidence: `ftp-view.js`)
- Android host → App shell: hosts app
