Manual de uso — Plantillador

Comparador por párrafos y oraciones con editor y dictado. Esta guía cubre flujo, atajos y trucos, alineada al código de tu app.

1) Mapa de la interfaz

La app se compone de barra superior, columna de Plantillas, área de Plantilla y Informe, y la Salida con métricas y acceso al editor.

Vista general de Plantillador — Vista general. Sube o escribe tu plantilla (izquierda), pega o dicta el informe (derecha) y pulsa **Comparar**.

Salida y métricas: frases totales, con cambios y porcentaje.

2) Flujo básico

Plantilla: carga un .txt o escribe tu base.
Informe: pega el texto o usa el micrófono (🎤).
Comparar: el sistema alinea por párrafos y compara por oraciones.
Salida: las oraciones con cambios se muestran en MAYÚSCULAS ámbar (en la salida) y el resto se mantiene normal.
Editar salida: abre el editor con control de cambios para pulir.
Copiar: copia el resultado de la salida en el portapapeles.

Consejo: pega el informe crudo; posteriormente el botón Normalizar del editor corrige espacios, mayúsculas y siglas.

3) Gestión de plantillas

Guardar plantilla: almacena el contenido actual con un nombre.
Usar: coloca la plantilla elegida en el cuadro de la izquierda.
Renombrar y Eliminar desde la lista.

Se guardan en localStorage del navegador (disponibles solo en el mismo equipo/navegador).

4) Dictado por voz (Web Speech)

Botón 🎤 en Informe o en el Editor.
Atajo configurable con Alt (modo pulsar o alternar en ⚙️).
Comandos útiles: “punto”, “coma”, “dos puntos”, “nueva línea”, “nuevo párrafo”.

5) Comparar & métricas

El algoritmo alinea cada párrafo del informe con su mejor match de la plantilla y compara por oraciones. Inserciones/reemplazos cuentan como “cambios”.

📝 Frases en informe: total detectado.
🔄 Frases con cambios: oraciones insertadas/reemplazadas o plantillas eliminadas.
📊 % cambio: cambios / máx(informe, plantilla).

Métricas de comparación — Métricas tras pulsar **Comparar**.

6) Editor con control de cambios

Texto base = la salida inicial; las inserciones aparecen con fondo cian.
El texto original en MAYÚSCULAS se pinta ámbar (sin fondo).
Enter = nuevo párrafo (doble salto). Shift+Enter = salto simple.
Limpiar resaltados: fija el estado actual como “original”.
Restaurar original: vuelve al HTML de salida con estilos originales.
Copiar: copia texto plano del editor.

Editor antes de editar — Estado inicial al abrir el editor.

Editor con cambios — Inserciones en cian; original en ámbar sin fondo.

Modal del editor — Barra del editor con acciones (🎤, Limpiar, Normalizar, Copiar, Restaurar).

7) Normalizar (reglas aplicadas)

Quita espacios sobrantes: antes de , . ; : ! ? …, alrededor de paréntesis y corchetes.
Asegura un espacio tras , ; : y tras . ! ? … cuando sigue texto.
Sentence case: mayúscula al inicio de línea y tras punto/exclamación/interrogación.
Respeta siglas (lista en ⚙️ “Palabras excluidas”) y unidades comunes (mm, cm, ml…).
Encabezados que terminan en : se mantienen en MAYÚSCULAS si activas “📌 Mantener encabezados”.

Antes de normalizar — Texto crudo con mayúsculas/espacios inconsistentes.

Después de normalizar — Espaciado corregido y capitalización coherente.

8) Configuración (⚙️)

Modo de dictado con Alt: Pulsar y mantener o Alternar.
Palabras excluidas: lista de siglas/terminología que no se alterará al normalizar.
Importa/Exporta esta lista en .json.

Modal de configuración — Modal de Configuración con switch de dictado y lista de exclusión.

9) Atajos de teclado

Alt — iniciar/detener dictado (según modo).
Editor: Enter = párrafo; Shift + Enter = línea.

10) Problemas comunes

Dictado no inicia/detiene: revisa permisos del micrófono y el modo de dictado en ⚙️; recarga la página.
Métricas no coinciden: ejecuta Comparar nuevamente después de editar la salida.
Plantillas desaparecieron: limpiar caché borra localStorage.

11) Privacidad y almacenamiento

Tus plantillas y el último estado (plantilla/informe) se guardan localmente usando localStorage. No se envían a servidores.

12) Acerca de

Contacto: drmsalinasv@gmail.com