INSTALACIÓN DE WEBSISCRE EN CPANEL
=================================

Este paquete incluye el sistema y una copia completa de la base de datos actual.
La importación conserva clientes, operaciones, pagos, parámetros, usuarios,
roles y permisos existentes.

REQUISITOS
----------
- PHP 8.0 o superior (recomendado PHP 8.1 u 8.2).
- MySQL o MariaDB.
- Extensiones PHP: mysqli, mbstring y fileinfo.
- Certificado SSL/HTTPS habilitado.

1. CREAR LA BASE DE DATOS
-------------------------
1) Ingrese a cPanel > Bases de datos MySQL.
2) Cree una base, por ejemplo: websiscre.
3) Cree un usuario para esa base con una contraseña segura.
4) Agregue el usuario a la base y marque TODOS LOS PRIVILEGIOS.

cPanel normalmente agrega el prefijo de su cuenta. Anote los valores completos,
por ejemplo:
  Base:    micuenta_websiscre
  Usuario: micuenta_websiscre
  Host:    localhost

2. IMPORTAR LA BASE ACTUAL
--------------------------
1) Abra cPanel > phpMyAdmin.
2) Seleccione a la izquierda la base recién creada.
3) Entre en Importar.
4) Seleccione database/websiscre_cpanel.sql.
5) Mantenga el juego de caracteres UTF-8 y pulse Importar.
6) Al finalizar deben existir 34 tablas.

El SQL no crea ni selecciona una base con nombre fijo: se importa dentro de la
base que usted haya seleccionado en phpMyAdmin.

3. SUBIR LOS ARCHIVOS
---------------------
Opción A - Dominio principal:
  Extraiga el contenido de WebSisCre-cPanel dentro de public_html.

Opción B - Subcarpeta:
  Cree public_html/websiscre y extraiga allí el contenido.
  La dirección será https://su-dominio.com/websiscre

Puede usar el Administrador de archivos de cPanel: suba el ZIP, selecciónelo y
pulse Extraer. Los archivos PHP deben quedar directamente en la carpeta elegida,
no dentro de dos carpetas WebSisCre-cPanel anidadas.

4. CONFIGURAR LA CONEXIÓN
-------------------------
Edite config.php desde el Administrador de archivos y cambie solamente:

  const DB_HOST = 'localhost';
  const DB_NAME = 'USUARIOCPANEL_websiscre';
  const DB_USER = 'USUARIOCPANEL_websiscre';
  const DB_PASS = 'CAMBIAR_POR_LA_CLAVE_DE_LA_BASE';

Use los nombres completos asignados por cPanel. La ruta web se detecta en forma
automática, tanto en el dominio principal como dentro de una subcarpeta.

5. PERMISOS Y PRIMER INGRESO
----------------------------
- Carpetas: normalmente 755.
- Archivos: normalmente 644.
- Carpeta uploads: 755; si no permite adjuntar documentos, use 775.
- Nunca use permisos 777 salvo indicación expresa de su proveedor.

Abra la dirección del sistema e ingrese con el mismo usuario y contraseña que
utiliza actualmente. La contraseña no puede verse en el SQL porque está cifrada,
pero continúa funcionando sin cambios.

6. COMPROBACIONES
-----------------
- Inicie sesión.
- Abra Inventario de Cartera y compruebe Guaraníes y Dólares.
- Abra un cliente y una operación.
- Compruebe Caja, Capitales e Informes.
- Pruebe subir un archivo pequeño a un cliente.
- Verifique que el dominio use HTTPS.

7. SEGURIDAD DESPUÉS DE INSTALAR
--------------------------------
1) Elimine del servidor la carpeta database después de importar el SQL.
2) Conserve el ZIP y el SQL solamente como respaldo fuera de public_html.
3) Cambie la contraseña de la base si el paquete fue compartido con otra persona.
4) Realice una copia de la base y de uploads antes de cada actualización.

SOLUCIÓN DE PROBLEMAS
---------------------
"Access denied for user": revise DB_USER, DB_PASS y que el usuario esté agregado
a la base con todos los privilegios.

"Unknown database": revise DB_NAME, incluyendo el prefijo de cPanel.

Pantalla en blanco o error 500: seleccione PHP 8.0 o superior y active mysqli.
Revise también el archivo error_log desde cPanel.

No se guardan documentos: confirme permisos de escritura en uploads y que el
límite de subida del hosting sea de al menos 10 MB.

Las páginas no cargan estilos: confirme que app.php, assets y config.php estén
en el mismo nivel y que no haya una carpeta adicional anidada.

