https://github.com/amg262/auctionnext
Microservices app using NextJS + .NET 8, Duende IdentityServer, MassTransit, RabbitMQ, gRPC, SSO, Stripe, Talon.One, EasyPost, running Redis, OpenTelemetry and Grafana on Docker and Kubernetes. React Native and MAUI Blazor Hybrid mobile apps also in development.
https://github.com/amg262/auctionnext
docker dotnet grpc nextjs rabbitmq
Last synced: 5 months ago
JSON representation
Microservices app using NextJS + .NET 8, Duende IdentityServer, MassTransit, RabbitMQ, gRPC, SSO, Stripe, Talon.One, EasyPost, running Redis, OpenTelemetry and Grafana on Docker and Kubernetes. React Native and MAUI Blazor Hybrid mobile apps also in development.
- Host: GitHub
- URL: https://github.com/amg262/auctionnext
- Owner: amg262
- Created: 2024-02-15T15:55:52.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-04T20:56:57.000Z (almost 2 years ago)
- Last Synced: 2024-05-21T05:38:39.162Z (almost 2 years ago)
- Topics: docker, dotnet, grpc, nextjs, rabbitmq
- Language: C#
- Homepage:
- Size: 3.45 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AuctionNext
## System Diagram
### I promise I have a life
[](https://wakatime.com/badge/github/amg262/AuctionNext)
## How to run the project
1. Clone the repository: `git clone `
2. Navigate to the project directory:
```bash
cd AuctionNext
```
3. Build the services locally on your computer by running
```bash
docker compose build
```
4. Run the services by running
```bash
docker compose up -d
````
5. To see the app working you will need to provide it with an SSL certificate. To do this please install 'mkcert' onto
your computer which you can get from [here](https://github.com/FiloSottile/mkcert). Once you have this you will need
to install the local Certificate
Authority by using:
```bash
mkcert -install
```
6. Once you have the local Certificate Authority installed you can then generate the SSL certificate by running:
```bash
cd devcerts
mkcert -key-file auctionnext.com.key -cert-file auctionnext.com.crt app.auctionnext.com api.auctionnext.com id.auctionnext.com
```
7. Add entry to your hosts file for domain name resolution:
```bash
127.0.0.1 id.auctionnext.com app.auctionnext.com api.auctionnext.com
```
## Table of Contents
- [Introduction](#introduction)
- [Technologies](#technologies)
- [Project Structure](#project-structure)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Introduction
AuctionNext is a web application built using ASP.NET Core and Entity Framework Core. It provides a platform for users to
create auctions, bid on items, and monitor auction status. The application uses a PostgreSQL database to store auction
and item data.
## Technologies
The following technologies and libraries are used in this project:
- ASP.NET Core: A cross-platform framework for building web applications.
- Entity Framework Core: An object-relational mapping (ORM) framework for .NET.
- PostgreSQL: A powerful, open-source relational database management system.
- Swagger: A tool for documenting and testing APIs.
- Newtonsoft.Json: A popular JSON framework for .NET.
- Npgsql.EntityFrameworkCore.PostgreSQL: A PostgreSQL provider for Entity Framework Core.
## Project Structure
The project structure is organized as follows:
- `src/AuctionService/`: The main project folder for the AuctionService.
- `Entities/`: Contains the entity classes representing auctions and items.
- `Data/`: Contains the database context and migrations.
- `Migrations/`: Contains the database migration files.
- `Properties/`: Contains project-related properties files.
- `appsettings.json`: Contains the application settings.
- `appsettings.Development.json`: Contains the development-specific application settings.
- `DbInitializer.cs`: Contains the database initializer class.
- `Program.cs`: Contains the entry point of the application.
- `Status.cs`: Contains the enum representing auction status.
- `src/SearchService/`: The main project folder for the SearchService.
- `Data/`: Contains the data access layer for the search service.
- `Services/`: Contains the business logic layer for the search service.
- `Consumers/`: Contains the message consumers for the search service.
- `Program.cs`: Contains the entry point of the application.
- `src/IdentityService/`: The main project folder for the IdentityService.
- `Data/`: Contains the data access layer for the identity service.
- `Models/`: Contains the models used in the identity service.
- `Pages/`: Contains the Razor Pages for the identity service.
- `Program.cs`: Contains the entry point of the application.
- `src/GatewayService/`: The main project folder for the GatewayService.
- `Controllers/`: Contains the controllers for the gateway service.
- `Services/`: Contains the services used in the gateway service.
- `Program.cs`: Contains the entry point of the application.
- `tests/AuctionService.Tests/`: Contains the unit tests for the AuctionService.
## Getting Started
To get started with the AuctionNext project, follow these steps:
1. Clone the repository: `git clone `
2. Navigate to the project directory: `cd AuctionNext`
3. Restore the dependencies: `dotnet restore`
4. Update the database connection string in the respective `appsettings.Development.json` files to match your PostgreSQL
database configuration.
5. Apply the database migrations for each project: `dotnet ef database update` (
e.g., `dotnet ef database update --project src/AuctionService`)
6. Run each project individually using the `dotnet run` command (e.g., `dotnet run --project src/AuctionService`)
## Usage
Once the application is running, you can access the API documentation using Swagger UI. Open your web browser and
navigate to the respective URLs for each project:
- AuctionService: `https://localhost:5001/swagger/index.html`
- SearchService: `https://localhost:7002/swagger/index.html`
- IdentityService: `https://localhost:5000/swagger/index.html`
- GatewayService: `https://localhost:6001/swagger/index.html`
Here, you can explore the available endpoints and test them.
## Contributing
Contributions to the AuctionNext project are welcome. To contribute, follow these steps:
1. Fork the repository
2. Create a new branch: `git checkout -b feature/your-feature-name`
3. Make your changes and commit them: `git commit -am 'Add some feature'`
4. Push the changes to your fork: `git push origin feature/your-feature-name`
5. Create a new pull request
## License
The AuctionNext project is licensed under the [MIT License](LICENSE).