新模块统一命名 drama-{domain}-service。公共代码放在 drama-common。
drama-gateway/ ← API 网关 drama-common/ ← 公共工具、客户端、结果体、异常 drama-user-service/ ← 用户域 drama-content-service/ ← 内容域 drama-trade-service/ ← 交易域 ...
每个服务模块内部必须遵循统一包结构:
com.drama.fusion.{domain}/
├── {Domain}ServiceApplication.java
├── controller/ ← REST 接口
├── service/ ← 业务逻辑
├── entity/ ← MyBatis-Plus 实体
├── mapper/ ← Mapper 接口
├── config/ ← 配置类
└── client/ ← 外部服务调用
ContentController 中存在 8+ 处 DriverManager.getConnection() 直连数据库,绕过连接池和 MyBatis。
// ❌ 禁止
var conn = java.sql.DriverManager.getConnection("jdbc:mysql://...", "root", "");
var ps = conn.prepareStatement("SELECT ...");
// ✅ 正确
@Autowired
private JdbcTemplate jdbc; // 或 MyBatis Mapper
限时整改:所有 JDBC 直连代码替换为 JdbcTemplate 或 MyBatis Mapper。
UserController 和 ContentController 中存在 6+ 处 new Thread(() -> {...}).start()
// ❌ 禁止
new Thread(() -> { spreeClient.createVendor(...) }).start();
// ✅ 正确
@EnableAsync + @Async("taskExecutor")
限时整改:替换为 Spring @Async + ThreadPoolTaskExecutor。
| 类型 | 命名规则 | 示例 |
|---|---|---|
| Controller | {Domain}Controller | UserController, AdController |
| Service | {Domain}Service | CoinService, TradeService |
| Entity (DO) | 名词,与表名对应 | User, Drama, Episode |
| Mapper | {Entity}Mapper | UserMapper, OrderMapper |
| DTO/VO | 后缀 DTO / VO | RiskCheckRequest, GoodsVO |
| Util | {Feature}Util | JwtUtil, RsaCryptoUtil |
| 配置类 | {Feature}Config | MybatisPlusConfig |
| 数据库表 | t_{entity_name} | t_user, t_drama, t_order |
| Redis Key | {domain}:{entity}:{id} | rec:user:123:seen |
实体类统一使用 @Data @Builder @NoArgsConstructor @AllArgsConstructor。
Controller 统一使用 @RequiredArgsConstructor 构造注入(禁止 @Autowired 字段注入)。
涉及多表写操作的方法必须标注 @Transactional。事务边界内不允许远程 RPC 调用。
// ❌ 事务内 RPC
@Transactional
public void create() { dbInsert(); thirdPartyApi.call(); } // RPC 失败不回滚
// ✅ 事务外异步
public void create() { dbInsert(); asyncService.syncToThirdParty(); }
UploadBox.vue, MultiUpload.vue)/cp/dramas, /contents/products)var(--xxx)所有接口统一返回 Result<T>:
{
"code": 200, // 200=成功, 4xx=客户端错误, 5xx=服务端错误
"message": "success",
"data": { ... } // 实际数据
}
| 操作 | Method | 路径 |
|---|---|---|
| 列表查询 | GET | /api/content/dramas?page=1&size=20 |
| 详情 | GET | /api/content/dramas/{id} |
| 创建 | POST | /api/content/dramas |
| 更新 | PUT | /api/content/dramas/{id} |
| 删除 | DELETE | /api/content/episodes/{id} |
| 动作 | POST | /api/content/drama/{id}/audit |
// 请求
GET /api/xxx?page=1&size=20
// 响应
{ "list": [...], "total": 100, "page": 1, "hasMore": true }
管理系统默认 size=20,最大 100。
新增服务必须在 Gateway application.yml 注册路由:
- id: {service-name}
uri: lb://drama-{service-name}
predicates: [Path=/api/{prefix}/**]
需免鉴权的端点加入 JwtAuthFilter.WHITE_LIST。
所有数据库操作通过 MyBatis-Plus 或 JdbcTemplate。禁止 Controller 内 JDBC 直连。
// ✅ 查询 LambdaQueryWrapper<User> w = new LambdaQueryWrapper<>(); w.eq(User::getPhone, phone); User user = userMapper.selectOne(w); // ✅ 分页 Page<Drama> page = dramaMapper.selectPage(new Page<>(pn, ps), w);
所有 DDL 变更通过 Flyway 迁移脚本管理:
src/main/resources/db/migration/ V20260613__user_extend.sql V20260615__account_status.sql V20260721__add_commission_log.sql
禁止手动执行 SQL 或在代码中 CREATE TABLE。
金融类操作必须幂等:
// 广告激励
if (transLogMapper.selectCount(new LambdaQueryWrapper<>()
.eq(AdTransLog::getTransId, transId)) > 0) {
return Map.of("message", "重复交易,已核销");
}
// 支付回调
if ("PAID".equals(order.getStatus())) return "success";
CoinService.spend() 在高并发下存在余额超扣风险。金币/钱包操作必须在多实例场景下使用分布式锁。
// ✅ 使用 Redis 分布式锁
String lockKey = "lock:coin:" + userId;
if (redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 5, TimeUnit.SECONDS)) {
try { /* 余额操作 */ }
finally { redisTemplate.delete(lockKey); }
}
强制 所有密钥、密码、Token 禁止硬编码在源码或配置文件中。
# ❌ 禁止
wechat.app-secret: db4fee431fc000a1982f9e5b39e5a785
# ✅ 正确
wechat.app-secret: ${WECHAT_APP_SECRET} # 环境变量 / K8s Secret / Vault
X-User-Id 头传递,下游不再解析 TokenPaymentService.verifySignature() 当前为 placeholder(始终返回 true),必须接入支付宝/微信官方签名验证 SDK。
#{}),禁止拼接开发环境允许全源,生产环境必须限制具体域名:
globalcors.cors-configurations:
'[/**]':
allowed-origins: "https://app.drama.com,https://admin.drama.com"
| 层级 | 目标覆盖率 | 框架 |
|---|---|---|
| L1: 单元测试 | ≥ 70% | JUnit 5 + Mockito |
| L2: 集成测试 | ≥ 50% | @SpringBootTest + H2 |
| L3: API 测试 | 核心接口 100% | MockMvc / Spring Cloud Contract |
| L4: E2E 测试 | 核心用户旅程 | Playwright / Cypress |
| 优先级 | 场景 |
|---|---|
| P0 | 金币充值/消费并发、广告激励幂等、支付回调幂等、风控评分全组合 |
| P1 | 三级审核状态机 (10→70)、CP 注册→审核→lilishop 同步、IM 对话历史、JWT 鉴权过滤器 |
| P2 | 商品卡片 CRUD、推荐算法准确性、弹幕推送、RSA 加解密 |
@Test @DisplayName("手机号登录 — 新用户自动创建画像和钱包")
void testLoginNewUser() { ... }
@Test @DisplayName("金币消费 — 余额不足应返回失败")
void testSpendInsufficientBalance() { ... }
main ──────●──●────────●──────●── 生产就绪
│ │ │ │
release ────┼──┼────────●──────┼── 发布分支
│ │ │
develop ────┼──●───────────────┼── 集成分支
│ │
feature ────●──────────────────┼── feature/user-login
│
hotfix ────────────────────────●── hotfix/payment-callback
强制 使用 Conventional Commits:
feat(coin): 添加签到领取金币功能 fix(payment): 修复支付回调签名验证 docs(api): 补充商品卡片接口文档 refactor(user): 移除 SpreeClient,迁移到 LilishopClient test(trade): 添加并发支付测试 chore(deps): 升级 spring-boot 至 3.2.6
所有合并到 develop/main 的代码必须通过 PR review。Review 检查项:
stages: [lint, test, security, build, docker] # lint: ESLint + Checkstyle # test: mvn test + jacoco (coverage > 50%) # security: OWASP dependency-check + SpotBugs + secretlint # build: mvn package + docker build # docker: push to registry
| 级别 | 场景 | 示例 |
|---|---|---|
| ERROR | 系统异常、需要人工介入 | 数据库连接失败、支付回调异常 |
| WARN | 可恢复的错误、降级行为 | 外部 API 超时、lilishop 同步失败 |
| INFO | 关键业务流程节点 | 登录成功、订单创建、CP 审核 |
| DEBUG | 调试信息 | 请求参数、SQL 执行 |
BizException(code, message)GlobalExceptionHandler 自动转换为 Result.fail()e.printStackTrace(),必须 log.error("上下文", e)catch (Exception ignored) {} 吞异常(外部 RPC 降级除外)138****1234eyJh...(仅打印前 8 位)以下操作必须记录审计日志(t_audit_log):
t_coin_transaction)| # | 等级 | 问题 | 规范条款 | 预计工时 |
|---|---|---|---|---|
| 1 | P0 | Controller 内 JDBC 直连(8+处) | R1.2 / R4.1 | 2h |
| 2 | P0 | 裸线程创建(6+处) | R1.2 | 2h |
| 3 | P0 | 密钥/密码硬编码 | R5.1 | 3h |
| 4 | P0 | 支付回调签名验证 placeholder | R5.2 | 4h |
| 5 | P0 | 金币无分布式锁 | R4.3 | 3h |
| 6 | P1 | Commit 规范 + 分支策略 | R7.1 / R7.2 | 1h |
| 7 | P1 | 测试补齐(金币/支付/风控) | R6.2 | 8h |
| 8 | P1 | JWT 缩短有效期 + 黑名单 | R5.2 | 2h |
| 9 | P2 | CI 流水线搭建 | R7.4 | 4h |
| 10 | P2 | 审计日志补齐 | R8.4 | 4h |
预估总工时: 33h (约 4 人天),建议分 2 周迭代完成。
Generated by DeepSeek TUI v0.8.18 | 2026-07-21