add-test

Adds tests. Specify test type or infer from context.

Unit Test

For pure logic in Shared, Domain, or Application layers.

1. Create src/backend/tests/MyProject.Unit.Tests/{Layer}/{ClassUnderTest}Tests.cs
2. Structure: {Method}_{Scenario}_{Expected} naming
3. No mocking, no DI - test pure inputs and outputs
4. Verify: dotnet test src/backend/tests/MyProject.Unit.Tests -c Release

Component Test

For service business logic with mocked dependencies.

1. Create src/backend/tests/MyProject.Component.Tests/Services/{Service}Tests.cs
2. Create mocks in constructor:

   private readonly MyProjectDbContext _dbContext = TestDbContextFactory.Create();
   private readonly IOrderRepository _orderRepo = Substitute.For<IOrderRepository>();
   private readonly HybridCache _cache = Substitute.For<HybridCache>();
   

3. For Identity: IdentityMockHelpers.CreateMockUserManager() / CreateMockRoleManager()
4. Assert on Result: Assert.True(result.IsSuccess); Assert.Equal(expectedId, result.Value);
5. Verify: dotnet test src/backend/tests/MyProject.Component.Tests -c Release

API Integration Test

For testing the full HTTP pipeline (routes, auth, validation, status codes).

1. Create src/backend/tests/MyProject.Api.Tests/Controllers/{Controller}Tests.cs
2. Structure:

   public class OrdersControllerTests : IClassFixture<CustomWebApplicationFactory>, IDisposable
   {
       private readonly CustomWebApplicationFactory _factory;
       private readonly HttpClient _client;
       public OrdersControllerTests(CustomWebApplicationFactory factory)
       {
           _factory = factory;
           _client = factory.CreateClient();
       }
       public void Dispose() => _client.Dispose();
   }
   

3. Auth per-request via Authorization header:
   • "Test" - basic authenticated user
   • TestAuth.WithPermissions(AppPermissions.Users.View) - specific permissions
   • TestAuth.Superuser() - bypasses all checks
   • No header - unauthenticated (401)
4. Configure mock returns: _factory.AdminService.Method(...).Returns(...);
5. If service interface not mocked in CustomWebApplicationFactory, add it there first
6. For 200/201 responses, add response contract assertions using frozen records in Contracts/ResponseContracts.cs
7. Verify: dotnet test src/backend/tests/MyProject.Api.Tests -c Release