OSPrestige

1. Introducción

OSPrestige es un sistema integral construido sobre Perfex CRM para gestionar procesos de ventas, reclutamiento, encuestas, propuestas, productos y programas de incentivos (Regalos Prestige). Este manual describe la estructura estándar del sistema, su funcionamiento general y las mejores prácticas para operar y clonar la plataforma para nuevos clientes.

2. Arquitectura General

2.1 Núcleo (Perfex CRM)

Perfex CRM actúa como el núcleo administrativo del sistema. Desde aquí se gestionan:

• Usuarios y roles

• Clientes y leads

• Estados y fuentes

• Configuración general

• Reportes

OSPrestige extiende Perfex mediante módulos nativos y aplicaciones front-end conectadas por API.

2.2 Módulos OSPrestige

Ventas Prestige

Módulo principal del sistema. Incluye:

• Gestión de demos

• Sistema de encuestas (pre y post demo)

• Flujo de ventas guiado

• Integración con propuestas

Propuestas

• Generación de propuestas automáticas

• Precarga de productos seleccionados en la encuesta

• Registro de resultados (cerró, seguimiento, no cerró)

Productos

• Gestión centralizada de productos

• Uso de tabla propia (tblproductos)

• Asociación de imágenes, videos y categorías

Regalos Prestige

• Administración de incentivos

• Vitrina pública de regalos

• Lógica de elegibilidad y seguimiento

Vitrina de Regalos

• Vista pública para clientes

• Consumo directo desde la API

• Diseño desacoplado de Perfex

3. Aplicaciones Front-End

El sistema incluye aplicaciones en HTML/JavaScript que no renderizan dentro de Perfex, sino que consumen la API pública:

• Distribuidor Encuesta

• Propuestas (vista externa)

• Vitrina Pública de Regalos

Estas aplicaciones:

• Usan tema White/Dark Premium

• Mantienen estado mediante localStorage

• Se versionan con cache busting

4. API Pública

Ubicada en /public-api. Principales endpoints:

• encuesta_get.php

• encuesta_preguntas.php

• encuesta_submit.php

• encuesta_tipos.php

• productos.php

• staff.php

• vitrina_public.php

Buenas prácticas:

• Validación de entrada JSON

• Respuestas consistentes

• Uso exclusivo para front-ends OSPrestige

5. Base de Datos

5.1 Tablas Estructurales

Estas tablas forman parte del sistema y deben mantenerse al clonar:

• Definiciones de módulos

• Configuraciones y opciones

• Productos

• Custom fields necesarios

5.2 Tablas Operativas

Estas deben limpiarse al clonar una instalación:

• Leads

• Encuestas respondidas

• Propuestas

• Logs

• Citas

• Actividad histórica

6. Proceso de Clonado para Nuevos Clientes

El sistema está diseñado para clonar una instalación completa de Perfex + OSPrestige.

Pasos generales:

1. Clonar código y base de datos

2. Limpiar datos operativos

3. Ajustar configuración del cliente (empresa, moneda, usuarios)

4. Verificar rutas y dominios

5. Validar funcionamiento de módulos y front-ends

No se requiere reinstalar módulos individualmente; el módulo viaja con el clon.

7. Seguridad y Permisos

• Permisos de archivos estándar: 775 carpetas / 664 archivos

• Propietario: usuario del sistema

• Grupo: www-data

• Acceso controlado a API

8. Buenas Prácticas Operativas

• No modificar directamente la base de datos sin respaldo

• Mantener versionado de cambios

• Documentar ajustes específicos por cliente

• Probar siempre en entorno de desarrollo antes de clonar

9. Mantenimiento y Evolución

OSPrestige está diseñado para evolucionar por versiones. Cada mejora debe:

• Mantener compatibilidad con clones existentes

• Documentarse

• Probarse antes de liberar

10. Conclusión

OSPrestige es una plataforma sólida, modular y lista para escalar mediante clonado controlado. Su correcta operación depende de mantener la separación entre estructura y datos operativos, y de seguir las buenas prácticas descritas en este manual.

Fin del Manual General del Sistema OSPrestige