Summary

This repository contains a simple User Management Web API built with ASP.NET Core. The API provides CRUD operations for managing user data, including creating, retrieving, updating, and deleting users. The project uses Entity Framework Core with SQLite as the database provider and includes comprehensive unit tests for the controllers, services, and repository layers.

You can explore and test the functionality of our Project Web API through our Swagger interface. Follow these steps to get started:

Access the Swagger UI: Open your web browser and navigate to the Swagger UI by clicking on this link.

Explore the Endpoints: Browse through the available API endpoints listed in the Swagger interface. Each endpoint represents a different operation you can perform with the API.

Test the API: To test an endpoint, select it from the list, and then click the “Try it out” button. Fill in any required parameters and click “Execute” to send a request to the API.

View Responses: After executing a request, you can view the response details, including the status code, response body, and any headers returned by the API.

The Swagger UI provides an intuitive way to interact with the API and understand its capabilities without writing any code. Feel free to explore and experiment with different endpoints to get a better understanding of how the API works.

Refer to the coding-challenge-requirements.pdf for detailed requirements.

The project follows a layered architecture with the following components:

• Controllers: Handle HTTP requests and responses.
• Services: Contain business logic and interact with repositories.
• Repositories: Handle data access and database operations.
• Models: Define the data structures and validation rules.
• Middleware: Custom middleware for logging HTTP requests and responses.

The demo video showcases the User Management Web API and demonstrates the CRUD operations for managing user data.

Link to General Demo Video

Link to Unique E-mail Validation Demo Video

• .NET 8.0 SDK
• Docker (optional, for containerized deployment)
• TODO: Due to time constraints I was not yet able to test and verify Docker deployment.

1. Clone the repository:

   git clone https://github.com/kathleenwest/UserManagementWebApiDemo.git

   1	git clone https://github.com/kathleenwest/UserManagementWebApiDemo.git

2. Restore the dependencies and build the solution:

   dotnet restore dotnet build

   1 2	dotnet restore dotnet build

1. Run the application:

   dotnet run --project UserManagement

   1	dotnet run --project UserManagement

2. The API will be available at https://localhost:7048 and http://localhost:5108.

1. Add a new migration:

   dotnet ef migrations add <span class="pl-k">&lt;</span>MigrationName<span class="pl-k">&gt;</span> --project UserManagement --startup-project UserManagement

   1	dotnet ef migrations add <span class="pl-k">&lt;</span>MigrationName<span class="pl-k">&gt;</span> --project UserManagement --startup-project UserManagement

2. Apply the migration to the database:

   dotnet ef database update --project UserManagement --startup-project UserManagement

   1	dotnet ef database update --project UserManagement --startup-project UserManagement

1. Ensure the connection string in appsettings.json points to the SQLite database file:

   { <span class="pl-ent">"ConnectionStrings"</span>: { <span class="pl-ent">"UserDb"</span>: <span class="pl-s"><span class="pl-pds">"</span>Data Source=UserDb.db<span class="pl-pds">"</span></span> } }

   1 2 3 4 5

   {   <span class="pl-ent">"ConnectionStrings"</span>: {     <span class="pl-ent">"UserDb"</span>: <span class="pl-s"><span class="pl-pds">"</span>Data Source=UserDb.db<span class="pl-pds">"</span></span>   } }

2. Run the application to create and apply the migrations:

   dotnet run --project UserManagement

   1	dotnet run --project UserManagement

The project includes unit tests for controllers, services, and repository layers using xUnit and Moq.

1. Navigate to the test project directory:

   <span class="pl-c1">cd</span> UserManagement.Tests

   1	<span class="pl-c1">cd</span> UserManagement.Tests

2. Run the tests:

   dotnet <span class="pl-c1">test</span>

   1	dotnet <span class="pl-c1">test</span>

The unit tests cover various scenarios, including:

• Creating, retrieving, updating, and deleting users.
• Validating email uniqueness.
• Handling errors and logging.
• TODO: Due to time constraints, I added ideas for additional tests in the UserManagement.Tests project.

This project is licensed under the MIT License.