Welcome to the backend of Gruas UCAB! This project is a .NET 8 Web API built using a microservices architecture. It consists of three microservices: Orders, Providers, and Admin, all accessed through a YARP API Gateway. Each service is dockerized and orchestrated using Docker Compose.
- Microservices Architecture: Modular design with separate services for Orders, Providers, and Admin functionalities.
- YARP API Gateway: Simplifies routing and management of microservices.
- Dockerized Services: Each microservice runs in its own Docker container for easy deployment and scalability.
- Orchestration with Docker Compose: Simplifies the setup and management of multi-container Docker applications.
The backend is structured into three main microservices:
- Orders Microservice: Manages order-related operations.
- Providers Microservice: Handles provider information and interactions.
- Admin Microservice: Admin controls and configurations.
All services communicate through the YARP API Gateway, which routes requests to the appropriate microservice.
To get started with the Gruas UCAB backend, follow these steps:
- .NET 8 SDK
- Visual Studio 2022 or later with ASP.NET and web development tools
- Docker Desktop
-
Clone the repository:
git clone https://github.com/yourusername/gruas-ucab-backend.git
-
Open the project in Visual Studio.
-
Ensure that you have the ASP.NET and web development tools installed.
-
Set
docker-compose
as the startup project:- Right-click on the solution in Solution Explorer.
- Select "Set Startup Projects..."
- Choose "Docker Compose" as the startup project.
-
Run the project without debugging:
- Click on the "Run" button or press
Ctrl + F5
.
- Click on the "Run" button or press
The application should now be running, and you can access it through the configured endpoints.
- .NET 8
- YARP (Yet Another Reverse Proxy)
- Docker
- Docker Compose
Contributions are welcome! If you would like to contribute to this project, please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/YourFeature
). - Make your changes and commit them (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature/YourFeature
). - Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
Thank you for checking out the Gruas UCAB backend! We hope you find it useful for your projects. If you have any questions or feedback, feel free to reach out!