docs(apps): expand configuration and integration guides

nextcloud/README.md

@@ -2,6 +2,21 @@
 
 Plataforma de archivos y colaboración con MariaDB, Redis, tareas cron y OnlyOffice Document Server.
 
+## Arquitectura y propósito
+
+MariaDB guarda metadatos, Redis aporta bloqueo y caché, `nextcloud` sirve la web y `nextcloud-cron` ejecuta tareas en segundo plano sobre los mismos volúmenes. OnlyOffice es un servicio independiente para editar documentos y se integra mediante JWT.
+
+## Configuración
+
+- `NC_DOMAIN`, `TRUSTED_PROXIES` y las variables `OVERWRITE*` hacen que Nextcloud genere HTTPS correctamente detrás de Traefik.
+- `MYSQL_*` debe coincidir en Nextcloud, cron y MariaDB.
+- `NEXTCLOUD_ADMIN_*` sólo inicializa la primera instalación; después administra usuarios desde Nextcloud.
+- `SMTP_*` configura notificaciones a través de `mail_internal`.
+- `OO_DOMAIN`, `OO_JWT_SECRET` y `OO_SECURE_LINK_SECRET` protegen la comunicación con OnlyOffice; el JWT configurado en la app de Nextcloud debe ser idéntico.
+- `/opt/nextcloud/html`, `config`, `data`, `custom_apps` y `themes` se comparten con cron para ejecutar el mismo código y configuración.
+
+Redis no sustituye una copia de seguridad. Respalda MariaDB, configuración y datos de forma consistente, preferiblemente activando antes el modo mantenimiento.
+
 ## Requisitos
 
 - Docker Compose