Welcome To Products Documentation

The check-list to follow when getting started:

1. Connect to the Internet and Build (or rebuild) your project.
2. On success:
   1. Run the project (as debug or without debugging.) The Super Administrator is created automatically.
   The Super Administrator credetials are as follows:

   Username: super

   Password: 123
3. Sign-in as Super Administrator and checkout the product features.

You can create other new accounts and manage them, see how the System handles Roles and Authorization, etc.

1. Create a Google App and Microsoft App then obtain your ClientId and ClientSecret from each provider.
   Follow these instruction to learn how you can create these apps:
   • Google App: Follow this tutorial.
   • Microsoft App: Follow this tutorial.
2. Go to your project files and open the appsettings.json file then add your authentication keys as follows:

   "OAuth": {
    "Google": {
   "ClientId": "your-client-id-comes-in-here",
   "ClientSecret": "your-client-secret-comes-in-here"
   },
   "Microsoft": {
   "ClientId": "your-client-id-comes-in-here",
   "ClientSecret": "your-client-secret-comes-in-here"
   }
                                                   

3. That's all! Save and build the project, then run. You can now Sign-up and Sign-in with Google and Microsoft.
Do not forget to publish your apps (Google OAuth2.0) from the console which you used to create the client keys as above.

1. In any given class, inject the IDbContextFactory like this:

                                           
   public class AnyClass(IDbContextFactory< AppDbContext > dbContextFactory)
                                       

2. Make a readonly field like this:

   private readonly IDbContextFactory< AppDbContext > dbContextFactory = dbContextFactory;

3. In any method/function, create a context like this:

   using var dbContext = await dbContextFactory.CreateDbContextAsync();

4. Create/Add an entity:

   await dbContext.AddAsync(Entity);

   await dbContext.SaveChangesAsync(); // do not forget to always save changes

5. Create/Add many entities:

   await dbContext.AddRangeAsync(EntityArray);

   await dbContext.SaveChangesAsync(); // do not forget to always save changes

6. Read entity/entities:

   var user = await dbContext.Users.FirstOrDefaultAsync(x => x.Id == "12345");

   var users = await dbContext.Users.AsNoTracking().ToListAsync();

   var usersWith2FaEnabled = await dbContext.Users.AsNoTracking().Where(x=> x.TwoFactorEnabled).ToListAsync();

   var usersFromNewYork = await dbContext.Users.AsNoTracking().Where(x=> x.City == "New York").ToListAsync();

7. Update an entity:

   dbContext.Update(Entity);

   await dbContext.SaveChangesAsync(); // do not forget to always save changes

8. Update many entities:

   dbContext.UpdateRange(Entity);

   await dbContext.SaveChangesAsync(); // do not forget to always save changes

9. Delete an entity:

   dbContext.Remove(Entity);

   await dbContext.SaveChangesAsync(); // do not forget to always save changes

10. Delete many entities:

    dbContext.RemoveRange(Entity);

    await dbContext.SaveChangesAsync(); // do not forget to always save changes

1. Go to your project files and locate DataModels > ApplicationUser > ApplicationUserModel
2. The ApplicationUserModel is the class that extends the IdentityUser class.
3. You can add your custom properties and features to this class. Build and run. Done.

1. Authentication pages: theme switcher: components/scss/floating-theme-switcher.scss
2. Password meter: components/scss/password-meter.scss
3. Authentication pages: css/authentication/authentication.scss
4. Custom bootstrap: custom-bootstrap/customBootstrap.scss
5. General styles: css/general.scss

1. All project javascript files: wwwroot/js/...

1. All project javascript files: wwwroot/js/..., therefore add your files in here.

1. All project font families are in here: wwwroot/fonts/..., therefore add your fonts in here.

1. Customize the Bootstrap colors in this file.

1. Customize the countries and states.

1. All flags are in this folder.

1. Go to your project files and locate HelperClasses > API > EmailValidation > AbstractAPI.
2. We have used Dependancy injection to implement the API and the result are 3 helper classes, as follows:
3. 1. IAbstractEmailService.cs: the interface that will be implemented by the class that will validate an email address.
   2. AbstractEmailService.cs: the class that implements the IAbstractEmailService.cs class and actually validates a given email address.
   3. AbstractEmailResponse.cs: the validation response which contains vital information about the validation process.
   4. You can learn more about the validation and response from this resource.
   5. When you have your Abstract API details, you can save them in the appsettings.json file like below:

      "AbstractApi": {
      "Email": {
          "ApiKey": "your-abstract-api-key",
          "BaseUrl": "https://emailvalidation.abstractapi.com/v1/" // the base URL (do not change)
      }
                                                                  

4. When the Super Admin or Admin enables Email Validation for new sign-ups, the Abstract API will kick in and go to work, in real-time.

How to change the solution (end-product) name: