# Manual de Uso y Administración Corporativa — Mesi Chat

**Aplicación:** Mesi Chat (`ar.com.mesi.mesimessenger`)  
**Autor:** Mesi (`mesi.com.ar`)  
**Clúster DHT Primario por Defecto:** `chat.mesi.com.ar` (con respaldo automático en la red DHT pública BEP-44)

---

## 1. Primer Inicio y Creación de tu Identidad Autocertificada (`alias#PIN`)

Mesi Chat no utiliza cuentas centrales, números de teléfono ni correos electrónicos:

1. Al abrir **Mesi Chat** por primera vez, escribe el **alias** con el que deseas identificarte (por ejemplo: `andres`, `administracion` o `soporte`).
2. Selecciona tu **Idioma** (Automático, Español, Inglés o Italiano) y **Tema visual** (Sistema, Claro u Oscuro).
3. Verifica que la casilla **"Acepto las Normas de Uso (EULA) y Política de Privacidad"** esté activada y toca **Continuar**.
4. Tu dispositivo generará localmente tus claves criptográficas (`X25519` y `Ed25519`) y mostrará en la parte superior de la pantalla tu **Código para compartir** con formato `alias#PIN` (por ejemplo: `andres#A7B9K2`).
   - **Nota de seguridad:** Los 6 caracteres después del `#` son una huella matemática derivada del `SHA-256` de tu clave pública. Nadie en el mundo puede falsificar ni clonar tu código `alias#PIN`.
   - Toca el botón **Copiar** junto a tu código para enviárselo a tus contactos o configurarlo en tus servidores de alertas.

---

## 2. Cómo Agregar Contactos y Personalizar tu Agenda Local

La agenda de Mesi Chat vive **100% dentro de tu teléfono** (no se sube a ningún servidor):

1. En la pantalla principal (**Conversaciones**), toca el ícono de **Nuevo Chat (`+`)** arriba a la derecha.
2. En el campo **Código del contacto (`alias#PIN`)**, pega o escribe el código exacto de la otra persona o servidor (por ejemplo: `gerencia#M4P8Q1`).
3. En el campo **Nombre para agendar (opcional)**, escribe el nombre con el que quieres verlo en tu lista (por ejemplo: `Gerencia General` o `Servidor ERP`).
4. Toca **Agregar**.
5. **¿Cómo cambiar el nombre de un contacto más adelante?**
   - En la lista de chats, **desliza la conversación hacia la derecha** y toca **Agendar / Cambiar nombre** (ícono de lápiz azul), o entra al chat, toca el menú **`(...)`** arriba a la derecha y elige **Agendar / Cambiar nombre**.

---

## 3. Mensajería Cifrada y Significado de los Estados de Entrega

Cada mensaje que envías tiene un límite físico de **960 bytes** de sobre criptográfico (aproximadamente 923 caracteres UTF-8), diseñado para entrar en un único registro mutable de memoria RAM en la red DHT:

- **`✓ Enviado` (P2P):** El paquete fue entregado directamente por red local o UDP directo al otro dispositivo.
- **`✓ En buzón DHT` (`DHT seq=N`):** El destinatario tiene el teléfono bloqueado o fuera de línea; tu sobre cifrado (`ChaCha20-Poly1305`) quedó depositado en la memoria RAM volátil de `chat.mesi.com.ar` (donde puede esperar hasta 28 días).
- **`✓✓ Recibido`:** El dispositivo del destinatario ya descargó tu mensaje y **sobrescribió físicamente la memoria RAM del servidor DHT** con un acuse firmado de 37 bytes (`RECV`). En este instante, el mensaje ya no existe en la memoria del servidor.
- **`✓✓ Leído` (color celeste brillante):** El destinatario abrió la conversación y vio tu mensaje en pantalla (`READ`).

---

## 4. Herramientas Corporativas dentro del Chat (Botón `+`)

A la izquierda de la barra de escritura encontrarás el botón **`+`** (y accesos rápidos en la barra superior):

### A) ⏱️ Modo Clave (Autodestrucción 60 segundos tras lectura)
Ideal para enviar contraseñas de servidores, claves bancarias o tokens temporales:
1. Toca el botón **`+`** y selecciona **Modo Clave (autodestrucción 60s)** (o toca el ícono del cronómetro `⏱️` arriba a la derecha).
2. Verás que el botón de envío y el borde del cuadro de texto cambian a **color violeta** con el aviso *"⏱️ Autodestrucción 60s tras lectura"*.
3. Escribe la clave y envíala.
4. **¿Cuándo se destruye?** El reloj de 60 segundos **no corre mientras el mensaje espera en el buzón DHT**; recién comienza a descontar en el segundo exacto en que el destinatario abre el chat y el mensaje pasa a **`✓✓ Leído`**. Pasados 60 segundos de su lectura, desaparece automáticamente del historial de ambos teléfonos.

