3.1
加权综合评分 / 5.0
8 维度加权平均
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%) | 严重不足 |
| JaCoCo | P1-1 已引入 JaCoCo 插件 | 已配置 |
| 测试 profile | 部分服务有 application-test.yml(user/content/ad) | 部分到位 |
| 前端测试 | 89 个前端测试文件(vitest),但无 ESLint/Prettier | 数量 OK |
| E2E | P1-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) | 到位 |
| CORS | Gateway 全局 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/CD | GitHub 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 | 丰富 |
| README | 59 行,涵盖项目简介和启动说明 | 到位 |
| 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 周 |