Sistema de Ventas Avantika

Descripción General

Sistema integral de gestión de ventas, inventario y facturación multi-empresa desarrollado en PHP. Actualmente funciona con PHP heredado y requiere migración completa a PHP 8.

Arquitectura del Sistema

Multi-Empresa

El sistema maneja múltiples empresas mediante una arquitectura de bases de datos separadas:

• Base Master: avantikads_nmgen - Autenticación y catálogos globales
• Bases Empresa: avantikads_nm{empresaId} - Datos específicos por empresa
• Ejemplo: avantikads_nm15 para empresaId = 15

Flujo de Autenticación

1. Usuario inicia sesión → Conexión a base master
2. Validación de credenciales en tabla usuario
3. Obtención de empresaId del registro del usuario
4. Conexión dinámica a base de datos específica de la empresa

Estado Actual

Versión PHP

• Actual: PHP con funciones obsoletas (mysql_*)
• Requerido: Migración completa a PHP 8

Compatibilidad

• ❌ NO COMPATIBLE con PHP 8
• Requiere migración completa antes de actualizar

Problemas Críticos Identificados

1. Funciones Obsoletas (CRÍTICO)

• 13 funciones mysql_* en classes/db.class.php
• Impacto: Sistema completo sin base de datos
• Solución: Migración completa a MySQLi/PDO

2. Funciones Eliminadas en PHP 8

• ereg_replace() → preg_replace()
• each() → foreach() (7 archivos)
• create_function() → funciones anónimas (4 archivos)
• split() → explode()/preg_split() (4 archivos)

3. Sintaxis Incompatible

• 100+ ocurrencias de $string{index} → $string[index]
• 98+ asignaciones list() incorrectas
• Múltiples asignaciones por referencia problemáticas

4. Seguridad

• Credenciales de bases de datos en código fuente
• Falta de configuración centralizada segura

Estructura del Proyecto

ventas/
├── index.php                    # Punto de entrada principal
├── config.php                   # Configuración actual (a eliminar)
├── libraries.php               # Carga de clases y librerías
├── init.php                    # Inicialización del sistema
├── classes/                    # Clases del sistema
│   ├── db.class.php           # Base de datos (mysql_* obsoletas)
│   ├── util.class.php         # Utilidades (funciones obsoletas)
│   ├── usuario.class.php       # Gestión de usuarios
│   ├── producto.class.php     # Gestión de productos
│   └── [20+ clases más]
├── ajax/                       # Endpoints AJAX (50+ archivos)
├── modules/                    # Módulos del sistema (100+ archivos)
├── templates_c/               # Plantillas compiladas Smarty
├── pdf/                       # Generación de PDFs
├── tcpdf/                     # Librería TCPDF
├── properties/                # Archivos de configuración
├── base_datos/                # Esquemas de bases de datos
│   ├── avantikads_nmgen.sql  # Estructura base master
│   └── avantikads_nm15.sql   # Ejemplo empresa
└── php8-migration/            # Plan de migración a PHP 8

Tecnologías Utilizadas

Backend

• PHP (versión heredada)
• MySQL (multi-base de datos)
• Smarty (motor de plantillas)
• NuSOAP (webservices)
• PHPMailer (correos electrónicos)
• TCPDF (generación de PDFs)

Base de Datos

• MySQL con arquitectura multi-empresa
• Motor: InnoDB/MyISAM mixto
• Charset: latin1 (requiere migración a utf8mb4)

Módulos Principales

• Usuarios: Gestión multi-empresa de usuarios
• Productos: Catálogo y control de inventario
• Pedidos: Sistema de pedidos y envíos
• Ventas: Procesamiento de ventas y facturación
• Facturación: Facturas electrónicas (México)
• Inventario: Control y ajustes de inventario
• Reportes: Múltiples reportes de negocio
• Proveedores: Gestión de proveedores
• Clientes: Administración de clientes

Plan de Migración a PHP 8

Documentación Completa

Ver php8-migration/ para documentación detallada:

1. analisis-sistema.md - Análisis general
2. reporte-problemas.md - Problemas identificados
3. plan-ejecucion.md - Plan de migración
4. ejemplo-db-mysqli.php - Ejemplo migración DB
5. ejemplo-env-config.php - Configuración segura
6. .env.example - Plantilla de variables
7. archivos-criticos.md - Lista de archivos críticos
8. analisis-base-datos.md - Análisis BD multi-empresa

Estimación de Tiempo

• Total estimado: 113-162 horas
• Fases: Configuración → MySQL → Funciones → Sintaxis → Pruebas

Requisitos de Migración

Críticos

1. ✅ Migrar funciones mysql_* a MySQLi/PDO
2. ✅ Implementar configuración .env segura
3. ✅ Actualizar sintaxis PHP 8
4. ✅ Reemplazar funciones obsoletas

Seguridad

1. ✅ Eliminar credenciales del código
2. ✅ Implementar variables de entorno
3. ✅ Validar routing multi-empresa
4. ✅ Aislar datos por empresa

Advertencias Importantes

⚠️ NO ACTUALIZAR PHP sin completar migración completa
⚠️ Backup completo obligatorio antes de cambios
⚠️ Entorno de pruebas aislado requerido
⚠️ Pérdida total de funcionalidad si se actualiza PHP sin migración

Licencia

Sistema propiedad de Avantika - Uso exclusivo del propietario.

---

Última actualización: Enero 2026
Estado: En espera de aprobación para migración a PHP 8