MemoryKings 🖥️

Una aplicación web de comercio electrónico desarrollada en Java EE para la venta de productos tecnológicos con gestión integral de clientes, empleados y pedidos.

🚀 Características Principales

• Gestión de Clientes: Registro, autenticación y perfil de usuarios
• Catálogo de Productos: Navegación por categorías con búsqueda avanzada
• Sistema de Pedidos: Carrito de compras y seguimiento de órdenes
• Consultas de Clientes: Sistema de tickets para soporte al cliente
• Panel Administrativo: Gestión de empleados con roles diferenciados

🛠️ Tecnologías Utilizadas

• Backend: Java EE 8, JPA/EclipseLink
• Frontend: JSP, HTML5, CSS3, JavaScript
• Base de Datos: MySQL 8.0
• Servidor: Apache Tomcat
• Gestión de Dependencias: Maven

📋 Requisitos del Sistema

• Java JDK 8 o superior
• Apache Tomcat 9.0+
• MySQL 8.0+
• Maven 3.6+

⚙️ Instalación y Configuración

1. Clonar el Repositorio

git clone https://github.com/franklinnot/MemoryKings.git
cd MemoryKings

2. Configurar Base de Datos

Crear una base de datos MySQL llamada memorykings y configurar las credenciales en persistence.xml

3. Compilar el Proyecto

mvn clean compile

4. Desplegar en Tomcat

mvn package
# Copiar el archivo .war generado a la carpeta webapps de Tomcat

🏗️ Arquitectura del Sistema

La aplicación sigue el patrón MVC con una arquitectura en capas:

┌─────────────────┐
│   Presentación  │ ← JSP, HTML, CSS
├─────────────────┤
│   Controlador   │ ← Servlets
├─────────────────┤
│ Lógica Negocio  │ ← Entidades JPA
├─────────────────┤
│  Persistencia   │ ← JPA Controllers
├─────────────────┤
│  Base de Datos  │ ← MySQL
└─────────────────┘

👥 Roles de Usuario

Cliente (Mewing)

• Navegación de productos
• Gestión de carrito de compras
• Realización de pedidos
• Consultas de soporte

Empleado

• Administrador: Acceso completo al sistema
• Atender Pedido: Gestión de órdenes y envíos
• Atender Consulta: Manejo de consultas de clientes 7

🔐 Seguridad

• Autenticación basada en sesiones
• Contraseñas encriptadas con BCrypt
• Control de acceso basado en roles
• Validación de formularios del lado servidor

📁 Estructura del Proyecto

MemoryKings/
├── src/main/java/
│   ├── logica/           # Entidades de negocio
│   ├── persistencia/     # Controladores JPA
│   └── servlets/         # Controladores web
├── src/main/webapp/
│   ├── HTML/            # Páginas JSP
│   ├── CSS/             # Estilos
│   ├── JavaScript/      # Scripts cliente
│   └── Image/           # Recursos gráficos
└── src/main/resources/
    └── META-INF/        # Configuración JPA

🚦 Flujo de Navegación

El sistema utiliza un dispatcher central en index.jsp que enruta las peticiones según el tipo de usuario y la sección solicitada

🤝 Contribución

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📝 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

---

⭐ ¡No olvides dar una estrella al proyecto si te fue útil!