SonqollayAPP

PWA móvil para gestión de clientes y cotizaciones con Firestore (sincronización en la nube + offline) y Firebase Cloud Messaging (notificaciones push web).

1) Configurar Firebase

a) Crear el proyecto / obtener config

1. Andá a https://console.firebase.google.com → tu proyecto.
2. Configuración del proyecto → "Tus apps" → agregá una App web si no existe.
3. Copiá el objeto firebaseConfig (apiKey, authDomain, projectId, storageBucket, messagingSenderId, appId).

b) Pegar los valores

Editá los mismos valores en dos lugares:

• firebase-config.js (módulo ES que usa la app)
• firebase-messaging-sw.js (config embebida que usa el service worker de FCM)

La VAPID Public Key ya está cargada:

BG51GzCL7b78_tnJ1GzvV53HimMawsAwPPdTCKM8XPAKV6RS8arlEQZ-BxzQqyFLxCJaY-durev5H6GyJysO9HU

c) Habilitar servicios en la consola

• Authentication → Sign-in method → habilitar Anónimo.
• Firestore Database → Crear base de datos (modo producción).
• Reglas de Firestore: copiar el contenido de firestore.rules en Rules y publicar.
• Cloud Messaging → ya tenés la VAPID Web Push registrada.

Acceso del equipo (importante). Las cotizaciones, clientes y plantillas ya no son accesibles para cualquier cuenta que inicie sesión. Como el registro de cuentas es abierto, el acceso a datos de negocio requiere aprobación de un admin: la función isMember() de firestore.rules (y la Cloud Function parseDictation) solo permiten al dueño, a los admins (isAdmin == true) y a usuarios con approved == true en users/{uid}.

Cómo aprobar a alguien: que la persona inicie sesión una vez (se crea su users/{uid}), luego en /administracion → Usuarios tocá "Aprobar" junto a su nombre. Mientras no esté aprobada, verá la app pero sin datos. Los admins (y el dueño) tienen acceso siempre.

d) Dominios autorizados

En Authentication → Settings → Authorized domains, agregá el dominio donde alojás la app (ej. tu-usuario.github.io). localhost ya viene autorizado.

2) Estructura de datos en Firestore

users/{uid}/
  ├─ quotes/{id}    → { empresa, numero, fecha, descripcion, valor,
  │                     contactos, estado, seguimiento, notas, createdAt, updatedAt }
  ├─ clients/{id}   → { empresa, nombre, email, telefono, cargo, notas }
  └─ fcmTokens/{token} → { token, ua, createdAt }

Cada teléfono recibe un UID anónimo persistente. Si reinstalás la app, generá un respaldo (Ajustes → Exportar JSON) o usá login Google en el futuro para enlazar datos entre dispositivos.

3) Funcionalidades

• Cotizaciones: ABM, estado (Borrador/Enviada/En seguimiento/Adjudicada/Perdida/Backlog), valor CLP, contactos, próximo seguimiento, notas, generada por (createdByName) y responsable del seguimiento (responsableUid + responsableNombre). El estado Backlog archiva la cotización: pasa manualmente o automático tras 3 meses (92 días) sin actualización, queda fuera del Dashboard, métricas, pipeline y recordatorios, y solo se ve activando el filtro "Backlog" en Cotizaciones (campos: backlogAt, backlogMotivo auto/manual, estadoPrevio).
  • Rename ago-2026: "En revisión" → "En seguimiento". normalizeEstado() en lib/format.js traduce el valor antiguo al leer y migrateEstadoLegacy() (app.js) migra los documentos una sola vez; las queries de Cloud Functions consultan ambos textos y normEstado() evita que la migración dispare notificaciones.
  • Los montos se leen con parseValor(), que interpreta el formato chileno (punto = miles, coma = decimales). Sin eso, "6.292.532" se guardaba como null y "6.292" como 6,292 pesos.
  • Volver de Backlog: el detalle ofrece "↩ Restaurar a estadoPrevio" en un toque. Mandar algo a Backlog nunca pide aprobación, así que revertirlo tampoco: esRestauracionBacklog() (app.js) y backlogRestore() (firestore.rules) eximen ese cambio del flujo de aprobación, que si no dejaba atrapada una cotización Adjudicada→Backlog para un usuario supervisado.
  • Cotizaciones tipo Academia: solo se registra la posible fecha de inicio del curso (cursoFecha). Los campos de nombre, modalidad y cupos se retiraron del formulario en ago-2026 por pedido del área comercial.
• Clientes: ficha por empresa con persona, email, teléfono, cargo.
• Dashboard: KPIs, próximos seguimientos, últimas cotizaciones.
• Sync real-time: cambios desde cualquier dispositivo aparecen al instante.
• Offline-first: Firestore con persistencia IndexedDB + Service Worker.
• Push web (FCM): botón en Ajustes para activar; el token queda guardado en users/{uid}/fcmTokens para enviar mensajes desde tu backend o Cloud Functions.
• Exportar/Importar respaldo JSON, Exportar CSV (Excel).

4) Probar local

cd SonqollayAPP
python3 -m http.server 8080
# abrir http://localhost:8080

Importante: FCM requiere HTTPS (o localhost). Para usarlo desde un teléfono real, hostealo en GitHub Pages / Netlify / Firebase Hosting.

5) Deploy con Firebase Hosting + Functions

El proyecto ya viene con firebase.json y .firebaserc apuntando al proyecto sonqollayapp.

npm i -g firebase-tools
firebase login

# Instalar deps de las functions
cd functions && npm install && cd ..

# Deploy completo (hosting + reglas + functions)
firebase deploy

Deploy parcial:

firebase deploy --only hosting
firebase deploy --only firestore:rules
firebase deploy --only functions
firebase deploy --only functions:dailyFollowUpReminders

6) Cloud Functions incluidas

Ubicadas en functions/index.js:

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