# clvansa/iptv-panel architecture

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

- Interactive diagram: https://gitdiagram.com/clvansa/iptv-panel
- Repository: https://github.com/clvansa/iptv-panel

## Overview

IPTV Panel manages channel libraries and ordered playlists, imports remote M3U feeds, and supports stream playback and M3U export. The main user workflow runs from the React dashboard through API calls to Express handlers and Sequelize-backed channel or playlist data. Separate branches cover import enrichment, filtering, playlist editing, stream checks/proxying, and export. Source excerpts and the index support the backend relationships; frontend-to-backend HTTP wiring and some README capabilities are not directly shown, so those links are marked unverified or omitted.

Main entry points: [`backend/models/Channel.js`](https://github.com/clvansa/iptv-panel/blob/master/backend/models/Channel.js) (Channel Records), [`backend/app.js`](https://github.com/clvansa/iptv-panel/blob/master/backend/app.js) (Express API), [`backend/services/import.service.js`](https://github.com/clvansa/iptv-panel/blob/master/backend/services/import.service.js) (M3U Import), [`frontend/src/routes/Router.jsx`](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/routes/Router.jsx) (Page Router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_router["Page Router<br/>[Router.jsx]"]
  node_channel_pages["Channel Pages<br/>[Channels.jsx]"]
  node_channel_forms["Channel Forms<br/>[AddChannel.jsx]"]
  node_import_page["Import Page<br/>[ImportPlaylist.jsx]"]
  node_playlist_pages["Playlist Pages<br/>[PlaylistEditor.jsx]"]
  node_player["Live Player<br/>[LivePlayer.jsx]"]
end

subgraph group_api["API Layer"]
  node_channel_api["Channel API Client<br/>[channels.js]"]
  node_playlist_api["Playlist API Client<br/>[playlists.js]"]
  node_filter_api["Filter API Client<br/>[filters.js]"]
  node_http_client["HTTP Client<br/>[axios.js]"]
  node_express_app["Express API<br/>[app.js]"]
end

subgraph group_catalog["Channel Catalog"]
  node_channel_routes["Channel Routes<br/>[channel.routes.js]"]
  node_channel_controller["Channel Operations"]
  node_filter_routes["Filter Routes<br/>[country.routes.js]"]
  node_filter_handlers["Filter Handlers"]
  node_channel_model[("Channel Records<br/>[Channel.js]")]
  node_database[("MySQL Connection<br/>[database.js]")]
end

subgraph group_playlists["Playlist Workflows"]
  node_playlist_routes["Playlist Routes<br/>[playlist.routes.js]"]
  node_playlist_controller["Playlist Operations"]
  node_playlist_model[("Playlist Records<br/>[Playlist.js]")]
  node_membership_model[("Playlist Membership<br/>[PlaylistChannel.js]")]
end

subgraph group_streaming["Import and Streaming"]
  node_import_routes["Import Routes<br/>[import.routes.js]"]
  node_import_controller["Import Handler"]
  node_import_service["M3U Import<br/>[import.service.js]"]
  node_m3u_parser["M3U Parser<br/>[parseM3u.js]"]
  node_metadata_sync["Metadata Sync"]
  node_country_sync["Country Sync"]
  node_stream_checker["Stream Checker"]
  node_export_routes["Export Routes<br/>[export.routes.js]"]
  node_export_controller["Export Handler"]
  node_export_service["M3U Export<br/>[export.service.js]"]
end

node_viewer(("Panel User"))
node_external_feed["Remote M3U Feed"]
node_stream_source(("Stream Source"))

node_viewer -->|"uses"| node_router
node_router -->|"routes to"| node_channel_pages
node_router -->|"routes to"| node_channel_forms
node_router -->|"routes to"| node_import_page
node_router -->|"routes to"| node_playlist_pages
node_channel_pages -->|"calls"| node_channel_api
node_channel_forms -->|"calls"| node_channel_api
node_import_page -->|"calls"| node_channel_api
node_playlist_pages -->|"calls"| node_playlist_api
node_channel_pages -->|"loads filters"| node_filter_api
node_playlist_pages -->|"renders"| node_player
node_channel_api -->|"uses"| node_http_client
node_playlist_api -->|"uses"| node_http_client
node_filter_api -->|"uses"| node_http_client
node_http_client -.->|"sends API requests"| node_express_app
node_express_app -->|"mounts"| node_channel_routes
node_express_app -->|"mounts"| node_playlist_routes
node_express_app -->|"mounts"| node_import_routes
node_express_app -->|"mounts"| node_export_routes
node_express_app -->|"mounts"| node_filter_routes
node_channel_routes -->|"dispatches"| node_channel_controller
node_channel_controller -->|"queries"| node_channel_model
node_channel_controller -->|"checks streams"| node_stream_checker
node_filter_routes -->|"dispatches"| node_filter_handlers
node_filter_handlers -->|"queries"| node_channel_model
node_playlist_routes -->|"dispatches"| node_playlist_controller
node_playlist_controller -->|"queries"| node_playlist_model
node_playlist_controller -->|"queries"| node_channel_model
node_playlist_controller -->|"updates membership"| node_membership_model
node_import_routes -->|"dispatches"| node_import_controller
node_import_controller -->|"invokes"| node_import_service
node_import_service -->|"fetches feed"| node_external_feed
node_import_service -->|"parses feed"| node_m3u_parser
node_import_service -->|"deduplicates and stores"| node_channel_model
node_import_service -->|"synchronizes metadata"| node_metadata_sync
node_import_service -->|"synchronizes countries"| node_country_sync
node_metadata_sync -->|"updates"| node_channel_model
node_country_sync -->|"updates"| node_channel_model
node_channel_controller -->|"proxies stream"| node_stream_source
node_player -.->|"plays stream"| node_stream_source
node_export_routes -->|"dispatches"| node_export_controller
node_export_controller -->|"generates M3U"| node_export_service
node_export_controller -->|"loads playlist"| node_playlist_model
node_export_controller -->|"loads channels"| node_channel_model
node_export_service -->|"reads channels"| node_channel_model
node_channel_model -->|"uses connection"| node_database
node_playlist_model -->|"uses connection"| node_database
node_membership_model -->|"uses connection"| node_database

click node_router "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/routes/Router.jsx"
click node_channel_pages "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/Channels.jsx"
click node_channel_forms "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/AddChannel.jsx"
click node_import_page "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/ImportPlaylist.jsx"
click node_playlist_pages "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/PlaylistEditor.jsx"
click node_player "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/components/player/LivePlayer.jsx"
click node_channel_api "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/channels.js"
click node_playlist_api "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/playlists.js"
click node_filter_api "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/filters.js"
click node_http_client "https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/axios.js"
click node_express_app "https://github.com/clvansa/iptv-panel/blob/master/backend/app.js"
click node_channel_routes "https://github.com/clvansa/iptv-panel/blob/master/backend/routes/channel.routes.js"
click node_channel_controller "https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/channel.controller.js"
click node_filter_routes "https://github.com/clvansa/iptv-panel/blob/master/backend/routes/country.routes.js"
click node_filter_handlers "https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/country.controller.js"
click node_channel_model "https://github.com/clvansa/iptv-panel/blob/master/backend/models/Channel.js"
click node_playlist_routes "https://github.com/clvansa/iptv-panel/blob/master/backend/routes/playlist.routes.js"
click node_playlist_controller "https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/playlist.controller.js"
click node_playlist_model "https://github.com/clvansa/iptv-panel/blob/master/backend/models/Playlist.js"
click node_membership_model "https://github.com/clvansa/iptv-panel/blob/master/backend/models/PlaylistChannel.js"
click node_import_routes "https://github.com/clvansa/iptv-panel/blob/master/backend/routes/import.routes.js"
click node_import_controller "https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/import.controller.js"
click node_import_service "https://github.com/clvansa/iptv-panel/blob/master/backend/services/import.service.js"
click node_m3u_parser "https://github.com/clvansa/iptv-panel/blob/master/backend/utils/parseM3u.js"
click node_metadata_sync "https://github.com/clvansa/iptv-panel/blob/master/backend/services/syncMetadata.service.js"
click node_country_sync "https://github.com/clvansa/iptv-panel/blob/master/backend/services/syncCountries.service.js"
click node_stream_checker "https://github.com/clvansa/iptv-panel/blob/master/backend/services/streamChecker.service.js"
click node_export_routes "https://github.com/clvansa/iptv-panel/blob/master/backend/routes/export.routes.js"
click node_export_controller "https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/export.controller.js"
click node_export_service "https://github.com/clvansa/iptv-panel/blob/master/backend/services/export.service.js"
click node_database "https://github.com/clvansa/iptv-panel/blob/master/backend/config/database.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_router,node_channel_pages,node_channel_forms,node_import_page,node_playlist_pages,node_player,node_viewer toneBlue
class node_channel_api,node_playlist_api,node_filter_api,node_http_client,node_express_app toneAmber
class node_channel_routes,node_channel_controller,node_filter_routes,node_filter_handlers,node_channel_model,node_database toneMint
class node_playlist_routes,node_playlist_controller,node_playlist_model,node_membership_model toneRose
class node_import_routes,node_import_controller,node_import_service,node_m3u_parser,node_metadata_sync,node_country_sync,node_stream_checker,node_export_routes,node_export_controller,node_export_service,node_external_feed,node_stream_source toneIndigo
```

## Components

### Dashboard

- [Page Router](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/routes/Router.jsx): `frontend/src/routes/Router.jsx`
- [Channel Pages](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/Channels.jsx): `frontend/src/pages/Channels.jsx`
- [Channel Forms](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/AddChannel.jsx): `frontend/src/pages/AddChannel.jsx`
- [Import Page](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/ImportPlaylist.jsx): `frontend/src/pages/ImportPlaylist.jsx`
- [Playlist Pages](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/pages/PlaylistEditor.jsx): `frontend/src/pages/PlaylistEditor.jsx`
- [Live Player](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/components/player/LivePlayer.jsx): `frontend/src/components/player/LivePlayer.jsx`

### API Layer

- [Channel API Client](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/channels.js): `frontend/src/api/channels.js`
- [Playlist API Client](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/playlists.js): `frontend/src/api/playlists.js`
- [Filter API Client](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/filters.js): `frontend/src/api/filters.js`
- [HTTP Client](https://github.com/clvansa/iptv-panel/blob/master/frontend/src/api/axios.js): `frontend/src/api/axios.js`
- [Express API](https://github.com/clvansa/iptv-panel/blob/master/backend/app.js): `backend/app.js`

### Channel Catalog

- [Channel Routes](https://github.com/clvansa/iptv-panel/blob/master/backend/routes/channel.routes.js): `backend/routes/channel.routes.js`
- [Channel Operations](https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/channel.controller.js): `backend/controllers/channel.controller.js`
- [Filter Routes](https://github.com/clvansa/iptv-panel/blob/master/backend/routes/country.routes.js): `backend/routes/country.routes.js`
- [Filter Handlers](https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/country.controller.js): `backend/controllers/country.controller.js`
- [Channel Records](https://github.com/clvansa/iptv-panel/blob/master/backend/models/Channel.js): `backend/models/Channel.js`
- [MySQL Connection](https://github.com/clvansa/iptv-panel/blob/master/backend/config/database.js): `backend/config/database.js`

### Playlist Workflows

- [Playlist Routes](https://github.com/clvansa/iptv-panel/blob/master/backend/routes/playlist.routes.js): `backend/routes/playlist.routes.js`
- [Playlist Operations](https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/playlist.controller.js): `backend/controllers/playlist.controller.js`
- [Playlist Records](https://github.com/clvansa/iptv-panel/blob/master/backend/models/Playlist.js): `backend/models/Playlist.js`
- [Playlist Membership](https://github.com/clvansa/iptv-panel/blob/master/backend/models/PlaylistChannel.js): `backend/models/PlaylistChannel.js`

### Import and Streaming

- [Import Routes](https://github.com/clvansa/iptv-panel/blob/master/backend/routes/import.routes.js): `backend/routes/import.routes.js`
- [Import Handler](https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/import.controller.js): `backend/controllers/import.controller.js`
- [M3U Import](https://github.com/clvansa/iptv-panel/blob/master/backend/services/import.service.js): `backend/services/import.service.js`
- [M3U Parser](https://github.com/clvansa/iptv-panel/blob/master/backend/utils/parseM3u.js): `backend/utils/parseM3u.js`
- [Metadata Sync](https://github.com/clvansa/iptv-panel/blob/master/backend/services/syncMetadata.service.js): `backend/services/syncMetadata.service.js`
- [Country Sync](https://github.com/clvansa/iptv-panel/blob/master/backend/services/syncCountries.service.js): `backend/services/syncCountries.service.js`
- [Stream Checker](https://github.com/clvansa/iptv-panel/blob/master/backend/services/streamChecker.service.js): `backend/services/streamChecker.service.js`
- [Export Routes](https://github.com/clvansa/iptv-panel/blob/master/backend/routes/export.routes.js): `backend/routes/export.routes.js`
- [Export Handler](https://github.com/clvansa/iptv-panel/blob/master/backend/controllers/export.controller.js): `backend/controllers/export.controller.js`
- [M3U Export](https://github.com/clvansa/iptv-panel/blob/master/backend/services/export.service.js): `backend/services/export.service.js`

### Other components

- **Panel User**
- **Remote M3U Feed**
- **Stream Source**

## Connections

- Panel User → Page Router: uses (evidence: `frontend/src/routes/Router.jsx`)
- Page Router → Channel Pages: routes to (evidence: `frontend/src/routes/Router.jsx`)
- Page Router → Channel Forms: routes to (evidence: `frontend/src/routes/Router.jsx`)
- Page Router → Import Page: routes to (evidence: `frontend/src/routes/Router.jsx`)
- Page Router → Playlist Pages: routes to (evidence: `frontend/src/routes/Router.jsx`)
- Channel Pages → Channel API Client: calls (evidence: `frontend/src/pages/Channels.jsx`)
- Channel Forms → Channel API Client: calls (evidence: `frontend/src/pages/AddChannel.jsx`)
- Import Page → Channel API Client: calls (evidence: `frontend/src/pages/ImportPlaylist.jsx`)
- Playlist Pages → Playlist API Client: calls (evidence: `frontend/src/pages/PlaylistEditor.jsx`)
- Channel Pages → Filter API Client: loads filters (evidence: `frontend/src/pages/Channels.jsx`)
- Playlist Pages → Live Player: renders (evidence: `frontend/src/pages/PlaylistEditor.jsx`)
- Channel API Client → HTTP Client: uses
- Playlist API Client → HTTP Client: uses (evidence: `frontend/src/api/playlists.js`)
- Filter API Client → HTTP Client: uses (evidence: `frontend/src/api/filters.js`)
- HTTP Client → Express API: sends API requests
- Express API → Channel Routes: mounts (evidence: `backend/app.js`)
- Express API → Playlist Routes: mounts (evidence: `backend/app.js`)
- Express API → Import Routes: mounts (evidence: `backend/app.js`)
- Express API → Export Routes: mounts (evidence: `backend/app.js`)
- Express API → Filter Routes: mounts (evidence: `backend/app.js`)
- Channel Routes → Channel Operations: dispatches (evidence: `backend/routes/channel.routes.js`)
- Channel Operations → Channel Records: queries (evidence: `backend/controllers/channel.controller.js`)
- Channel Operations → Stream Checker: checks streams (evidence: `backend/controllers/channel.controller.js`)
- Filter Routes → Filter Handlers: dispatches (evidence: `backend/routes/country.routes.js`)
- Filter Handlers → Channel Records: queries (evidence: `backend/controllers/country.controller.js`)
- Playlist Routes → Playlist Operations: dispatches (evidence: `backend/routes/playlist.routes.js`)
- Playlist Operations → Playlist Records: queries (evidence: `backend/controllers/playlist.controller.js`)
- Playlist Operations → Channel Records: queries (evidence: `backend/controllers/playlist.controller.js`)
- Playlist Operations → Playlist Membership: updates membership (evidence: `backend/controllers/playlist.controller.js`)
- Import Routes → Import Handler: dispatches (evidence: `backend/routes/import.routes.js`)
- Import Handler → M3U Import: invokes (evidence: `backend/controllers/import.controller.js`)
- M3U Import → Remote M3U Feed: fetches feed (evidence: `backend/services/import.service.js`)
- M3U Import → M3U Parser: parses feed (evidence: `backend/services/import.service.js`)
- M3U Import → Channel Records: deduplicates and stores (evidence: `backend/services/import.service.js`)
- M3U Import → Metadata Sync: synchronizes metadata (evidence: `backend/services/import.service.js`)
- M3U Import → Country Sync: synchronizes countries (evidence: `backend/services/import.service.js`)
- Metadata Sync → Channel Records: updates (evidence: `backend/services/syncMetadata.service.js`)
- Country Sync → Channel Records: updates (evidence: `backend/services/syncCountries.service.js`)
- Channel Operations → Stream Source: proxies stream (evidence: `backend/controllers/channel.controller.js`)
- Live Player → Stream Source: plays stream
- Export Routes → Export Handler: dispatches (evidence: `backend/routes/export.routes.js`)
- Export Handler → M3U Export: generates M3U (evidence: `backend/controllers/export.controller.js`)
- Export Handler → Playlist Records: loads playlist (evidence: `backend/controllers/export.controller.js`)
- Export Handler → Channel Records: loads channels (evidence: `backend/controllers/export.controller.js`)
- M3U Export → Channel Records: reads channels (evidence: `backend/services/export.service.js`)
- Channel Records → MySQL Connection: uses connection (evidence: `backend/models/Channel.js`)
- Playlist Records → MySQL Connection: uses connection (evidence: `backend/models/Playlist.js`)
- Playlist Membership → MySQL Connection: uses connection (evidence: `backend/models/PlaylistChannel.js`)
