Manual de Firescope

Instalación

1. Desde la página de descarga obtén el .dmg para Mac (puedes elegir entre Apple Silicon e Intel).
2. Abre el .dmg descargado y arrastra el icono de Firescope a la carpeta «Aplicaciones».
3. Inicia Firescope desde la carpeta de Aplicaciones.

Windows

1. Desde la página de descarga obtén y ejecuta Firescope-Setup.exe.
2. Si aparece un aviso de SmartScreen la primera vez, continúa con «Más información» → «Ejecutar de todas formas».

Configuración inicial (idioma y tema)

Al iniciar por primera vez se abre un asistente de configuración de 4 pasos. Primero eliges el idioma de la interfaz (incluye 9 idiomas: 日本語, English, 简体中文, 繁體中文, 한국어, Español, Português, Français y Deutsch). El cambio se aplica al instante al hacer clic, así que si tienes dudas, pruébalo y compruébalo.

A continuación eliges el tema visual: Light y Dark, entre 10 opciones en total. También se previsualiza al instante con un clic.

Conectar con Firestore

Para conectar se usa la clave privada de cuenta de servicio (JSON) de Firebase. Aunque no la tengas todavía, siguiendo las indicaciones en pantalla puedes obtenerla en aproximadamente un minuto.

1. Al pulsar «Abrir la página de configuración de cuenta de servicio» se abre en el navegador la página correspondiente de la consola de Firebase (ruta: Configuración del proyecto → Cuentas de servicio).
2. Haz clic en «Generar nueva clave privada» para descargar el JSON.
3. Vuelve a Firescope y, desde «Seleccionar archivo JSON para conectar», elige el JSON descargado. También puedes seleccionar los JSON de varios proyectos a la vez para conectarlos simultáneamente.
4. Elige el entorno de destino (desarrollo / pruebas / staging / producción). Se muestra en la barra lateral como una etiqueta de color, y esta etiqueta también determina la intensidad de la protección de seguridad.

Ver los datos

Abre una conexión en la barra lateral y haz clic en una colección para ver los documentos en una tabla. Cada encabezado de columna incluye una insignia de tipo (string / int / time, etc.), así que la forma de los datos se entiende de un vistazo.

• Al hacer clic en una fila, el panel derecho muestra todos los campos del documento.
• El orden, la cantidad mostrada y la búsqueda por grupo (collection group) se cambian desde la barra de herramientas.
• El número de lecturas se muestra siempre en la barra de estado (como referencia para la facturación).

Nombres lógicos (traducción de campos)

Puedes mostrar nombres de campo en inglés como carryingOutCoffinMasterId con un nombre lógico, por ejemplo en español. El interruptor «Nombre lógico» de la barra de herramientas alterna en cualquier momento entre el nombre físico y el lógico.

• El diccionario se edita desde el icono 📖 de la barra de herramientas. Tiene dos niveles de alcance: «común a toda la conexión» y «solo esta colección (sobrescribe)».
• «Traducción automática» completa los campos vacíos de una vez, usando el diccionario incorporado y una API de traducción gratuita.
• Al pulsar «Abrir Google Translate» se abre la página de traducción con los nombres de campo convertidos a texto en inglés; solo copia la traducción y vuelve a la app para aplicarla en bloque.
• Haz clic derecho en el encabezado de una columna → «Definir nombre lógico…» para editar solo esa columna al instante.
• La insignia de tipo del encabezado (string / int, etc.) se puede mostrar u ocultar con el interruptor «Mostrar tipo».

Pestañas y grupos

Haz clic derecho en una colección → «Abrir en una pestaña nueva» para añadir pestañas, como en un navegador. Las pestañas se pueden organizar en grupos, al estilo Chrome.

• Haz clic derecho en una pestaña → «Añadir a un grupo nuevo» para crear un grupo. Puedes asignarle nombre y color.
• Al hacer clic en el chip del grupo, se contrae o se expande.
• Doble clic en una pestaña para cambiar su nombre y color de fondo.
• Arrastra y suelta para reordenar y mover pestañas dentro o fuera de un grupo.
• El estado de las pestañas se restaura tras reiniciar (puedes desactivarlo en la configuración).

Vista dividida

Haz clic derecho en una colección → «Mostrar dividido a la derecha» para ver dos colecciones una junto a otra. Muy útil para cotejar datos maestros con transacciones.

