实现网站游戏评分与评价

新增游戏唯一评分评价私有表、事务保存与公共分页统计
接入个人评价读取保存接口并同步前后端契约及生成绑定
在网站详情页实现评分评论、编辑取消、字数统计和请求隔离
补齐定向测试、真实数据库接口验收脚本及文档证据

packages/shared/src/contracts/gameDistribution.ts

@@ -41,6 +41,44 @@ export type GameDistributionAuthor = {
   avatarUrl?: string | null;
 };
 
+export type GameDistributionReview = {
+  id: string;
+  gameId: string;
+  author: GameDistributionAuthor;
+  score: number;
+  comment: string;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type GameDistributionRatingSummary = {
+  averageScore: number | null;
+  ratingCount: number;
+};
+
+export type GameDistributionReviewsResponse = {
+  reviews: GameDistributionReview[];
+  page: number;
+  pageSize: number;
+  total: number;
+  totalPages: number;
+  ratingSummary: GameDistributionRatingSummary;
+};
+
+export type GameDistributionMyReviewResponse = {
+  review: GameDistributionReview | null;
+};
+
+export type GameDistributionSaveReviewRequest = {
+  score: number;
+  comment?: string;
+};
+
+export type GameDistributionSaveReviewResponse = {
+  review: GameDistributionReview;
+  ratingSummary: GameDistributionRatingSummary;
+};
+
 export type GameDistributionVersionStatus =
   | 'awaiting_upload'
   | 'uploaded'