### B) ✍️ Solicitud de Autorización Firmada Criptográficamente
Permite aprobar o rechazar órdenes, pagos o cambios de sistemas dejando constancia matemática sin usar blockchain ni bases de datos externas:
1. Toca el botón **`+`** dentro del chat y elige **Solicitar Autorización Firmada**.
2. Escribe el concepto a autorizar (por ejemplo: *"Autorizar transferencia proveedor USD 1.500 - Factura 0042"*) y toca **Enviar Solicitud**.
3. Al destinatario le aparecerá una tarjeta interactiva con dos botones: **`[ ✅ Aprobar ]`** y **`[ ❌ Rechazar ]`**.
4. Cuando el destinatario pulsa uno de los dos botones, su teléfono firma criptográficamente la decisión y ambos ven en pantalla el sello verde o rojo con el **`ID: alias#PIN`** del firmante y el hash **`SHA256`** único de la operación.

### C) ⚡ Zumbidos de Atención Inmediata
- Toca el botón naranja con el rayo **`⚡`** junto al cuadro de texto para enviar un **Zumbido**.
- El teléfono del destinatario reproducirá el sonido de alerta especial, vibrará físicamente y sacudirá toda la ventana de la aplicación.

---

## 5. Estado de Conexión (Login / Logout), Horario Laboral Online y Control Parental (`⚙️ Opciones`)

En la parte superior de la pantalla principal (**Conversaciones**) y dentro de **`⚙️ Opciones`**, Mesi Chat incorpora tres funciones diseñadas para el bienestar laboral en empresas y la seguridad de menores en familias:

1. **Botón En Línea / Desconectado (Login / Logout sin perder tu identidad):**
   - En la tarjeta superior de la lista de conversaciones verás tu estado actual: **🟢 En línea** (con botón **`[ Desconectar ]`**) o **🔴 Desconectado (En pausa)** (con botón **`[ Conectar ahora ]`**).
   - Cuando pasas a **Desconectado**, Mesi Chat pausa por completo la recepción, las notificaciones, los sonidos y el envío de mensajes.
   - Los mensajes que otros te envíen mientras estás Desconectado **no se pierden**: esperan cifrados en la memoria RAM del buzón DHT (donde el emisor ve `✓ En buzón DHT`, sabiendo que aún no estás disponible) y se descargan juntos en el instante en que tocas **`[ Conectar ahora ]`**.
2. **Programación de Días y Horario Online (Jornada Laboral o Horario Familiar):**
   - Entra a **`⚙️ Opciones -> Estado de Conexión y Horario Online`** y activa **"Programar días y horario online"**.
   - Selecciona los **Días activos** tocando los círculos de cada día (**`L` `M` `X` `J` `V` `S` `D`**, por defecto Lunes a Viernes) y elige la **Hora de inicio** (ej. `09:00`) y la **Hora de fin** (ej. `18:00`).
   - Fuera de ese rango horario, la app pasa automáticamente a **"Fuera de horario laboral"**, silenciando la recepción y el despertar en segundo plano hasta el próximo día hábil (o hasta que toques manualmente **`[ Conectar ahora ]`**).
3. **Control Parental con PIN (Modo Familiar para Menores):**
   - Entra a **`⚙️ Opciones -> Control Parental (Modo Familiar)`**, activa **"Activar Control Parental con PIN"** e ingresa un PIN de adulto de al menos 4 dígitos.
   - Cuando el **Control Parental** está activo:
     - **El menor NO puede agregar contactos nuevos** (el botón `+` muestra un candado y exige el PIN de adulto).
     - **El menor NO puede borrar ni bloquear a los contactos familiares agendados**, ni vaciar el historial de conversaciones, ni eliminar la identidad.
     - **Se activa automáticamente el Modo Cerrado Anti-Spam** (*Permitir solicitudes de nuevos contactos = NO*) y se oculta el código `alias#PIN` en pantalla (`🔒 alias#••••••`) para que ningún desconocido pueda contactar al menor.
     - **Combinable con el Horario Online:** Los padres pueden programar en qué días y horarios el menor puede chatear; como las Opciones y el botón de conexión quedan protegidos con el PIN Parental, el menor no puede alterar el horario.
4. **Bloqueo con Face ID / Touch ID y Servidor DHT Propio (`chat.mesi.com.ar`):**
   - Si activas **Bloqueo con Face ID / Touch ID**, cada vez que Mesi Chat se abra exigirá validación biométrica.
   - Por defecto utiliza como Prioridad #1 el clúster en memoria RAM `chat.mesi.com.ar` con conmutación automática a la red DHT pública mundial.

---

## 6. Envío de Alertas desde Servidores y Sistemas (`mesichat-cli`)

Las empresas pueden enviar alertas automáticas desde sus servidores hacia los dispositivos de sus administradores:

1. **Iniciar el agente en el servidor:**
   ```bash
   ./mesichat-cli -nick srv-backup -dht chat.mesi.com.ar
   ```
2. **Comandos disponibles dentro de `mesichat-cli`:**
   - `/code` — Muestra el código `srv-backup#PIN` del servidor.
   - `/add usuario#PIN` — Vincula al servidor con el teléfono del administrador.
   - `/msg usuario <texto>` — Envía un mensaje o alerta cifrada (por P2P o buzón DHT en RAM).
   - `/read <MsgID>` — Envía confirmación de lectura manual.
   - `/peers` — Lista los contactos vinculados y sus claves públicas verificadas.
