RealEstateManagement is a robust Ruby on Rails application tailored for efficient real estate property management. It offers a comprehensive, RESTful API for seamless property administration. This project is Docker-ready, fully tested, and boasts 100% test coverage. Additionally, it leverages Swagger for effortless API documentation.
To get your RealEstateManagement application up and running, follow these simple steps. You have two options: using Docker or running it directly without Docker.
-
Clone this repository:
git clone https://github.com/bernar40/RealEstateManagement.git
-
Navigate to the project directory:
cd RealEstateManagement
-
Build the Docker containers:
docker-compose build
-
Run the Docker containers:
docker-compose up
-
Access the application at http://localhost:3000.
-
Explore the Swagger documentation at http://localhost:3000/api-docs/index.html.
-
For those looking to deploy the production environment, ensure you run the database seed task:
docker-compose run web bin/rails db:seed
-
Clone this repository:
git clone https://github.com/bernar40/RealEstateManagement.git
-
Navigate to the project directory:
cd RealEstateManagement
-
Install the required gems:
bundle install
-
You don't need to set up the database separately if you're using the pre-existing one in the repository. However, if needed, you can set up your own:
bin/rails db:setup
-
Start the Rails server:
bin/rails s
-
Access the application at http://localhost:3000.
-
Explore the Swagger documentation at http://localhost:3000/api-docs/index.html.
RealEstateManagement uses SQLite3 as its database, and the database file is already included in the repository. There's no need to set up a separate database server.
In the development database, you can use the following IDs for agents when testing or interacting with the application:
Agent ID | First Name | Last Name | |
---|---|---|---|
8 | Agent1 | Smith | agent1@example.com |
9 | Agent2 | Johnson | agent2@example.com |
10 | Agent3 | Williams | agent3@example.com |
These agents are pre-populated in the development database to facilitate testing and interactions with the application during development.
Our application boasts comprehensive testing, ensuring 100% code coverage. For a deeper understanding, you can check the coverage/index.html
folder, generated using the SimpleCov gem.
This project is open-source and available under the MIT License.