sala online beta

Author: mfuentespagliero

PIRAMIDE-MOBILE-MULTIJUGADOR/README.md

@@ -1,111 +1,99 @@
-# Pirámide Mobile Multijugador
+# Pirámide Mobile Multijugador — beta Spark
 
-Versión online de Pirámide con salas para 3 a 12 jugadores, anfitrión, sincronización en tiempo real y manos privadas o visibles para todos.
+Versión online de Pirámide para 2 a 8 jugadores. Funciona con Firebase Authentication anónima, Realtime Database y GitHub Pages, sin Cloud Functions, Cloud Run, servidores propios ni servicios que requieran facturación.
 
-## Funciones incluidas
+> Esta implementación está diseñada para pruebas privadas. La lógica crítica se ejecuta en los clientes y no ofrece seguridad equivalente a un backend confiable.
 
-- Autenticación anónima persistente.
-- Creación y acceso mediante códigos de seis caracteres.
-- Lobby con configuración exclusiva del anfitrión.
-- Selector `settings.handVisibility` con valores `private` y `public`.
-- Bloqueo de configuración al comenzar.
-- Reparto y acciones validadas por Cloud Functions.
-- Manos privadas en `privateHands/{roomCode}/{playerUid}/cards`.
-- Manos públicas en `rooms/{roomCode}/publicHands/{playerUid}/cards`.
-- Bluff automático desactivado en modalidad pública.
-- Declaraciones, aceptación, desafío y consumo autoritativo de cartas.
-- Presencia, reconexión y limpieza de listeners.
-- Nueva ronda con regreso al lobby.
-- Reglas que impiden editar configuraciones, cartas, cargas o puntajes desde el cliente.
+La advertencia anterior es parte de la documentación y no se muestra dentro de la interfaz normal del juego. La versión local continúa aislada en `../PIRAMIDE-MOBILE-SIMPLE`.
 
-La versión local continúa aislada en `../PIRAMIDE-MOBILE-SIMPLE`.
+## Qué incluye
 
-## Requisitos
+- Salas con códigos únicos de seis caracteres, sin `O`, `0`, `I` ni `1`.
+- Autenticación anónima persistente y reconexión después de actualizar.
+- Lobby, presencia con `.info/connected` y configuración exclusiva del host.
+- Reparto desde el navegador del host con manos privadas o públicas.
+- Mazo oculto de la pirámide en `hostState/{roomCode}` y cartas reveladas en la sala.
+- Declaraciones, bluff, aceptación, desafío, cargas y puntajes sincronizados.
+- Cierre manual de sala y vencimiento lógico después de 12 horas.
+- Reglas para reducir modificaciones accidentales y limitar manos privadas.
 
-- Node.js 20.
-- Firebase CLI.
-- Un proyecto Firebase con plan compatible con Cloud Functions.
-- Authentication anónima activada.
-- Realtime Database creada.
+La carpeta `functions/` se conserva únicamente como respaldo histórico. No forma parte del frontend, de `firebase.json` ni del despliegue beta.
 
-## Configuración
+## Arquitectura de datos
 
-1. El frontend ya está configurado para el proyecto `vacila-cb462`.
-2. Verifica que Realtime Database use `https://vacila-cb462-default-rtdb.firebaseio.com/`.
-3. Activa el proveedor **Anónimo** en Authentication.
-4. Copia `.firebaserc.example` como `.firebaserc` si quieres usar comandos manuales de Firebase sin pasar `--project vacila-cb462`.
-5. Instala dependencias:
+- `rooms/{roomCode}`: lobby, jugadores, configuración y estado público.
+- `privateHands/{roomCode}/{uid}/cards`: mano legible solamente por su dueño.
+- `rooms/{roomCode}/publicHands`: manos visibles para integrantes de la sala.
+- `hostState/{roomCode}/pyramidDeck`: pirámide oculta, legible solamente por el host.
+- `claimProofs/{roomCode}/{claimId}`: carta puntual usada para resolver un desafío privado.
 
