TP Ingenieria de Software I - 2C2024

📦 Sistema de Gestión de Órdenes (IS1 - FIUBA)

El sistema consiste en un backend robusto diseñado para gestionar el ciclo de vida de productos, órdenes de compra y control de inventario, con un fuerte enfoque en patrones de diseño y seguridad.

🎯 Objetivos del Proyecto

• Desarrollar un sistema bajo estándares de calidad de ingeniería de software.
• Garantizar la seguridad y privacidad mediante autenticación y autorización con JWT.
• Implementar un flujo de registro de usuarios con verificación por email.

🚀 Arquitectura y Diseño

• Arquitectura por Capas: Estructura organizada para una clara separación de responsabilidades entre la capa de presentación, capa de negocio y capa de acceso a datos.
• Modelo de Dominio: Lógica de negocio centralizada para resolver la gestión compleja de órdenes y stock.
• Principios SOLID: Aplicados rigurosamente para asegurar la mantenibilidad y extensibilidad del código.
• Patrones de Diseño Implementados:
  • State Pattern: Para gestionar las transiciones de estado de las órdenes de compra (ej. Enviada -> En Proceso -> Confirmada o Cancelada).
  • Strategy Pattern: Utilizado para la selección dinámica de repositorios de persistencia según el contexto.
  • Specification Pattern: Para componer reglas de negocio complejas (mediante operaciones logicas AND, OR, NOT) sobre los productos de forma flexible y desacoplada .

🔐 Seguridad y Roles (RBAC)

El sistema implementa un control de acceso basado en roles para proteger los recursos del dominio:

• Administrador: Acceso total. Puede crear, modificar y eliminar productos, además de gestionar el estado de todos los carritos de compra existentes.
• Usuario: Acceso limitado. Puede ver y comprar productos, y visualizar sus propios carritos, pero no tiene permisos para modificar productos ni alterar el estado de sus órdenes.

🛠️ Stack Tecnológico

• Lenguaje: Java / Spring Boot
• Seguridad: JSON Web Tokens (JWT) / Java Mail Sender
• Persistencia: SQL / JPA (Hibernate)
• Herramientas: Git, JUnit, Docker.

Run with docker

To build and run the containers:

docker-compose up --build

The env vars are set on a .env file at root of the project

Access the API

• The API will be available at http://localhost:8080.
• The front-end interface is available at http://localhost:5173.

Access the PostgreSQL Database

1. Open a new terminal and use the following command to enter the PostgreSQL container:

   docker exec -it is1_db psql -U is1_admin -d orderdb
   

2. Once inside the container, you can run SQL commands to inspect the database, like:

   \dt   -- List all tables
   \conninfo -- Check connection
   

Access pgAdmin via Web

To access the PostgreSQL database using the web interface:

1. After running docker-compose up --build, pgAdmin will be available at http://localhost:8081.

2. Log in using the following credentials (defined in the docker-compose.yml):

   • Email: admin@admin.com
   • Password: admin

Stop the containers

To stop the containers, press CTRL + C in the terminal where Docker Compose is running, then clean up the containers:

docker-compose down