https://github.com/ct0rm4n/cleanarch-commerce
CleanArch Commerce - CQRS - DDD - Microservices - MicroOrm
https://github.com/ct0rm4n/cleanarch-commerce
clean-architecture cqrs csharp csharp-app csharp-code dapper dapper-donet-core ddd docker dotnet dotnet-core dotnetcore gateway-api microorm microservice microsoft ocelot-gateway proxy-reverse tdd
Last synced: 3 months ago
JSON representation
CleanArch Commerce - CQRS - DDD - Microservices - MicroOrm
- Host: GitHub
- URL: https://github.com/ct0rm4n/cleanarch-commerce
- Owner: ct0rm4n
- Created: 2024-04-29T01:13:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-03T02:49:29.000Z (5 months ago)
- Last Synced: 2025-04-06T05:51:42.510Z (3 months ago)
- Topics: clean-architecture, cqrs, csharp, csharp-app, csharp-code, dapper, dapper-donet-core, ddd, docker, dotnet, dotnet-core, dotnetcore, gateway-api, microorm, microservice, microsoft, ocelot-gateway, proxy-reverse, tdd
- Language: C#
- Homepage: https://www.linkedin.com/in/pedro-torman
- Size: 42.7 MB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CleanArch Commerce - Sample
This is an e-commerce project developed with Blazor and .NET 8. The project includes a catalog API, an API gateway using Ocelot, and a Blazor WebAssembly client application.
Fast Architecture:
## Roadmap
- [x] Net. 8
- [x] API Gateway - Ocelot
- [X] ORM - Dapper
- [ ] RabbitMQ
- [X] Authentication
- [ ] Payment - OpenPix
- [ ] Authorization ACL
- [X] CQRS Patern Generic
- [ ] Webhook Client
- [ ] Multi-language Support
- [ ] Chinese
- [ ] Spanish
- [ ] English
## Requirements
To run this project, you will need to have the following software installed:
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
- [Docker](https://www.docker.com/get-started) (with Linux support)
## Environment Setup
1. **Clone the repository:**
git clone https://github.com/ct0rm4n/FastCommerce.git cd fastcommerce
2. **Ensure Docker is running:**
Verify that Docker is installed and running on your system. You can check this by running the following command:
docker --version
3. **Build and start the Docker containers:**
Navigate to the root directory of the project and run the command below to build and start the Docker containers:
docker-compose up
This command will build the necessary Docker images and start the containers defined in the `docker-compose.yml` file.
## Project Structure
- **Api.Ocelot**: API gateway using Ocelot.
- **FastCommerce.Api.Catalog**: Catalog API for managing products and categories.
- **UI**: Blazor WebAssembly client application.
## Accessing the Application
After running the `docker compose up` command, you can access the application at the following URLs:
- **API Gateway**: [http://host.docker.internal:5000/swagger/index.html](http://host.docker.internal:5000/swagger/index.html)
- **Blazor Client Application**: [http://localhost:5005](http://host.docker.internal:5005)
## SQL Scripts
The project includes an SQL script (`CreateDatabase.sql`) to create the database and necessary tables. This script is automatically executed when the catalog API starts, ensuring the database is properly configured.
## Contribution
If you would like to contribute to this project, feel free to open a pull request or report issues in the repository.
## License
This project is licensed under the [MIT License](LICENSE).