# fergader1/seminario architecture

> Architecture diagram of the GitHub repository fergader1/seminario, 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/fergader1/seminario
- Repository: https://github.com/fergader1/seminario

## Overview

This is an Ionic/Angular music-listening app. Its visible user workflow is routed access through login/registration and an intro gate, followed by music browsing and track playback; users can also search, browse artists/albums, manage favorites, and change theme. The sampled code shows API-backed music and account operations alongside local storage for account state, favorites, and preferences. The README provides no product description, so unsampled feature wiring is omitted where source evidence does not establish it.

Main entry points: [`src/app/app.routes.ts`](https://github.com/fergader1/seminario/blob/main/src/app/app.routes.ts) (Route Map), [`src/app/components/header/header.component.ts`](https://github.com/fergader1/seminario/blob/main/src/app/components/header/header.component.ts) (Header), [`src/app/services/storage/storage.service.ts`](https://github.com/fergader1/seminario/blob/main/src/app/services/storage/storage.service.ts) (Local Storage), [`src/app/home/home.page.ts`](https://github.com/fergader1/seminario/blob/main/src/app/home/home.page.ts) (Home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation and Shell"]
  node_routes["Route Map<br/>[app.routes.ts]"]
  node_layout["App Layout"]
  node_header["Header"]
  node_tabs["Navigation Tabs<br/>[tabs.component.ts]"]
end

subgraph group_accounts["Accounts and Preferences"]
  node_intro["Intro<br/>[intro.page.ts]"]
  node_login["Login Page<br/>[login.page.ts]"]
  node_register["Registration Page<br/>[register.page.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_registration["Registration Logic"]
  node_guards["Route Guards"]
  node_theme["Theme Controls<br/>[theme.component.ts]"]
  node_theme_service["Theme State<br/>[theme.service.ts]"]
end

subgraph group_music["Music Discovery and Playback"]
  node_home["Home<br/>[home.page.ts]"]
  node_genres["Albums and Genres"]
  node_artists["Artists<br/>[artists.page.ts]"]
  node_search["Track Search"]
  node_music_service["Music Data<br/>[music.service.ts]"]
  node_playback_ui["Playback View"]
  node_song_modal["Song Modal"]
  node_playback["Audio Playback"]
  node_favorites["Favorites"]
  node_track_types["Track Model<br/>[ITracksResponse.ts]"]
end

subgraph group_state["Local State"]
  node_storage[("Local Storage<br/>[storage.service.ts]")]
end

node_user(("Listener"))
node_music_api{{"Music API"}}
node_account_api{{"Account API"}}

node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_register
node_routes -->|"routes to"| node_intro
node_routes -->|"routes to"| node_layout
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_playback_ui
node_routes -->|"routes to"| node_genres
node_routes -->|"routes to"| node_artists
node_routes -->|"routes to"| node_search
node_layout -->|"renders"| node_tabs
node_login -->|"calls"| node_auth
node_register -->|"calls"| node_registration
node_guards -->|"reads"| node_storage
node_intro -->|"reads and writes"| node_storage
node_auth -->|"reads and writes"| node_storage
node_registration -->|"reads and writes"| node_storage
node_auth -->|"posts login"| node_account_api
node_registration -->|"posts signup"| node_account_api
node_header -->|"renders"| node_theme
node_home -->|"renders"| node_header
node_home -->|"loads tracks"| node_music_service
node_music_service -->|"requests catalog"| node_music_api
node_home -->|"toggles favorites"| node_favorites
node_favorites -->|"reads and writes"| node_storage
node_home -->|"starts playback"| node_playback
node_theme -.->|"controls"| node_theme_service
node_theme_service -->|"reads and writes"| node_storage
node_artists -->|"renders"| node_header
node_genres -->|"renders"| node_header
node_search -->|"renders"| node_header
node_playback_ui -->|"renders"| node_header
node_song_modal -->|"uses playback"| node_playback

click node_routes "https://github.com/fergader1/seminario/blob/main/src/app/app.routes.ts"
click node_layout "https://github.com/fergader1/seminario/blob/main/src/app/components/layout/layout.component.ts"
click node_header "https://github.com/fergader1/seminario/blob/main/src/app/components/header/header.component.ts"
click node_tabs "https://github.com/fergader1/seminario/blob/main/src/app/components/tabs/tabs.component.ts"
click node_intro "https://github.com/fergader1/seminario/blob/main/src/app/intro/intro.page.ts"
click node_login "https://github.com/fergader1/seminario/blob/main/src/app/login/login.page.ts"
click node_register "https://github.com/fergader1/seminario/blob/main/src/app/register/register.page.ts"
click node_auth "https://github.com/fergader1/seminario/blob/main/src/app/services/auth/auth.service.ts"
click node_registration "https://github.com/fergader1/seminario/blob/main/src/app/services/register/register.service.ts"
click node_guards "https://github.com/fergader1/seminario/tree/main/src/app/guards"
click node_theme "https://github.com/fergader1/seminario/blob/main/src/app/components/theme/theme.component.ts"
click node_theme_service "https://github.com/fergader1/seminario/blob/main/src/app/services/theme/theme.service.ts"
click node_home "https://github.com/fergader1/seminario/blob/main/src/app/home/home.page.ts"
click node_genres "https://github.com/fergader1/seminario/blob/main/src/app/components/genres/genres.component.ts"
click node_artists "https://github.com/fergader1/seminario/blob/main/src/app/artists/artists.page.ts"
click node_search "https://github.com/fergader1/seminario/blob/main/src/app/components/search/search.component.ts"
click node_music_service "https://github.com/fergader1/seminario/blob/main/src/app/services/music/music.service.ts"
click node_playback_ui "https://github.com/fergader1/seminario/blob/main/src/app/components/listen-now/listen-now.component.ts"
click node_song_modal "https://github.com/fergader1/seminario/blob/main/src/app/songs-modal/songs-modal.page.ts"
click node_playback "https://github.com/fergader1/seminario/blob/main/src/app/services/listen-now/listen-now.service.ts"
click node_favorites "https://github.com/fergader1/seminario/blob/main/src/app/services/favorite/favorite.service.ts"
click node_track_types "https://github.com/fergader1/seminario/blob/main/src/app/interfaces/ITracksResponse.ts"
click node_storage "https://github.com/fergader1/seminario/blob/main/src/app/services/storage/storage.service.ts"

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_routes,node_layout,node_header,node_tabs toneBlue
class node_intro,node_login,node_register,node_auth,node_registration,node_guards,node_theme,node_theme_service toneAmber
class node_home,node_genres,node_artists,node_search,node_music_service,node_playback_ui,node_song_modal,node_playback,node_favorites,node_track_types,node_music_api,node_account_api toneMint
class node_storage toneRose
class node_user toneIndigo
```

## Components

### Navigation and Shell

- [Route Map](https://github.com/fergader1/seminario/blob/main/src/app/app.routes.ts): `src/app/app.routes.ts`
- [App Layout](https://github.com/fergader1/seminario/blob/main/src/app/components/layout/layout.component.ts): `src/app/components/layout/layout.component.ts`
- [Header](https://github.com/fergader1/seminario/blob/main/src/app/components/header/header.component.ts): `src/app/components/header/header.component.ts`
- [Navigation Tabs](https://github.com/fergader1/seminario/blob/main/src/app/components/tabs/tabs.component.ts): `src/app/components/tabs/tabs.component.ts`

### Accounts and Preferences

- [Intro](https://github.com/fergader1/seminario/blob/main/src/app/intro/intro.page.ts): `src/app/intro/intro.page.ts`
- [Login Page](https://github.com/fergader1/seminario/blob/main/src/app/login/login.page.ts): `src/app/login/login.page.ts`
- [Registration Page](https://github.com/fergader1/seminario/blob/main/src/app/register/register.page.ts): `src/app/register/register.page.ts`
- [Authentication](https://github.com/fergader1/seminario/blob/main/src/app/services/auth/auth.service.ts): `src/app/services/auth/auth.service.ts`
- [Registration Logic](https://github.com/fergader1/seminario/blob/main/src/app/services/register/register.service.ts): `src/app/services/register/register.service.ts`
- [Route Guards](https://github.com/fergader1/seminario/tree/main/src/app/guards): `src/app/guards`
- [Theme Controls](https://github.com/fergader1/seminario/blob/main/src/app/components/theme/theme.component.ts): `src/app/components/theme/theme.component.ts`
- [Theme State](https://github.com/fergader1/seminario/blob/main/src/app/services/theme/theme.service.ts): `src/app/services/theme/theme.service.ts`

### Music Discovery and Playback

- [Home](https://github.com/fergader1/seminario/blob/main/src/app/home/home.page.ts): `src/app/home/home.page.ts`
- [Albums and Genres](https://github.com/fergader1/seminario/blob/main/src/app/components/genres/genres.component.ts): `src/app/components/genres/genres.component.ts`
- [Artists](https://github.com/fergader1/seminario/blob/main/src/app/artists/artists.page.ts): `src/app/artists/artists.page.ts`
- [Track Search](https://github.com/fergader1/seminario/blob/main/src/app/components/search/search.component.ts): `src/app/components/search/search.component.ts`
- [Music Data](https://github.com/fergader1/seminario/blob/main/src/app/services/music/music.service.ts): `src/app/services/music/music.service.ts`
- [Playback View](https://github.com/fergader1/seminario/blob/main/src/app/components/listen-now/listen-now.component.ts): `src/app/components/listen-now/listen-now.component.ts`
- [Song Modal](https://github.com/fergader1/seminario/blob/main/src/app/songs-modal/songs-modal.page.ts): `src/app/songs-modal/songs-modal.page.ts`
- [Audio Playback](https://github.com/fergader1/seminario/blob/main/src/app/services/listen-now/listen-now.service.ts): `src/app/services/listen-now/listen-now.service.ts`
- [Favorites](https://github.com/fergader1/seminario/blob/main/src/app/services/favorite/favorite.service.ts): `src/app/services/favorite/favorite.service.ts`
- [Track Model](https://github.com/fergader1/seminario/blob/main/src/app/interfaces/ITracksResponse.ts): `src/app/interfaces/ITracksResponse.ts`

### Local State

- [Local Storage](https://github.com/fergader1/seminario/blob/main/src/app/services/storage/storage.service.ts): `src/app/services/storage/storage.service.ts`

### Other components

- **Listener**
- **Music API**
- **Account API**

## Connections

- Route Map → Login Page: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Registration Page: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Intro: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → App Layout: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Home: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Playback View: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Albums and Genres: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Artists: routes to (evidence: `src/app/app.routes.ts`)
- Route Map → Track Search: routes to (evidence: `src/app/app.routes.ts`)
- App Layout → Navigation Tabs: renders (evidence: `src/app/components/layout/layout.component.ts`)
- Login Page → Authentication: calls (evidence: `src/app/login/login.page.ts`)
- Registration Page → Registration Logic: calls (evidence: `src/app/register/register.page.ts`)
- Route Guards → Local Storage: reads (evidence: `src/app/guards/login.guard.ts`)
- Intro → Local Storage: reads and writes (evidence: `src/app/intro/intro.page.ts`)
- Authentication → Local Storage: reads and writes (evidence: `src/app/services/auth/auth.service.ts`)
- Registration Logic → Local Storage: reads and writes (evidence: `src/app/services/register/register.service.ts`)
- Authentication → Account API: posts login (evidence: `src/app/services/auth/auth.service.ts`)
- Registration Logic → Account API: posts signup (evidence: `src/app/services/register/register.service.ts`)
- Header → Theme Controls: renders (evidence: `src/app/components/header/header.component.ts`)
- Home → Header: renders (evidence: `src/app/home/home.page.ts`)
- Home → Music Data: loads tracks (evidence: `src/app/home/home.page.ts`)
- Music Data → Music API: requests catalog (evidence: `src/app/services/music/music.service.ts`)
- Home → Favorites: toggles favorites (evidence: `src/app/home/home.page.ts`)
- Favorites → Local Storage: reads and writes (evidence: `src/app/services/favorite/favorite.service.ts`)
- Home → Audio Playback: starts playback (evidence: `src/app/home/home.page.ts`)
- Theme Controls → Theme State: controls
- Theme State → Local Storage: reads and writes (evidence: `src/app/services/theme/theme.service.ts`)
- Artists → Header: renders (evidence: `src/app/artists/artists.page.ts`)
- Albums and Genres → Header: renders (evidence: `src/app/components/genres/genres.component.ts`)
- Track Search → Header: renders (evidence: `src/app/components/search/search.component.ts`)
- Playback View → Header: renders (evidence: `src/app/components/listen-now/listen-now.component.ts`)
- Song Modal → Audio Playback: uses playback (evidence: `src/app/songs-modal/songs-modal.page.ts`)
