DRAMA 融合短剧平台

开发规范整改方案 — P1/P2 实施落地报告 v1.0
基于 dev-standards.html 整改优先级 | 代码基线扫描日期: 2026-07-22 | 覆盖 5 项整改 · 预估 20.5h

当前代码基线快照

基于对源码库的实际扫描结果:

维度当前状态来源
JWT 有效期7 天 硬编码 7*24*60*60*1000,无 Refresh Token,无黑名单JwtUtil.java:35
测试覆盖3 个测试文件(UserServiceTest / ContentServiceTest / RiskServiceTest),覆盖率 < 5%src/test/
Git 远端无 remote 配置,无分支策略,无 CONTRIBUTING.md.git/config
审计日志仅 t_content_audit_log 覆盖内容审核,缺管理员/金币/配置变更CopyrightController.java:177
CI/CD无 CI 流水线,仅 docker-compose.ymldocker/

P1 整改项(优先级 1 — 1~2 周内完成)

P1-1 · JWT 缩短有效期 + Refresh Token + 黑名单 2h · 规范 R5.2 / R6.2

涉及文件

文件操作
drama-common/.../utils/JwtUtil.java修改
drama-common/.../utils/JwtRefreshUtil.java新建
drama-gateway/.../filter/JwtAuthFilter.java修改
drama-common/.../entity/RefreshToken.java新建

实施步骤

Step 1 — 缩短 Access Token,新增 Refresh Token

当前 JwtUtil.java:35:

private static final long EXPIRE = 7 * 24 * 60 * 60 * 1000L; // 7 天

修改为:

// Access Token: 2 小时
private static final long ACCESS_EXPIRE = 2 * 60 * 60 * 1000L;
// Refresh Token: 7 天(轮换制)
private static final long REFRESH_EXPIRE = 7 * 24 * 60 * 60 * 1000L;

Step 2 — 新增 Refresh 端点

POST /api/user/auth/refresh
Header: Authorization: Bearer <refresh_token>
→ 返回 { accessToken, refreshToken, expiresIn }

Step 3 — JwtAuthFilter Redis 黑名单

@Scheduled(fixedRate = 60_000)
public void refreshBlacklist() {
    blacklist = redisTemplate.opsForSet().members("jwt:blacklist");
}
if (blacklist.contains(token)) {
    return Mono.error(new UnauthorizedException("Token 已被吊销"));
}

Step 4 — 登出接口

POST /api/user/logout
→ 当前 Access Token + Refresh Token 加入 Redis 黑名单
P1-2 · 测试补齐(金币/支付/风控)8h · 规范 R6.2

当前仅 3 个测试文件,覆盖率 < 5%。

CoinServiceTest(新建)

场景验收条件
余额不足消费抛出 BizException
余额充足扣减余额正确减少
充值余额增加,流水记录
并发扣减10 线程并发,最终余额 ≥ 0

TradeServiceTest(新建)

场景验收条件
支付回调 — 重复通知返回 "success"
支付回调 — 正常流程订单状态变更 + 佣金计算

RiskServiceTest(追加)

场景期望评分区间
模拟器 + Root + Hook≥ 80(BLOCK)
正常设备0–49(PASS)
全风险维度组合遍历覆盖 0–49 / 50–79 / 80–100

验收标准

指标目标
新增测试用例≥ 20 个
代码行覆盖率≥ 50%(Jacoco)
P0 场景100% 覆盖
CI gatemvn test 必须通过
P1-3 · Commit 规范 + 分支策略 1h · 规范 R7.1 / R7.2

Step 1 — 配置远端仓库

git remote add origin <remote-url>

Step 2 — 分支策略

