LastRoom

1. Description

API for the last hotel in Cancun.

Unfortunately we only have one room available, please check the days already booked in advance.

1.1. Running the project

• dotnet ef --project .\LastRoom.Api\ database update
• dotnet run --project .\LastRoom.Api\

2. API

2.1. GET (/bookings/days)

List the next 30 days and if the room is vacant.

• Response

[
	{
		"vacant": false,
		"date": "2022-09-11"
	},
	...
]

2.2. GET (bookings/{ticket})

The user can retrieve the booking with the ticket.

• Response

{
	"ticket": "65475ce5-3293-4f96-8c1a-dbb6350420c1",
	"clientFullName": "User 01",
	"checkInDate": "2022-09-11",
	"checkOutDate": "2022-09-13"
}

2.3. POST (bookings)

The user can create a new booking.

• Request

{
  "clientIdentification": "id",
  "clientFullName": "User 01",
  "checkInDate": "2022-09-11",
  "checkOutDate": "2022-09-13"
}

• Response

{
	"ticket": "65475ce5-3293-4f96-8c1a-dbb6350420c1",
	"clientFullName": "User 01",
	"checkInDate": "2022-09-11",
	"checkOutDate": "2022-09-13"
}

2.4. PUT (bookings/{ticket})

The user can update the booking.

• Request

{
  "clientIdentification": "id",
  "clientFullName": "User 01",
  "checkInDate": "2022-09-11",
  "checkOutDate": "2022-09-13"
}

• Response

{
	"ticket": "65475ce5-3293-4f96-8c1a-dbb6350420c1",
	"clientFullName": "User 01",
	"checkInDate": "2022-09-11",
	"checkOutDate": "2022-09-13"
}

2.5. DELETE (bookings/{ticket})

The user can undo the booking.

• Response 204

3. Improvements

• We can remove the manual mapping from the controller with:

  • AutoMapper

• We can separate the controllers from the services using CQRS with:

  • MediatR

• MediatR can also be good for separating validation from service.

• Improve the error object in the return.

• Create a docker file for deployment.

4. Extensions used for tests

• .NET Core Test Explorer
• Coverage Gutters

5. NuGet Packages:

• LastRoom.Api
  • FluentResults
  • Sqlite
  • EntityFrameworkCore
  • EntityFrameworkCore.Design
  • EntityFrameworkCore.Sqlite
  • Swashbuckle.AspNetCore
• LastRoom.Api.Tests
  • coverlet.msbuild
  • EntityFrameworkCore.InMemory
  • Moq
  • xunit