Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/angel-raa/pos-system-spring-boot-thymeleaf

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.
https://github.com/angel-raa/pos-system-spring-boot-thymeleaf

api-rest bootstrap5 docker docker-compose java point-of-sale postgresql spring-boot spring-mvc spring-security thymeleaf

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/angel-raa/pos-system-spring-boot-thymeleaf
Owner: Angel-Raa
License: mit
Created: 2024-08-10T23:10:25.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-08-23T20:31:15.000Z (4 months ago)
Last Synced: 2024-11-16T22:35:17.386Z (about 2 months ago)
Topics: api-rest, bootstrap5, docker, docker-compose, java, point-of-sale, postgresql, spring-boot, spring-mvc, spring-security, thymeleaf
Language: CSS
Homepage:
Size: 8.99 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# POS System

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

## 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
![Pantalla de Login](https://github.com/Angel-Raa/POS-Spring-Boot/blob/main/src/main/resources/static/img/login.png)
*Interfaz de la pantalla de inicio de sesión.*

### Pantalla de Inicio (Home)
![Pantalla de Inicio](https://github.com/Angel-Raa/POS-Spring-Boot/blob/main/src/main/resources/static/img/home.png)
*Vista general de la pantalla de inicio una vez que el usuario ha iniciado sesión.*

### Lista de Categorías
![Lista de Categorías](https://github.com/Angel-Raa/POS-Spring-Boot/blob/main/src/main/resources/static/img/list.png)
*Pantalla donde se muestran las categorías de productos disponibles en el sistema.*

### Reporte de Ventas
![Reporte de Ventas](https://github.com/Angel-Raa/POS-Spring-Boot/blob/main/src/main/resources/static/img/report.png)
*Interfaz del reporte de ventas, mostrando detalles de las transacciones realizadas.*

### Diagramas de Relación

![Diagrama ER](https://github.com/Angel-Raa/POS-Spring-Boot-Thymeleaf/blob/main/src/main/resources/static/img/base-de-dato.png)

## 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:
```bash
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:
```bash
mvn clean install
```

4. Ejecuta la aplicación:
```bash
mvn spring-boot:run
```

5. (Opcional) Ejecuta en Docker:
```bash
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](https://spring.io/projects/spring-data)
- [Documentacion de open jdk 21](https://docs.oracle.com/en/java/javase/21/)
- [Documentacion de Spring boot](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/)
- [Documentacion de Maven](https://maven.apache.org/guides/getting-started/)
- [Documentacion de Docker](https://docs.docker.com/)
- [Documentacion de Thymeleaf](https://www.thymeleaf.org/documentation.html)
- [Documentacion de Spring Security](https://docs.spring.io/spring-security/reference/index.html)
- [Documentacion de iTextPDF](https://itextpdf.com/resources/api-documentation)
- [Documentacion de Git](https://git-scm.com/doc)

## Licencia

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