-```bash
-npm install
-npm --prefix functions install
-```
+El host genera el mazo y escribe temporalmente las manos. `clearSensitiveDealData()` limpia los arrays de reparto al finalizar. Esto mejora la privacidad cotidiana, pero un usuario avanzado aún podría manipular su cliente.
 
-La región configurada es `southamerica-west1`. Si la cambias en `functions/index.js`, actualiza también `functionsRegion` en `js/firebase-config.js`.
+## Preparar Firebase en Spark
 
-## Emuladores y pruebas
+1. Crea un proyecto en [Firebase Console](https://console.firebase.google.com/).
+2. En **Authentication → Sign-in method**, activa el proveedor **Anónimo** y agrega tu dominio de GitHub Pages en **Authorized domains**.
+3. Crea una **Realtime Database**.
+4. Registra una aplicación web y pega su `firebaseConfig` en `js/firebase-config.js`. Este repositorio ya contiene la configuración de `vacila-cb462`.
+5. Instala Firebase CLI si todavía no lo tienes e inicia sesión.
+6. Desde esta carpeta publica solamente las reglas:
 
 ```bash
-npm run emulators
-npm test
+firebase deploy --project vacila-cb462 --only database
 ```
 
-Las pruebas cubren reparto, compatibilidad de bluff, consumo único de cartas, privacidad, permisos de sala, presencia y rechazo de escrituras ilegales.
+También puedes usar:
 
-Vistas sin Firebase:
+```bash
+npm install
+npm run deploy
+```
 
-- `index.html?demo=lobby`
-- `index.html?demo=private`
-- `index.html?demo=public`
+El script `deploy` ejecuta exclusivamente el despliegue de Realtime Database. No uses `firebase deploy --only functions` para esta beta.
 
-## Despliegue
+## Publicar el frontend
 
-Ejecuta desde la carpeta `PIRAMIDE-MOBILE-MULTIJUGADOR`:
+Publica la carpeta del repositorio con GitHub Pages. El juego carga los módulos Firebase desde el CDN oficial y no necesita un proceso de compilación. Si Pages sirve el repositorio completo, la entrada es:
 
-```bash
-cd functions
-npm install
-cd ..
-firebase deploy --project vacila-cb462 --only functions
+```text
+PIRAMIDE-MOBILE-MULTIJUGADOR/index.html
 ```
 
-Las funciones usan Cloud Functions de segunda generación en `southamerica-west1`, son callable mediante el SDK de Firebase y tienen CORS habilitado. El frontend usa Firebase JavaScript SDK modular 12.15.0.
+## Desarrollo y pruebas
 
-Para publicar además Hosting y las reglas de Realtime Database puedes usar:
+Con Node.js, Firebase CLI y las dependencias instaladas:
 
 ```bash
-npm run deploy
+npm run emulators
+npm test
 ```
 
-El script ya apunta al proyecto `vacila-cb462`.
+Vistas visuales sin Firebase:
 
-### Verificación posterior al despliegue
-
-1. Crear una sala desde `http://127.0.0.1:5500`.
-2. Unirse desde `http://localhost:5500` en otra pestaña.
-3. Unirse desde otro teléfono.
-4. Repetir la prueba desde `https://juegosparavacilar.cl` y GitHub Pages.
-5. Confirmar en la consola que no aparezcan errores CORS.
-6. Comprobar que las callables reciban `request.auth.uid`.
-7. Confirmar que un invitado no pueda cambiar ajustes, iniciar, revelar cartas ni finalizar la partida.
-
-## Modelo de seguridad
+- `index.html?demo=lobby`
+- `index.html?demo=private`
+- `index.html?demo=public`
 
-Los clientes solo pueden:
+## Lista de comprobación
 
-- Leer una sala a la que pertenecen.
-- Leer su propia mano privada.
-- Leer las manos públicas de su sala.
-- Actualizar sus campos de presencia.
-- Invocar funciones autenticadas.
+1. Crear una sala y confirmar que el código tenga seis caracteres válidos.
+2. Entrar desde dos teléfonos adicionales con cuentas anónimas distintas.
+3. Ver los tres jugadores y sus cambios de conexión en tiempo real.
+4. Probar manos privadas; cada teléfono debe leer solo la propia.
+5. Probar manos públicas; todos deben ver cartas disponibles y usadas.
+6. Confirmar que un invitado no pueda configurar, iniciar, revelar, reiniciar ni cerrar.
+7. Revelar las 15 cartas y comprobar la sincronización de pisos y multiplicadores.
+8. Probar una coincidencia real, un bluff aceptado y un bluff desafiado.
+9. Actualizar una página y confirmar la reconexión sin abrir automáticamente la mano.
+10. Cerrar la sala como host y comprobar que desaparezcan sala, manos y estado oculto.
+11. Verificar en la consola de red que no existan solicitudes a `cloudfunctions.net`.
 
-Todos los cambios de configuración y partida se ejecutan con Admin SDK dentro de Cloud Functions. Las rutas `roomSecrets` nunca son legibles por clientes y almacenan temporalmente la verdad de una declaración para que un bluff no pueda descubrirse inspeccionando la sala.
+No existe una tarea programada en Spark para borrar salas exactamente al vencer. La aplicación rechaza salas de más de 12 horas y el host puede cerrarlas manualmente.
 
 ## Archivos principales
 
-- `js/app.js`: interfaz, listeners y privacidad al perder foco.
-- `js/firebase-service.js`: Authentication, Database y callables.
-- `functions/index.js`: servidor autoritativo.
-- `functions/src/game.js`: reparto y reglas puras.
-- `database.rules.json`: autorización de clientes.
-- `tests/rules.test.mjs`: pruebas de reglas con Emulator Suite.
+- `js/app.js`: interfaz, estado visual y listeners.
+- `js/firebase-service.js`: Auth, transacciones, presencia y lógica beta.
+- `database.rules.json`: permisos de Realtime Database.
+- `firebase.json`: reglas, hosting opcional y emuladores sin Functions.
+- `tests/rules.test.mjs`: pruebas de privacidad y permisos.

PIRAMIDE-MOBILE-MULTIJUGADOR/css/styles.css

@@ -622,6 +622,45 @@ code {
   border-top: 1px solid var(--line);
 }
 
+.multiplier-setting {
+  padding: 10px 4px 16px;
+}
+
+.multiplier-setting > span {
+  display: grid;
+  margin-bottom: 10px;
+}
+
+.multiplier-setting small {
+  color: var(--muted);
+  font-size: .69rem;
+}
+
+.multiplier-inputs {
+  display: grid;
+  grid-template-columns: repeat(5, minmax(0, 1fr));
+  gap: 7px;
+}
+
+.multiplier-inputs label {
+  display: grid;
+  gap: 4px;
+  text-align: center;
+}
+
+.multiplier-inputs input {
+  width: 100%;
+  min-width: 0;
+  padding: 9px 4px;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  color: var(--text);
+  background: rgba(255, 255, 255, .04);
+  font: inherit;
+  font-weight: 800;
+  text-align: center;
+}
+
 .select-setting > span,
 .toggle-setting > span {
   display: grid;
@@ -1088,6 +1127,33 @@ code {
   gap: 9px;
 }
 
+.claim-card-options {
+  margin: 14px 0 18px;
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 9px;
+}
+
+.claim-card-options .choice-card {
+  grid-template-columns: 1fr;
+  color: var(--text);
+  font: inherit;
+  font-weight: 800;
+  text-align: center;
+}
+
+.connection-warning {
+  margin: 0 0 14px;
+  padding: 11px 14px;
+  border: 1px solid rgba(255, 184, 77, .3);
+  border-radius: 14px;
+  color: #ffd39a;
+  background: rgba(255, 153, 51, .08);
+  font-size: .78rem;
+  font-weight: 750;
+  text-align: center;
+}
+
 .target-grid button {
   min-height: 78px;
   padding: 10px;