• También puedes dividir arrastrando una colección desde la barra lateral hasta el borde izquierdo o derecho de la pantalla.
• Arrastrando el chip de un panel puedes intercambiar izquierda/derecha o extraerlo a una pestaña nueva.
• El estado de la división se conserva por pestaña.

Monitoreo en tiempo real

Al pulsar «Monitorear» en la barra de herramientas, los cambios de la colección que estás viendo se reflejan en vivo en la tabla. El contenido escrito por otra app o por tu servidor llega directamente, sin necesidad de recargar.

• En el diálogo previo al inicio puedes acotar por condiciones (campo/valor), orden y cantidad.
• En el feed de cambios de la derecha aparecen en orden cronológico las altas, actualizaciones y bajas, incluyendo qué campos cambiaron.
• El monitoreo es de solo lectura. Las operaciones de escritura mientras monitoreas siguen pasando normalmente por el pipeline de seguridad.
• Puedes monitorear hasta 5 colecciones a la vez.
• Se detiene automáticamente tras un tiempo determinado (configurable), para evitar un uso excesivo de lecturas.

Editar los datos

Haz doble clic en una celda para editarla ahí mismo. Enter confirma, Esc cancela. Los tipos como int o timestamp se conservan al escribir.

Toda escritura pasa por el pipeline de seguridad:

1. Confirmación — aparece un diálogo cuya intensidad depende de la etiqueta de entorno × el riesgo de la operación. Las operaciones destructivas en producción requieren escribir el ID del proyecto.
2. Copia de seguridad automática — los documentos afectados se guardan como snapshot antes de ejecutar.
3. Ejecución — se realiza la escritura.
4. Registro de auditoría — se registra el resultado, con éxito o error (consúltalo desde «Registro de auditoría» en la barra inferior).

Copia de seguridad y restauración

Los snapshots tomados justo antes de una operación destructiva se acumulan en «Copias de seguridad», en la barra inferior. Al seleccionar uno se abre la vista previa de restauración, donde puedes revisar las diferencias (recrear / sobrescribir / sin cambios) antes de restaurar.

• Con ⌘Z (o el icono ↩︎ de la barra lateral) puedes restaurar al instante tu última escritura.
• Los snapshots más antiguos se eliminan al superar el límite de generaciones. Fija con 📌 los que quieras conservar.

Consola

En «Consola», en la barra lateral, puedes escribir consultas en JavaScript al estilo firebase-admin. Al ejecutar con ⌘Enter, el resultado se muestra en una tabla con tipos anotados.

const snap = await db.collection('orders')
  .where('status', '==', 'paid')
  .orderBy('amount', 'desc')
  .limit(20)
  .get();
return snap.docs.map((d) => ({ id: d.id, ...d.data() }));

• Para quienes prefieren el mouse, también hay un generador visual (obtener / actualizar / crear / eliminar). Las condiciones armadas se pueden convertir a JS con «Reflejar en código».
• El código que incluye escrituras se ejecuta en el orden ensayo (dry-run) → vista previa de escritura → aplicar, así que los datos nunca cambian de repente.
• También admite vista de join (combinación) entre colecciones.

Importación/exportación CSV

Exportación

Al pulsar «Exportar CSV» en la barra de herramientas de una colección, puedes guardar en CSV el resultado de la consulta que estás viendo (con filtros y orden aplicados). El encabezado incluye anotaciones de tipo, así que al reimportarlo más tarde los tipos no se pierden.

Importación

1. En la barra de herramientas, «Importar» → selecciona el archivo CSV (Shift_JIS se detecta automáticamente).
2. Revisa el tipo de cada columna y el modo (upsert / solo nuevos / solo actualizar).
3. «Verificar cantidad» muestra una vista previa de cuántos registros son nuevos y cuántos se sobrescribirán.
4. «Ejecutar importación» → tras un diálogo de confirmación se realiza la carga. Los registros sobrescritos se respaldan automáticamente antes de ejecutar.

Revisión de esquema (detección de inconsistencias)

Haz clic derecho en una colección → «Revisión de esquema…» para leer toda la colección y detectar automáticamente campos con tipos mixtos, campos ausentes solo en algunos documentos y campos poco frecuentes que podrían ser errores de tipeo (límite de 20.000 documentos).