main                    ← 生产就绪,仅从 release/hotfix 合并
├── develop             ← 日常集成分支
├── feature/*           ← 功能分支,从 develop 拉取
├── release/*           ← 发布分支
└── hotfix/*            ← 紧急修复

Step 3 — CONTRIBUTING.md

必须使用 Conventional Commits:

feat(coin): 添加签到领取金币功能
fix(payment): 修复支付回调签名验证
docs(api): 补充商品卡片接口文档
refactor(user): 移除 SpreeClient
test(trade): 添加并发支付测试
chore(deps): 升级 spring-boot 至 3.2.6

P2 整改项(优先级 2 — 3~4 周内完成)

P2-1 · CI 流水线搭建 4h · 规范 R7.4

流水线阶段(GitLab CI)

stages:
  - lint      # mvn checkstyle:check
  - test      # mvn test + jacoco:report
  - security  # dependency-check
  - build     # mvn package
  - docker    # build + push(仅 main)

Dockerfile

FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
COPY target/*.jar app.jar
EXPOSE 810x
ENTRYPOINT ["java", "-jar", "app.jar"]

门禁规则

门禁通过条件
MR → developlint + test 通过
MR → mainlint + test + security + build 通过
main tag 触发全流水线 + docker push
P2-2 · 审计日志补齐 4h · 规范 R8.4

全局审计日志表

CREATE TABLE t_audit_log (
    id            BIGINT AUTO_INCREMENT PRIMARY KEY,
    operator_id   BIGINT       NOT NULL,
    operator_type VARCHAR(20),
    action        VARCHAR(50)  NOT NULL,
    target_type   VARCHAR(50),
    target_id     VARCHAR(64),
    detail        JSON,
    ip_address    VARCHAR(45),
    created_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);

AuditLogService

@Service
@RequiredArgsConstructor
public class AuditLogService {
    private final AuditLogMapper auditLogMapper;
    @Async("auditLogExecutor")
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void record(Long operatorId, String operatorType, String action,
                       String targetType, String targetId, Object detail) {
        AuditLog log = AuditLog.builder()
            .operatorId(operatorId).operatorType(operatorType)
            .action(action).targetType(targetType).targetId(targetId)
            .detail(JsonUtils.toJson(detail))
            .ipAddress(IpUtil.getCurrentRequestIp()).build();
        auditLogMapper.insert(log);
    }
}

8 个注入点

场景位置Action
CP 审核UserController.reviewCp()CP_REVIEW_APPROVE/REJECT
用户封禁/解封UserController.banUser()USER_BAN/UNBAN
内容上架/下架ContentController.audit()CONTENT_PUBLISH/UNPUBLISH
金币充值CoinController.recharge()COIN_RECHARGE
提现审批WalletController.withdraw()WITHDRAW_APPROVE/REJECT
广告位配置变更AdController.updatePlacement()AD_PLACEMENT_UPDATE
提现档位变更WithdrawConfigController.update()WITHDRAW_CONFIG_UPDATE
支付费率变更PaymentController.updateRate()PAYMENT_RATE_UPDATE

实施路线图

第 1 周(P1)
├── 周一: JWT 缩短 + Refresh + 黑名单 (2h)
├── 周二: 测试基础设施 + 金币/支付测试 (4h)
├── 周三: 风控测试 + 分支策略 + CONTRIBUTING.md (2h)
└── 周四: 剩余测试补全 + CI 调试 (4h)
第 2 周(P2)
├── 周一: CI 流水线搭建 + Dockerfile (4h)
├── 周二: 审计日志表 + Entity + Service (2h)
├── 周三: 审计日志 8 处注入点 (1.5h)
└── 周四: 自测 + 修复 + 验收

预算总工时: P1(11h) + P2(9.5h) = 20.5h(约 2.5 人天)

验收总体标准

检查项验收条件
JWTAccess Token 2h, Refresh Token 7d, 黑名单生效
测试≥ 20 用例, 覆盖率 ≥ 50%, CI gate 通过
Gitremote 配置, CONTRIBUTING.md, 分支策略
CIlint+test+security+build 全流水线通过
审计日志8 场景全覆盖, 异步不阻塞

Generated by DeepSeek TUI v0.8.18 | 2026-07-22 | 基于 dev-standards.html