========================================================================
 BITÁCORA VIRTUAL — LA EXTENSIÓN — LÉEME PRIMERO
========================================================================

Esta carpeta es la extensión de Chrome. No pasa por ninguna tienda ni
pide "solicitar acceso" a nadie — la instalás una vez y queda lista
para usar en tus clases de Google Meet, Microsoft Teams o Zoom (la
versión que corre en el navegador, no la app de escritorio).


------------------------------------------------------------------------
1. INSTALARLA (una sola vez, dos minutos)
------------------------------------------------------------------------

    1. Abrí Chrome y escribí en la barra de direcciones:
           chrome://extensions
    2. Arriba a la derecha, activá "Modo de desarrollador" /
       "Developer mode".
    3. Hacé clic en "Cargar descomprimida" / "Load unpacked".
    4. Seleccioná esta carpeta completa (bitacora-virtual-extension).
    5. Listo — ya aparece el ícono de Bitácora Virtual (la lunita
       naranja) junto a la barra de direcciones de Chrome.

Truco: hacé clic en el ícono de puzzle 🧩 de Chrome y "fijá" el ícono
de Bitácora Virtual para tenerlo siempre a mano.


------------------------------------------------------------------------
2. USARLA EN UNA CLASE
------------------------------------------------------------------------

    1. Entrá a tu clase normalmente (Meet, Teams o Zoom, desde Chrome).
    2. Abrí el panel de "Personas" / "Participantes" de esa
       plataforma — así es como Bitácora Virtual sabe quién está.
    3. Hacé clic en el ícono de la extensión: vas a ver la lista en
       vivo, con cuánto lleva conectada cada persona.
    4. Al terminar la clase, tocá "Exportar a Excel". Se descarga un
       archivo .xlsx con nombre, correo (cuando esté disponible),
       hora de ingreso, duración y reconexiones de cada quien.


------------------------------------------------------------------------
2b. SABER SI ALGUIEN ESTUVO TODA LA CLASE (o solo se asomó)
------------------------------------------------------------------------

Si alguien se desconecta y vuelve a entrar, la bitácora no solo
cuenta cuántas veces lo hizo: también mide CUÁNTO TIEMPO ESTUVO
AUSENTE y en qué horarios.

En la ventana de la extensión, debajo del nombre de quien se
ausentó, vas a ver una línea en ámbar como:

    ausente 15m 00s · 88% presente

Y en el archivo de Excel tenés tres columnas para esto:

    - "Tiempo ausente"      → cuánto estuvo fuera en total
    - "% presente"          → qué parte del tiempo estuvo realmente
    - "Detalle de ausencias" → los horarios exactos de cada ausencia,
                               ej. 18:50–19:05 (15m 00s)

Para qué sirve: alguien que entra 10 minutos al inicio y 10 al
final suma 20 minutos igual que quien estuvo 20 minutos seguidos —
pero el primero te va a aparecer con un 17% presente y una ausencia
de 1h 40m en el medio. Ahí se nota la diferencia.

Podés volver a abrir la extensión días después: "Sesiones guardadas"
te deja exportar clases anteriores sin tener que estar en la llamada.


------------------------------------------------------------------------
3. SI ALGUIEN NO APARECE EN LA LISTA
------------------------------------------------------------------------

Tocá "Tomar snapshot" dentro de la extensión — hace una lectura
manual del panel de participantes en ese momento, igual que si
tomaras una captura de pantalla, pero queda guardada como parte de
tu registro. Es un buen hábito hacerlo un par de veces durante clases
largas, además del registro automático.


------------------------------------------------------------------------
4. LO QUE ESTA EXTENSIÓN NO PUEDE HACER (para que no te sorprenda)
------------------------------------------------------------------------

- No puede leer el correo de nadie si la propia plataforma no lo
  muestra en pantalla. Google Meet, en particular, casi nunca lo
  expone — vas a tener nombre y foto siempre, correo solo a veces.
- No funciona con la app de escritorio de Zoom — solo con la versión
  que corre dentro de Chrome (zoom.us en el navegador).
- Si Google, Microsoft o Zoom rediseñan su panel de participantes,
  la lectura automática puede fallar hasta que se actualice esta
  extensión. Para esos casos siempre está "Tomar snapshot".
- No sube nada a internet. Todo el registro vive en tu propia
  computadora, dentro de este navegador — si lo desinstalás, se
  borra (exportá lo que necesites conservar antes).


------------------------------------------------------------------------
5. AJUSTES
------------------------------------------------------------------------

Hacé clic en el ícono ⚙ dentro de la extensión (o clic derecho sobre
el ícono → Opciones) para poner tu nombre, tu facultad y tu correo —
así tus archivos Excel exportados llevan esos datos.


------------------------------------------------------------------------
¿Dudas? Escribile a quien te entregó esta extensión.
========================================================================
