Características del Proyecto

Funciones de la página principal y módulos que componen el proyecto

Acceso al Sistema

Inicio de Sesión

  • Credenciales: Utiliza el correo electrónico y contraseña proporcionados por el sistema.
  • Seguridad: El sistema bloquea después de 3 intentos fallidos por 15 minutos.
  • Sesión: Se cierra automáticamente después de 15 minutos de inactividad.

Solicitar acceso

  • Correo electrónico: Introduce un correo que debe ser válido y único en el sistema, para que el mismo automáticamente te envíe las credenciales de acceso.
  • Contraseña temporal: Se envía automáticamente al correo proporcionado.

Seguridad del Sistema

Control de Sesiones

  • Cookies seguras: Solo se transmiten por HTTPS y no son accesibles desde JavaScript
  • Regeneración de ID: La sesión genera un nuevo ID al autenticarse

Protección de Acceso

  • Conexión segura: Forzado de HTTPS para todas las comunicaciones
  • Validación estricta: Verificación de formato y longitud en credenciales

Protección de Datos

  • Tokens CSRF: Todos los formularios incluyen protección contra falsificación
  • Consultas seguras: Uso de consultas preparadas para prevenir inyecciones SQL
  • Contraseñas: Almacenadas con hash seguro (bcrypt)

Cabeceras de Seguridad

  • X-Frame-Options: Previene ataques de clickjacking
  • Content-Security-Policy: Restringe fuentes de contenido para prevenir XSS
  • X-Content-Type-Options: Evita MIME-sniffing
  • X-XSS-Protection: Filtrado XSS en navegadores compatibles

Otras Medidas

  • Confirmaciones: Cambios importantes requieren confirmación explícita
  • Escape de salida: Todos los datos mostrados son sanitizados

Catálogo de Productos (Página principal)

Búsqueda y Filtrado

  • Buscar productos: Escribe cualquier término en el campo de búsqueda
  • Ordenar por: Nombre (A-Z/Z-A) o Precio (menor/mayor)
  • Etiquetas visuales: Productos agotados o con pocas unidades se marcan automáticamente

Información de Productos

  • Imágenes: Visualización ampliada al hacer clic
  • Precios: Mostrados con formato claro y consistente
  • Stock: Cantidades actualizadas en tiempo real

Agendamiento de Citas (Página principal)

Formulario de Cita

  • Campos obligatorios: Marcados con *
  • Selección de fecha/hora: Elige entre las opciones disponibles
  • Motivo de visita: Especifica el propósito de tu cita

Seguridad y Validación

  • reCAPTCHA: Sistema de verificación para prevenir spam
  • Validación: Comprobación de formato en teléfono y email
  • Confirmación: Mensaje visual al enviar correctamente

Asistente Virtual (Página principal)

Funcionalidades

  • Respuestas rápidas: Información sobre la aplicación y sus funciones
  • Temas disponibles: Qué es la aplicación, su motivo, características y guía de uso
  • Reiniciar conversación: Usa el botón "Limpiar chat" para comenzar de nuevo

Uso del Chatbot

  • Activar/desactivar: Botón flotante en esquina inferior derecha
  • Opciones rápidas: Selecciona entre las respuestas sugeridas
  • Historial: La conversación persiste durante tu sesión

Analizador de Opiniones(Página principal)

Funcionalidades

  • Análisis en tiempo real asistido por Inteligencia Artificial: Detecta el sentimiento (positivo/negativo) de tus opiniones sobre productos
  • Historial de comentarios: Accede a opiniones anteriores con el ícono
  • Límites de uso: Máximo 3 análisis cada 15 minutos para garantizar estabilidad

Cómo usar

  • Escribe tu opinión: Máximo 100 caracteres en el área de texto
  • Obtén resultados: Presiona "Analizar Sentimiento" para ver la valoración asistida por Inteligencia Artificial
  • Resultados guardados: Tus análisis se almacenan para mejorar el servicio

Limitaciones

  • Tiempo de espera: Si excedes el límite, podrás intentarlo de nuevo en 15 minutos
  • Idiomas soportados: El análisis funciona mejor con texto en español
  • Seguridad: Tu IP se registra temporalmente solo para control de uso

Gestión de Ventas (Módulo)

Proceso de Venta

Búsqueda

Filtra por nombre o descripción

Ordenamiento flexible disponible

Límites

Máximo 15 unidades por artículo

Previene sobreventa

Registro

Zona horaria automática

Fecha/hora exacta

Métodos de Pago

Efectivo

Pago inmediato

Moneda nacional

Tarjeta

Procesamiento con TPV

Terminal punto de venta

Crédito

Requiere cliente registrado

Estado activo verificado

Cálculos Automáticos

Subtotal

Suma antes de impuestos

IVA (16%)

Calculado automáticamente

Total

Subtotal + IVA con formato $

Validaciones

Stock

No permite sobreventa

Verifica disponibilidad

Clientes

Verifica estado activo

Para ventas a crédito

Transacciones

Rollback automático

En caso de errores

Ventas a Crédito

Clave

4 dígitos requeridos

Verifica existencia

Plazo

1 día para pago

Configurable

Registro

Entrada automática

En módulo de créditos

Importante: Las cancelaciones deben realizarse antes de cerrar la sesión. No hay reversión automática de inventario.

Gestión de Productos (Módulo)

Operaciones Básicas

Agregar

Completa todos los campos requeridos

Campos obligatorios

Editar

Modifica la información del producto

Guardar cambios

Eliminar

Confirmación requerida

Previene borrados accidentales

Detalle

Muestra información completa

Todos los datos del producto

Búsqueda Avanzada

Búsqueda

Por nombre, descripción o categoría

Filtrado flexible

Ordenamiento

Por diferentes criterios:

  • Nombre
  • Precio
  • Stock
Limpiar

Restablece la búsqueda

Valores por defecto

Gestión de Clientes (Módulo)

Listado de Clientes

Información Básica

Clave única: Código de 4 dígitos automático

Fecha registro: Formato día/mes/año hora:minuto

Activo / Inactivo Estados visibles

Estado Financiero

Rojo = Cliente con deuda

Verde = Cliente al corriente

Deuda total visible en listado

Operaciones con Clientes

Agregar

Nombre: Obligatorio

Teléfono: Validado

Email: Opcional

Dirección: Campo amplio

Editar

Cambiar estado activo/inactivo

Cancelar edición

Guardar cambios

Eliminar

Restricción con deudas

Inactivar como alternativa

Confirmación requerida

Relación con Créditos

Conexión Financiera

Acceso directo: Botón visible con adeudos

Cálculo automático: Suma todos los créditos pendientes

Protección: No se permiten eliminaciones que afecten registros

Seguridad de Datos

Clientes inactivos: Conservan historial completo

Integridad: Relaciones financieras protegidas

Auditoría: Todos los cambios quedan registrados

Nota: Los clientes inactivos no aparecen para nuevos créditos pero mantienen su historial.

Gestión de Visitas (Módulo)

Visión General

Calendario

Interactivo: Visualización completa de visitas

Marcadores: Colores por tipo de visita

Filtrado

Por fecha: Visualiza visitas de días específicos

Rápido: Navegación intuitiva

Estadísticas

Resumen: Visitas pendientes y confirmadas

Instantáneo: Datos actualizados

Operaciones

Agendar

Obligatorios: Nombre, teléfono, fecha/motivo

Duración: 15-240 minutos

Tipos: Cliente, Proveedor, Personal

Editar

Todos los campos editables

Estados: Pendiente, Confirmada, Cancelada

Conserva fecha original

Eliminar

Confirmación requerida

Eliminación permanente

Visualización

Código de Colores

Clientes - Visitas con clientes

Proveedores - Visitas con proveedores

Personal - Visitas internas

Detalles

Información completa: Nombre, motivo, estado

Fecha/Hora: Formato claro y consistente

Zona horaria: México (UTC-6/-5)

Consejo: Usa el calendario lateral para navegar rápidamente entre días con visitas (marcados con puntos de color).

Gestión de Clientes (Módulo)

Listado de Clientes

Información Básica

Clave única: Código de 4 dígitos automático

Fecha registro: Formato día/mes/año hora:minuto

Activo / Inactivo Estados visibles

Estado Financiero

Rojo = Cliente con deuda

Verde = Cliente al corriente

Deuda total visible en listado

Operaciones con Clientes

Agregar

Nombre: Obligatorio

Teléfono: Validado

Email: Opcional

Editar

Cambiar estado activo/inactivo

Cancelar edición

Guardar cambios

Eliminar

Restricción con deudas

Inactivar como alternativa

Confirmación requerida

Relación con Créditos

Conexión Financiera

Acceso directo: Botón visible con adeudos

Cálculo automático: Suma todos los créditos pendientes

Protección: No se permiten eliminaciones que afecten registros

Seguridad de Datos

Clientes inactivos: Conservan historial completo

Integridad: Relaciones financieras protegidas

Auditoría: Todos los cambios quedan registrados

Nota: Los clientes inactivos no aparecen para nuevos créditos pero mantienen su historial.

Gestión de Créditos (Módulo)

Listado de Créditos

Identificación

Clave cliente: 4 dígitos asociado

Estado: Pagado Pendiente Vencido

Montos

Total: Valor original del crédito

Saldo: Pendiente por pagar

Fechas

Inicio: Cuando se creó

Límite: Para pago (día/mes/año)

Operaciones

Registro de Pagos

Validación: Monto no excede saldo

Métodos: Efectivo, Tarjeta, Transferencia

Fecha: Automática (hora México)

Seguridad: Transacción atómica

Filtrado

Por Cliente: Menú desplegable

Por Clave: 4 dígitos

Limpiar: Restablecer vista

Resumen Financiero

Total Créditos

Cantidad según filtros aplicados

Saldo Pendiente

Suma de adeudos con formato $

Detalles

Historial completo de pagos

Consejo: Usa el botón "Ver detalles" para acceder al historial completo de pagos.

Gestión de Créditos Vencidos (Módulo)

Actualización Automática

Proceso Automático

El sistema actualiza los estados a "vencido" al detectar fechas límite pasadas.

Operación protegida por transacción para evitar inconsistencias.

Importante

Los recargos se calculan desde la fecha límite original hasta la fecha actual del sistema.

La actualización ocurre cada vez que se carga la página.

Métricas Clave

Créditos Vencidos

Total de créditos con fecha límite pasada

Tasa Diaria

5% interés compuesto por día de atraso

Cálculo

Saldo × (1.05)días = Total

Métodos

Efectivo, Tarjeta o Transferencia

Proceso de Cobro

Validaciones

Desglose completo: Muestra todos los componentes del pago (saldo, recargo, total).

Restricciones: El monto no puede exceder el total ni ser menor/igual a cero.

Actualización

Recálculo automático: Los recargos se actualizan al cargar la página.

Transacción segura: Todo el proceso está protegido contra fallos.

Importante: Los pagos parciales se aplican primero al recargo acumulado y luego al saldo principal.

Dashboard de Créditos (Módulo)

Actualización Automática

Proceso Automático

Al cargar la página, el sistema actualiza los estados de créditos vencidos automáticamente.

Operación protegida por transacción para mantener la integridad de los datos.

Estados de Créditos

Pagados Créditos completamente liquidados

Pendientes Créditos activos dentro de plazo

Vencidos Créditos pendientes con fecha límite pasada

Métricas Clave

Total Pagado

Suma de todos los créditos liquidados

Pendientes

Créditos activos dentro de plazo

Por Vencer

Créditos próximos a su fecha límite

Vencidos

Créditos con pagos atrasados

Morosidad

Top Clientes Morosos

Enfoque: Muestra los 5 clientes con mayor deuda vencida

