FruitServer/docs/plans/2026-10-21-K93-drama-multi-tag.md

K93 短剧类型与内容类型支持多选

目标

• 后台短剧基础信息中的「类型」「内容类型」改为至少选一项的多选。
• 后台列表筛选、列表展示支持多分类与多内容类型。
• App 分类分区和内容类型 feed 使用多标签字段做整词匹配。
• 单值字段继续保留，兼容创作者中心、旧接口和现有 App 卡片。

分支

• FruitServer：feat/k93-drama-multi-tag，从 origin/develop 创建。
• ReelShortWeb：feat/k93-drama-multi-tag-ui，从 origin/develop 创建。

A. FruitServer

A1 数据库

• 新增 sql/migrate-k93-drama-multi-tag.sql：
  • drama.drama_types VARCHAR(32) NOT NULL DEFAULT ''
  • drama.category_ids VARCHAR(255) NOT NULL DEFAULT ''
  • 从现有 drama_type / category_id 幂等回填。
• 同步 sql/schema.sql 的 drama 建表字段。
• 只提交迁移文件，不执行数据库。

A2 实体与 VO

• Drama：增加 dramaTypes/categoryIds 逗号字符串。
• DramaSaveReqVO：
  • 新增 List<String> dramaTypes、List<Long> categoryIds，列表优先。
  • 保留 dramaType/categoryId 单值兜底。
• DramaPageReqVO：增加 List<Long> categoryIds，保留 categoryId。
• DramaRespVO：增加 dramaTypes/categoryIds/categoryNames，旧单值字段语义不变。

A3 保存规则

• 内容类型列表：normalize、去重、保持提交顺序；主值写第一个，完整列表写 drama_types。
• 分类列表：过滤 null/非正数、去重、保持提交顺序；主值写第一个或 0，完整列表写 category_ids。
• 列表为空时回退单值；单值也没有时保留当前值。
• 创建时内容类型最终为空则默认 LIVE。
• 非法内容类型继续返回 BAD_REQUEST。

A4 查询规则

统一使用整词匹配：

(',' || column || ',') LIKE '%,value,%'

• 后台分页：
  • dramaTypes 非空：drama_types token 匹配。
  • categoryIds 非空：category_ids token 匹配。
  • categoryIds 为空：回退 category_id 等值。
• App listPublishedFeed：drama_types token 匹配。
• App feed 游标：marker 的解析后 dramaTypes 与任一筛选类型相交才允许继续。
• App listPublished(categoryId)：category_ids token 匹配，使多分类剧出现在每个分类分区。

A5 响应装配

• 解析 drama_types/category_ids，空值回退单值。
• categoryNames 按 categoryIds 顺序映射分类名。
• 分类名缺失时回退 genre。
• 现有 dramaType/categoryId/category 保持旧语义。

A6 文档与测试

• 更新 docs/api-phase1.md 的后台保存/分页字段、App feed 和分类说明。
• 增加服务测试覆盖：
  • 多类型/多分类去重、顺序与主值写回。
  • 单值兜底行为不变。
  • 后台分页 token 条件。
  • feed 多标签 marker 可被 ANIME/LIVE 命中。
  • App 分类分区 token 条件。
  • 响应多值解析和分类名顺序。
• 门禁：mvn test 全模块通过。

B. ReelShortWeb

B1 类型

• DramaItem 增加 dramaTypes/categoryIds/categoryNames。
• DramaSaveData 增加 dramaTypes/categoryIds。
• DramaPageParams 增加 categoryIds。

B2 表单

• form.categoryIds: number[]，默认空数组。
• form.dramaTypes: string[]，创建默认 ['LIVE']。
• 两个下拉均使用 multiple、collapse-tags、collapse-tags-tooltip、filterable。
• 校验至少 1 项。
• 编辑时优先数组，缺失回退单值。
• 提交数组；genre 使用所选分类名以 / 拼接。

B3 筛选与表格

• 分类筛选改为 categoryIds: number[]。
• 内容类型筛选改为 dramaTypes: string[]。
• 查询传数组，重置为空数组。
• 类型列显示 categoryNames.join(' / ')，回退 genre。
• 内容类型列逐个渲染标签，缺失时回退 dramaType。

B4 门禁

• pnpm ts:check
• pnpm build:dev
• 对修改文件执行定向 ESLint

风险与说明

1. 新代码依赖迁移后的 drama_types/category_ids 列，发布顺序必须先执行迁移再启动新版本。
2. 逗号列仅存储受控内容类型和数字 id，不允许用户输入；查询值均来自校验后的数组。
3. 主值继续保留，降低旧客户端、创作者中心和旧接口的兼容风险。
4. 本次不改 specs 与 Flutter 客户端，不执行数据库迁移，不操作真机。

Git

• FruitServer：feat(content): 短剧类型与内容类型支持多选
• ReelShortWeb：feat(admin): 短剧类型与内容类型多选
• 两仓库均 --no-ff 合回 develop 并 push。
• 作者：Zhou Weidong <502333560@qq.com>；禁止 git add -A。