Files

T

Admin 89569736b7 Reorganize backend to mirror Musify.slnx folder structure

Moves the six backend projects on disk into Core/ and Hosts/
subfolders, matching the solution folders already defined in
Musify.slnx, so the file explorer reflects the same layout as the
solution:

  backend/Core/Musify.Domain
  backend/Core/Musify.Application
  backend/Core/Musify.Infrastructure
  backend/Hosts/Musify.Api
  backend/Hosts/Musify.Worker
  backend/Hosts/Musify.StreamingGateway

Updates every reference to the old paths: ProjectReference entries in
Musify.Api.csproj and Musify.Worker.csproj, the three Dockerfiles,
deploy/scripts/migrate.ps1|sh, deploy/zitadel/provision.ps1,
deploy/up.ps1, deploy/README.md and docs/development.md. Also fixes a
stale Dockerfile comment pointing at a compose file that no longer
exists.

Verified with `dotnet build Musify.slnx` against the new layout.

2026-09-09 14:27:50 +02:00

3.3 KiB

Raw Blame History

Entorno de desarrollo

Cómo levantar todo en local y probarlo. El detalle completo del deploy (y el de producción) está en deploy/README.md.

Arranque

./deploy/up.ps1            # infraestructura; las apps se ejecutan desde el IDE
./deploy/up.ps1 -Apps      # todo en Docker (api, worker, gateway, web player)

up.ps1 hace el bootstrap completo: crea deploy/.env, genera las claves RS256 de stream-ticket en deploy/keys/, levanta el stack, aplica las migraciones y provisiona Zitadel (proyecto + apps OIDC), dejando los client ids en deploy/.env, en los user-secrets de Musify.Api y en web-player/.env.

Otros modificadores: -Tools (pgAdmin), -SkipMigrations, -Down, -Destroy.

Aplicaciones

dotnet run --project backend/Hosts/Musify.Api               # :5111
dotnet run --project backend/Hosts/Musify.StreamingGateway  # :8081
dotnet run --project backend/Hosts/Musify.Worker            # background
npm --prefix web-player run dev                       # :5173

Mapa de puertos

Servicio	Puerto
Musify.Api	5111 (`/scalar/v1`, `/openapi/v1.json`)
Musify.StreamingGateway	8081 (`/health`, `/media/...`)
web-player	5173 (`npm run dev`) o 3000 (contenedor)
SeaweedFS S3 / filer / master	8333 / 8888 / 9333
Zitadel	8080
PostgreSQL	59000 (→ 5432 en el contenedor)
RabbitMQ AMQP / management	5672 / 15672
Jaeger UI / OTLP	16686 / 4317
pgAdmin (`-Tools`)	5050

DB: musify_db, usuario postgres/postgres. Bucket S3: webapi-storage (credenciales admin_access_key/admin_secret_key). Todos los valores salen de deploy/.env.

Migraciones

No hay migración automática al arrancar; up.ps1 las aplica en el bootstrap. A mano, tras cambios de esquema:

dotnet ef database update --project backend/Core/Musify.Infrastructure --startup-project backend/Core/Musify.Infrastructure --context Database

Musify.Infrastructure es a la vez el proyecto de migraciones y el de arranque: tiene el IDesignTimeDbContextFactory y el paquete EFCore.Design. La cadena de conexión se lee de sus user-secrets (up.ps1 la deja puesta).

Stream-tickets (claves RS256)

La API firma los stream-tickets con la clave privada y el gateway los valida con la pública. up.ps1 las genera en deploy/keys/; a mano:

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out deploy/keys/stream_private.pem
openssl rsa -in deploy/keys/stream_private.pem -pubout -out deploy/keys/stream_public.pem

API: StreamTicket:PrivateKeyPath.
Gateway: StreamTicket:PublicKeyPath.

Config (AppSettings)

Convención: AppSettings.json es la plantilla con valores vacíos o neutros; AppSettings.Development.json tiene los valores reales de dev; en Docker todo se sobreescribe con variables de entorno (Seccion__Clave) desde deploy/compose.yml. Los valores de Authentication los deja el provisioning en user-secrets, no en el repo.

Secciones clave: Authentication (Zitadel), Database, MassTransit, InfrastructureStorage (S3), ApplicationStorage (bucket), Track, PlayList, UploadIntent, AudioTranscoder, YtDlp, Workers, StreamGateway / StreamTicket.

Requisitos del host

.NET 10 SDK y Node 22.
ffmpeg y yt-dlp en el PATH (transcode y descarga de audio del Worker).
Docker Desktop.

3.3 KiB Raw Blame History