Getting Started

To setup and run the project locally you will need to first install the prequisite software on your machine and then follow the instructions below

Software Requirements:

.Net 8 SDK
Docker

Optionally if you would like to have your containers hosted on a separate machine Portainer would be a good option to setup and manage the stack for this application.

Optional Setup Requirements

These are a list of requirements you only need if you want to have a real mail server and use paypal when doing checkout

A mail server

If you opt to not use the mailhog server below and want to have emails actually sent out you will need to set something up and get the credentials necessary for the secrets.json file in the worker project.

Dotnet Project Setup Steps

Open Powershell and move into the root directory of the project
- Your shell path should look similar to C:\GitRepos\EcommerceApp> on windows
- For superior Linux users it should look more like this ~/GitRepos/EcommerceApp$

Run the following command to set up a MySQL Docker Container

docker run -d --name ecommerce-mailhog -p 1025:1025 -p 8025:8025 mailhog/mailhog
docker run -d --name ecommerce-rabbit -e RABBITMQ_DEFAULT_USER=user -e RABBITMQ_DEFAULT_PASS=password -p 15672:15672 -p 5672:5672 rabbitmq:3-management
docker run -d --name ecommerce-mysql -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=ecommerce -e MYSQL_USER=applicationuser -e MYSQL_PASSWORD=password -p 3306:3306 mysql:latest

Run the following command to install the dotnet tools needed for this repo
```
dotnet tool restore
```
Update your appsettings.Development.json or file in the API project to have the following connection string
(You SHOULD change the values to match your MySQL container setup)
```
"ConnectionStrings": {
    "datastorage": "server=localhost;port=3306;database=ecommerce;user=applicationuser;password=password"
}
```
You will need to use a program of your choice or bash into the container to access your MySql database to run the following snippet as a user with admin privileges
```
 SET GLOBAL event_scheduler = ON;
```

Add a secrets.json file to the API project and add paste the following into it
Be sure to update the sections with the values for your project, and match your settings to what was used in the docker container setup step

{
    "JwtSettings": {
    "Key": "somevaluesuperduperlongstringthatwillbeatleast128bitslongandsatisfytherequirementofhthealgowereusinghere"
    },
    "Paypal": {
        "ClientId": "AnId",
        "Secret": "something"
    },
    "RabbitMQ": {
        "Username": "CHANGEME",
        "Password": "CHANGEME"
    }
}

Add a secrets.json file to the Worker project and paste the following into it
As with the API project be sure to update your values appropriately, if you are using mailhog you can skip the MailSettings object

{
    "RabbitMQ": {
        "Username": "CHANGEME",
        "Password": "CHANGEME"
    },
    "MailSettings": {
        "Host": "localhost",
        "Port": 1025,
        "UserName": "ecommerce@techforge.com",
        "Password": "CHANGEME"
    }
}

(Mailhog Only) Update the MailServiceRegistration.cs file under the Ecommerce.Mail class library project so it looks like this

//Use for local testing with MailHog
SmtpClient client = new SmtpClient
{
    EnableSsl = false,
    Port = 1025,
    Host = mailSettings.Host
};

//Use for sending emails with a real SMTP server
// SmtpClient client = new SmtpClient (mailSettings.Host)
// {
//     EnableSsl = true,
//     Port = mailSettings.Port,
//     UseDefaultCredentials = false,
//     Credentials = new System.Net.NetworkCredential(mailSettings.UserName, mailSettings.Password)
// };

If you plan to use the Blazor UI instead of the React UI go into the appsettings.json file in the Api project and update the UIUrl property to the following value
```
"UIUrl": "http://localhost:5233"
```
Run the API, Worker, and optionall the UI projects together in an IDE of your choice, if you are using mailhog you can access your inbox at localhost:8025

React UI Setup Steps

Run the following command to download the dependencies you will need for the project
```
npm install
```
Use an IDE of your choice or run the following command to run the UI locally
```
npm run dev
```

Post Setup Instructions

You can now run the application, but you will need to go to the register page, you can either append the UI path with /Register or click login in the top right and click Register here
To add more Products with pictures you will need to set up your own S3 bucket and use the urls from that to show product pictures