后端 — 概览 & 技术选型

📝 作者

广

杨天广·409102

信息化中心

安

戴安·026827

共享技术中心

祥

张祥·026828

共享技术中心

杰

张杰·409336

共享技术中心

越

潘超越·409332

共享技术中心

快速上手

新成员请先看 后端快速上手：环境准备 → 契约生成三段式 → 审计与质量门 → 数据库变更流程，约 30 分钟跑通最小闭环。

v0.24.0 已落地

后端方向基于 @agile-team/wl-skills-bd（v0.24.0） 形成可安装、可验证、可回放的工程闭环，覆盖契约驱动生成、模块目录与精准上下文、配置分层与多环境、任务驱动、数据安全护栏、行为契约测试、生产保障、质量门、数据库事实源治理、变更审查统一质量门（review run/baseline）、多模块与字段影响分析、集成适配器治理 与 MCP 全链路。

---

项目简介

后端业务微服务标准模板基于 Java 8 + Spring Boot 2 + jh4j-cloud 3.1，采用 MyBatis-Plus + 原生 XML 双轨 ORM。每个微服务对应一个业务领域，独立 Git 仓库、独立部署，通过 Nacos 服务注册、Feign 远程调用、RocketMQ 异步消息组成分布式系统。

版块导航

• 快速上手 — 30 分钟跑通契约生成最小闭环
• 架构设计 — 微服务拆分模型、服务接入三类注册、扩展点机制（以 wl-produce 为实例）
• MES 集成实战 — QMS / L2 / MPS 三路对接协议与治理
• 开发规范 — Java 编码规约基线（机器可判定部分已固化为 B 规则）
• Skills 集合 — 13 个 Skill / 17 个 MCP / 30 条规范全景与使用指南

# 安装后端 Skills（Node.js >= 22）
npx @agile-team/wl-skills-bd init
npx @agile-team/wl-skills-bd doctor

---

技术栈

分类	技术	版本	说明
语言	Java	1.8	团队统一基线
框架	Spring Boot + jh4j-cloud	2.x + 3.1	微服务基础框架
ORM	MyBatis-Plus	—	继承 JhBaseMapper<T> + 原生 XML
数据库	MySQL / Oracle	—	MySQL（业务）/ Oracle（主数据）
缓存	Redis	—	带 TTL + Redisson 分布式锁
消息队列	RocketMQ	—	异步解耦 / 削峰
服务注册	Nacos	—	服务发现 + 动态配置
接口规范	OpenAPI 3	—	新代码统一；Swagger 2 存量保留
返回包装	ApiResult	—	code=2000，{code, message, data}
权限	Spring Security	—	@PreAuthorize("@pms.hasPermission(x)")
工具库	Hutool / Commons / Lombok	—	5.x / FastJSON 2.0
构建	Maven	—	mvn verify -Pwl-quality

---

核心能力（v0.24.0）

维度	数量	说明
AI Skill	13	契约设计→代码生成→DDL→单测→审计→修复→集成适配 全链路
MCP 工具	17	wls_be_* 前缀，CLI/MCP 复用同一核心
后端规范	30	B1~B31 确定性扫描（工程基线→安全护栏→稳定性→生产保障→数据库治理→变更审查）
Java 质量门	8	J1~J8（ArchUnit/Checkstyle/PMD/SpotBugs/Spotless/P3C/JaCoCo）
变更审查	1	review run/baseline：Git 变更 + 规则 + 历史基线 + 豁免 + 平台适配 + 供应链 + JaCoCo 变更覆盖率，同一确定性门
代码模板	16	Entity/DTO/VO/Controller/Service/Mapper XML/DDL/Flyway/Test
任务驱动	8 种	new-service/add-api/add-field/add-business-cmd/fix-bug/refactor/audit/config-op

---

开发模式

场景	工作流	说明
新开发完整服务	全链路	契约→生成17产物→质量门→审计
加接口	add-api	增量契约→只生成变化文件→子集审计
改 Bug	fix-bug	审计定位→safe-fix（B3/B5）→复扫确认
配置管理	config-op	三层配置→体检→环境迁移→故障诊断

详见 使用指南。

---

AI Skills 流水线

① api-design-be → ② entity-codegen → ③ service-codegen → ④ mapper-xml-gen
      ↓                                                              ↓
⑤ db-migration（DDL+Flyway）←───────────────────────────────────── ⑦ unit-test-gen
      ↓                                                              ↓
⑥ convention-audit-be（B1-B31 + J1-J8）←───────────────────────── ⑧ code-fix-be

详见 AI Skills 流水线。

---

版块内容

内容	入口	说明
开发规范	44 条规范	命名 / 编程 / 性能 / 漏洞隐患 四大类
Skills 集合	12 Skill + 16 MCP	契约驱动代码生成全链路
AI Skills 流水线	12 Skill 衔接	生成链→数据链→审计链 + 任务驱动
使用指南	5 种工作流	新开发/加接口/改Bug/配置/模块目录

---

伴生工程

• 前端 Skills：wl-skills-kit
• 前端视觉：wl-skills-ui
• 测试工程：wl-skills-test