WeeControl

Project Overview

This project is created as a milestone to develop and customize a software application using .NET technologies to solve a business need.

Philosophy:

• Continuous refactoring to increase code readability and performance.
• Separation of concerns by applying SOLID principles to the limit before creating too much abstraction.
• Unit testing are important during development.

Technologies:

• .NET 7 for Server API.
• Blazor WebAssembly as front end.
• Entity Framework Core as database persistence.

Patterns:

• CQRS on backend side.

Copyright and Licensing

This is open source project, while you need to read and accept each nuget package imported into this project.

Configuration Instructions

In order to use this application you need to do the following:

1. Edit values in "~/WebApi/appsettings.json" including:
   1. Change "UseInMemoryDb" to false if you didn't want to use in memory database.
   2. Database connection string.
   3. File storage connection string, you can use your own server directory.
2. Edit values in "~/Wasm/wwwroot/appsettings.json" including:
   1. Api base address of WebApi server.
3. Run WebApi server.
4. Run Wasm (Blazor App).
5. ...

Installation Instructions

This project code depend on many nuget packages, so ensure to restore the packages before running the servers.

Note that this project is currently under heavy development so if you faced any issues try to manually delete the database then the application will create new one with the default values, or migrate the database.

Operating Instructions

1. Ensure that both API and Blazor servers are running.
2. On Blazor webpage using credentials: Username : developer Password : developer

What is this?

This is software consists of Blazor web assembly project as front end and linked to an Api server as backend.

The user can use front end to do the following:

Essential Operation for Any Website:

1. Able to register and have an account.
2. Able to login using provided data during registration.
3. Able to request a temporary password if user forgot his password.
4. Able to change his password after being logged in.
5. Able to have a token saved so use for other operations.
6. Able to logout later when he wishes if he already have the token.

Contact

You can contact me on my email at [email protected].

Known Bugs

Still this project is in its initial developing stage, lots of bugs are expected at the current time, I wish that the project will be ready soon to be released in alpha stage to identfy bugs.

Credits and Acknowledgments

Appreciate the opensoure community for inspiring and supporting such project:

• The Markdown Guide: Markdown Guide and how to create a README.md file on Medium.
• JWT authentication: aspnet-core-3-jwt-authentication-api.
• Clean architecture pattern: CleanArchitecture By Steve Smith, CleanArchitecture by Jason Taylor and NorthwindTraders.
• The youtube channels IAmTimCorey, Nick Chapsas and VoidRealms gave the courage to start getting a workable programming application.