# kokakolita02/ada architecture

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

- Interactive diagram: https://gitdiagram.com/kokakolita02/ada
- Repository: https://github.com/kokakolita02/ada

## Overview

ADA is a static browser music player. The main user journey is login, browse/search the catalog, play a track, and manage playlists or listening history; browser localStorage keeps session and user data without a server. The graph includes documented catalog suggestions and help alongside the sampled runtime. Edges use only relationships shown in excerpts or stated in the README; unsampled page wiring is not inferred.

Main entry points: [`HTML/js/explorador.js`](https://github.com/kokakolita02/ada/blob/master/HTML/js/explorador.js) (Search and suggestions), [`HTML/js/reproductor.js`](https://github.com/kokakolita02/ada/blob/master/HTML/js/reproductor.js) (Audio controls), [`HTML/js/app.js`](https://github.com/kokakolita02/ada/blob/master/HTML/js/app.js) (Login), [`HTML/js/playlist.js`](https://github.com/kokakolita02/ada/blob/master/HTML/js/playlist.js) (Playlist management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_login["Login<br/>[app.js]"]
  node_navigation["Session navigation<br/>[navbar.js]"]
  node_menu["Main menu<br/>[menu.html]"]
end

subgraph group_catalog["Catalog discovery"]
  node_catalog_pages["Catalog page<br/>[catalogo.html]"]
  node_catalog_data["Catalog data<br/>[catalogo.js]"]
  node_catalog_json["Song catalog JSON<br/>[canciones.json]"]
  node_explorer["Search and suggestions<br/>[explorador.js]"]
end

subgraph group_playback["Playback"]
  node_player_page["Player interface<br/>[reproductor.html]"]
  node_player_controls["Audio controls<br/>[reproductor.js]"]
  node_audio_files[("Music files")]
end

subgraph group_library["Personal library"]
  node_playlist_page["Playlist page<br/>[playlist.html]"]
  node_playlists["Playlist management<br/>[playlist.js]"]
  node_history["Listening history<br/>[historial.html]"]
end

subgraph group_data["Browser data"]
  node_suggestions[("Saved suggestions<br/>[explorador.js]")]
  node_local_storage[("Browser localStorage")]
  node_users_json["User credentials<br/>[usuarios.json]"]
end

node_listener(("Listener"))

node_listener -->|"signs in"| node_login
node_login -->|"validates against"| node_users_json
node_login -->|"stores session"| node_local_storage
node_navigation -->|"checks session"| node_local_storage
node_navigation -->|"redirects to"| node_login
node_listener -.->|"opens"| node_menu
node_menu -.->|"navigates to"| node_catalog_pages
node_catalog_pages -->|"starts"| node_explorer
node_explorer -->|"fetches"| node_catalog_json
node_explorer -->|"matches playlist tracks"| node_catalog_data
node_listener -.->|"searches and suggests"| node_explorer
node_explorer -.->|"saves locally"| node_suggestions
node_explorer -->|"starts playback"| node_player_controls
node_player_controls -->|"loads track metadata"| node_catalog_data
node_player_controls -->|"plays audio"| node_audio_files
node_listener -.->|"controls playback"| node_player_page
node_player_controls -->|"records history and favorites"| node_local_storage
node_listener -.->|"manages playlists"| node_playlist_page
node_playlists -->|"loads and saves"| node_local_storage
node_playlists -->|"reads track details"| node_catalog_data
node_playlists -->|"queues tracks"| node_player_controls
node_listener -.->|"reviews history"| node_history
node_player_controls -->|"adds played tracks"| node_history

click node_login "https://github.com/kokakolita02/ada/blob/master/HTML/js/app.js"
click node_navigation "https://github.com/kokakolita02/ada/blob/master/HTML/js/navbar.js"
click node_menu "https://github.com/kokakolita02/ada/blob/master/HTML/html/menu.html"
click node_catalog_pages "https://github.com/kokakolita02/ada/blob/master/HTML/html/catalogo.html"
click node_catalog_data "https://github.com/kokakolita02/ada/blob/master/HTML/js/catalogo.js"
click node_catalog_json "https://github.com/kokakolita02/ada/blob/master/HTML/json/canciones.json"
click node_explorer "https://github.com/kokakolita02/ada/blob/master/HTML/js/explorador.js"
click node_suggestions "https://github.com/kokakolita02/ada/blob/master/HTML/js/explorador.js"
click node_player_page "https://github.com/kokakolita02/ada/blob/master/HTML/html/reproductor.html"
click node_player_controls "https://github.com/kokakolita02/ada/blob/master/HTML/js/reproductor.js"
click node_audio_files "https://github.com/kokakolita02/ada/tree/master/HTML/music"
click node_playlist_page "https://github.com/kokakolita02/ada/blob/master/HTML/html/playlist.html"
click node_playlists "https://github.com/kokakolita02/ada/blob/master/HTML/js/playlist.js"
click node_history "https://github.com/kokakolita02/ada/blob/master/HTML/html/historial.html"
click node_users_json "https://github.com/kokakolita02/ada/blob/master/HTML/json/usuarios.json"

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_login,node_navigation,node_menu toneBlue
class node_catalog_pages,node_catalog_data,node_catalog_json,node_explorer toneAmber
class node_player_page,node_player_controls,node_audio_files toneMint
class node_playlist_page,node_playlists,node_history toneRose
class node_suggestions,node_local_storage,node_users_json,node_listener toneIndigo
```

## Components

### Access and navigation

- [Login](https://github.com/kokakolita02/ada/blob/master/HTML/js/app.js): `HTML/js/app.js`
- [Session navigation](https://github.com/kokakolita02/ada/blob/master/HTML/js/navbar.js): `HTML/js/navbar.js`
- [Main menu](https://github.com/kokakolita02/ada/blob/master/HTML/html/menu.html): `HTML/html/menu.html`

### Catalog discovery

- [Catalog page](https://github.com/kokakolita02/ada/blob/master/HTML/html/catalogo.html): `HTML/html/catalogo.html`
- [Catalog data](https://github.com/kokakolita02/ada/blob/master/HTML/js/catalogo.js): `HTML/js/catalogo.js`
- [Song catalog JSON](https://github.com/kokakolita02/ada/blob/master/HTML/json/canciones.json): `HTML/json/canciones.json`
- [Search and suggestions](https://github.com/kokakolita02/ada/blob/master/HTML/js/explorador.js): `HTML/js/explorador.js`

### Playback

- [Player interface](https://github.com/kokakolita02/ada/blob/master/HTML/html/reproductor.html): `HTML/html/reproductor.html`
- [Audio controls](https://github.com/kokakolita02/ada/blob/master/HTML/js/reproductor.js): `HTML/js/reproductor.js`
- [Music files](https://github.com/kokakolita02/ada/tree/master/HTML/music): `HTML/music`

### Personal library

- [Playlist page](https://github.com/kokakolita02/ada/blob/master/HTML/html/playlist.html): `HTML/html/playlist.html`
- [Playlist management](https://github.com/kokakolita02/ada/blob/master/HTML/js/playlist.js): `HTML/js/playlist.js`
- [Listening history](https://github.com/kokakolita02/ada/blob/master/HTML/html/historial.html): `HTML/html/historial.html`

### Browser data

- [Saved suggestions](https://github.com/kokakolita02/ada/blob/master/HTML/js/explorador.js): `HTML/js/explorador.js`
- **Browser localStorage**
- [User credentials](https://github.com/kokakolita02/ada/blob/master/HTML/json/usuarios.json): `HTML/json/usuarios.json`

### Other components

- **Listener**

## Connections

- Listener → Login: signs in (evidence: `HTML/js/app.js`)
- Login → User credentials: validates against (evidence: `HTML/js/app.js`)
- Login → Browser localStorage: stores session (evidence: `HTML/js/app.js`)
- Session navigation → Browser localStorage: checks session (evidence: `HTML/js/navbar.js`)
- Session navigation → Login: redirects to (evidence: `HTML/js/navbar.js`)
- Listener → Main menu: opens (evidence: `README.md`)
- Main menu → Catalog page: navigates to (evidence: `README.md`)
- Catalog page → Search and suggestions: starts (evidence: `README.md`)
- Search and suggestions → Song catalog JSON: fetches (evidence: `HTML/js/explorador.js`)
- Search and suggestions → Catalog data: matches playlist tracks (evidence: `HTML/js/explorador.js`)
- Listener → Search and suggestions: searches and suggests (evidence: `README.md`)
- Search and suggestions → Saved suggestions: saves locally (evidence: `README.md`)
- Search and suggestions → Audio controls: starts playback (evidence: `HTML/js/explorador.js`)
- Audio controls → Catalog data: loads track metadata (evidence: `HTML/js/reproductor.js`)
- Audio controls → Music files: plays audio (evidence: `HTML/js/reproductor.js`)
- Listener → Player interface: controls playback (evidence: `README.md`)
- Audio controls → Browser localStorage: records history and favorites (evidence: `HTML/js/reproductor.js`)
- Listener → Playlist page: manages playlists (evidence: `README.md`)
- Playlist management → Browser localStorage: loads and saves (evidence: `HTML/js/playlist.js`)
- Playlist management → Catalog data: reads track details (evidence: `HTML/js/playlist.js`)
- Playlist management → Audio controls: queues tracks (evidence: `HTML/js/playlist.js`)
- Listener → Listening history: reviews history (evidence: `README.md`)
- Audio controls → Listening history: adds played tracks (evidence: `HTML/js/reproductor.js`)
