LOTEA · INSTALACIÓN EN CPANEL
=============================

Lo que necesitas del hosting
----------------------------
- PHP 8.3 o superior.
- Extensiones activas: pdo_mysql, mbstring, openssl, zip, gd, zlib, fileinfo, intl.
  En cPanel se activan en "Select PHP Version" > pestaña "Extensions".
- MySQL 5.7+ o MariaDB 10.2+ (se usan columnas JSON).
- Al menos 32 MB de subida de archivos. Si tu plano pesa más, sube
  upload_max_filesize y post_max_size en "MultiPHP INI Editor".

No hace falta Composer ni Node: el paquete ya trae las dependencias y el
front end compilado.


Paso 1 · Crea la base de datos
------------------------------
En cPanel > "MySQL® Databases":
  1. Crea una base, por ejemplo  cuenta_lotea
  2. Crea un usuario, por ejemplo  cuenta_lotea
  3. Añade el usuario a la base con TODOS LOS PRIVILEGIOS.
Anota el nombre completo de la base, el usuario y la contraseña.


Paso 2 · Sube el sistema
------------------------
Tienes dos formas. La primera es la recomendada.

  A) Dominio apuntando a public/  (más segura)
     1. Sube el ZIP a una carpeta fuera de public_html, por ejemplo /home/usuario/lotea
     2. Extráelo ahí con el Administrador de archivos.
     3. En cPanel > "Domains", edita el dominio y pon como raíz del documento:
        /home/usuario/lotea/public
     4. Borra install/htaccess-raiz.txt, no lo necesitas.

  B) Todo dentro de public_html  (si no puedes cambiar la raíz)
     1. Sube el ZIP a public_html y extráelo ahí.
     2. Renombra  install/htaccess-raiz.txt  a  .htaccess  y muévelo a la raíz
        donde quedó el sistema (junto al archivo artisan).


Paso 3 · Permisos
-----------------
Con el Administrador de archivos, marca 755 (o 775 si tu hosting lo pide) en:
  storage           (y todo su contenido, recursivo)
  bootstrap/cache


Paso 4 · Instala
----------------
Abre en el navegador:   https://tu-dominio.com/instalar

La página revisa los requisitos y te pide:
  - Nombre y dirección del sitio
  - Datos de la base de datos del Paso 1
  - Nombre, correo y contraseña del administrador

Al terminar crea las tablas, tu usuario y la configuración. El instalador se
cierra solo: /instalar deja de responder.


Alternativa · Importar el SQL a mano
------------------------------------
Si prefieres phpMyAdmin, importa  install/lotea-mysql.sql  sobre una base
vacía. Después edita el archivo .env con tus datos de conexión y crea el
archivo storage/app/installed.json con este contenido:

  {"version":"1.0.0","installed_at":"2026-01-01T00:00:00+00:00"}

En ese caso el usuario administrador tendrás que crearlo tú en la tabla users
(la contraseña va cifrada con bcrypt), así que el instalador web es más simple.


Paso 5 · Imágenes de los planos
-------------------------------
Los planos y galerías se guardan en storage/app/public y se sirven desde
public/storage. Si las imágenes no cargan, crea el enlace simbólico desde el
Terminal de cPanel:

  cd /home/usuario/lotea && php artisan storage:link

Si tu hosting no permite enlaces simbólicos, copia el contenido de
storage/app/public dentro de public/storage.


Después de instalar
-------------------
- Entra a /admin/digitalizador y sube el PDF de tu plano: cada plano crea un
  proyecto con sus manzanas y lotes.
- Confirma en .env que APP_DEBUG=false.
- Borra la carpeta install/ del servidor.

Actualizaciones
---------------
En el panel, "Actualización" te deja subir el ZIP de una versión nueva. Respalda
el código actual, reemplaza los archivos, aplica las migraciones y limpia las
cachés. Nunca toca tu .env ni los planos que ya subiste.
