DISTRIBUCIONES YONY — V9 COMPLETA — PHP + MySQL — PC Y CELULAR
=============================================================

IMPORTANTE: COPIA DE SEGURIDAD ANTES DE BORRAR NADA
- Exporte la base actual desde phpMyAdmin a .sql y descargue la carpeta completa desde cPanel.
- No borre documentos fiscales emitidos. Este código todavía NO transmite comprobantes a SUNAT.
- No comparta contraseñas, token DNI/RUC ni certificados por el chat.

SI YA TIENE EL SISTEMA INSTALADO V6/V7/V8:
1) Guarde la copia de seguridad. Suba el contenido de este ZIP a la carpeta existente,
   reemplazando los archivos PHP, JS y CSS. NO reemplace config/config.php ni el contenido
   de storage/certificates, storage/documents ni storage/logs.
2) Ingrese como Administrador y abra https://su-dominio/su-ruta/actualizar_v9.php
3) Primero verá las columnas que faltan. Marque la confirmación del respaldo y pulse
   «Comprobar y reparar frecuencia». Corrige únicamente las dos columnas agregadas en V8
   si faltan: clients.visit_frequency_value y clients.visit_frequency_unit.
4) Si el diagnóstico muestra otras tablas/columnas faltantes, NO borre datos para
   arreglarlo; restaure la copia o utilice una base NUEVA con instalación limpia.
5) Si el cliente desea EMPEZAR EN BLANCO y NO existe ninguna boleta/factura en la base:
   abra como Administrador reiniciar_datos.php. Antes de confirmar verifique el listado
   de registros que se borrarán. Escriba «BORRAR TODO YONY», introduzca la contraseña
   actual del Administrador y confirme su respaldo. No hay borrado automático al subir.
6) Cierre sesión en PC y celulares, vuelva a entrar y recargue la página completamente.
   Las colas offline anteriores al reinicio se invalidan para que no reaparezcan datos viejos.
7) Elimine actualizar_v9.php y reiniciar_datos.php de cPanel una vez usados.

SI QUIERE INSTALACIÓN TOTALMENTE NUEVA Y EN BLANCO:
1) NO sobrescriba ni elimine la base anterior sin antes hacer un respaldo.
2) Cree una base MySQL NUEVA Y VACÍA en cPanel, asigne un usuario con todos los privilegios.
3) Suba y extraiga el ZIP en una carpeta nueva (o renombre la antigua previamente).
4) Abra https://su-dominio/su-ruta/install.php, complete MySQL y cree su Administrador.
5) NO ejecute los instaladores antiguos; no importa padrón, productos ni ubicaciones demo.
6) Inicie sesión. Clientes, rutas, productos, notas, GPS y cobros comienzan vacíos.
7) Al terminar, retire install.php y actualizar_v9.php del hosting.

CONTROLES DE EDICIÓN Y ELIMINACIÓN
- Clientes: nuevo, ver, editar, eliminar y quitar ubicación del mapa.
- Productos: nuevo, editar y eliminar; los relacionados con ventas se desactivan
  para preservar kardex e historial.
- Rutas: nuevo, editar y quitar del uso comercial; preserva referencias históricas.
- Usuarios: editar y desactivar. Nunca se elimina el Administrador que está operando.
- Notas: editar o anular según su estado (no anular documentación fiscal).
- Fuera del horario configurado, la edición continúa bloqueada para roles no administradores.
- Si el cliente tiene ventas pendientes, debe completar/cancelar antes de eliminarlo.

OPERACIÓN
- Sin barra lateral, botones cuadrados, versión móvil y escritorio.
- Mapa muestra solo clientes con coordenadas; GPS requiere HTTPS, permisos y aplicación abierta.
- El almacén recibe pedidos conectados y pedidos offline al recuperar señal.
- Hoja de salida por ruta, impresión notas individual, cuatro por A4 y térmica.
- Nota de venta principal; selector C&J Grupo / Distribuciones Yony.
- Configuración independiente de certificado por emisor; envío XML/CDR a SUNAT
  no se considera habilitado hasta pruebas reales de integración.
