Fix ReadModel migration for PostgreSQL and update credentials

Author: beyondnetPeru

docker-compose.yml

@@ -0,0 +1,29 @@
+version: "3.9"
+
+services:
+  db:
+    image: postgres:16-alpine
+    container_name: ums_postgres
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: root   # password set to 'root'
+      POSTGRES_DB: UmsReadModel
+    ports:
+      - "5433:5432"
+    healthcheck:
+      test: ["CMD", "pg_isready", "-U", "postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  admin:
+    image: dpage/pgadmin4:8
+    container_name: ums_pgadmin
+    environment:
+      PGADMIN_DEFAULT_EMAIL: admin@ums.local
+      PGADMIN_DEFAULT_PASSWORD: root   # same password for convenience
+    ports:
+      - "5051:80"
+    depends_on:
+      db:
+        condition: service_healthy

infra/Makefile

@@ -0,0 +1,20 @@
+.PHONY: build helm-up helm-down compose-up compose-down clean
+
+build:
+	cd ../src && docker build -t ums-api:latest -f apps/ums.api/Ums.Presentation/Dockerfile .
+	cd ../src && docker build -t ums-web:latest -f apps/ums.web-app/Dockerfile .
+
+helm-up:
+	helm upgrade --install ums ./local/kubernetes/helm/ums
+
+helm-down:
+	helm uninstall ums || true
+
+compose-up:
+	docker compose -f local/compose/docker-compose.yml up -d
+
+compose-down:
+	docker compose -f local/compose/docker-compose.yml down -v
+
+clean: helm-down compose-down
+	docker images | grep ums | awk '{print $$3}' | xargs -r docker rmi -f

infra/accesos_local.md

@@ -0,0 +1,69 @@
+# Accesos al Entorno Local (Kubernetes)
+
+Este documento detalla todas las URLs, comandos y credenciales necesarias para acceder a los distintos componentes del proyecto UMS desplegado localmente usando Helm en Docker Desktop.
+
+## 1. Configuración Previa Obligatoria
+
+Para que el *Ingress Controller* local pueda enrutar el tráfico a tus aplicaciones usando nombres de dominio limpios, debes asegurarte de que tu archivo `/etc/hosts` tenga mapeados los dominios a `localhost` (`127.0.0.1`).
+
+Ejecuta en tu terminal:
+```bash
+sudo sh -c 'echo "127.0.0.1 ums.local grafana.ums.local" >> /etc/hosts'
+```
+
+> **IMPORTANTE PARA USUARIOS MAC / DOCKER DESKTOP:**
+> A veces Docker Desktop no vincula automáticamente el puerto 80 del Ingress al `localhost` de tu Mac. Si no puedes acceder a la web, debes abrir una terminal y dejar corriendo este comando para forzar el puente:
+> ```bash
+> sudo kubectl port-forward -n ingress-nginx svc/ingress-nginx-controller 80:80
+> ```
+
+---
+
+## 2. Aplicaciones Web (vía Ingress)
+
+Estos servicios están expuestos automáticamente en los puertos 80/443 de tu máquina anfitriona. Solo debes abrir tu navegador en los siguientes enlaces:
+
+| Componente | URL Local | Descripción |
+| :--- | :--- | :--- |
+| **Portal Web (Frontend)** | [http://ums.local](http://ums.local) | Aplicación principal en React. |
+| **API Backend (Swagger)** | [http://ums.local/api/swagger](http://ums.local/api/swagger) | (O la ruta base de Swagger configurada) Documentación interactiva de la API. |
+| **Grafana** | [http://grafana.ums.local](http://grafana.ums.local) | Panel de observabilidad (Log in anónimo automático habilitado para modo dev). |
+
+---
+
+## 3. Servicios Internos y Bases de Datos (Port Forwarding)
+
+Los componentes de infraestructura pesada como bases de datos o colectores de métricas corren aislados dentro del clúster (tipo `ClusterIP`). Para conectar clientes externos (como Azure Data Studio, SSMS, o Redis Insight), debes crear un puente o "Port-Forward" abriendo una terminal dedicada.
+
+### SQL Server (Base de Datos)
+* **Comando:** `kubectl port-forward svc/sqlserver-lite 1433:1433`
+* **Conexión:** `localhost,1433` o `127.0.0.1,1433`
+* **Usuario:** `sa`
+* **Contraseña:** `Your_password123`
+
+### Redis (Caché)
+* **Comando:** `kubectl port-forward svc/redis 6379:6379`
+* **Conexión:** `localhost:6379`
+
+### Prometheus (Métricas Crudas)
+* **Comando:** `kubectl port-forward svc/prometheus 9090:9090`
+* **Acceso Web:** [http://localhost:9090](http://localhost:9090)
+
+### Loki (Logs)
+* **Comando:** `kubectl port-forward svc/loki 3100:3100`
+* **Uso:** Generalmente se explora directamente desde Grafana, pero este es el puerto de la API directa de Loki.
+
+### Tempo (Trazas Distribuidas)
+* **Comando:** `kubectl port-forward svc/tempo 3200:3200`
+* **Uso:** Generalmente explorado a través de Grafana, pero expone interfaces de API directas.
+
+---
+
+## 4. Notas de Administración
+
+Si necesitas gestionar los pods directamente o acceder a la terminal de alguno de ellos, usa las etiquetas del Helm chart:
+
+* **Listar todos los pods:** `kubectl get pods`
+* **Ver logs de la API:** `kubectl logs -l app=ums-api -f`
+* **Ver logs del Web:** `kubectl logs -l app=ums-web -f`
+* **Reiniciar el backend:** `kubectl rollout restart deployment ums-api`

src/docker-compose.yml infra/local/compose/docker-compose.ymlsrc/docker-compose.yml renamed to infra/local/compose/docker-compose.yml

@@ -1,25 +1,35 @@
 services:
-  sqlserver-lite:
-    image: mcr.microsoft.com/azure-sql-edge:latest
-    container_name: ums-sqlserver-lite
+  postgres:
+    image: postgres:15-alpine
+    container_name: ums-postgres
     environment:
-      ACCEPT_EULA: "Y"
-      MSSQL_SA_PASSWORD: "Your_password123"
-      MSSQL_PID: "Developer"
+      POSTGRES_USER: "postgres"
+      POSTGRES_PASSWORD: "Your_password123"
+      POSTGRES_DB: "UmsDev"
     ports:
-      - "1433:1433"
+      - "5432:5432"
     volumes:
-      - sqlserver_data:/var/opt/mssql
+      - postgres_data:/var/lib/postgresql/data
     healthcheck:
-      test:
-        [
-          "CMD-SHELL",
-          "/opt/mssql-tools18/bin/sqlcmd -C -S localhost -U sa -P \"$${MSSQL_SA_PASSWORD}\" -Q \"SELECT 1\" || /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P \"$${MSSQL_SA_PASSWORD}\" -Q \"SELECT 1\"",
-        ]
+      test: ["CMD-SHELL", "pg_isready -U postgres -d UmsDev"]
       interval: 15s
       timeout: 10s
       retries: 10
-      start_period: 45s
+      start_period: 15s
+    networks:
+      - ums-network
+
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: ums-pgadmin
+    environment:
+      PGADMIN_DEFAULT_EMAIL: "admin@ums.com"
+      PGADMIN_DEFAULT_PASSWORD: "Your_password123"
+    ports:
+      - "5050:80"
+    depends_on:
+      postgres:
+        condition: service_healthy
     networks:
       - ums-network
 
@@ -180,12 +190,12 @@ services:
       ASPNETCORE_ENVIRONMENT: Development
       ASPNETCORE_URLS: http://+:8080
       AllowedOrigins: http://localhost:5173,http://localhost:3000
-      ConnectionStrings__DefaultConnection: Server=sqlserver-lite,1433;Database=UmsDev;User Id=sa;Password=Your_password123;TrustServerCertificate=True;Encrypt=False;
-      Persistence__Provider: SqlServer
-      Persistence__AggregateStoreMode: SqlServer
-      Persistence__UseSqlServerIdentityStores: "true"
-      Persistence__UseSqlServerAuthorizationStores: "true"
-      Persistence__UseSqlServerConfigurationStores: "true"
+      ConnectionStrings__DefaultConnection: Host=postgres;Port=5432;Database=UmsDev;Username=postgres;Password=Your_password123;
+      Persistence__Provider: PostgreSql
+      Persistence__AggregateStoreMode: PostgreSql
+      Persistence__UsePostgreSqlIdentityStores: "true"
+      Persistence__UsePostgreSqlAuthorizationStores: "true"
+      Persistence__UsePostgreSqlConfigurationStores: "true"
       Persistence__SeedDevData: "true"
       Persistence__EnableOutbox: "true"
       Persistence__InitializePlatformStoreOnStartup: "true"
@@ -197,7 +207,7 @@ services:
     ports:
       - "5293:8080"
     depends_on:
-      sqlserver-lite:
+      postgres:
         condition: service_healthy
       redis:
         condition: service_healthy
@@ -236,7 +246,7 @@ networks:
     driver: bridge
 
 volumes:
-  sqlserver_data:
+  postgres_data:
   tempo_data:
   loki_data:
   prometheus_data: