Sistema de Gestión de Clientes

Un paquete Python completo y profesional para la gestión de clientes en sistemas de comercio electrónico

Características Principales

Gestión de Clientes

Registro, búsqueda, actualización y eliminación de clientes con validaciones robustas.

Sistema VIP

Clientes con descuentos y beneficios especiales. 5 niveles desde Bronce hasta Diamante.

Persistencia de Datos

Almacenamiento automático en JSON con carga y guardado transparente.

Validaciones

Verificación de correos electrónicos, montos y rangos de descuento.

Estadísticas

Métricas completas del sistema con análisis de clientes y compras.

Múltiples Interfaces

Interfaz CLI con colores y web con Flask para máxima flexibilidad.

Demo Interactivo

Ejemplo de Uso
from mi_paquete_clientes.sistema_clientes import SistemaClientes
from mi_paquete_clientes.cliente import Cliente, ClienteVIP

# Crear sistema
sistema = SistemaClientes()

# Registrar cliente regular
cliente = Cliente("Juan Pérez", "juan@email.com", "Calle 123", 100.0)
print(sistema.registrar_cliente(cliente))

# Registrar cliente VIP
cliente_vip = ClienteVIP("María García", "maria@email.com", "Av. 456", 200.0, 0.15)
print(sistema.registrar_cliente(cliente_vip))

# Realizar compra con descuento
resultado = cliente_vip.realizar_compra(50.0)
print(resultado)  # ✨ Compra VIP exitosa!
Interfaz CLI
# Ejecutar interfaz de consola
python main.py

# Opciones disponibles:
# 1. 👤 Registrar cliente regular
# 2. 👑 Registrar cliente VIP
# 3. 📋 Listar todos los clientes
# 4. 🔍 Buscar cliente por correo
# 5. 📊 Ver estadísticas del sistema
# 6. 💰 Realizar compra
# 7. 💳 Recargar saldo
# 8. 🗑️ Eliminar cliente
# 9. 🔄 Activar/Desactivar cliente
# 10. 🏆 Top clientes con mayor saldo
# 11. 🌐 Abrir interfaz web
Estadísticas del Sistema

25

Total Clientes

23

Clientes Activos

8

Clientes VIP

$1,250

Saldo Total

Instalación y Uso

Instalación
# Clonar el repositorio
git clone https://github.com/yanelyapura/customers-management-package.git
cd customers-management-package

# Instalar dependencias
pip install -r requirements.txt

# Instalar el paquete
pip install -e .
Ejecutar
# Interfaz de consola
python main.py

# Interfaz web
python web_interface.py
# Luego abrir http://127.0.0.1:5000