A project of website with access to currencies retrieved from an API. Users must log in/register to use the website. The website has a home page where available currencies are displayed. From the homepage, users can go to their profile page or the currency converter, where they can select the currency to sell/buy and the amount of money to exchange to check the currency rate and the amount of money in the purchased currency.
- Extract the project files into a chosen directory.
- Open the terminal in the CurrencyManager.WebApp directory.
- Install the dotnet ef tool using the command:
dotnet tool install --global dotnet-ef - Run the application using:
dotnet run
The project was designed so that the database would automatically be created when the project is started. In case of errors related to creating the database, the Source parameter must be set to the address of your local server in the connection string. The connection string is located at Projekt_asp\CurrencyManager.Data\Configuration in the file CurrencyManagerDbContext.cs.
Any user has access to the page https://localhost:7104/Login/Register where they can enter their registration details in a form, such as email address and a password. A user with the password 1qazXSW@#premium will have the status of Premium User.
After submitting the form, if the data entered is correct, the user is redirected to the main page displaying available currencies at https://localhost:7104/Currency/Index.
Access to the login page: https://localhost:7104/login is available to any user where they must enter their email address and password
After submitting the form with the correct login details, the user is redirected to the main page at https://localhost:7104/Currency/Index displaying the available currencies.
After successful login / registration, the user has access to the Currency Converter tab, which, when clicked, is redirected to the address: https://localhost:7104/Converter/Converter
In the converter, you must select the currency being sold, purchased, and the amount of money to be exchanged. Once the options have been selected, confirm your selection with the "Convert" button, wait for the page to return the rate, and then display the result of the currency conversion with the "Display" button.
After successful login / registration, the user has access to the tab "Profile" which, when clicked, will be redirected to the address: "https://localhost:7104/Profile/Profile"
On the profile page, the user can update/change their personal data such as:
- First Name
- Last Name
- Age
- Password
- User Type
User premium in addition to the ability to change their personal data, also has a history of their last currency conversion.
To change the user type from standard to premium, change the password to: 1qazXSW@#premium
User premium:
- Email: premium@user.pl
- Hasło: 1qazXSW@#premium
User standard:
- Email: standard@user.pl
- Hasło: 1qazXSW@#
This project contains two implementations of the ICurrencyProviderService interface providing currencies:
ApiCurrencyProviderService- production repository - currencies retrieved from APIHardcodedCurrencyProviderService- test repository
and two implementations of the IExchangeRateProviderService interface providing rates of selected currencies:
ApiExchangeRatesProviderService- production repository - rates downloaded from an APIHardcodedExchangeRatesProviderService- test repository
By default, the project uses production repositories. In case of errors related to Api, such as: Bad request, it is necessary to close and restart the project. To change the production repositories to the test repositories, it is necessary to change the ApiCurrencyProviderService to HardcodedCurrencyProviderService and the ApiExchangeRatesProviderService to HardcodedExchangeRatesProviderService in the Program.cs file.
- C# 10.0
- NET.6.0
- Bootstrap 5.0
- MicrosoftEntityFrameworkCor.SqlServer 7.0.1
- RestSharp.Serializers.NewtonsoftJson 108.0.1
- Moq 4.18.4
- xunit 2.4.1
- xunit.runner.visualstudio 2.4.3
- Microsoft.VisualStudio.Web.CodeGeneration.Design