Rating and Weightage Value Objects

Summary

Technical handling of bounded evaluation and goal-weight values without exposing appraisal results.

Audience

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

Overview

Rating and Weightage are immutable value objects with structural equality. Factory methods normalize incoming values to source-defined bounds rather than rejecting them.

Confirmed implementation

• The appraisal stores an overall Rating value object.
• Goals store separate self and manager Rating value objects plus Weightage.
• Manager rollup is weight-based when weights exist and otherwise uses an average.
• HR review may retain or replace the rollup through the same bounded value object.
• There is no rule requiring all goal weights to total a fixed amount.

Classification

Implemented value-object behavior; policy meaning and display labels require confirmation.

Requires confirmation

Business ownership of the scale, rounding policy across consumers, and validation-versus-normalization policy require confirmation.

Related Articles

• Performance technical documentation
• Performance module

See Also

• Technical known limitations
• Performance business documentation

Keywords

• Performance service
• Rating Model
• Draft technical documentation

Source References

• microservices/src/performance-service/Domain/Common/ValueObjects.cs
• microservices/src/performance-service/Domain/Appraisal/Appraisal.cs
• microservices/src/performance-service/Application/Queries/PerformanceReports.cs

Revision Information

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