Skip to content

app.ratings

TableRow level security on

Two-sided ratings of a completed engagement (Section 4.4.3): the org rates the party and the party rates the org. Both are released together once both are in or 14 days after the engagement completed. Ratings are never edited, withdrawn or suppressed (Section 14.9); gateway.ratings_enabled only decides whether the org's members are prompted to rate and never hides or removes a rating (ADR 0038). Moderation follows policy only (abuse, personal data), whatever the score. Internal org notes and internal ratings live elsewhere and never appear here.

Primary key: id

Columns of app.ratings
ColumnTypeNullableDescription
iduuidNoPrimary key, UUID v7.
org_iduuidNoOwning org, derived from app.engagements on insert; never accepted from the caller and never changed.References app.organizations.id
engagement_iduuidNoCompleted engagement rated.References app.engagements.id
rater_sideapp.rating_sideNoOrganization (rating the party) or Party (rating the org).
scoresmallintNoScore from 1 to 5.
commenttextYesPublic comment.
rated_byuuidYesPerson who gave the rating, set from the session.References app.people.id
submitted_attimestamp with time zoneNoWhen the rating was given, set by the database.
deleted_attimestamp with time zoneYesSoft delete time. A row with deleted_at set is ignored by every access helper.
created_attimestamp with time zoneNoWhen the row was inserted. Set by the database.
created_byuuidYesPerson who inserted the row, or null for a platform process. Set by the database.References app.people.id
updated_attimestamp with time zoneNoWhen the row last changed. Set by the database.
updated_byuuidYesPerson who last changed the row, or null for a platform process. Set by the database.References app.people.id