docs: rewrite the deploy documentation and fix the stale references

The root README was a design handoff for a prototype that is not in this repo,
web-player/README.md was the sv template, and deploy/README.md only covered
development. Replace all three and document the production deploy: its
prerequisites, what up.sh does and why nginx sits in front.

The docs under docs/ still used the pre-monorepo project paths, Ardalis.Result
instead of ErrorOr and the player.html test console that no longer exists.

docs/projects.md

@@ -1,8 +1,9 @@
 # Proyectos
 
-Cada carpeta de nivel superior es una solución/repo independiente.
+Los seis proyectos .NET viven en `backend/` (solución `Musify.slnx`); el cliente
+web en `web-player/`.
 
-## Musify.WebApi/WebApi  (`:5111`)
+## Musify.Api  (`:5111`)
 
 API REST pública (Minimal APIs, .NET 10). Es la fachada fina del sistema.
 
@@ -11,12 +12,12 @@ API REST pública (Minimal APIs, .NET 10). Es la fachada fina del sistema.
 - **`CurrentUser`**: abstracción que se enlaza como parámetro de endpoint (`IBindableFromHttpContext`) y expone los claims básicos (`Id` como `long?`, `RequiredId`, nombre, etc.) sin tener que leer `ClaimsPrincipal` a mano.
 - **Emite**: presigned URLs de subida (vía `IStorageService`) y **stream-tickets** (vía `IStreamTicketService`, RS256).
 - **OpenAPI + Scalar** para documentación/prueba; OAuth2 (PKCE) configurado para login desde Scalar.
-- **CORS** totalmente abierto **solo en Development** (para el `player.html` y front local).
-- Traduce `Ardalis.Result` → HTTP en `ResultHttpExtensions`.
+- **CORS** totalmente abierto **solo en Development** (para el front local).
+- Traduce `ErrorOr` → HTTP en `ResultHttpExtensions`.
 
 **Propósito/porqué**: separar la cara pública (autorización + metadatos) del procesado y del servido de bytes.
 
-## MusifyBackend  (Domain + Application + Infrastructure)
+## Musify.Domain + Musify.Application + Musify.Infrastructure
 
 El núcleo, en tres proyectos (clean architecture):
 
@@ -31,7 +32,7 @@ Casos de uso (CQRS con Mediator):
 - `Shared/` → helpers transversales (`StorageKey.Combine`, `ImageSize`).
 - `Pagination/` → `PaginatedResponse<T>`.
 
-**Porqué**: la lógica de negocio no conoce EF, S3 ni RabbitMQ; solo interfaces. Reutilizable por WebApi y Worker.
+**Porqué**: la lógica de negocio no conoce EF, S3 ni RabbitMQ; solo interfaces. Reutilizable por la API y el Worker.
 
 ### Infrastructure
 Implementaciones concretas:
@@ -40,20 +41,26 @@ Implementaciones concretas:
 - `MassTransit/` → consumers, activities y routing slips (ver [media-processing.md](media-processing.md)).
 - `Jobs/` → `UploadIntentExpirationJob`, `TemporalUploadsCleanUpJob`.
 
-## Musify.StreamingGateway/StreamingGateway  (`:8081`)
+## Musify.StreamingGateway  (`:8081`)
 
 Reverse proxy (ASP.NET + **YARP**) que sirve el audio (`.m4a`) desde SeaweedFS. Valida el stream-ticket (RS256, clave pública) y, si el objeto pedido cae bajo el prefijo autorizado, reenvía al filer.
 
 **Porqué un proyecto aparte**: escala con el tráfico de bytes independientemente de la API, tiene superficie mínima (solo sabe validar un JWT y proxiar) y permite que SeaweedFS quede en red privada. Ver [streaming.md](streaming.md).
 
-## Musify.Worker/Worker
+## Musify.Worker
 
 Worker Service (host de fondo) que consume los eventos de MassTransit y ejecuta el procesado pesado: transcode de audio a `.m4a` (ffmpeg), generación de miniaturas (ImageSharp), transferencias de ficheros en el bucket, y los jobs de expiración/limpieza de upload intents.
 
 **Porqué aparte**: el trabajo CPU/IO no debe ocurrir dentro de un request HTTP; se escala y reinicia por separado. (Antes se llamaba `Musify.PictureWorker`; se renombró porque hace más que imágenes.)
 
-## Raíz del workspace (no versionada)
+## web-player  (`:5173` en dev, `:3000` en contenedor)
 
-- **`deploy/seaweedfs/`** — `docker-compose.yml` + `s3.conf` para levantar SeaweedFS.
-- **`player.html`** — consola de pruebas (un solo archivo): login con token, CRUD de playlists, añadir/quitar canciones, listar y reproducir. Ver [development.md](development.md). (Pendiente: hoy usa dash.js; con el cambio a `.m4a` debe reproducir el fichero directo por `<audio>`/range.)
+Cliente web (SvelteKit 2 + Svelte 5 + Tailwind 4). La sesión OIDC vive en el
+servidor (cookie cifrada); las llamadas al backend salen del servidor con el
+access token, y las subidas se hacen contra las URLs prefirmadas de S3.
+
+## Otras carpetas
+
+- **`deploy/`** — stacks de Docker Compose (dev y prod) y los scripts de
+  arranque, migraciones y provisioning. Ver [../deploy/README.md](../deploy/README.md).
 - **`docs/`** — esta documentación.