5.2.4 RecommendationsTable Reference
This stable page summarizes app/plugins/Awards/src/Model/Table/RecommendationsTable.php. Use the source and generated API documentation for exact fields and method signatures.
Associations
RecommendationsTable belongs to requesters, recommended members, branch, award, bestowal, scheduled/assigned event and gathering, and an optional group head. It has group children, notes, feedback items, state logs, and many-to-many event/gathering relationships.
The table uses timestamp, footprint, and soft-delete behaviors. Validation/application rules protect required relationships and workflow-compatible values. beforeSave() maintains table-level derived data; use table saves rather than direct SQL. addBranchScopeQuery() is the shared branch-filtering helper.
Service boundary
Controllers should not implement recommendation state transitions against this table directly. Use the focused submission, update, transition, deletion, grouping, feedback, approval, bestowal-link, and state-log services described in Awards services.
Authorization and tenancy
Authorize an entity with RecommendationPolicy; scope collections with RecommendationsTablePolicy before grids, counts, or exports. The table policy combines branch/award-level authority with visibility granted by current or retained workflow approvals. Recommendations, approval runs, workflow instances, feedback, and bestowals must all be loaded from the same active tenant.