# Changelog

## Score

- CAI 52 → 41 (-10.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 53 → 53 (-0.0)
- Architecture 83 → 79 (-4.5)
- Maturity 55 → 53 (-2.1)
- Readiness 47 → 50 (+2.8)
- Security 53 → 53 (+0.4)
- Domain Modelling 27 (new)
- Performance 64 → 60 (-4.1)

## Resolved (14)

- Fragmented Authentication/Token Logic: The API exposes multiple distinct endpoints for token generation and validation across different controllers (Admin vs User). 'AdminLogin' and 'TokenRequest' likely perform similar authentication flows but are separated by role. 'ValidateUser' and 'TokenRequest' have ambiguous naming regarding whether they generate new tokens or just verify existing ones. 'RefreshUserToken' is a specific state change, but the lack of a unified 'Auth' or 'Account' controller makes the authentication surface disjointed.
- Inconsistent Naming Convention for Retrieval: 'GetAllUsers' uses a plural noun indicating a collection, while 'GetUserOrders' uses a possessive/relationship structure. While semantically distinct, the pattern for listing resources is inconsistent. More critically, 'GetOrders' in OrderManagementController lacks the 'All' or 'List' qualifier, whereas 'GetAllUsers' explicitly states it retrieves all. This creates ambiguity about whether 'GetOrders' returns all orders or requires parameters.
- Inconsistent Verb Usage for Creation: 'CreateUser' uses the standard 'Create' verb, while 'AddNewAdmin' uses 'AddNew'. 'AddNew' is redundant ('Add' implies creation) and inconsistent with the 'Create' pattern used elsewhere. This suggests a lack of standardized command naming conventions for resource creation.
- Vulnerable: NuGet.Packaging
- XML-doc coverage: CleanArc.Application (src/Core/CleanArc.Application/CleanArc.Application.csproj)
- XML-doc coverage: CleanArc.Domain (src/Core/CleanArc.Domain/CleanArc.Domain.csproj)
- XML-doc coverage: CleanArc.Infrastructure.CrossCutting (src/Infrastructure/CleanArc.Infrastructure.CrossCutting/CleanArc.Infrastructure.CrossCutting.csproj)
- XML-doc coverage: CleanArc.Infrastructure.Identity (src/Infrastructure/CleanArc.Infrastructure.Identity/CleanArc.Infrastructure.Identity.csproj)
- XML-doc coverage: CleanArc.Infrastructure.Monitoring (src/Infrastructure/CleanArc.Infrastructure.Monitoring/CleanArc.Infrastructure.Monitoring.csproj)
- XML-doc coverage: CleanArc.Infrastructure.Persistence (src/Infrastructure/CleanArc.Infrastructure.Persistence/CleanArc.Infrastructure.Persistence.csproj)
- XML-doc coverage: CleanArc.SharedKernel (src/Shared/CleanArc.SharedKernel/CleanArc.SharedKernel.csproj)
- XML-doc coverage: CleanArc.Web.Api (src/API/CleanArc.Web.Api/CleanArc.Web.Api.csproj)
- XML-doc coverage: CleanArc.Web.Plugins.Grpc (src/API/Plugins/CleanArc.Web.Plugins.Grpc/CleanArc.Web.Plugins.Grpc.csproj)
- XML-doc coverage: CleanArc.WebFramework (src/API/CleanArc.WebFramework/CleanArc.WebFramework.csproj)

## New (2)

- doc comments repeat the names (src/API/CleanArc.Web.Api/Controllers/V1/Admin/RoleManagerController.cs)
- doc comments repeat the names (src/Shared/CleanArc.SharedKernel/Extensions/ModelBuilderExtensions.cs)

## API surface

- Unchanged — 20 HTTP endpoints

## Architecture

- Unchanged — 2 containers · 1 contexts · 0 edges