• Los campos faltantes que se repiten en el mismo grupo de documentos se agrupan en una sola tarjeta. «Abrir todo» marca automáticamente todas las filas afectadas, listas para, por ejemplo, eliminarlas en bloque.
• Al hacer clic en el ID de un documento afectado, la tabla hace scroll automático hasta esa fila y la resalta.
• Los resultados se conservan aunque cierres el asistente, así que puedes ir y volver revisando documentos las veces que necesites.
• En la pestaña «Validación con esquema Zod» puedes pegar un esquema Zod (TypeScript) y validar todos los documentos.

Comparar y copiar entornos

Comparar con otro entorno

Haz clic derecho en una colección → «Comparar con otro entorno…» para cotejar la misma colección entre dos entornos (por ejemplo, desarrollo y producción). Las diferencias (altas / bajas / cambios) se listan por documento y por campo.

• Puedes indicar campos a excluir de la comparación, como updatedAt.
• El contenido de las diferencias se puede exportar como CSV.

Copiar a otro entorno

«Copiar a otro entorno…» te permite duplicar una colección hacia otra conexión (entorno). Antes de ejecutar se previsualiza la cantidad y si habrá sobrescrituras, y la escritura en producción pasa por la misma protección estricta de siempre.

Usuarios de Authentication

Desde «Authentication», en la barra lateral, puedes ver y administrar los usuarios de Firebase Authentication.

• Lista de correo, nombre visible, proveedor, fecha de creación y último inicio de sesión. El interruptor de nombre lógico también traduce los nombres de los campos.
• Permite deshabilitar / habilitar y eliminar usuarios, y enviar correos de restablecimiento de contraseña.
• Puedes copiar el UID de un usuario para cotejarlo con los documentos de Firestore.
• Las operaciones destructivas (como eliminar) pasan por el mismo pipeline de seguridad que Firestore (confirmación → registro de auditoría).

Actualización

• Las actualizaciones se comprueban automáticamente cada 6 horas y al iniciar (también puedes comprobarlo manualmente desde Configuración → Información → «Buscar actualizaciones»).
• Si se publica una actualización obligatoria, desde la pantalla de actualización al iniciar se realiza automáticamente la descarga → el reinicio → la aplicación, sin necesidad de pulsar ningún botón.
• Solo si falla (por ejemplo, sin conexión) se indica la descarga manual desde el navegador.

Precios y licencia

• Desde el primer inicio tienes 14 días de prueba con todas las funciones disponibles. No se requiere registro ni datos de pago.
• Aunque venza el plazo, la visualización de datos sigue siendo gratuita.
• La compra se hace desde dentro de la app: en ⚙ Configuración → Licencia, abajo a la derecha, elige un plan (Pro / TEAM, mensual / anual) y se abrirá en el navegador la página de pago segura de Stripe. Al completar el pago, la app activa la licencia automáticamente.
• Si cambias a otro Mac, primero «Desactiva la licencia» en el equipo anterior y luego actívala en el nuevo.

Para más detalles sobre los planes, consulta la página de precios.

Preguntas frecuentes

No puedo conectar / aparece «Error de autenticación»

Comprueba que el JSON sea la clave de cuenta de servicio del proyecto correcto. Si regeneraste la clave, lo más seguro es desconectar la conexión antigua y volver a conectar con el nuevo JSON.

¿Se envían mis datos a algún lado?

No. Firescope accede directamente a Firestore desde tu Mac. Ni las claves ni los datos se envían a servidores externos.

¿Qué hace exactamente la «protección de producción»?

Es un mecanismo que ajusta automáticamente la intensidad de la confirmación según la etiqueta de entorno de la conexión y el riesgo de la operación. Por ejemplo, eliminar una colección en producción no se puede ejecutar sin escribir a mano el ID del proyecto. Como la validación ocurre en el núcleo de la app (el proceso principal) y no es solo un aviso de la interfaz, no se puede saltar por descuido.

¿Hay versión para Windows?

Sí. Descarga Firescope-Setup.exe desde la página de descargas (si aparece un aviso de SmartScreen, continúa con «Más información» → «Ejecutar de todas formas»).

¿Puedo añadir otro idioma?

Sí. Desde Configuración → Idioma puedes exportar un paquete de idioma (JSON), traducirlo e importarlo para añadir el idioma que quieras.