================================================================================
                    SISTEMA AGESCONT - REQUISITOS DEL SERVIDOR
================================================================================

REQUISITOS MINIMOS
------------------

1. SERVIDOR WEB
   - Apache 2.4 o superior
   - Nginx 1.18 o superior
   - LiteSpeed
   - Cualquier servidor web que soporte PHP

2. PHP
   - Version: PHP 7.4 o superior (recomendado PHP 8.0+)
   - Extensiones requeridas:
     * json (generalmente incluida por defecto)
     * fileinfo (para manejo de archivos)

3. PERMISOS DE ARCHIVOS
   - La carpeta "data/" debe tener permisos de ESCRITURA
   - Permisos recomendados:
     * Carpeta data/: 755 o 777
     * Archivos .json: 644 o 666

   Comando para configurar permisos (Linux):
   chmod -R 755 data/
   chmod 644 data/*.json


HOSTINGS COMPATIBLES
--------------------

El sistema funciona en cualquier hosting que soporte PHP:

- Hostinger
- GoDaddy
- Bluehost
- SiteGround
- HostGator
- Namecheap
- DreamHost
- A2 Hosting
- InMotion Hosting
- Cualquier hosting con cPanel o Plesk
- Servidores VPS (DigitalOcean, Linode, AWS, etc.)
- XAMPP / WAMP / MAMP (para pruebas locales)


INSTALACION
-----------

1. Descomprime el archivo clientes.zip en tu servidor
   - En cPanel: Sube el ZIP y usa "Extract"
   - Por FTP: Sube todos los archivos a public_html o www

2. Verifica que la carpeta "data/" tenga permisos de escritura
   - En cPanel: Click derecho > Change Permissions > 755

3. Accede desde tu navegador:
   - tudominio.com/
   - tudominio.com/index.html

4. Credenciales por defecto:
   - Usuario: admin
   - Contrasena: admin123

   IMPORTANTE: Cambia la contrasena despues del primer acceso


ESTRUCTURA DE ARCHIVOS
----------------------

clientes/
  ├── index.html              Aplicacion principal (frontend)
  ├── api.php                 API REST (backend)
  ├── LOGO AGESCONT.jpeg      Logo del sistema
  ├── REQUISITOS-SERVIDOR.txt Este archivo
  └── data/
      ├── clientes.json       Datos de clientes
      ├── pagos.json          Registro de pagos
      ├── trabajos.json       Trabajos pendientes
      ├── control_mensual.json Control de declaraciones
      └── usuarios.json       Usuarios (se crea automaticamente)


NOTAS IMPORTANTES
-----------------

- NO se requiere base de datos MySQL/MariaDB
- Los datos se guardan en archivos JSON dentro de la carpeta data/
- Multiples usuarios pueden acceder desde diferentes PCs
- Los cambios se sincronizan automaticamente
- Funciona en modo offline si el servidor no esta disponible
- Se recomienda hacer backups periodicos de la carpeta data/


SOLUCION DE PROBLEMAS
---------------------

1. "Error al guardar datos"
   - Verifica que la carpeta data/ tenga permisos de escritura (755 o 777)

2. "No se puede conectar al servidor"
   - Verifica que el archivo api.php este en la misma carpeta que index.html
   - Verifica que PHP este funcionando en tu servidor

3. "Usuario o contrasena incorrectos"
   - Usuario por defecto: admin
   - Contrasena por defecto: admin123
   - Si olvidaste la contrasena, elimina el archivo data/usuarios.json
     y se recreara con las credenciales por defecto

4. Logo no aparece
   - Verifica que "LOGO AGESCONT.jpeg" este en la carpeta raiz


SOPORTE
-------

Para soporte tecnico o consultas, contacta al desarrollador.


================================================================================
                         AGESCONT - Sistema de Gestion Contable
================================================================================