5.2.3 Recommendation State Logs Table Reference
This stable page supports source-code links. Read app/plugins/Awards/src/Model/Table/RecommendationsStatesLogsTable.php for exact validation and associations.
RecommendationsStatesLogsTable persists the historical state changes for an Awards recommendation in awards_recommendations_states_logs. It belongs to the recommendation through the AwardsRecommendations association and records timestamps for audit/timeline display.
New state changes should be written through RecommendationStateLogService as part of the owning transition transaction. Do not save an isolated log row and then attempt the recommendation mutation separately.
Access to the audit trail is governed by RecommendationsStatesLogPolicy and its table policy, plus the parent recommendation’s visibility rules. Logs are tenant-local and may contain sensitive workflow context; they are not a public event stream.