POS System

Si encuentras útil este repositorio, ¡por favor ayúdanos marcándolo con una ⭐! 😊

POS es un sistema de punto de venta completo desarrollado para gestionar eficientemente las operaciones de ventas en un entorno comercial. Este proyecto está diseñado para proporcionar una solución integral para la administración de ventas, productos, categorías, clientes y compras.

Funcionalidades principales

• Gestión de ventas: Realiza y administra transacciones.
• Administración de productos: Añade, edita y elimina productos del inventario.
• Categorías de productos: Organiza los productos en categorías.
• Gestión de clientes: Guarda y administra información de los clientes.
• Generación de reportes: Genera reportes en PDF utilizando iTextPDF.
• Sistema de autenticación: Implementación de seguridad con Spring Security.
• Base de datos: Manejo de datos con PostgreSQL.

Tecnologías utilizadas

• Java
• Spring Boot
• Spring Security
• Thymeleaf
• PostgreSQL
• Docker
• iTextPDF

Capturas de pantalla

Aquí puedes ver algunas capturas de pantalla del proyecto para obtener una idea visual de cómo luce la aplicación en funcionamiento.

Pantalla de Login

Interfaz de la pantalla de inicio de sesión.

Pantalla de Inicio (Home)

Vista general de la pantalla de inicio una vez que el usuario ha iniciado sesión.

Lista de Categorías

Pantalla donde se muestran las categorías de productos disponibles en el sistema.

Reporte de Ventas

Interfaz del reporte de ventas, mostrando detalles de las transacciones realizadas.

Diagramas de Relación

Requisitos previos

• Java 21
• Maven
• Docker (opcional, si deseas ejecutar la aplicación en un contenedor).
• PostgreSQL.

Instalación y ejecución

1. Clona el repositorio:

   git clone https://github.com/Angel-Raa/POS-System-Spring-Boot-Thymeleaf.git
   cd POS-System-Spring-Boot-Thymeleaf
   

2. Configura la base de datos PostgreSQL en application.yml o en las variables de entorno.

3. Construye el proyecto con Maven:

   mvn clean install
   

4. Ejecuta la aplicación:

   mvn spring-boot:run
   

5. (Opcional) Ejecuta en Docker:

   docker-compose up --build .
   

Contribuciones

¡Las contribuciones son bienvenidas! Siéntete libre de abrir un issue o un pull request.

Recursos Adicionales

Aquí hay algunos recursos adicionales que podrían ser útiles:

• Documentacion de Spring Data
• Documentacion de open jdk 21
• Documentacion de Spring boot
• Documentacion de Maven
• Documentacion de Docker
• Documentacion de Thymeleaf
• Documentacion de Spring Security
• Documentacion de iTextPDF
• Documentacion de Git

Licencia

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