Drama 融合平台

生产级质量分析报告 · 2026-08-07
基于 drama-fusion-platform develop 分支(HEAD: b078996)
12 微服务 258 Java 文件 17,438 行 Spring Boot 3.2.5 Java 17
3.1
加权综合评分 / 5.0
8 维度加权平均
5
门户缺口
致命/高风险项
4
已达标维度
架构 · 可观测 · 部署 · 文档

📊 八维雷达图

📋 1. 项目概况

技术栈:Spring Boot 3.2.5 + Spring Cloud Alibaba 2023.0.1 + MyBatis-Plus + Nacos + RocketMQ + Redis + MySQL 8.0。前后端分离,6 个前端模块(Vue/Vite + UniApp)。基础设施全容器化(docker-compose),代码仓库使用 GitLab/GitHub 双托管。
指标数据评价
后端服务模块12 个(gateway + 10 业务 + common)合理
前端模块6 个(admin/admin-portal/h5/lemon/seller/uniapp/uniapp-app)完整
Java 源码文件258 个中等
业务代码行数17,438 行中等
Flyway 迁移脚本35 个规范
YML 配置文件26 个(含 test/profile)多层次
Git 提交记录76 次活跃
最近发布P0/P1/P2 安全质量迭代(7 月-8 月)持续交付

🏗️ 2. 架构设计 ★★★★☆ 4.0 / 5.0

架构是项目的核心优势。BOUNDARIES.md 明确定义了 11 个服务的职责、端口、数据表及外部系统边界。数据所有权规则严格:「每张表有且仅有一个拥有服务,其他服务一律通过 API 访问,禁止跨服务直连数据库。」这是生产级架构的重要标志。
检查项现状评价
服务边界文档BOUNDARIES.md(55 行)完整定义端口/职责/数据表/外部系统优秀
数据所有权每表唯一拥有者,禁止跨服务直连;资金表强制事务+锁+审计优秀
通用模块复用drama-common 汇聚 JWT/异常/工具类良好
网关统一入口路由 + JWT 鉴权 + 限流 + CORS + Header 透传良好
外部系统边界9 个外部系统文档化(Redis/Nacos/RocketMQ/OpenIM/DeepSeek/微信/OSS 等)良好
服务拆分粒度资金/内容/用户/社交/广告/AI 等核心域独立,耦合低良好

💻 3. 代码质量 ★★★☆☆ 3.0 / 5.0

基础架构代码质量 OK:有统一异常处理、事务管理意识良好、线程池已配置。但参数校验覆盖率极低(仅 1 处 @Valid),缺乏静态分析工具(Checkstyle/SpotBugs/SonarQube)。
检查项现状评价
全局异常处理drama-common GlobalExceptionHandler(@RestControllerAdvice)到位
参数校验仅 1 处 @Valid/@Validated(项目全局搜索)严重不足
事务管理47 处 @Transactional,覆盖资金/订单关键路径良好
异步/线程池user-service 显式配置 ThreadPoolTaskExecutor + @EnableAsync部分覆盖
自定义异常2 个自定义异常类可扩展
静态分析无 Checkstyle/SpotBugs/SonarQube 配置缺失
代码审查PR #29 合并记录显示 review 痕迹执行中

🧪 4. 测试覆盖 ★★☆☆☆ 1.5 / 5.0

⚠️ 测试是项目最大瓶颈。258 个 Java 文件仅有 9 个测试类,测试/业务代码比为 6.2%。未达到生产级最低标准(建议单元测试覆盖率 ≥ 60%,集成测试覆盖关键路径)。
检查项现状评价
后端测试类9 个测试文件 / 258 个 Java 文件(3.5%)严重不足
测试代码量1,073 行 vs 17,438 行业务代码(6.2%)严重不足
JaCoCoP1-1 已引入 JaCoCo 插件已配置
测试 profile部分服务有 application-test.yml(user/content/ad)部分到位
前端测试89 个前端测试文件(vitest),但无 ESLint/Prettier数量 OK
E2EP1-8 引入 Playwright/Cypress E2E已规划
CI 测试GitHub Actions 有测试 job,但近期多次修复不稳定性不稳定

🔒 5. 安全性 ★★★☆☆ 3.0 / 5.0

认证、限流、CORS 等基础安全措施到位。但密钥外部化、CSRF/XSS、细粒度 RBAC 尚未完全落地。当前适合内网/开发环境,生产环境需要加固。
检查项现状评价
身份认证Gateway JwtAuthFilter + common/JwtUtil,RSA 密钥对到位
全局限流Gateway Redis RateLimiter(100 QPS replenish / 200 burst)到位
CORSGateway 全局 CORS 配置(明确允许来源)到位
敏感数据脱敏SensitiveUtil 工具类到位
密钥管理YML 中出现明文密码/密钥(dev 环境可接受)需外部化
CSRF/XSS未见显式防护(Gateway 纯 API 场景风险较低)需评估
细粒度 RBAC未见 SecurityConfig 或方法级注解(可能依赖 Gateway 单一入口模型)待确认

