El propósito de este proyecto es desarrollar un sistema CRUD (Crear, Leer, Actualizar, Eliminar) para la gestión de propiedades inmobiliarias. La aplicación web permitirá a los usuarios administrar anuncios de propiedades de manera eficiente a través de una interfaz intuitiva y un backend robusto.
Los usuarios podrán:
✅ Crear nuevas propiedades agregando información detallada.
✅ Visualizar una lista de propiedades disponibles y acceder a los detalles de cada una.
✅ Actualizar los datos de una propiedad existente en caso de modificaciones.
✅ Eliminar propiedades que ya no estén disponibles.
Para lograr esto, la aplicación se desarrollará con Spring Boot para el backend, MySQL como base de datos, y un frontend en HTML, JavaScript y AJAX (o Fetch API) para una experiencia de usuario fluida. Además, se desplegará en AWS, asegurando escalabilidad y disponibilidad.
1- Backend (Spring Boot)
Controladores: Manejan las solicitudes HTTP y definen los endpoints de la API. Entidades: Representan las tablas de la base de datos. Repositorios: Proveen métodos para realizar operaciones CRUD en la base de datos.
2- Frontend (HTML, CSS, JavaScript)
HTML: Define la estructura de la página web. CSS: Aplica estilos a la página web. JavaScript: Maneja la lógica del frontend, incluyendo la interacción con la API del backend.
3- Despliegue en AWS
EC2: Instancias para ejecutar la aplicación. Docker: Contenedores para empaquetar y desplegar la aplicación.
Esta aplicación web permite a los usuarios registrar, visualizar, actualizar y eliminar propiedades. Está construida utilizando Spring Boot en el backend y HTML, CSS y JavaScript en el frontend. La aplicación se conecta a una base de datos MySQL para almacenar la información de las propiedades.
Este proyecto proporcionará experiencia práctica en desarrollo full-stack, diseño de APIs REST, gestión de bases de datos, y despliegue en la nube con AWS.
Este diagrama representa la arquitectura de un sistema web de gestión de propiedades desplegado en AWS. A continuación, se describe el flujo de la información y los componentes involucrados:
- Usuario (User)
Un usuario accede al sistema a través de un navegador web (Browser) ingresando la URL de la aplicación: http://ec2-52-91-91-122.compute-1.amazonaws.com:8080.
- Aplicación Web en AWS (PropertyController & Property)
La solicitud es dirigida a un servidor alojado en una instancia Amazon EC2, donde se ejecuta una aplicación Spring Boot. PropertyController: Controlador REST que gestiona las solicitudes HTTP del usuario. Property: Representa la entidad de propiedad inmobiliaria en la aplicación.
- Recursos del Servidor
El servidor puede manejar múltiples solicitudes y administrar recursos para procesarlas.
- Base de Datos en AWS
Se utiliza AWS Database Migration Service (DMS) para la gestión y migración de bases de datos. Se almacena la información de las propiedades en una base de datos, probablemente en Amazon RDS (MySQL, PostgreSQL, etc.).
- Servicios de Migración en AWS
AWS Server Migration Service (SMS) permite mover servidores y bases de datos hacia la nube de AWS. Este componente se encarga de la transferencia de datos entre servidores.
- Comunicación Externa (HTTP)
Finalmente, la información puede ser compartida con otros sistemas o servicios externos mediante protocolos HTTP.
Este diagrama muestra un sistema basado en AWS donde un usuario interactúa con una aplicación web en una instancia EC2, que a su vez gestiona propiedades inmobiliarias mediante una base de datos. Se incluyen herramientas de migración de AWS para administrar la infraestructura y los datos.
Este diagrama de clases representa la estructura del sistema CRUD para gestionar propiedades inmobiliarias utilizando Spring Boot y JPA.
- Clase Property (Entidad Principal) Esta clase representa una propiedad inmobiliaria y contiene los siguientes atributos:
id: Long → Identificador único de la propiedad. address: String → Dirección de la propiedad. price: String → Precio de la propiedad. size: String → Tamaño de la propiedad. description: String → Descripción de la propiedad. También incluye los métodos getter y setter para manipular los atributos.
- PropertyController (Controlador REST) Es el controlador de la API que maneja las operaciones CRUD y expone los endpoints REST. Contiene los siguientes métodos:
requestMethodName(param: String): String → Un método auxiliar. createProperty(property: Property): Property → Crea una nueva propiedad. getAllProperties(): List → Devuelve una lista con todas las propiedades. getPropertyById(id: Long): ResponseEntity → Obtiene una propiedad por su ID. updateProperty(id: Long, propertyDetails: Property): ResponseEntity → Actualiza una propiedad existente. deleteProperty(id: Long): ResponseEntity → Elimina una propiedad. Este controlador interactúa con el repositorio PropertyRepository para acceder a la base de datos.
- PropertyRepository (Interfaz del Repositorio JPA) Es una interfaz que extiende JpaRepository<Property, Long>.
Permite realizar operaciones sobre la base de datos, como guardar, actualizar, eliminar y buscar propiedades. Se enlaza directamente con la entidad Property. 4. JpaRepository<Property, Long> (Interfaz Genérica de Spring Data JPA) JpaRepository<K, V> es una interfaz genérica donde K representa la entidad (Property) y V el tipo de la clave primaria (Long). Proporciona métodos listos para usar, como save(), findById(), findAll(), deleteById(), entre otros.
- ResponseEntity (Clase para Manejo de Respuestas HTTP) Se usa para envolver respuestas HTTP en los métodos del controlador. ResponseEntity → Respuesta HTTP con una propiedad como cuerpo. ResponseEntity → Respuesta HTTP sin contenido, usada en eliminaciones (DELETE). Relaciones entre las clases PropertyController usa PropertyRepository para acceder a los datos. PropertyRepository extiende JpaRepository<Property, Long>, lo que permite manipular la base de datos sin escribir consultas SQL manuales. ResponseEntity se utiliza en los métodos del controlador para manejar respuestas HTTP de forma adecuada.
Las siguientes instrucciones le permitirán obtener una copia del proyecto en funcionamiento en su máquina local para fines de desarrollo y prueba.
- Maven : Gestor de dependencias y automatización de construcción para Java.
- JavaScript : Lenguaje de programación para interactividad en la web.
- Java : Lenguaje de programación robusto para backend y aplicaciones empresariales.
- SpringBoot : Marco web de Java basado en microservicios de código abierto que ofrece Spring.
* Versión Maven: 3.9.9
* Versión Java: 17
Realice los siguientes pasos para clonar el proyecto en su máquina local.
git clone https://github.com/Pau993/Taller05.git
cd Taller05
git checkout Taller05
mvn clean compile
Para ejecutar la aplicación, ejecute el siguiente comando:
mvn exec:java -Dexec.mainClass="com.example.Application"
El anterior comando limpiará las contrucciones previas, compilará y empaquetará el código en un jar y luego ejecutará la aplicación.
Diríjase a su navegador de preferencia y vaya a la siguiente dirección: http://localhost:35000/ para ver la aplicación en funcionamiento.
Para ejecutar las pruebas, ejecute el siguiente comando:
Las pruebas realizadas en este proyecto se enfocan en la validación y verificación de requisitos relacionados con el proceso de gestión de solicitudes, asegurando su correcto funcionamiento y cumplimiento de especificaciones.
mvn test
- testCreateProperty (Prueba de Creación de Propiedad) Descripción:
Simula una solicitud POST a /properties para crear una nueva propiedad. Envía un JSON con los datos de la propiedad. Verifica que la respuesta tenga un estado 200 OK. Valida que los datos de la respuesta sean los mismos que los enviados (dirección, precio, tamaño y descripción).
- testGetPropertyById (Prueba de Consulta por ID) Descripción:
Crea y guarda una propiedad en la base de datos usando PropertyRepository. Simula una solicitud GET a /properties/{id} para recuperar la propiedad creada. Verifica que la respuesta tenga un estado 200 OK. Confirma que los datos obtenidos coincidan con los de la propiedad almacenada.
- testUpdateProperty (Prueba de Actualización de Propiedad) Descripción:
Crea y guarda una propiedad en la base de datos. Simula una solicitud PUT a /properties/{id} con nuevos valores para actualizar la propiedad. Verifica que la respuesta tenga un estado 200 OK. Confirma que los datos de la propiedad fueron actualizados correctamente en la respuesta.
- testDeleteProperty (Prueba de Eliminación de Propiedad) Descripción:
Crea y guarda una propiedad en la base de datos. Simula una solicitud DELETE a /properties/{id} para eliminar la propiedad. Verifica que la respuesta tenga un estado 204 No Content, lo que indica que la propiedad fue eliminada con éxito.
- Interfaz moderna y responsiva:
- Un diseño minimalista con un esquema de colores que incluye degradados de tonos morados, creando una experiencia visual sofisticada.
- Totalmente adaptable a diferentes dispositivos gracias a su diseño responsivo.
- Panel de busqueda de archivos, el cual permite leer cualquier tipo de archivo localmente.
- Gestión de archivos: ⚙️
- Incluye botones interactivos que permiten abrir y visualizar archivos clave como:
- Ver las propiedades
- Agregar propiedades
- Archivos JavaScript (script.js).
- Hojas de estilo CSS (estilos.css).
- Documentos HTML (index.html).
- Imágenes (Chill.jpg).
Grabacion.de.pantalla.2025-03-06.211836.mp4
- *Paula Natalia Paez Vega - Initial work - Paulinguis993
This project is licensed under the MIT License - see the LICENSE.md file for details
Agradecimientos al profeso Daniel Benavides por brindarme sus conocimientos.