THALISAN API FACTURACION v1.1 — INSTALACION INICIAL
=================================================

ESTA ENTREGA NO EMITE FACTURAS NI SE CONECTA A SUNAT. Solo prepara un microservicio REST para guardar borradores y consultarlos, aislado del SISTEMA DE VENTAS existente.

PASO 1. cPanel: crear el subdominio facturacion.thalisan.com. IMPORTANTE: debe apuntar a la carpeta public/ DE ESTE PROYECTO, no a la raiz del paquete. En Hosting SSD confirma la ruta real antes de subirlo.
PASO 2. Subir los archivos manteniendo exactamente la estructura (app/, database/, public/, scripts/, .env.example). La carpeta raiz del proyecto debe quedar fuera de la raiz publica. No colocar .env en public_html ni otro directorio accesible por HTTP.
PASO 3. Crear una nueva base de datos en cPanel, con un usuario MySQL nuevo y permisos SOLO sobre ella. Importar database/01_esquema.sql desde phpMyAdmin en ESA BASE NUEVA (nunca en thalisan_logistica).
PASO 4. Duplicar .env.example como .env en la RAIZ PRIVADA del proyecto y completar DB_HOST, DB_PORT, DB_NAME, DB_USER y DB_PASS. Los nombres completos de la BD y el usuario pueden llevar prefijos cPanel. No enviar credenciales ni tokens por el chat.
PASO 5. Configurar PHP 8.1+ (recomendado 8.2+) con PDO_MYSQL y HTTPS para el subdominio. Desactivar listados de directorio. No habilitar HTTP sin TLS.
PASO 6. Abrir https://facturacion.thalisan.com/api/v1/salud — debe mostrar JSON con version 1.1-base y sunat DESHABILITADO. Si no abre, no intentar crear credenciales aun.
PASO 7. Insertar una empresa ficticia solo en la nueva BD mediante phpMyAdmin:
  INSERT INTO empresas (ruc, razon_social) VALUES ('00000000000', 'EMPRESA PILOTO - SOLO BORRADORES');
Este RUC es ficticio y no se usara para enviar a SUNAT.
PASO 8. Si dispones de Terminal cPanel, ejecutar desde la RAIZ PRIVADA (no public/): php scripts/crear_clave_api.php 1 "Sistema Ventas Ensayo". Si el ID no es 1, usar el ID real de la empresa. El token se muestra una unica vez; guardarlo en lugar privado y no copiarlo en el navegador ni capturas. Si no tienes terminal, detente aqui: no expongas el script CLI por HTTP.
PASO 9. Usar PRUEBAS_POWERSHELL.txt para crear un borrador ficticio y consultarlo. Sin SUNAT y sin tocar ventas reales.

ATENCION: NO cargar este proyecto sobre /mi_sistema ni copiarle archivos de facturacion SUNAT antiguos. No modificar demo.thalisan.com, certificados, CDR ni base de datos comercial.

Esta version es SOLO laboratorio de backend. Antes de publicar a clientes faltan limite de solicitudes, registros operativos, gestion de empresas, motor tributario, certificado por empresa, firma, XML, CDR y controles de despliegue.