Documentación Técnica

Sistema de Gestión de Órdenes de Trabajo, Presupuestos y Facturación

Requisitos del Servidor

Para garantizar el correcto funcionamiento del sistema, el entorno de alojamiento debe cumplir con las siguientes especificaciones:

  • Servidor Web: Apache o Nginx.
  • Lenguaje: PHP 8.0 o superior.
  • Base de Datos: MySQL 5.7+ o MariaDB 10.2+.
  • Extensión PHP: mysqli (Conexión a BD).
  • Extensión PHP: mbstring (Manejo de caracteres).
  • Extensión PHP: json (Respuestas API).
Guía de Instalación Rápida

El sistema cuenta con un instalador automatizado que configura la base de datos y la conexión en pocos segundos.

1
Subir los archivos

Sube todo el contenido del proyecto al directorio público de tu servidor web (ej. htdocs, public_html o /var/www/html).

2
Permisos de escritura

Asegúrate de que el archivo config.php en la raíz tenga permisos de escritura (chmod 666 o 775) para que el instalador pueda guardar las credenciales.

3
Ejecutar el Instalador

Abre tu navegador web y dirígete a la ruta de instalación:
http://tu-dominio.com/install/

4
Configurar la Base de Datos

Ingresa los datos de tu servidor MySQL (Host, Usuario, Contraseña y Nombre de la Base de Datos). El instalador creará la base de datos automáticamente si no existe.

Credenciales por Defecto

Utiliza estos datos para tu primer inicio de sesión como Administrador:

Usuario / Correo: admin
Contraseña: admin123
Se recomienda cambiar esta contraseña inmediatamente.
Configuración de Correo (SMTP)

Para enviar correos (recuperación de contraseñas, facturas, presupuestos), configura el SMTP desde la interfaz:

  1. Inicia sesión como Administrador.
  2. Ve al módulo de Configuración en el menú lateral.
  3. Llena los datos en la sección Configuración de Correo (SMTP).
  4. Guarda los cambios.
Estructura de Archivos

Resumen de los directorios y archivos principales del proyecto:

/
├── api/                    # Controladores y endpoints del backend (AJAX/Fetch)
├── css/                    # Hojas de estilo personalizadas
├── js/                     # Scripts del frontend (lógica de UI)
├── install/                # Directorio del instalador automatizado
│   ├── index.php           # Interfaz gráfica del instalador
│   └── database.sql        # Estructura de la BD y datos iniciales
├── vendor/                 # Dependencias de Composer (PHPMailer, etc.)
├── config.php              # Configuración de conexión a la BD
├── index.php               # Página de Login y recuperación de contraseña
├── dashboard.php           # Panel principal (Métricas y resúmenes)
├── configuracion.php       # Panel de configuración general y SMTP
├── usuarios.php            # Gestión de usuarios
├── roles.php               # Gestión de roles y permisos dinámicos
├── clientes.php            # Módulo de clientes
├── productos.php           # Módulo de inventario de productos
├── servicios.php           # Módulo de catálogo de servicios
├── ordenes.php             # Módulo de órdenes de trabajo
├── presupuestos.php        # Módulo de presupuestos
├── facturacion.php         # Módulo de facturación
└── reporte_*.php           # Módulos de reportes (ventas, inventario, etc.)