# fabiodevcode/slyhear architecture

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

- Interactive diagram: https://gitdiagram.com/fabiodevcode/slyhear
- Repository: https://github.com/fabiodevcode/slyhear

## Overview

Slyhear is a personal audio-streaming application: users can download music from YouTube URLs, browse and play their audio library, and delete tracks; the README also lists playlists as an unfinished capability. The main flow runs through Express routes and controllers, with Sequelize/SQLite persistence and uploaded audio files. The graph includes the sampled download worker and the documented browser-facing capabilities. Frontend-to-route wiring and unsampled download internals are not fully evidenced, so uncertain links are omitted.

Main entry points: [`src/controllers/action.controller.js`](https://github.com/fabiodevcode/slyhear/blob/main/src/controllers/action.controller.js) (Action controller), [`src/models/index.js`](https://github.com/fabiodevcode/slyhear/blob/main/src/models/index.js) (Model registry), [`src/helpers/models.helpers.js`](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/models.helpers.js) (Model builders), [`src/app.js`](https://github.com/fabiodevcode/slyhear/blob/main/src/app.js) (Express app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_server["Server entry<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_routes["Route registry<br/>[index.js]"]
  node_action_routes["Action routes<br/>[action.routes.js]"]
  node_page_routes["Page routes<br/>[default.routes.js]"]
  node_app_helpers["Config setup<br/>[app.helpers.js]"]
end

subgraph group_domain["Audio workflows"]
  node_action_controller["Action controller"]
  node_page_controller["Page controller"]
  node_download_worker["Download worker"]
  node_download_helpers["Download helpers<br/>[scripts.helpers.js]"]
  node_track_helpers["Track preparation<br/>[tracks.helpers.js]"]
end

subgraph group_storage["Persistence and files"]
  node_models["Model registry<br/>[index.js]"]
  node_track_models["Track model<br/>[tracks.models.js]"]
  node_playlist_models["Playlist model"]
  node_list_models["Download-list model<br/>[list.models.js]"]
  node_settings_models["Settings model<br/>[settings.models.js]"]
  node_user_models["User model<br/>[user.models.js]"]
  node_model_helpers["Model builders<br/>[models.helpers.js]"]
  node_sqlite[("SQLite database")]
  node_audio_files["Uploaded audio"]
  node_model_attributes["Model definitions"]
end

subgraph group_identity["Identity and utilities"]
  node_user_middleware["Cookie guard"]
  node_user_helpers["Cookie generation<br/>[user.helpers.js]"]
  node_crypto["Cookie crypto<br/>[crypto.utils.js]"]
  node_string_utils["String utilities<br/>[string.utils.js]"]
  node_validators["Login validation<br/>[user.validators.js]"]
end

subgraph group_presentation["Browser experience"]
  node_browser_features["Browser features"]
  node_templates["Page templates"]
  node_handlebars_helpers["Template helpers<br/>[hbs_fn.js]"]
end

node_user(("User"))

node_user -->|"opens app"| node_server
node_server -->|"starts"| node_app
node_app -->|"registers"| node_routes
node_app -->|"syncs database"| node_models
node_app -->|"checks config"| node_app_helpers
node_app -->|"configures templates"| node_handlebars_helpers
node_routes -->|"mounts"| node_action_routes
node_routes -->|"mounts"| node_page_routes
node_action_routes -->|"dispatches"| node_action_controller
node_page_routes -->|"dispatches"| node_page_controller
node_action_routes -->|"validates login"| node_validators
node_action_routes -->|"guards actions"| node_user_middleware
node_page_routes -->|"guards pages"| node_user_middleware
node_action_controller -->|"forks download"| node_download_worker
node_action_controller -->|"reads and writes"| node_models
node_action_controller -->|"generates cookie"| node_user_helpers
node_action_controller -->|"creates job id"| node_string_utils
node_action_controller -->|"streams and deletes"| node_audio_files
node_download_worker -->|"uses"| node_download_helpers
node_download_worker -->|"uses"| node_models
node_page_controller -->|"queries"| node_models
node_page_controller -->|"prepares tracks"| node_track_helpers
node_page_controller -->|"renders pages"| node_templates
node_models -->|"stores records"| node_sqlite
node_track_models -->|"builds model"| node_model_helpers
node_playlist_models -->|"builds model"| node_model_helpers
node_list_models -->|"builds model"| node_model_helpers
node_settings_models -->|"builds model"| node_model_helpers
node_user_models -->|"builds model"| node_model_helpers
node_model_helpers -->|"capitalizes names"| node_string_utils
node_models -.->|"loads definitions"| node_model_attributes
node_user_middleware -->|"decrypts cookie"| node_crypto
node_user_helpers -->|"uses encryption"| node_crypto
node_app_helpers -->|"generates keys"| node_string_utils
node_browser_features -.->|"provides controls"| node_user

click node_server "https://github.com/fabiodevcode/slyhear/blob/main/server.js"
click node_app "https://github.com/fabiodevcode/slyhear/blob/main/src/app.js"
click node_routes "https://github.com/fabiodevcode/slyhear/blob/main/src/routes/index.js"
click node_action_routes "https://github.com/fabiodevcode/slyhear/blob/main/src/routes/action.routes.js"
click node_page_routes "https://github.com/fabiodevcode/slyhear/blob/main/src/routes/default.routes.js"
click node_action_controller "https://github.com/fabiodevcode/slyhear/blob/main/src/controllers/action.controller.js"
click node_page_controller "https://github.com/fabiodevcode/slyhear/blob/main/src/controllers/default.controller.js"
click node_download_worker "https://github.com/fabiodevcode/slyhear/blob/main/src/workers/downloadChildTask.js"
click node_download_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/scripts.helpers.js"
click node_track_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/tracks.helpers.js"
click node_browser_features "https://github.com/fabiodevcode/slyhear/tree/main/src/public/js"
click node_templates "https://github.com/fabiodevcode/slyhear/tree/main/src/views/pages"
click node_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/index.js"
click node_track_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/tracks.models.js"
click node_playlist_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/playlists.models.js"
click node_list_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/list.models.js"
click node_settings_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/settings.models.js"
click node_user_models "https://github.com/fabiodevcode/slyhear/blob/main/src/models/user.models.js"
click node_model_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/models.helpers.js"
click node_sqlite "https://github.com/fabiodevcode/slyhear/tree/main/src/database"
click node_audio_files "https://github.com/fabiodevcode/slyhear/tree/main/src/upload/sounds"
click node_user_middleware "https://github.com/fabiodevcode/slyhear/blob/main/src/middlewares/cookie.middlewares.js"
click node_user_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/user.helpers.js"
click node_crypto "https://github.com/fabiodevcode/slyhear/blob/main/src/utils/crypto.utils.js"
click node_string_utils "https://github.com/fabiodevcode/slyhear/blob/main/src/utils/string.utils.js"
click node_validators "https://github.com/fabiodevcode/slyhear/blob/main/src/validators/user.validators.js"
click node_app_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/app.helpers.js"
click node_handlebars_helpers "https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/hbs_fn.js"
click node_model_attributes "https://github.com/fabiodevcode/slyhear/tree/main/src/models/attributes"

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_server,node_app,node_routes,node_action_routes,node_page_routes,node_app_helpers,node_user toneBlue
class node_action_controller,node_page_controller,node_download_worker,node_download_helpers,node_track_helpers toneAmber
class node_models,node_track_models,node_playlist_models,node_list_models,node_settings_models,node_user_models,node_model_helpers,node_sqlite,node_audio_files,node_model_attributes toneMint
class node_user_middleware,node_user_helpers,node_crypto,node_string_utils,node_validators toneRose
class node_browser_features,node_templates,node_handlebars_helpers toneIndigo
```

## Components

### Web application

- [Server entry](https://github.com/fabiodevcode/slyhear/blob/main/server.js): `server.js`
- [Express app](https://github.com/fabiodevcode/slyhear/blob/main/src/app.js): `src/app.js`
- [Route registry](https://github.com/fabiodevcode/slyhear/blob/main/src/routes/index.js): `src/routes/index.js`
- [Action routes](https://github.com/fabiodevcode/slyhear/blob/main/src/routes/action.routes.js): `src/routes/action.routes.js`
- [Page routes](https://github.com/fabiodevcode/slyhear/blob/main/src/routes/default.routes.js): `src/routes/default.routes.js`
- [Config setup](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/app.helpers.js): `src/helpers/app.helpers.js`

### Audio workflows

- [Action controller](https://github.com/fabiodevcode/slyhear/blob/main/src/controllers/action.controller.js): `src/controllers/action.controller.js`
- [Page controller](https://github.com/fabiodevcode/slyhear/blob/main/src/controllers/default.controller.js): `src/controllers/default.controller.js`
- [Download worker](https://github.com/fabiodevcode/slyhear/blob/main/src/workers/downloadChildTask.js): `src/workers/downloadChildTask.js`
- [Download helpers](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/scripts.helpers.js): `src/helpers/scripts.helpers.js`
- [Track preparation](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/tracks.helpers.js): `src/helpers/tracks.helpers.js`

### Persistence and files

- [Model registry](https://github.com/fabiodevcode/slyhear/blob/main/src/models/index.js): `src/models/index.js`
- [Track model](https://github.com/fabiodevcode/slyhear/blob/main/src/models/tracks.models.js): `src/models/tracks.models.js`
- [Playlist model](https://github.com/fabiodevcode/slyhear/blob/main/src/models/playlists.models.js): `src/models/playlists.models.js`
- [Download-list model](https://github.com/fabiodevcode/slyhear/blob/main/src/models/list.models.js): `src/models/list.models.js`
- [Settings model](https://github.com/fabiodevcode/slyhear/blob/main/src/models/settings.models.js): `src/models/settings.models.js`
- [User model](https://github.com/fabiodevcode/slyhear/blob/main/src/models/user.models.js): `src/models/user.models.js`
- [Model builders](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/models.helpers.js): `src/helpers/models.helpers.js`
- [SQLite database](https://github.com/fabiodevcode/slyhear/tree/main/src/database): `src/database`
- [Uploaded audio](https://github.com/fabiodevcode/slyhear/tree/main/src/upload/sounds): `src/upload/sounds`
- [Model definitions](https://github.com/fabiodevcode/slyhear/tree/main/src/models/attributes): `src/models/attributes`

### Identity and utilities

- [Cookie guard](https://github.com/fabiodevcode/slyhear/blob/main/src/middlewares/cookie.middlewares.js): `src/middlewares/cookie.middlewares.js`
- [Cookie generation](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/user.helpers.js): `src/helpers/user.helpers.js`
- [Cookie crypto](https://github.com/fabiodevcode/slyhear/blob/main/src/utils/crypto.utils.js): `src/utils/crypto.utils.js`
- [String utilities](https://github.com/fabiodevcode/slyhear/blob/main/src/utils/string.utils.js): `src/utils/string.utils.js`
- [Login validation](https://github.com/fabiodevcode/slyhear/blob/main/src/validators/user.validators.js): `src/validators/user.validators.js`

### Browser experience

- [Browser features](https://github.com/fabiodevcode/slyhear/tree/main/src/public/js): `src/public/js`
- [Page templates](https://github.com/fabiodevcode/slyhear/tree/main/src/views/pages): `src/views/pages`
- [Template helpers](https://github.com/fabiodevcode/slyhear/blob/main/src/helpers/hbs_fn.js): `src/helpers/hbs_fn.js`

### Other components

- **User**

## Connections

- User → Server entry: opens app (evidence: `README.md`)
- Server entry → Express app: starts (evidence: `server.js`)
- Express app → Route registry: registers (evidence: `src/app.js`)
- Express app → Model registry: syncs database (evidence: `src/app.js`)
- Express app → Config setup: checks config (evidence: `src/app.js`)
- Express app → Template helpers: configures templates (evidence: `src/app.js`)
- Route registry → Action routes: mounts (evidence: `src/routes/index.js`)
- Route registry → Page routes: mounts (evidence: `src/routes/index.js`)
- Action routes → Action controller: dispatches (evidence: `src/routes/action.routes.js`)
- Page routes → Page controller: dispatches (evidence: `src/routes/default.routes.js`)
- Action routes → Login validation: validates login (evidence: `src/routes/action.routes.js`)
- Action routes → Cookie guard: guards actions (evidence: `src/routes/action.routes.js`)
- Page routes → Cookie guard: guards pages (evidence: `src/routes/default.routes.js`)
- Action controller → Download worker: forks download (evidence: `src/controllers/action.controller.js`)
- Action controller → Model registry: reads and writes (evidence: `src/controllers/action.controller.js`)
- Action controller → Cookie generation: generates cookie (evidence: `src/controllers/action.controller.js`)
- Action controller → String utilities: creates job id (evidence: `src/controllers/action.controller.js`)
- Action controller → Uploaded audio: streams and deletes (evidence: `src/controllers/action.controller.js`)
- Download worker → Download helpers: uses (evidence: `src/workers/downloadChildTask.js`)
- Download worker → Model registry: uses (evidence: `src/workers/downloadChildTask.js`)
- Page controller → Model registry: queries (evidence: `src/controllers/default.controller.js`)
- Page controller → Track preparation: prepares tracks (evidence: `src/controllers/default.controller.js`)
- Page controller → Page templates: renders pages (evidence: `src/controllers/default.controller.js`)
- Model registry → SQLite database: stores records (evidence: `src/models/index.js`)
- Track model → Model builders: builds model (evidence: `src/models/tracks.models.js`)
- Playlist model → Model builders: builds model (evidence: `src/models/playlists.models.js`)
- Download-list model → Model builders: builds model (evidence: `src/models/list.models.js`)
- Settings model → Model builders: builds model (evidence: `src/models/settings.models.js`)
- User model → Model builders: builds model (evidence: `src/models/user.models.js`)
- Model builders → String utilities: capitalizes names (evidence: `src/helpers/models.helpers.js`)
- Model registry → Model definitions: loads definitions
- Cookie guard → Cookie crypto: decrypts cookie (evidence: `src/middlewares/cookie.middlewares.js`)
- Cookie generation → Cookie crypto: uses encryption (evidence: `src/helpers/user.helpers.js`)
- Config setup → String utilities: generates keys (evidence: `src/helpers/app.helpers.js`)
- Browser features → User: provides controls
