- HBNB Project - Cohort C#25

The HBnB project at Holberton is a simplified full-stack clone of Airbnb. It covers various aspects of software development, including backend, database management, front-end integration, and deployment.

---

📘 Part 1: UML Diagrams

We started the development of the HBnB Evolution application by creating a detailed blueprint. This technical documentation compiles essential diagrams and explanations, serving as a comprehensive guide to the system’s architecture, design, and implementation steps, from user interactions to database operations.

Key Points:

1. High-level architecture with a package diagram outlining the three layers and the use of the Facade Pattern.

2. Detailed diagrams of the business logic layer illustrating key entities, their relationships, and their role in the system.

3. Sequence diagrams for key API interactions depicting critical operations such as:

   • User registration
   • Place creation
   • Review submission
   • Fetching places

---

⚙️ Part 2: Business Logic & API

The Business Logic (BL) Layer and API are key components of the HBnB system, ensuring efficient handling of user requests and data processing. This section details how the business logic is structured and how the API provides a seamless interface for external interactions.

🔹 Business Logic Layer

• Implements core functionalities such as user authentication, property management, and review processing.
• Uses object-oriented programming (OOP) principles to encapsulate logic and enforce data consistency.
• Interacts with the database layer to store and retrieve information efficiently.
• Implements error handling to ensure data integrity and robust performance.

🔹 API Implementation

• Built using Flask as a lightweight framework to handle HTTP requests and responses.
• Follows RESTful principles, making it scalable and easy to interact with.
• Provides CRUD operations for major entities such as Users, Places, and Reviews.
• Implements JWT authentication for secure access control.

🌍 API Endpoints Overview

HTTP Method	Endpoint	Description
GET	/api/v1/users	Retrieve all users
POST	/api/v1/users	Create a new user
GET	/api/v1/users/<user_id>	Retrieve a specific user
PUT	/api/v1/users/<user_id>	Update user details
DELETE	/api/v1/users/<user_id>	Delete a user
GET	/api/v1/places	Retrieve all places
POST	/api/v1/places	Create a new place
GET	/api/v1/places/<place_id>	Retrieve a specific place
PUT	/api/v1/places/<place_id>	Update place details
DELETE	/api/v1/places/<place_id>	Delete a place
GET	/api/v1/reviews	Retrieve all reviews
POST	/api/v1/reviews	Submit a new review
GET	/api/v1/reviews/<review_id>	Retrieve a specific review
PUT	/api/v1/reviews/<review_id>	Update a review
DELETE	/api/v1/reviews/<review_id>	Delete a review

---

👤 Contributors:

• David Tolza
• Giovanni Farias
• Ludiane Trouillefou
• Maxime Truel