Reinforce and practice all of the Ruby and programming concepts we've covered in class so far:
- Design a system using object-oriented principles
- Create and instantiate classes with attributes
- Create class and instance methods within our classes
- Write pseudocode and create tests to drive the creation of our code
This is a stage 3, individual project.
Your company has been contracted to build a booking system for a small hotel. This system will be used by employees working at the front desk, and will not be available to the general public.
This system will have two parts: a user interface that runs in the terminal, and a module full of business logic, classes and methods that keep track of which rooms are reserved when. Your job is to implement the business logic only. You do not need to build a CLI for this project.
Instead, you will use tests to verify your part of the system works as intended.
This project is both a culmination of our Intro to Ruby unit and our first stage 3 project. This means the requirements are more open-ended and ambiguous than previous projects you have worked on. This is intentional. You will be expected to:
- Make decisions on how to structure your classes and methods
- Ask questions when you need clarification
- Understand that the way you implement something may be different than the way your neighbor implements it
It is possible you will not be able to complete all requirements. Though all 3 waves will be visible at the beginning of the project, they are organized by difficulty and relevance to the learning goals, and should be tackled in order.
We will use the same project structure we used for the previous project. Classes should be in files in the lib folder, and tests should be in files in the spec folder. You should utilize a spec helper file. You will run your tests automatically whenever files are added or changed, with the guard command.
- Fork this repository in GitHub
- Clone the repository to your computer
- Open a terminal and run the
guardcommand from within the project's root directory (where theGuardfileis). - Create a test to check the instantiation of one of your object types (RED)
- Create the class for the object tested in the step above (GREEN)
- Use
git add,commitandpushcommands to push your initial code to GitHub
You should use the following process as much as possible:
- Write pseudocode
- Write test(s)
- Write code
- Commit
You should have 95% code coverage using simplecov.
Your git commit history should provide a clear description of how your code developed, letting the reader know what changed when and why. Making frequent, small commits is essential!
This will be an in-class activity.
Remember that your job is only to build the classes that store information and handle business logic, and the tests to verify they're behaving as expected. Building a user interface is not part of this project!
- As an administrator, I can access the list of all of the rooms in the hotel
- As an administrator, I can reserve a room for a given date range
- As an administrator, I can access the list of reservations for a specific date
- As an administrator, I can get the total cost for a given reservation
- The hotel has 20 rooms, and they are numbered 1 through 20
- Every room is identical, and a room always costs $200/night
- The last day of a reservation is the checkout day, so the guest should not be charged for that night
- For this wave, any room can be reserved at any time, and you don't need to check whether reservations conflict with each other (this will come in wave 2!)
- Your code should raise an error (StandardError) when an invalid date range is provided
- You might want to investigate Ruby's
Dategem.
- As an administrator, I can view a list of rooms that are not reserved for a given date range
- As an administrator, I can reserve an available room for a given date range
- A reservation is allowed start on the same day that another reservation for the same room ends
- Your code should raise an exception when asked to reserve a room that is not available
If you are not familiar with what a block of hotel rooms, here is a brief description:
A Block Booking refers to a group of rooms set aside for a specific group of customers for a set period of time.
Room blocks are commonly created for large events like weddings or conventions. A number of rooms are set aside, and are made available for reservation by certain customers at a discounted rate. These rooms are not available to be reserved by the general public.
- As an administrator, I can create a block of rooms
- To create a block you need a date range, collection of rooms and a discounted room rate
- The collection of rooms should only include rooms that are available for the given date range
- If a room is set aside in a block, it is not available for reservation by the general public, nor can it be included in another block
- As an administrator, I can check whether a given block has any rooms available
- As an administrator, I can reserve a room from within a block of rooms
- A block can contain a maximum of 5 rooms
- When a room is reserved from a block of rooms, the reservation dates will always match the date range of the block
- All of the availability checking logic from Wave 2 should now respect room blocks as well as individual reservations
Usually by the end of a project, we can look back on what we made with a clearer understanding of what we actually needed. In industry, this is a great time to do a refactor of some sort. For this project however, you're off the hook... for the moment. We will be revisiting our hotels later on on the course, and you may want to make some changes at that point.
- Create a new file in the project called
refactors.txt - Make a short list of the changes that you could make, particularly in terms of naming conventions
- These notes will be used by you in a few weeks, so make sure that they are detailed enough that someone else could understand your thinking and follow your directions
- Do not make any further changes to your code at this time
You should not be working on these (or even thinking about them) until you have fully completed wave 3.
- Allow a user to set different rates for different rooms
- Read/write CSV files for each piece of data that your system is storing
- Create a CLI to interact with your hotel system
You can find what instructors will be looking for in the feedback markdown document.