Rui Santos Laboratory

Welcome to the Rui Santos Laboratory, an ASP.NET Core API that streamlines medical appointment scheduling and management for patients and doctors.

Introduction

This repository contains a comprehensive solution for medical appointment scheduling, providing features for both patients and doctors.

Features

• Schedule medical appointments with doctors from various specialties.
• View and manage appointments for patients.
• Easily cancel appointments when needed.
• Doctors can view their appointments for the day.

Technologies Used

This project was built using the following technologies:

• Services:
  • ASP.NET Core
  • Swagger
  • GraphQL
  • HotChocolate
• Client:
  • Blazor Webassembly
  • Blazorise
  • CommunityToolkit.Mvvm
• Tests:
  • xUnit Tests
  • Testcontainers
  • NSubstitute
• Host:
  • AWS Dynamodb
  • Localstack
  • Docker

Getting Started

To set up the Rui Santos Laboratory on your local machine, follow these steps:

1. Clone this repository:

git clone https://github.com/ruisantos78/Laboratory.git

2. Navigate to the root directory of the project:

cd Laboratory

3. Build and start the API Service and Database containers:

make build-server

4. The API will now be available at http://localhost:8001.

5. Build and start the Client container:

make build-client

6. The Client will now be available at http://localhost:8002.

7. Stop and remove all containers.

make kill

API Documentation

API documentation is available at http://localhost:8001/swagger.

GraphQL documentation is available at http://localhost:8001/graphql.

Makefile Commands

For simplified project management, we provide a Makefile with the following commands:

• make start: Built and start all containers.
• make build-server: Start the DynamoDB and API containers.
• make build-client: Start the client container.
• make kill: Stop and remove all containers.
• make update-client: Update the GraphQL schema on the client container (requires the build-server command to be run first).
• make help: Show this help message.

To use these commands, make sure you have the make utility installed on your system.

Contributing

Pull requests and bug reports are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT License.

Acknowledgments

This API was built using ASP.NET Core and Docker. Thanks to their respective communities for their hard work and contributions.

Author

This API was created by Rui Sergio Carvalho dos Santos.