From 135cea6c76b95ecee023750b962890b86c6502d7 Mon Sep 17 00:00:00 2001
From: XShine555 <xshine555@gmail.com>
Date: Wed, 15 Jul 2026 16:10:18 +0200
Subject: [PATCH] chore(deploy): add pgAdmin to the dev stack

Runs alongside Postgres in the unified compose file at
http://localhost:5050, config via PGADMIN_* env vars.
---
 deploy/.env.example       |  5 +++++
 deploy/docker-compose.yml | 17 +++++++++++++++++
 deploy/up.ps1             |  1 +
 3 files changed, 23 insertions(+)

diff --git a/deploy/.env.example b/deploy/.env.example
index 7f1d7e9..373b309 100644
--- a/deploy/.env.example
+++ b/deploy/.env.example
@@ -7,6 +7,11 @@ POSTGRES_PASSWORD=postgres
 POSTGRES_DB=musify_db
 POSTGRES_HOST_PORT=59000
 
+# pgAdmin (Postgres UI). http://localhost:5050
+PGADMIN_DEFAULT_EMAIL=admin@musify.dev
+PGADMIN_DEFAULT_PASSWORD=admin
+PGADMIN_HOST_PORT=5050
+
 # RabbitMQ (MassTransit)
 RABBITMQ_DEFAULT_USER=guest
 RABBITMQ_DEFAULT_PASS=guest
diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml
index a427dd9..0205587 100644
--- a/deploy/docker-compose.yml
+++ b/deploy/docker-compose.yml
@@ -25,6 +25,22 @@ services:
       retries: 10
     restart: unless-stopped
 
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: musify-pgadmin
+    environment:
+      PGADMIN_DEFAULT_EMAIL: ${PGADMIN_DEFAULT_EMAIL}
+      PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_DEFAULT_PASSWORD}
+      PGADMIN_CONFIG_SERVER_MODE: "False"
+    depends_on:
+      postgres:
+        condition: service_healthy
+    ports:
+      - "${PGADMIN_HOST_PORT}:80"
+    volumes:
+      - pgadmin_data:/var/lib/pgadmin
+    restart: unless-stopped
+
   zitadel:
     image: ghcr.io/zitadel/zitadel:latest
     container_name: musify-zitadel
@@ -142,5 +158,6 @@ services:
 
 volumes:
   postgres_data:
+  pgadmin_data:
   rabbitmq_data:
   seaweedfs_data:
diff --git a/deploy/up.ps1 b/deploy/up.ps1
index f87f187..04f6421 100644
--- a/deploy/up.ps1
+++ b/deploy/up.ps1
@@ -102,6 +102,7 @@ Write-Host @"
   Service             URL / port
   ------------------  --------------------------------------
   PostgreSQL          localhost:$($cfg['POSTGRES_HOST_PORT'])  (db: $($cfg['POSTGRES_DB']))
+  pgAdmin             http://localhost:$($cfg['PGADMIN_HOST_PORT'])  ($($cfg['PGADMIN_DEFAULT_EMAIL'])/$($cfg['PGADMIN_DEFAULT_PASSWORD']))
   Zitadel console     http://$zDomain`:$zPort/ui/console
   RabbitMQ mgmt       http://localhost:15672  ($($cfg['RABBITMQ_DEFAULT_USER'])/$($cfg['RABBITMQ_DEFAULT_PASS']))
   SeaweedFS S3        http://localhost:8333   (bucket: $($cfg['S3_BUCKET']))