Skip to main content

Commands and Queries

Summary​

Custom CQRS-style write and read paths in the Performance application layer.

Audience​

Engineers, architects, QA, support, security reviewers, and operators working with the Performance module.

Overview​

ReviewCycleCommands and AppraisalCommands form the write side. PerformanceQueries and PerformanceReports form the read side. They are ordinary injected classes, not mediator handlers.

Confirmed implementation​

  • Write operations load aggregates, invoke domain behavior, record history, and save through IUnitOfWork.
  • List and detail queries use repository queryables and explicit DTO mappings.
  • Report queries are cycle-scoped, tenant-filtered, read-only projections.
  • MediatR, FluentValidation, and AutoMapper are absent from the service project.
  • Known errors are carried through Result rather than thrown on the expected path.

Classification​

Implemented lightweight CQRS; mediator and validation pipelines are Not implemented.

Requires confirmation​

Request pipeline standardization, query pagination contracts, and read-model separation require confirmation.

Diagram​

See Also​

Keywords​

  • Performance service
  • Commands and Queries
  • Draft technical documentation

Source References​

  • microservices/src/performance-service/Application/Commands/ReviewCycleCommands.cs
  • microservices/src/performance-service/Application/Commands/AppraisalCommands.cs
  • microservices/src/performance-service/Application/Queries/PerformanceQueries.cs
  • microservices/src/performance-service/Application/Queries/PerformanceReports.cs

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-16
  • Review cycle: Quarterly