Kavita项目中的单卷/单章书评功能设计与实现

在数字阅读平台Kavita的最新开发计划中，团队正在为书籍/漫画用户设计一个更丰富的阅读体验功能——单卷(Volume)和单章(Chapter)级别的书评系统。这一功能将允许用户对作品的特定部分进行更细致的评价，而不仅仅局限于对整个系列的评价。

功能概述

传统的书评系统通常只允许用户对整个作品系列进行评价，这在处理多卷本作品时显得过于笼统。Kavita的新设计将书评功能细分为三个层次：

1. 系列评价：保留原有的整体系列评价功能，反映用户对整个系列的综合体验
2. 卷评价：针对特定卷(如单行本、合订本)的评价，会聚合该卷下所有章节的评价
3. 章节评价：最细粒度的评价单元，允许用户对单个章节进行评分和评论

数据库设计

为了实现这一功能，Kavita团队设计了以下数据库模型：

用户实体扩展

在现有的AppUser实体中，新增了一个ChapterRatings集合属性，用于关联用户对各个章节的评价记录：

public class AppUser {
  // 其他属性...
  public ICollection<AppUserChapterRating> ChapterRatings {get; set;} = null!;
}

章节评价实体

新增的AppUserChapterRating实体包含了详细的评价信息：

public class AppUserChapterRating {
  public int Id { get; set; }
  public float Rating { get; set; }          // 评分值
  public bool HasBeenRated { get; set; }     // 是否已评分
  public string? Review { get; set; }        // 评论文本
  public ScrobbleProvider Provider {get; set; } // 评价来源平台
  public bool IsCritic {get; set;}          // 是否为专业评论
  
  // 关联的系列信息
  public int SeriesId { get; set; }
  public Series Series { get; set; } = null!;
  
  // 关联的章节信息
  public int ChapterId { get; set; }
  public Chapter Chapter { get; set; } = null!;
  
  // 关联的卷信息
  public int VolumeId { get; set; }
  public Volume Volume { get; set; } = null!;
  
  // 关联的用户信息
  public int AppUserId { get; set; }
  public AppUser AppUser { get; set; } = null!;
}

功能实现细节

卷详情页设计

卷详情页将展示该卷下所有章节的评价内容。设计上会：

1. 自动聚合该卷下所有章节的评价
2. 对于单卷作品(如单行本、图书)，预期只有一个主要评价
3. 提供"添加评价"按钮，引导用户进入添加章节评价流程

章节详情页设计

章节详情页将提供：

1. 专门的"添加评价"按钮
2. 展示其他用户、自己的评价以及任何外部评价
3. 评价展示风格与系列详情页保持一致，保证用户体验的一致性

技术考量

1. 数据一致性：通过外键约束确保评价与系列、卷、章节的关联完整性
2. 性能优化：评价聚合查询需要考虑大数据量下的性能问题
3. 用户体验：保持不同层级评价界面的一致性，降低用户学习成本
4. 扩展性：设计时考虑了评价来源平台(Provider)和专业评论标志(IsCritic)，为未来功能扩展预留空间

应用场景

这一功能的典型使用场景包括：

1. 用户对漫画单行本中特定章节的精彩内容进行评价
2. 专业评论家对书籍某一卷的深度分析
3. 读者追踪同一系列不同卷的质量变化
4. 社区讨论特定章节的情节发展

通过这种细粒度的评价系统，Kavita能够为用户提供更精准的内容推荐，同时丰富社区互动体验。这一设计也体现了现代数字阅读平台向精细化、个性化方向发展的趋势。