👁️ 6. 可观测性 ★★★★☆ 3.5 / 5.0

Prometheus + Micrometer Tracing + Zipkin 三件套已就绪,Zipkin 经验证 UP(9411 端口 span 上报正常)。5 个服务暴露 Prometheus 端点。日志结构化(logstash-logback-encoder)已引入。Loki + Grafana 定义于 compose 但未实际运行。
检查项现状评价
指标(Metrics)Gateway + user/content/rec/ad/ai 暴露 /actuator/prometheus良好
链路追踪(Tracing)Micrometer + Brave + Zipkin reporter,Zipkin 3.4.4 已验证正常已验证
健康检查Actuator health/info 端点均已暴露,含详细信息到位
日志结构化logstash-logback-encoder 已引入,JSON 格式日志到位
日志集中化docker-compose 定义 Loki + Promtail(2.9.4)但未启动未启用
仪表盘Grafana 定义但未部署,无预置面板缺失

🚀 7. 运维部署 ★★★★☆ 3.5 / 5.0

开发环境部署成熟:Dockerfile 多阶段构建 + docker-compose 全栈编排(MySQL/Redis/Nacos/RocketMQ + 应用服务)。start-all.sh 支持一键启停和状态查看。Flyway 版本化 35 个迁移脚本。CI/CD pipeline 存在但近期多次修复。
检查项现状评价
容器化Dockerfile 多阶段构建 + compose 全栈,支持 build args优秀
数据库迁移35 个 Flyway V 脚本,版本化管理(V20260613-V20260615)规范
部署脚本start-all.sh:setsid/disown 脱离进程组,内存限制,--stop/--status完善
CI/CDGitHub Actions 存在,但近期 v3-v5 多次修复稳定性不稳定
K8s 编排未发现 Helm Chart / k8s manifest缺失
灰度发布无蓝绿/金丝雀/滚动发布策略缺失

📚 8. 文档 ★★★★☆ 3.5 / 5.0

运维/架构/边界文档良好。BOUNDARIES.md 和 ARCHITECTURE.md 是项目的文档亮点。但主服务缺少 OpenAPI/Swagger 文档,API 文档几乎是空白。
检查项现状评价
服务边界BOUNDARIES.md(55 行),CHANGELOG 中体现优秀
架构文档ARCHITECTURE.md + 26 个 MD丰富
README59 行,涵盖项目简介和启动说明到位
API 文档仅 lilishop 集成有 Swagger 注解;主服务无 OpenAPI严重缺失
交付记录P0/P1/P2 分析文档完整到位

🛡️ 9. 韧性容错 ★★★☆☆ 3.0 / 5.0

限流与缓存已有基础,content 列表已有 fail-soft 降级。但熔断仅 1 处 @CircuitBreaker,重试 @Retryable 未使用。面对下游服务故障时缺乏系统性防护。
检查项现状评价
全局限流Gateway Redis RateLimiter(100/200 tps)到位
熔断器仅 1 处 Resilience4j @CircuitBreaker严重不足
缓存策略Redis 71 处引用,缓存使用广泛良好
消息队列RocketMQ 21 处引用,异步解耦关键路径良好
服务降级content 列表缓存 fail-soft(ci#144 修复)有先例
自动重试未见 @Retryable 使用缺失

🔧 改进建议(按优先级排序)

优先级维度问题建议预估工作量
P0 致命 测试 后端测试覆盖率仅 6%,无法保证变更安全 核心路径(资金/用户/订单)补充单元测试 + 集成测试,目标 ≥60% 3-5 周
P0 致命 安全性 YML 明文密钥,生产环境不可接受 敏感配置外部化(环境变量 / Vault / K8s Secret) 1-2 周
P1 高 韧性 仅 1 处熔断器,缺乏系统级故障防护 关键调用链(支付/交易/外部 API)全面接入 Resilience4j CircuitBreaker + Retry 2-3 周
P1 高 代码质量 参数校验覆盖率极低 全量接入 Bean Validation(@NotNull/@Valid 等),Gateway 加请求体校验 1-2 周
P1 高 运维 CI 流水线多次修复仍不稳定 重构 CI pipeline,引入确定性构建 + 依赖缓存,修复 flaky tests 1 周
P2 中 文档 无 OpenAPI/Swagger 文档 引入 springdoc-openapi,自动生成 API 文档 3-5 天
P2 中 可观测性 Loki + Grafana 已定义但未运行 启动 Loki/Promtail/Grafana 并预置业务面板 3-5 天
P2 中 代码质量 无静态分析工具 接入 SpotBugs + Checkstyle,CI 门禁 2-3 天
P2 中 运维 无 K8s/灰度发布方案 调研容器平台,编写 Helm Chart,建立灰度发布流程 2-4 周