Datos: Suma de todos los créditos vencidos por cliente

Interacción: Pasa el cursor para ver detalles completos

Tendencias

Periodo: Últimos 6 meses de actividad

Visualización: Línea con tendencia suavizada

Datos: Suma total de pagos por mes

Tip: Todos los gráficos son interactivos - pasa el cursor para ver detalles específicos

Dashboard de Estadísticas (Módulo)

Interpretación de Gráficos

Inventario

Top Productos: Muestra los productos con mayor stock, destacando en rojo los agotados.

Por Categoría: Distribución del inventario según clasificación.

Ventas

Tendencia Diaria: Evolución de ventas en la última semana.

Productos Destacados: Identifica los más y menos vendidos para tomar decisiones.

Consejos
  • Pasa el cursor sobre los gráficos para detalles
  • Productos menos vendidos pueden necesitar promoción
  • Monitoriza diariamente los productos agotados

Métricas Clave

Stock Total

Suma de todas las unidades disponibles en inventario

Ventas Hoy

Número de transacciones registradas hoy

Productos Diferentes

Variedad de productos en el catálogo

Agotados

Productos sin unidades disponibles

Actualización: Todos los datos se refrescan automáticamente al cargar la página.

Resumen de Inventario (Módulo)

Métricas Principales

Total de Productos

Muestra la variedad de productos diferentes que maneja el negocio.

Actualizado en tiempo real
Unidades en Stock

Suma total de todas las unidades disponibles para venta.

Incluye todos los productos
Valor del Inventario

Valor monetario total calculado como (precio x cantidad) de cada producto.

Estimación del valor actual

Alertas de Inventario

La sección de Productos con Bajo Stock muestra automáticamente los ítems con menos de 10 unidades.
Funcionalidades
  • Cantidades en rojo indican stock crítico
  • Click en cualquier producto para ver su detalle completo
  • Botón para ver lista completa ordenada por stock
Recomendaciones

Revise diariamente esta sección para:

  • Programar reposiciones oportunas
  • Identificar productos con movimiento lento
  • Evitar faltantes en productos clave

Análisis por Categoría

Distribución Detallada

Muestra para cada categoría:

  • Número de productos diferentes
  • Total de unidades disponibles
  • Valor monetario total
Las barras de progreso comparan la cantidad de productos entre categorías
Valor por Categoría

Vista porcentual del valor del inventario:

  • Badges con nombres de categorías
  • Valor absoluto y porcentaje
  • Diseño responsive para móviles

Use esta vista para identificar categorías que concentran mayor inversión.

Gestión de Proveedores (Módulo)

Panel de Estadísticas

Total Proveedores

Muestra la cantidad de proveedores activos en el sistema.

Actualizado en tiempo real
Productos Asociados

Total de productos vinculados a proveedores.

Incluye todos los proveedores
Inversión Total

Valor calculado del inventario por proveedor.

Costo proveedor x cantidad
Ganancia Potencial

Margen estimado (precio sugerido - costo).

Cuando está definido

Búsqueda y Filtrado

Escribe en el campo de búsqueda para filtrar proveedores por nombre en tiempo real.
Funcionalidades
  • Búsqueda instantánea al escribir
  • No requiere presionar Enter
  • Filtra solo por nombre de proveedor
Visualización

Los proveedores se muestran en tarjetas con:

  • Imagen/logo identificador
  • Información de contacto
  • Número de productos asociados
  • Acciones rápidas

Gestión de Proveedores

Nuevo Proveedor

Formulario completo con:

  • Campos obligatorios marcados
  • Vista previa de imagen/logo
  • Validación de formato RFC
Edición

Acceso directo desde cada tarjeta:

  • Mantiene todos los datos originales
  • Permite cambiar imagen/logo
  • Actualiza relaciones con productos
Eliminación

Proceso seguro con:

  • Confirmación requerida
  • Validación de productos asociados
  • Protección contra eliminación accidental
Seguridad: Todas las acciones están protegidas contra ataques CSRF y requieren sesión activa.