 Vicky
|
5ce6de1e3b
|
Merge remote-tracking branch 'origin/main'
|
2026-10-16 10:51:15 +08:00 |
|
|
Vicky
|
c6fcfcc6ea
|
docs(backend): S1 接口文档在线化——补 springdoc 配置 + 39 个 Controller 中文注解
为什么：前端联调依赖在线接口文档。S1 条目要求两个端口的 /v3/api-docs 能看、
且每个接口有中文分组与中文 summary。
诊断（与 PM 初步定位不同，有硬证据）：app-api 的 /v3/api-docs、/doc.html、/、
/error 全部"挂住"（8s 超时 0 字节），根因不是 Spring Security 拦截，而是
运行中的进程握着一个被重新打包替换掉的旧 jar——spring-boot:repackage 把原 fat jar
原地改名为 .jar.original（同一 inode）再写新 jar，进程再去加载"启动后未加载过的类"
就必然 NoClassDefFoundError（日志里连 logback 的 ThrowableProxy 都加载不到），
线程直接死掉、既不响应也记不了日志。SecurityConfig.PUBLIC_PATHS 本来就包含
/doc.html、/swagger-ui/**、/v3/api-docs/**，未改任何安全配置。
- app-api 的 application.yml 补 springdoc.swagger-ui.path: /doc.html
- 39 个 Controller（app-api 10 + admin-api 29）补 @Tag(name=中文分组)
与 @Operation(summary=中文描述)，共 172 个接口；描述取自 api-phase1.md 与既有 Javadoc
- 两个入口类加 @OpenAPIDefinition：文档标题 + 顶层 tags 清单（springdoc 默认顶层 tags 为空）
- 纯新增 357 行、删除 0 行：业务逻辑、路径、字段零改动
- 实测：mvn test 37 条契约测试全过；两个入口 package BUILD SUCCESS；
两端口 /v3/api-docs 中文 tags + 中文 summary，/doc.html 可打开，
非白名单路径 5ms 内返回 {"code":401,...} 不再挂住
|
2026-10-16 10:44:37 +08:00 |
|
|
Zhou Weidong
|
66e6fc1555
|
feat: app-api 启用 Swagger 在线接口文档 (springdoc /doc.html)
|
2026-10-16 10:13:47 +08:00 |
|
|
Vicky
|
37c9a141d3
|
feat: S0 主键改雪花（DDL 去 identity + 实体 ASSIGN_ID + 雪花配置）
为什么：自增主键把 ID 分配锁在单库序列上，分库分表时无法横向扩展。趁线上业务数据
近零（只有系统种子表有量）先改，代价最低。
- sql/schema.sql、sql/schema-phase1.sql、sql/partition-maintenance.sql：61 处
GENERATED BY DEFAULT AS IDENTITY 去掉，主键改 BIGINT 无默认值
- 52 个实体 @TableId IdType.AUTO -> IdType.ASSIGN_ID；两个入口 id-type: assign_id，
并加 global-config.sequence.worker-id/datacenter-id（单机固定值，多实例需按实例分配）
- 新增 sql/migrate-s0-snowflake.sql：存量库幂等迁移，走 DROP IDENTITY 保留数据，不重建表
- 实测：三份建表脚本在新库连跑两遍幂等；线上 57 张表 identity 归零；
watch_history/playback_ticket/order_event 的主键与唯一索引仍含分区键
|
2026-10-16 09:00:38 +08:00 |
|
|
Zhou Weidong
|
35be37c193
|
style: 全量补充作者标识 // Author: fruit.com.cn
|
2026-10-16 00:01:53 +08:00 |
|
|
Vicky
|
af1dc48494
|
feat: 06 互动与内容治理落地（评论 / 点赞 / 举报 / 敏感词 / 审核留证）
为什么：
1) 产品侧要先把内容治理闭环跑通才能谈上线：评论可发布、可翻页、可删除，
违规内容能在后台被审核与驳回，举报要有工单可追溯。本提交把这套补齐。
2) 审核不能只靠人肉：敏感词按 BLOCK/REPLACE/REVIEW 三档处置，
机审通过即发布（可配置为 PRE_REVIEW 全部先审后发），人审与机审的结论
都写进 content_audit_record，争议时可回答"当时凭什么放行/驳回"。
3) 举报处理必须与处置打通：结论成立会联动驳回被举报评论，并可选同时封禁被举报用户，
避免"工单处理完了但违规内容还挂着"。
4) 顺带修复一个真实缺陷：user_favorite / content_like 上有唯一索引，而全局配置会把
deleteById 改写成逻辑删除，导致取消收藏/点赞后旧的 deleted 行仍占位，
再次收藏或点赞直接撞唯一索引报错。关系类数据没有留证价值，改为显式物理删除，
并补了"取消后再来一次"的回归自测。
|
2026-10-15 12:03:32 +08:00 |
|
|
Vicky
|
b3179fc836
|
refactor: 后端标识统一为 FruitShorts，并落地 05 离线下载
为什么：
1) 产品已定名 FruitShorts，但后端仍是 reelshort 系列标识 —— Java 包 com.reelshort、
模块名与 jar 名 reelshort-*、spring.application.name、配置前缀 reelshort.*，
这些会出现在启动日志、命令行和 IDE 里，与产品名不一致。本次整体替换为 fruitshorts，
数据库连接名上一轮已改名，保持不变。
2) 第一阶段下一批第 1 步（05 离线下载）要求把下载授权（设备绑定/有效期/吊销）、
下载任务与断点续传、配额与过期清理、仅 Wi-Fi 规则做成完整接口，本提交一并落地。
3) 顺带修复：schema-phase1.sql 里 playback_ticket / order_event 仍按普通表定义唯一索引，
表分区化之后重跑脚本必定报错（分区表的唯一索引必须包含分区键）。改为在本脚本里就
按分区表定义，并验证脚本可重复执行。
|
2026-10-15 11:44:26 +08:00 |
|