feat(life): add game versions and 5-star ratings to posts

Support associating life posts with specific game versions
Allow 1-5 star ratings on posts in rateable categories
Add feed filters for game version, rateable status, and top-rated sorting

backend/db/schema.sql

@@ -238,6 +238,7 @@ VALUES
   ('life.comments.delete', 'Delete own Life comments', 'Delete own Life comments.', 'Life', true),
   ('life.comments.delete-any', 'Delete any Life comment', 'Delete any Life comment.', 'Life', true),
   ('life.reactions.set', 'Set Life reactions', 'Set and remove Life reactions.', 'Life', true),
+  ('life.ratings.set', 'Set Life ratings', 'Set and remove Life star ratings.', 'Life', true),
   ('discussions.comments.create', 'Create discussion comments', 'Create entity discussion comments and replies.', 'Discussions', true),
   ('discussions.comments.delete', 'Delete own discussion comments', 'Delete own entity discussion comments.', 'Discussions', true),
   ('discussions.comments.delete-any', 'Delete any discussion comment', 'Delete any entity discussion comment.', 'Discussions', true)
@@ -321,6 +322,7 @@ JOIN permissions p ON p.key = ANY (ARRAY[
   'life.comments.delete',
   'life.comments.delete-any',
   'life.reactions.set',
+  'life.ratings.set',
   'discussions.comments.create',
   'discussions.comments.delete',
   'discussions.comments.delete-any'
@@ -374,6 +376,7 @@ JOIN permissions p ON p.key = ANY (ARRAY[
   'life.comments.create',
   'life.comments.delete',
   'life.reactions.set',
+  'life.ratings.set',
   'discussions.comments.create',
   'discussions.comments.delete'
 ])
@@ -395,6 +398,7 @@ JOIN permissions p ON p.key = ANY (ARRAY[
   'life.comments.create',
   'life.comments.delete',
   'life.reactions.set',
+  'life.ratings.set',
   'discussions.comments.create',
   'discussions.comments.delete'
 ])
@@ -406,6 +410,13 @@ WHERE r.key = 'member'
   )
 ON CONFLICT DO NOTHING;
 
+INSERT INTO role_permissions (role_id, permission_id)
+SELECT r.id, p.id
+FROM roles r
+JOIN permissions p ON p.key = 'life.ratings.set'
+WHERE r.key IN ('admin', 'editor', 'member')
+ON CONFLICT DO NOTHING;
+
 WITH first_owner_user AS (
   SELECT u.id
   FROM users u
@@ -524,6 +535,7 @@ CREATE TABLE IF NOT EXISTS life_tags (
   id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
   name text NOT NULL UNIQUE,
   is_default boolean NOT NULL DEFAULT false,
+  is_rateable boolean NOT NULL DEFAULT false,
   sort_order integer NOT NULL DEFAULT 0 CHECK (sort_order >= 0),
   created_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
   updated_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
@@ -531,10 +543,25 @@ CREATE TABLE IF NOT EXISTS life_tags (
   updated_at timestamptz NOT NULL DEFAULT now()
 );
 
+CREATE TABLE IF NOT EXISTS game_versions (
+  id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  name text NOT NULL UNIQUE,
+  change_log text NOT NULL DEFAULT '',
+  sort_order integer NOT NULL DEFAULT 0 CHECK (sort_order >= 0),
+  created_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
+  updated_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS game_versions_sort_order_idx
+  ON game_versions(sort_order, id);
+
 CREATE TABLE IF NOT EXISTS life_posts (
   id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
   body text NOT NULL CHECK (length(body) BETWEEN 1 AND 2000),
   category_id integer REFERENCES life_tags(id) ON DELETE RESTRICT,
+  game_version_id integer REFERENCES game_versions(id) ON DELETE SET NULL,
   ai_moderation_status text NOT NULL DEFAULT 'unreviewed' CHECK (ai_moderation_status IN ('unreviewed', 'reviewing', 'approved', 'rejected', 'failed')),
   ai_moderation_language_code text REFERENCES languages(code) ON DELETE SET NULL,
   ai_moderation_content_hash text,
@@ -611,6 +638,21 @@ CREATE INDEX IF NOT EXISTS life_post_reactions_post_idx
 CREATE INDEX IF NOT EXISTS life_post_reactions_user_idx
   ON life_post_reactions(user_id, updated_at DESC, post_id DESC);
 
+CREATE TABLE IF NOT EXISTS life_post_ratings (
+  post_id integer NOT NULL REFERENCES life_posts(id) ON DELETE CASCADE,
+  user_id integer NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  rating integer NOT NULL CHECK (rating BETWEEN 1 AND 5),
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now(),
+  PRIMARY KEY (post_id, user_id)
+);
+
+CREATE INDEX IF NOT EXISTS life_post_ratings_post_idx
+  ON life_post_ratings(post_id, rating);
+
+CREATE INDEX IF NOT EXISTS life_post_ratings_user_idx
+  ON life_post_ratings(user_id, updated_at DESC, post_id DESC);
+
 CREATE TABLE IF NOT EXISTS skills (
   id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
   name text NOT NULL UNIQUE,
@@ -904,9 +946,27 @@ CREATE INDEX IF NOT EXISTS entity_discussion_comments_parent_idx
 CREATE INDEX IF NOT EXISTS entity_discussion_comments_user_idx
   ON entity_discussion_comments(created_by_user_id);
 
+ALTER TABLE life_tags
+  ADD COLUMN IF NOT EXISTS is_rateable boolean NOT NULL DEFAULT false;
+
+CREATE TABLE IF NOT EXISTS game_versions (
+  id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  name text NOT NULL UNIQUE,
+  change_log text NOT NULL DEFAULT '',
+  sort_order integer NOT NULL DEFAULT 0 CHECK (sort_order >= 0),
+  created_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
+  updated_by_user_id integer REFERENCES users(id) ON DELETE SET NULL,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS game_versions_sort_order_idx
+  ON game_versions(sort_order, id);
+
 ALTER TABLE life_posts
   ADD COLUMN IF NOT EXISTS ai_moderation_status text NOT NULL DEFAULT 'unreviewed' CHECK (ai_moderation_status IN ('unreviewed', 'reviewing', 'approved', 'rejected', 'failed')),
   ADD COLUMN IF NOT EXISTS category_id integer REFERENCES life_tags(id) ON DELETE RESTRICT,
+  ADD COLUMN IF NOT EXISTS game_version_id integer REFERENCES game_versions(id) ON DELETE SET NULL,
   ADD COLUMN IF NOT EXISTS ai_moderation_language_code text REFERENCES languages(code) ON DELETE SET NULL,
   ADD COLUMN IF NOT EXISTS ai_moderation_content_hash text,
   ADD COLUMN IF NOT EXISTS ai_moderation_checked_at timestamptz,
@@ -928,6 +988,25 @@ CREATE INDEX IF NOT EXISTS life_posts_category_idx
   ON life_posts(category_id, created_at DESC, id DESC)
   WHERE deleted_at IS NULL;
 
+CREATE INDEX IF NOT EXISTS life_posts_game_version_idx
+  ON life_posts(game_version_id, created_at DESC, id DESC)
+  WHERE deleted_at IS NULL;
+
+CREATE TABLE IF NOT EXISTS life_post_ratings (
+  post_id integer NOT NULL REFERENCES life_posts(id) ON DELETE CASCADE,
+  user_id integer NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  rating integer NOT NULL CHECK (rating BETWEEN 1 AND 5),
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now(),
+  PRIMARY KEY (post_id, user_id)
+);
+
+CREATE INDEX IF NOT EXISTS life_post_ratings_post_idx
+  ON life_post_ratings(post_id, rating);
+
+CREATE INDEX IF NOT EXISTS life_post_ratings_user_idx
+  ON life_post_ratings(user_id, updated_at DESC, post_id DESC);
+
 ALTER TABLE life_post_comments
   ADD COLUMN IF NOT EXISTS ai_moderation_status text NOT NULL DEFAULT 'unreviewed' CHECK (ai_moderation_status IN ('unreviewed', 'reviewing', 'approved', 'rejected', 'failed')),
   ADD COLUMN IF NOT EXISTS ai_moderation_language_code text REFERENCES languages(code) ON DELETE SET NULL,

backend/src/queries.ts

@@ -38,7 +38,8 @@ type EntityType =
   | 'maps'
   | 'habitats'
   | 'daily-checklist-items'
-  | 'life-tags';
+  | 'life-tags'
+  | 'game-versions';
 
 type ConfigType =
   | 'pokemon-types'
@@ -49,13 +50,16 @@ type ConfigType =
   | 'item-usages'
   | 'acquisition-methods'
   | 'maps'
-  | 'life-tags';
+  | 'life-tags'
+  | 'game-versions';
 
 type ConfigDefinition = {
   table: string;
   entityType: EntityType;
   hasItemDrop?: boolean;
   hasDefault?: boolean;
+  hasRateable?: boolean;
+  hasChangeLog?: boolean;
 };
 type SortableContentType = 'pokemon' | 'items' | 'recipes' | 'habitats';
 type SortableContentDefinition = {
@@ -180,6 +184,7 @@ type DailyChecklistPayload = {
 type LifePostPayload = {
   body: string;
   categoryId: number;
+  gameVersionId: number | null;
   languageCode: string | null;
 };
 
@@ -251,7 +256,10 @@ type LifePostRow = {
   updatedAt: Date;
   author: { id: number; displayName: string } | null;
   updatedBy: { id: number; displayName: string } | null;
-  category: { id: number; name: string } | null;
+  category: { id: number; name: string; isRateable: boolean } | null;
+  gameVersion: { id: number; name: string; changeLog: string } | null;
+  ratingAverage: number | null;
+  ratingCount: number;
 };
 
 type LifePost = Omit<LifePostRow, 'createdAtCursor'> & {
@@ -259,13 +267,17 @@ type LifePost = Omit<LifePostRow, 'createdAtCursor'> & {
   commentCount: number;
   reactionCounts: LifeReactionCounts;
   myReaction: LifeReactionType | null;
+  myRating: number | null;
 };
 
 type LifePostCursor = {
   createdAt: string;
   id: number;
+  ratingAverage?: number;
 };
 
+type LifePostSort = 'latest' | 'oldest' | 'top-rated';
+
 type LifePostFilters = {
   authorId?: number;
 };
@@ -460,7 +472,8 @@ const configDefinitions: Record<ConfigType, ConfigDefinition> = {
   'item-usages': { table: 'item_usages', entityType: 'item-usages' },
   'acquisition-methods': { table: 'acquisition_methods', entityType: 'acquisition-methods' },
   maps: { table: 'maps', entityType: 'maps' },
-  'life-tags': { table: 'life_tags', entityType: 'life-tags', hasDefault: true }
+  'life-tags': { table: 'life_tags', entityType: 'life-tags', hasDefault: true, hasRateable: true },
+  'game-versions': { table: 'game_versions', entityType: 'game-versions', hasChangeLog: true }
 };
 
 const sortableContentDefinitions: Record<SortableContentType, SortableContentDefinition> = {
@@ -685,9 +698,16 @@ function optionSelect(
   return query(`SELECT o.id, ${name} AS name FROM ${tableName} o ORDER BY ${orderByEntity('o')}`);
 }
 
-function lifeCategoryOptions(locale: string): Promise<Array<{ id: number; name: string; isDefault: boolean }>> {
+function lifeCategoryOptions(locale: string): Promise<Array<{ id: number; name: string; isDefault: boolean; isRateable: boolean }>> {
   const name = localizedName('life-tags', 'lc', locale);
-  return query(`SELECT lc.id, ${name} AS name, lc.is_default AS "isDefault" FROM life_tags lc ORDER BY ${orderByEntity('lc')}`);
+  return query(
+    `SELECT lc.id, ${name} AS name, lc.is_default AS "isDefault", lc.is_rateable AS "isRateable" FROM life_tags lc ORDER BY ${orderByEntity('lc')}`
+  );
+}
+
+function gameVersionOptions(locale: string): Promise<Array<{ id: number; name: string; changeLog: string }>> {
+  const name = localizedName('game-versions', 'gv', locale);
+  return query(`SELECT gv.id, ${name} AS name, gv.change_log AS "changeLog" FROM game_versions gv ORDER BY ${orderByEntity('gv')}`);
 }
 
 function skillOptions(locale: string): Promise<Array<{ id: number; name: string; hasItemDrop: boolean }>> {
@@ -731,6 +751,12 @@ function configSelect(definition: ConfigDefinition, locale: string): string {
   if (definition.hasDefault) {
     columns.push(`c.is_default AS "isDefault"`);
   }
+  if (definition.hasRateable) {
+    columns.push(`c.is_rateable AS "isRateable"`);
+  }
+  if (definition.hasChangeLog) {
+    columns.push(`c.change_log AS "changeLog"`);
+  }
   return columns.join(', ');
 }
 
@@ -748,6 +774,14 @@ function requirePositiveInteger(value: unknown, message: string): number {
   return numberValue;
 }
 
+function optionalPositiveInteger(value: unknown, message: string): number | null {
+  if (value === undefined || value === null || value === '') {
+    return null;
+  }
+
+  return requirePositiveInteger(value, message);
+}
+
 function cleanName(value: unknown, message = 'server.validation.nameRequired'): string {
   if (typeof value !== 'string' || value.trim() === '') {
     throw validationError(message);
@@ -2056,7 +2090,8 @@ export async function getOptions(locale = defaultLocale) {
     itemUsages,
     acquisitionMethods,
     maps,
-    lifeCategories
+    lifeCategories,
+    gameVersions
   ] = await Promise.all([
     optionSelect('pokemon_types', 'pokemon-types', locale),
     skillOptions(locale),
@@ -2066,7 +2101,8 @@ export async function getOptions(locale = defaultLocale) {
     optionSelect('item_usages', 'item-usages', locale),
     optionSelect('acquisition_methods', 'acquisition-methods', locale),
     optionSelect('maps', 'maps', locale),
-    lifeCategoryOptions(locale)
+    lifeCategoryOptions(locale),
+    gameVersionOptions(locale)
   ]);
 
   return {
@@ -2079,7 +2115,8 @@ export async function getOptions(locale = defaultLocale) {
     acquisitionMethods,
     itemTags: favoriteThings,
     maps,
-    lifeCategories
+    lifeCategories,
+    gameVersions
   };
 }
 
@@ -2221,10 +2258,12 @@ function cleanLifePostPayload(payload: Record<string, unknown>): LifePostPayload
     throw validationError('server.validation.postTooLong');
   }
   const categoryId = requirePositiveInteger(payload.categoryId, 'server.validation.lifeCategoryRequired');
+  const gameVersionId = optionalPositiveInteger(payload.gameVersionId, 'server.validation.gameVersionInvalid');
 
   return {
     body,
     categoryId,
+    gameVersionId,
     languageCode: cleanModerationLanguageCode(payload.languageCode)
   };
 }
@@ -2268,6 +2307,15 @@ function cleanLifeReactionFilter(value: QueryValue): LifeReactionType | null {
   return cleanLifeReactionType(reactionType);
 }
 
+function cleanLifeRating(value: unknown): number {
+  const rating = Number(value);
+  if (!Number.isInteger(rating) || rating < 1 || rating > 5) {
+    throw validationError('server.validation.ratingInvalid');
+  }
+
+  return rating;
+}
+
 function cleanUserCommentActivitySourceFilter(value: QueryValue): UserCommentActivitySource | null {
   const source = asString(value);
   if (!source) {
@@ -2322,6 +2370,7 @@ function addModerationLanguageCondition(
 
 function lifePostProjection(locale = defaultLocale): string {
   const categoryName = localizedName('life-tags', 'lc', locale);
+  const gameVersionName = localizedName('game-versions', 'gv', locale);
 
   return `
     SELECT
@@ -2342,10 +2391,27 @@ function lifePostProjection(locale = defaultLocale): string {
       END AS "updatedBy",
       CASE
         WHEN lc.id IS NULL THEN NULL
-        ELSE json_build_object('id', lc.id, 'name', ${categoryName})
-      END AS category
+        ELSE json_build_object('id', lc.id, 'name', ${categoryName}, 'isRateable', lc.is_rateable)
+      END AS category,
+      CASE
+        WHEN gv.id IS NULL THEN NULL
+        ELSE json_build_object('id', gv.id, 'name', ${gameVersionName}, 'changeLog', gv.change_log)
+      END AS "gameVersion",
+      CASE
+        WHEN rating_stats.rating_count = 0 THEN NULL
+        ELSE rating_stats.rating_average::double precision
+      END AS "ratingAverage",
+      rating_stats.rating_count AS "ratingCount"
     FROM life_posts lp
     LEFT JOIN life_tags lc ON lc.id = lp.category_id
+    LEFT JOIN game_versions gv ON gv.id = lp.game_version_id
+    LEFT JOIN LATERAL (
+      SELECT
+        ROUND(AVG(lpr.rating)::numeric, 2) AS rating_average,
+        COUNT(*)::integer AS rating_count
+      FROM life_post_ratings lpr
+      WHERE lpr.post_id = lp.id
+    ) rating_stats ON true
     LEFT JOIN users created_user ON created_user.id = lp.created_by_user_id
     LEFT JOIN users updated_user ON updated_user.id = lp.updated_by_user_id
   `;
@@ -2361,6 +2427,22 @@ function cleanLifePostLimit(value: QueryValue): number {
   return Number.isInteger(limit) && limit > 0 ? Math.min(limit, maxLifePostLimit) : defaultLifePostLimit;
 }
 
+function cleanLifePostSort(value: QueryValue): LifePostSort {
+  const sort = asString(value);
+  return sort === 'oldest' || sort === 'top-rated' ? sort : 'latest';
+}
+
+function cleanRateableFilter(value: QueryValue): boolean | null {
+  const rateable = asString(value);
+  if (rateable === 'true') {
+    return true;
+  }
+  if (rateable === 'false') {
+    return false;
+  }
+  return null;
+}
+
 function cleanCommentLimit(value: QueryValue): number {
   const rawLimit = asString(value);
   if (rawLimit === undefined || rawLimit === '') {
@@ -2381,12 +2463,19 @@ function decodeLifePostCursor(value: QueryValue): LifePostCursor | null {
     const cursor = JSON.parse(Buffer.from(rawCursor, 'base64url').toString('utf8')) as Partial<LifePostCursor>;
     const createdAt = typeof cursor.createdAt === 'string' ? cursor.createdAt : '';
     const id = Number(cursor.id);
+    const ratingAverage = cursor.ratingAverage === undefined ? undefined : Number(cursor.ratingAverage);
 
-    if (!createdAt || Number.isNaN(new Date(createdAt).getTime()) || !Number.isInteger(id) || id <= 0) {
+    if (
+      !createdAt ||
+      Number.isNaN(new Date(createdAt).getTime()) ||
+      !Number.isInteger(id) ||
+      id <= 0 ||
+      (ratingAverage !== undefined && (Number.isNaN(ratingAverage) || ratingAverage < 0))
+    ) {
       throw validationError('server.validation.cursorInvalid');
     }
 
-    return { createdAt, id };
+    return { createdAt, id, ratingAverage };
   } catch (error) {
     if (error instanceof Error && 'statusCode' in error) {
       throw error;
@@ -2396,7 +2485,10 @@ function decodeLifePostCursor(value: QueryValue): LifePostCursor | null {
 }
 
 function encodeLifePostCursor(post: LifePostRow): string {
-  return Buffer.from(JSON.stringify({ createdAt: post.createdAtCursor, id: post.id }), 'utf8').toString('base64url');
+  return Buffer.from(
+    JSON.stringify({ createdAt: post.createdAtCursor, id: post.id, ratingAverage: post.ratingAverage ?? 0 }),
+    'utf8'
+  ).toString('base64url');
 }
 
 function encodeProfileCursor(cursor: LifePostCursor): string {
@@ -2443,7 +2535,8 @@ function hydrateLifePost(
   commentPreviewByPost: Map<number, LifeComment[]>,
   commentCountsByPost: Map<number, number>,
   countsByPost: Map<number, LifeReactionCounts>,
-  myReactionsByPost: Map<number, LifeReactionType>
+  myReactionsByPost: Map<number, LifeReactionType>,
+  myRatingsByPost: Map<number, number>
 ): LifePost {
   return {
     id: post.id,
@@ -2455,10 +2548,14 @@ function hydrateLifePost(
     author: post.author,
     updatedBy: post.updatedBy,
     category: post.category,
+    gameVersion: post.gameVersion,
+    ratingAverage: post.ratingAverage,
+    ratingCount: post.ratingCount,
     commentPreview: commentPreviewByPost.get(post.id) ?? [],
     commentCount: commentCountsByPost.get(post.id) ?? 0,
     reactionCounts: countsByPost.get(post.id) ?? emptyLifeReactionCounts(),
-    myReaction: myReactionsByPost.get(post.id) ?? null
+    myReaction: myReactionsByPost.get(post.id) ?? null,
+    myRating: myRatingsByPost.get(post.id) ?? null
   };
 }
 
@@ -2740,6 +2837,30 @@ async function lifeReactionsForPosts(
   return { countsByPost, myReactionsByPost };
 }
 
+async function lifeRatingsForPosts(postIds: number[], userId: number | null): Promise<Map<number, number>> {
+  const myRatingsByPost = new Map<number, number>();
+
+  if (postIds.length === 0 || userId === null) {
+    return myRatingsByPost;
+  }
+
+  const rows = await query<{ postId: number; rating: number }>(
+    `
+      SELECT post_id AS "postId", rating
+      FROM life_post_ratings
+      WHERE post_id = ANY($1::integer[])
+        AND user_id = $2
+    `,
+    [postIds, userId]
+  );
+
+  for (const row of rows) {
+    myRatingsByPost.set(row.postId, row.rating);
+  }
+
+  return myRatingsByPost;
+}
+
 async function getLifeCommentById(id: number): Promise<LifeComment | null> {
   const row = await queryOne<LifeCommentRow>(
     `
@@ -2765,8 +2886,11 @@ async function listLifePostsWithFilters(
 ): Promise<LifePostsPage> {
   const cursor = decodeLifePostCursor(paramsQuery.cursor);
   const limit = cleanLifePostLimit(paramsQuery.limit);
+  const sort = cleanLifePostSort(paramsQuery.sort);
   const search = asString(paramsQuery.search)?.trim();
   const categoryIdValue = asString(paramsQuery.categoryId)?.trim();
+  const gameVersionIdValue = asString(paramsQuery.gameVersionId)?.trim();
+  const rateable = cleanRateableFilter(paramsQuery.rateable);
   const languageCode = cleanModerationLanguageFilter(paramsQuery.language);
   const params: unknown[] = [];
   const conditions: string[] = ['lp.deleted_at IS NULL'];
@@ -2790,18 +2914,42 @@ async function listLifePostsWithFilters(
     conditions.push(`lp.category_id = $${params.length}`);
   }
 
-  if (cursor) {
-    params.push(cursor.createdAt, cursor.id);
-    conditions.push(`(lp.created_at, lp.id) < ($${params.length - 1}::timestamptz, $${params.length}::integer)`);
+  if (gameVersionIdValue && gameVersionIdValue !== 'all') {
+    const gameVersionId = requirePositiveInteger(gameVersionIdValue, 'server.validation.gameVersionInvalid');
+    params.push(gameVersionId);
+    conditions.push(`lp.game_version_id = $${params.length}`);
   }
 
+  if (rateable !== null) {
+    params.push(rateable);
+    conditions.push(`lc.is_rateable = $${params.length}`);
+  }
+
+  if (cursor) {
+    if (sort === 'top-rated') {
+      params.push(cursor.ratingAverage ?? 0, cursor.createdAt, cursor.id);
+      conditions.push(
+        `(COALESCE(rating_stats.rating_average, 0), lp.created_at, lp.id) < ($${params.length - 2}::numeric, $${params.length - 1}::timestamptz, $${params.length}::integer)`
+      );
+    } else {
+      params.push(cursor.createdAt, cursor.id);
+      conditions.push(
+        `(lp.created_at, lp.id) ${sort === 'oldest' ? '>' : '<'} ($${params.length - 1}::timestamptz, $${params.length}::integer)`
+      );
+    }
+  }
+
+  const orderClause =
+    sort === 'top-rated'
+      ? 'ORDER BY COALESCE(rating_stats.rating_average, 0) DESC, lp.created_at DESC, lp.id DESC'
+      : `ORDER BY lp.created_at ${sort === 'oldest' ? 'ASC' : 'DESC'}, lp.id ${sort === 'oldest' ? 'ASC' : 'DESC'}`;
   const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
   params.push(limit + 1);
   const rows = await query<LifePostRow>(
     `
       ${lifePostProjection(locale)}
       ${whereClause}
-      ORDER BY lp.created_at DESC, lp.id DESC
+      ${orderClause}
       LIMIT $${params.length}
     `,
     params
@@ -2813,9 +2961,12 @@ async function listLifePostsWithFilters(
   const commentPreviewByPost = await lifeCommentPreviewForPosts(postIds, userId, canViewAll);
   const commentCountsByPost = await lifeCommentCountsForPosts(postIds, userId, canViewAll);
   const { countsByPost, myReactionsByPost } = await lifeReactionsForPosts(postIds, userId);
+  const myRatingsByPost = await lifeRatingsForPosts(postIds, userId);
 
   return {
-    items: posts.map((post) => hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost)),
+    items: posts.map((post) =>
+      hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost, myRatingsByPost)
+    ),
     nextCursor: hasMore && posts.length > 0 ? encodeLifePostCursor(posts[posts.length - 1]) : null,
     hasMore
   };
@@ -2975,9 +3126,10 @@ async function hydrateLifePostsById(
   const commentPreviewByPost = await lifeCommentPreviewForPosts(postIds, viewerUserId, canViewAll);
   const commentCountsByPost = await lifeCommentCountsForPosts(postIds, viewerUserId, canViewAll);
   const { countsByPost, myReactionsByPost } = await lifeReactionsForPosts(postIds, viewerUserId);
+  const myRatingsByPost = await lifeRatingsForPosts(postIds, viewerUserId);
 
   for (const post of posts) {
-    postById.set(post.id, hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost));
+    postById.set(post.id, hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost, myRatingsByPost));
   }
 
   return postById;
@@ -3223,7 +3375,8 @@ async function getLifePostById(id: number, userId: number | null = null, locale
   const commentPreviewByPost = await lifeCommentPreviewForPosts([post.id], userId, false);
   const commentCountsByPost = await lifeCommentCountsForPosts([post.id], userId, false);
   const { countsByPost, myReactionsByPost } = await lifeReactionsForPosts([post.id], userId);
-  return hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost);
+  const myRatingsByPost = await lifeRatingsForPosts([post.id], userId);
+  return hydrateLifePost(post, commentPreviewByPost, commentCountsByPost, countsByPost, myReactionsByPost, myRatingsByPost);
 }
 
 async function ensureLifeCategory(client: DbClient, categoryId: number): Promise<void> {
@@ -3233,6 +3386,17 @@ async function ensureLifeCategory(client: DbClient, categoryId: number): Promise
   }
 }
 
+async function ensureGameVersion(client: DbClient, gameVersionId: number | null): Promise<void> {
+  if (gameVersionId === null) {
+    return;
+  }
+
+  const result = await client.query<{ id: number }>('SELECT id FROM game_versions WHERE id = $1', [gameVersionId]);
+  if (result.rowCount === 0) {
+    throw validationError('server.validation.gameVersionInvalid');
+  }
+}
+
 async function replaceLifePostCategoryLink(client: DbClient, postId: number, categoryId: number): Promise<void> {
   await client.query('DELETE FROM life_post_tags WHERE post_id = $1', [postId]);
   await client.query(
@@ -3249,13 +3413,22 @@ export async function createLifePost(payload: Record<string, unknown>, userId: n
 
   const id = await withTransaction(async (client) => {
     await ensureLifeCategory(client, cleanPayload.categoryId);
+    await ensureGameVersion(client, cleanPayload.gameVersionId);
     const result = await client.query<{ id: number }>(
       `
-        INSERT INTO life_posts (body, category_id, ai_moderation_status, ai_moderation_language_code, created_by_user_id, updated_by_user_id)
-        VALUES ($1, $2, 'reviewing', NULL, $3, $3)
+        INSERT INTO life_posts (
+          body,
+          category_id,
+          game_version_id,
+          ai_moderation_status,
+          ai_moderation_language_code,
+          created_by_user_id,
+          updated_by_user_id
+        )
+        VALUES ($1, $2, $3, 'reviewing', NULL, $4, $4)
         RETURNING id
       `,
-      [cleanPayload.body, cleanPayload.categoryId, userId]
+      [cleanPayload.body, cleanPayload.categoryId, cleanPayload.gameVersionId, userId]
     );
 
     const createdId = result.rows[0].id;
@@ -3278,25 +3451,27 @@ export async function updateLifePost(
 
   const updatedId = await withTransaction(async (client) => {
     await ensureLifeCategory(client, cleanPayload.categoryId);
+    await ensureGameVersion(client, cleanPayload.gameVersionId);
     const result = await client.query<{ id: number }>(
       `
         UPDATE life_posts
         SET body = $1,
             category_id = $2,
+            game_version_id = $3,
             ai_moderation_status = 'reviewing',
             ai_moderation_language_code = NULL,
             ai_moderation_content_hash = NULL,
             ai_moderation_checked_at = NULL,
             ai_moderation_retry_count = 0,
             ai_moderation_updated_at = now(),
-            updated_by_user_id = $3,
+            updated_by_user_id = $4,
             updated_at = now()
-        WHERE id = $4
-          AND ($5 = true OR created_by_user_id = $3)
+        WHERE id = $5
+          AND ($6 = true OR created_by_user_id = $4)
           AND deleted_at IS NULL
         RETURNING id
       `,
-      [cleanPayload.body, cleanPayload.categoryId, userId, id, allowAny]
+      [cleanPayload.body, cleanPayload.categoryId, cleanPayload.gameVersionId, userId, id, allowAny]
     );
 
     const resultId = result.rows[0]?.id ?? null;
@@ -3408,6 +3583,57 @@ export async function deleteLifePostReaction(postId: number, userId: number, loc
   return getLifePostById(postId, userId, locale);
 }
 
+export async function setLifePostRating(
+  postId: number,
+  payload: Record<string, unknown>,
+  userId: number,
+  locale = defaultLocale
+) {
+  const rating = cleanLifeRating(payload.rating);
+
+  const result = await queryOne<{ postId: number }>(
+    `
+      INSERT INTO life_post_ratings (post_id, user_id, rating)
+      SELECT $1, $2, $3
+      FROM life_posts lp
+      JOIN life_tags lt ON lt.id = lp.category_id
+      WHERE lp.id = $1
+        AND lp.deleted_at IS NULL
+        AND lp.ai_moderation_status = 'approved'
+        AND lt.is_rateable = true
+      ON CONFLICT (post_id, user_id)
+      DO UPDATE SET rating = EXCLUDED.rating, updated_at = now()
+      RETURNING post_id AS "postId"
+    `,
+    [postId, userId, rating]
+  );
+
+  return result ? getLifePostById(result.postId, userId, locale) : null;
+}
+
+export async function deleteLifePostRating(postId: number, userId: number, locale = defaultLocale) {
+  const result = await queryOne<{ postId: number }>(
+    `
+      DELETE FROM life_post_ratings
+      WHERE post_id = $1
+        AND user_id = $2
+        AND EXISTS (
+          SELECT 1
+          FROM life_posts lp
+          JOIN life_tags lt ON lt.id = lp.category_id
+          WHERE lp.id = $1
+            AND lp.deleted_at IS NULL
+            AND lp.ai_moderation_status = 'approved'
+            AND lt.is_rateable = true
+        )
+      RETURNING post_id AS "postId"
+    `,
+    [postId, userId]
+  );
+
+  return result ? getLifePostById(postId, userId, locale) : null;
+}
+
 export async function createLifeComment(postId: number, payload: Record<string, unknown>, userId: number) {
   const cleanPayload = cleanLifeCommentPayload(payload);
 
@@ -3889,6 +4115,8 @@ export async function createConfig(type: ConfigType, payload: Record<string, unk
   const translations = cleanTranslations(payload.translations, ['name']);
   const hasItemDrop = definition.hasItemDrop ? Boolean(payload.hasItemDrop) : false;
   const isDefault = definition.hasDefault ? Boolean(payload.isDefault) : false;
+  const isRateable = definition.hasRateable ? Boolean(payload.isRateable) : false;
+  const changeLog = definition.hasChangeLog ? cleanOptionalText(payload.changeLog) : '';
 
   const id = await withTransaction(async (client) => {
     const sortOrder = await nextSortOrder(client, definition.table);
@@ -3908,6 +4136,14 @@ export async function createConfig(type: ConfigType, payload: Record<string, unk
       columns.push('is_default');
       values.push(isDefault);
     }
+    if (definition.hasRateable) {
+      columns.push('is_rateable');
+      values.push(isRateable);
+    }
+    if (definition.hasChangeLog) {
+      columns.push('change_log');
+      values.push(changeLog);
+    }
     columns.push('sort_order', 'created_by_user_id', 'updated_by_user_id');
     values.push(sortOrder, userId, userId);
     const placeholders = values.map((_, index) => `$${index + 1}`).join(', ');
@@ -3955,6 +4191,8 @@ export async function updateConfig(
   const translations = cleanTranslations(payload.translations, ['name']);
   const hasItemDrop = definition.hasItemDrop ? Boolean(payload.hasItemDrop) : false;
   const isDefault = definition.hasDefault ? Boolean(payload.isDefault) : false;
+  const isRateable = definition.hasRateable ? Boolean(payload.isRateable) : false;
+  const changeLog = definition.hasChangeLog ? cleanOptionalText(payload.changeLog) : '';
 
   const updated = await withTransaction(async (client) => {
     if (definition.hasDefault && isDefault) {
@@ -3974,6 +4212,14 @@ export async function updateConfig(
       values.push(isDefault);
       assignments.push(`is_default = $${values.length}`);
     }
+    if (definition.hasRateable) {
+      values.push(isRateable);
+      assignments.push(`is_rateable = $${values.length}`);
+    }
+    if (definition.hasChangeLog) {
+      values.push(changeLog);
+      assignments.push(`change_log = $${values.length}`);
+    }
     values.push(userId);
     assignments.push(`updated_by_user_id = $${values.length}`, 'updated_at = now()');
     values.push(id);

backend/src/server.ts

@@ -55,6 +55,7 @@ import {
   deleteLanguage,
   deleteLifeComment,
   deleteLifePost,
+  deleteLifePostRating,
   deleteLifePostReaction,
   deletePokemon,
   deleteRecipe,
@@ -91,6 +92,7 @@ import {
   retryEntityDiscussionCommentModeration,
   retryLifeCommentModeration,
   retryLifePostModeration,
+  setLifePostRating,
   setLifePostReaction,
   updateConfig,
   updateDailyChecklistItem,
@@ -920,6 +922,26 @@ app.delete('/api/life-posts/:id/reaction', async (request, reply) => {
   return post ? post : notFound(reply, request);
 });
 
+app.put('/api/life-posts/:id/rating', async (request, reply) => {
+  const user = await requirePermissionWithRateLimits(request, reply, 'life.ratings.set', 'communityReaction');
+  if (!user) {
+    return;
+  }
+  const { id } = request.params as { id: string };
+  const post = await setLifePostRating(Number(id), request.body as Record<string, unknown>, user.id, requestLocale(request));
+  return post ? post : notFound(reply, request);
+});
+
+app.delete('/api/life-posts/:id/rating', async (request, reply) => {
+  const user = await requirePermissionWithRateLimits(request, reply, 'life.ratings.set', 'communityReaction');
+  if (!user) {
+    return;
+  }
+  const { id } = request.params as { id: string };
+  const post = await deleteLifePostRating(Number(id), user.id, requestLocale(request));
+  return post ? post : notFound(reply, request);
+});
+
 app.delete('/api/life-posts/:id', async (request, reply) => {
   const user = await requireAnyPermissionWithRateLimits(
     request,