# Guía de Implementación del Corrector Ortográfico Automático

Este documento detalla el funcionamiento técnico del módulo de corrección ortográfica automática en español. Su objetivo es colocar de manera transparente tildes (acentos) y la letra "ñ" en campos comunes como nombres, apellidos, cargos/rangos y departamentos, tanto en el frontend en tiempo real como en el backend al procesar inserciones o importaciones masivas.

---

## 1. Funcionamiento del Backend (PHP)

El núcleo del corrector en el backend se encuentra en el archivo [corrector_helper.php](file:///c:/xampp/htdocs/Polimerida_Control_QR/backend/corrector_helper.php).

### Algoritmo y Diccionario
El script utiliza una función `corregirTextoAcentos($texto)` que cuenta con un diccionario estático de términos comunes (ej: `"jose" => "José"`, `"perez" => "Pérez"`, `"policia" => "Policía"`).

```php
function corregirTextoAcentos($texto) {
    if (empty($texto)) return $texto;
    
    static $diccionario = [
        "policia" => "Policía",
        "tecnico" => "Técnico",
        "cientifico" => "Científico",
        "jose" => "José",
        "maria" => "María",
        "perez" => "Pérez",
        "gonzalez" => "González",
        // ... (Ver diccionario completo en backend/corrector_helper.php)
    ];
    // ...
}
```

### Reglas de Preservación de Capitalización
Para no alterar el formato visual de la base de datos o el carnet, el algoritmo preserva el estado de mayúsculas y minúsculas original utilizando funciones unicode de PHP:

1. **MAYÚSCULAS COMPLETAS**: Si la palabra ingresada está completamente en mayúsculas (ej: `JOSE PEREZ`), se retorna en mayúsculas corregidas (`JOSÉ PÉREZ`).
2. **Tipo Título (Capitalizado)**: Si la palabra empieza con mayúscula (ej: `Jose Perez`), se retorna capitalizada (`José Pérez`).
3. **minúsculas**: Si está en minúsculas (ej: `jose perez`), se retorna en minúsculas (`josé pérez`).

Esto se logra mediante la siguiente expresión regular unicode:

```php
return preg_replace_callback('/[\p{L}]+/u', function($coincidencia) use ($diccionario) {
    $palabra = $coincidencia[0];
    $palabra_normalizada = mb_strtolower($palabra, 'UTF-8');
    
    // Normalizar tildes existentes para buscar en diccionario sin conflicto
    $sin_acentos = str_replace(
        ['á', 'é', 'í', 'ó', 'ú', 'ü', 'ñ'],
        ['a', 'e', 'i', 'o', 'u', 'u', 'n'],
        $palabra_normalizada
    );
    
    $key = isset($diccionario[$palabra_normalizada]) ? $palabra_normalizada : (isset($diccionario[$sin_acentos]) ? $sin_acentos : null);
    
    if ($key !== null) {
        $correcto = $diccionario[$key];
        
        // 1. Todo en MAYÚSCULAS
        if (mb_strtoupper($palabra, 'UTF-8') === $palabra) {
            return mb_strtoupper($correcto, 'UTF-8');
        }
        // 2. Tipo Título
        if (preg_match('/^\p{Lu}/u', $palabra)) {
            return mb_convert_case($correcto, MB_CASE_TITLE, 'UTF-8');
        }
        // 3. Minúsculas
        return mb_strtolower($correcto, 'UTF-8');
    }
    return $palabra;
}, $texto);
```

---

## 2. Funcionamiento del Frontend (JavaScript)

El script cliente [corrector.js](file:///c:/xampp/htdocs/Polimerida_Control_QR/js/corrector.js) realiza la misma lógica de corrección en tiempo real en los formularios del navegador.

### Activación en el Evento Blur
El archivo JS escucha la pérdida de foco (`blur`) de los campos de texto del formulario y reemplaza el texto en vivo:

```javascript
// Auto-enlazar eventos en carga de página
function initCorrector() {
    const selectors = [
        'input[name="nombres"]', 
        'input[name="apellidos"]', 
        'input[name="rango"]', 
        'input[name="departamento"]'
    ];
    selectors.forEach(sel => {
        document.querySelectorAll(sel).forEach(input => {
            if (input.dataset.correctorInit) return;
            input.dataset.correctorInit = "true";
            
            input.addEventListener('blur', function() {
                this.value = corregirTextoAcentosJS(this.value);
            });
        });
    });
}

if (document.readyState !== 'loading') {
    initCorrector();
} else {
    document.addEventListener('DOMContentLoaded', initCorrector);
}
```

> [!NOTE]
> Al corregir tanto en el cliente (JS) como en el servidor (PHP), se garantiza una excelente experiencia de usuario interactiva y una base de datos 100% limpia incluso si las peticiones evaden el navegador (ej: carga masiva).

---

## 3. Limpieza Retroactiva en la Base de Datos

Para corregir registros previamente guardados sin acentos, se puede ejecutar una sola vez un script de limpieza backend que examine todos los registros, aplique el corrector y actualice si hay diferencias:

```php
<?php
require 'backend/conexion.php';
require 'backend/corrector_helper.php';

$stmt = $pdo->query("SELECT id, nombres, apellidos, rango, departamento FROM personal");
$funcionarios = $stmt->fetchAll(PDO::FETCH_ASSOC);

$updated = 0;
foreach ($funcionarios as $f) {
    $nombres_c = corregirTextoAcentos($f['nombres']);
    $apellidos_c = corregirTextoAcentos($f['apellidos']);
    $rango_c = corregirTextoAcentos($f['rango']);
    $departamento_c = corregirTextoAcentos($f['departamento']);
    
    if (
        $nombres_c !== $f['nombres'] || 
        $apellidos_c !== $f['apellidos'] || 
        $rango_c !== $f['rango'] || 
        $departamento_c !== $f['departamento']
    ) {
        $updateStmt = $pdo->prepare("UPDATE personal SET nombres = ?, apellidos = ?, rango = ?, departamento = ? WHERE id = ?");
        $updateStmt->execute([$nombres_c, $apellidos_c, $rango_c, $departamento_c, $f['id']]);
        $updated++;
    }
}
echo "Se corrigieron retroactivamente $updated registros.";
```

---

## 4. Guía Paso a Paso para Integrar en un Nuevo Proyecto

Para aplicar esta funcionalidad a un nuevo formulario en otro proyecto:

1. **Copiar Archivos**: Copia el archivo `corrector_helper.php` a la carpeta `backend/` de tu proyecto y `corrector.js` a tu carpeta `js/`.
2. **Enlazar el JavaScript**: Añade la etiqueta script al final de los archivos HTML o PHP del formulario:
   ```html
   <script src="js/corrector.js"></script>
   ```
   *Asegúrate de que los inputs de texto tengan el atributo `name` configurado como `nombres`, `apellidos`, `rango` o `departamento` (o edita la variable `selectors` dentro de `corrector.js` para adaptarlos a tus nombres de inputs).*
3. **Incluir en Procesamiento Backend**: En el script PHP receptor que procesa el formulario de inserción o actualización (ej: `guardar.php`), incluye el helper al principio:
   ```php
   require 'backend/corrector_helper.php';
   ```
4. **Sanitizar/Corregir Variables**: Aplica la función antes de guardar o usar las variables en tus consultas preparadas de SQL:
   ```php
   $nombres = corregirTextoAcentos($_POST['nombres'] ?? '');
   $apellidos = corregirTextoAcentos($_POST['apellidos'] ?? '');
   ```
