# rdkcentral/tdk-testmanager-deployment architecture

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

- Interactive diagram: https://gitdiagram.com/rdkcentral/tdk-testmanager-deployment
- Repository: https://github.com/rdkcentral/tdk-testmanager-deployment

## Overview

This repository deploys the TDK Test Manager application and also provides a small API for uploading and deploying frontend UI upgrades. The principal workflow is an administrator uploading a UI archive, the API extracting it, and then invoking the deployment script; the API also exposes deployment logs. Docker Compose coordinates the application services, while the repository carries database initialization data and release migrations. Docker Compose internals and migration execution wiring were not sampled, so those relationships are limited to what the README documents.

Main entry points: [`frontend-deployment-nodeapp/server.js`](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js) (Upgrade API), [`docker/database`](https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/database) (MySQL Database), [`docker/docker-compose.yml`](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/docker-compose.yml) (Compose Services), [`docker/backend`](https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/backend) (Backend Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_upgrade["UI Upgrade"]
  node_upgrade_api["Upgrade API<br/>[server.js]"]
  node_upload_extract["Upload and Extract<br/>[server.js]"]
  node_deploy_script["Deploy Script<br/>[deploy.sh]"]
  node_deployment_logs["Deployment Logs<br/>[server.js]"]
end

subgraph group_deployment["Application Deployment"]
  node_compose["Compose Services<br/>[docker-compose.yml]"]
  node_backend["Backend Service"]
  node_frontend["Frontend Service"]
  node_nginx["Nginx Proxy<br/>[nginx.conf]"]
end

subgraph group_data["Database Data"]
  node_database[("MySQL Database")]
  node_init_dump["Database Initialization"]
  node_release_migrations["Release Migrations"]
  node_recovery_dump["Recovery Dump"]
end

node_admin(("Administrator"))

node_admin -->|"uploads build"| node_upgrade_api
node_upgrade_api -->|"accepts archive"| node_upload_extract
node_upgrade_api -->|"invokes deployment"| node_deploy_script
node_admin -->|"requests logs"| node_upgrade_api
node_upgrade_api -->|"reads latest"| node_deployment_logs
node_compose -->|"orchestrates"| node_backend
node_compose -->|"orchestrates"| node_frontend
node_compose -->|"orchestrates"| node_database
node_nginx -->|"proxies API"| node_backend
node_database -.->|"loads initialization"| node_init_dump
node_release_migrations -.->|"updates data"| node_database
node_database -.->|"recovery data"| node_recovery_dump

click node_upgrade_api "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js"
click node_upload_extract "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js"
click node_deploy_script "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/deploy.sh"
click node_deployment_logs "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js"
click node_compose "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/docker-compose.yml"
click node_backend "https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/backend"
click node_frontend "https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/frontend"
click node_nginx "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/nginx.conf"
click node_database "https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/database"
click node_init_dump "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/database/init/tdk-master-data-dump.sql"
click node_release_migrations "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/datamigration/changelogs/changelog-master.xml"
click node_recovery_dump "https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/datamigration/tdk-data-recovery-dump.sql"

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_upgrade_api,node_upload_extract,node_deploy_script,node_deployment_logs toneBlue
class node_compose,node_backend,node_frontend,node_nginx toneAmber
class node_database,node_init_dump,node_release_migrations,node_recovery_dump toneMint
class node_admin toneIndigo
```

## Components

### UI Upgrade

- [Upgrade API](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js): `frontend-deployment-nodeapp/server.js`
- [Upload and Extract](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js): `frontend-deployment-nodeapp/server.js`
- [Deploy Script](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/deploy.sh): `frontend-deployment-nodeapp/deploy.sh`
- [Deployment Logs](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/frontend-deployment-nodeapp/server.js): `frontend-deployment-nodeapp/server.js`

### Application Deployment

- [Compose Services](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/docker-compose.yml): `docker/docker-compose.yml`
- [Backend Service](https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/backend): `docker/backend`
- [Frontend Service](https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/frontend): `docker/frontend`
- [Nginx Proxy](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/nginx.conf): `docker/nginx.conf`

### Database Data

- [MySQL Database](https://github.com/rdkcentral/tdk-testmanager-deployment/tree/main/docker/database): `docker/database`
- [Database Initialization](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/docker/database/init/tdk-master-data-dump.sql): `docker/database/init/tdk-master-data-dump.sql`
- [Release Migrations](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/datamigration/changelogs/changelog-master.xml): `datamigration/changelogs/changelog-master.xml`
- [Recovery Dump](https://github.com/rdkcentral/tdk-testmanager-deployment/blob/main/datamigration/tdk-data-recovery-dump.sql): `datamigration/tdk-data-recovery-dump.sql`

### Other components

- **Administrator**

## Connections

- Administrator → Upgrade API: uploads build (evidence: `frontend-deployment-nodeapp/server.js`)
- Upgrade API → Upload and Extract: accepts archive (evidence: `frontend-deployment-nodeapp/server.js`)
- Upgrade API → Deploy Script: invokes deployment (evidence: `frontend-deployment-nodeapp/server.js`)
- Administrator → Upgrade API: requests logs (evidence: `frontend-deployment-nodeapp/server.js`)
- Upgrade API → Deployment Logs: reads latest (evidence: `frontend-deployment-nodeapp/server.js`)
- Compose Services → Backend Service: orchestrates (evidence: `README.md`)
- Compose Services → Frontend Service: orchestrates (evidence: `README.md`)
- Compose Services → MySQL Database: orchestrates (evidence: `README.md`)
- Nginx Proxy → Backend Service: proxies API (evidence: `README.md`)
- MySQL Database → Database Initialization: loads initialization
- Release Migrations → MySQL Database: updates data
- MySQL Database → Recovery Dump: recovery data
