小程序端五层服务架构图:config → http → auth → api → normalize → mock,页面只调业务域方法
6 个 自研后端业务域(培训 / 技能 / 招聘 / 分销 / 企业 / 实名)
3 端 小程序 · PC 官网 · Vue3 后台
3 重身份 一个微信号 = 学员 / 推荐官 / 用人单位
5 态 佣金结算状态机,每一分钱可追溯

At a glance

案例速览

要解决的问题
养老护理员、中医保健按摩师等工种的培训与就业信息割裂:只发纸质证书、推岗靠一次性人工对接,招生靠地推砸钱。
约束条件
三方角色共用一套微信账号体系,数据要协同又要隔离;报名、提现等写操作「一次点击 = 一次真实业务后果」;大量姓名 / 手机 / 身份证 PII 必须合规处理。
我的职责边界
独立完成 jjt 全部后端业务域(在 likeadmin_java 底座上二次开发),并负责小程序端五层服务架构与登录 / 幂等 / 归一化基建。
结果
平台已上线(PC 官网 jiangjiangtong.cn + 微信小程序「匠将通」),打通「报名—考证—分销—就业」全链路;接口联调返工与重复提交类问题基本消除。

Overview

项目说明

匠将通是面向养老 / 康养行业职业技能人才的「培训 + 认证 + 就业」一体化平台,采用学员 / 推荐官 / 用人单位三方多角色模型,覆盖微信小程序(C 端主入口)+ PC 官网 + 后台管理三端。PC 官网 jiangjiangtong.cn 与微信小程序「匠将通」均已上线。

要解决什么

养老康养行业「招工难、留人难、培训与就业信息割裂、只发单一纸质证书、一次性推岗、机构收费不透明」。平台用一个三端三角色协同的系统,把「报名 → 集训 → 考证认证 → 推荐官分销获客 → 岗位推荐 → 就业意向 → 在岗跟踪 → 升段复训」串成闭环。

技术要点

技术 / 工具在项目里做什么解决什么问题
原生小程序 + 五层服务架构页面只写业务调用,网络 / 鉴权 / 字段转换下沉后端改字段只改适配层一处
登录态自愈单例 Promise 合并并发登录;401 自动重登并重放请求报名到一半不会被踢回登录页
request_id 幂等报名、就业意向、发布用工需求、提现都带唯一号,服务端去重手抖点两下、弱网重试不会重复扣款
normalize 响应归一化snake_case ↔ camelCase、金额按分、区划码转城市、「8-12K·13薪」解析前后端字段对不上的问题一次解决
多角色 RBAC + 审核流同一微信号多身份,后台审核驱动状态学员毕业转推荐官不用重新注册
推荐官分销 + 佣金结算专属推荐码与海报,五态结算招生不靠地推砸钱,每笔佣金可查
隐私脱敏 + 三要素实名人才库只返回脱敏视图,关键操作人脸核验真实联系方式不会被企业导走
likeadmin_java 二次开发Spring Boot 2.7.5 / MyBatis-Plus / MySQL / Redis通用能力直接复用,时间花在业务上
微信生态 + 多云存储code2session 登录、手机号解密;本地 / OSS / COS / 七牛可切换换云厂商改配置不改代码

配图说明:PC 官网首屏、核心优势、实训实景为线上站点真实截图;五层服务架构、三端多角色闭环、登录态自愈与结算状态机为按项目实际接口与代码结构绘制的技术示意图。

Stack

技术栈与工具

  • 原生微信小程序
  • config → http → auth → api → normalize
  • Java · Spring Boot 2.7.5
  • MyBatis-Plus
  • MySQL
  • Redis
  • likeadmin_java
  • Vue3 + TypeScript + Vite
  • Element Plus
  • 微信 code2session
  • 三要素 + 人脸实名
  • OSS / COS / 七牛多驱动存储

Build

实现过程

按实现顺序拆开关键模块:每一步解决什么问题、为什么这样做。

  1. 线上平台:PC 营销官网(jiangjiangtong.cn)

    PC 端是营销落地页 + 同域后端 API 网关,负责获客与品牌背书。项目由广西星辰大海教育联合央企光大养老集团(和光颐养 · 广西覃塘培训基地)共建,主营养老护理员、中医保健按摩师、长期照护师、辅具适配师等工种的培训、考核与就业输送。官网为原生 HTML / CSS / Vanilla JS(IntersectionObserver 滚动动效),响应式。

    匠将通 PC 官网首屏真实截图:老年专业服务人才实训基地
    匠将通 PC 官网首屏真实截图:老年专业服务人才实训基地
  2. 后端:在 likeadmin_java 上自研六个业务域

    权限、上传、配置、代码生成等通用能力直接复用开源底座,时间全花在业务上。我按 admin / api / framework 多模块分层完成培训、技能、招聘、分销、企业、实名六个域:MyBatis-Plus 用 LambdaQueryWrapper 组织多条件动态查询,分页插件处理岗位与人才列表,逻辑删除与自动填充统一维护审计字段,慢查询按业务场景补索引;Redis 承担 token 会话与续签、配置缓存、验证码与写操作幂等去重。

  3. 小程序五层服务架构(本人主要产出)

    原生微信小程序(非 uni-app / Taro),自研 config(环境 / 域名 / 超时 / useMock 开关)→ http(请求内核 + request_id 注入)→ auth(登录编排)→ api(jjt 业务域)→ normalize(响应归一)五层,另挂 mock 离线数据层。页面只写「报名」「查岗位」这类业务调用——后端改接口或字段名,只改适配层一处。

    五层服务架构图:config → http → auth → api → normalize → mock 逐层职责
    五层服务架构图:config → http → auth → api → normalize → mock 逐层职责
  4. 三方多角色:隔离协同的就业闭环

    一个微信用户可同时是学员、推荐官、用人单位,通过「申请 → 后台审核 → 身份切换」流转,状态在 reviewing → 补件 → 通过 / 驳回之间由后台驱动。前端 canEnterRole 做角色准入门控,后端做接口级权限与项目授权校验,双保险。

    三端多角色就业闭环图:学员 / 推荐官 / 用人单位 + 报名到就业全链路
    三端多角色就业闭环图:学员 / 推荐官 / 用人单位 + 报名到就业全链路
  5. 登录态自愈 + 佣金结算状态机

    登录态自愈:wx.login → mnpLogin 换 token 落盘,ensureLogin 用单例 Promise 合并并发登录,请求 401(code = -1)自动静默重登并重放原请求。佣金按「待核验 → 已核验 → 已结算 → 提现中 → 已到账」五态推进;每个推荐官有专属推荐码和海报,学员扫码报名自动绑定。

    登录态自愈四步 + 分销奖励结算状态机图
    登录态自愈四步 + 分销奖励结算状态机图
  6. 技能画像与岗位匹配:学员知道离上岗还差什么

    九个维度打分生成能力雷达图,学员选定目标工种后对照初 / 中 / 高级达标线,标出还差哪几项;平台按缺口推课,不用盲目报班。官网「核心优势」里的段位晋升(1–9 段、段位挂钩薪资)、闭环就业兜底等业务规则,直接映射到培训、技能、招聘业务域。

    官网核心优势真实截图:段位晋升 / 实景实训 / 双证保障 / 闭环就业兜底
    官网核心优势真实截图:段位晋升 / 实景实训 / 双证保障 / 闭环就业兜底
  7. 真实场景:央企实景实训基地

    和光颐养 · 广西覃塘培训中心依托光大直营的实景养老院开展实景教学,配套失能失智照护、康复、居家服务等实操区域。技术平台背后是真实的产业与就业输送场景,这也是为什么平台必须先把合规与健壮性做扎实。

    官网基地简介真实截图:覃塘颐养中心前台实景
    官网基地简介真实截图:覃塘颐养中心前台实景

Decisions

关键决策

说明为什么这样做,而不只是列出做了哪些动作。

Q1

五层分层的本质:让变化只发生在一层

后端由 likeadmin 底座 + 自研 jjt 域拼成,字段命名、金额单位、区划编码各处不一。如果页面直接调接口,一次字段变动就要改几十个页面。分层把「变化」锁进 normalize 与 api 两层:后端改字段只动 normalize,换接口只动 api——关注点分离不是审美,是维护成本。

Q2

健壮性基建优先于业务功能

报名、提现、就业意向都是「一次点击 = 一次真实业务后果」。所以先把三件事做扎实:登录态自愈(过期不打断)、request_id 幂等(手抖、弱网不重复)、normalize 归一(字段不错配)。基建写一次,上面每个业务域自动继承。

Q3

多角色不是权限开关,而是隔离协同

推荐官能看推荐记录但看不到别人的佣金,企业能查人才库但只见脱敏视图(「张*梅」、手机号与身份证打码)。审核状态机让「谁能进哪个角色」有可追溯的流转;关键操作接三要素 + 人脸实名。

Q4

Mock 优先,让前后端真正并行

内置带权限门控的完整 Mock 层,useMock 一键切换真假数据。前端不等后端就能联调与演示;顺便把「接口契约」在 Mock 里写了一遍,联调时逐项对照即可。

Result

交付与结果

交付内容

  • 后端:按 admin / api / framework 多模块分层,独立完成 jjt 六个业务域,统一 /api/jjt.{域}.{控制器}/{动作} 路由与 {code, msg, data} 返回规范
  • 小程序端:自研 config → http → auth → api → normalize 五层服务架构(另挂 mock 假数据层),页面与网络 / 鉴权 / 字段适配彻底解耦
  • 登录态自愈:wx.login 换 token,单例 Promise 合并并发登录,401 自动静默重登并重放原请求
  • 写操作 request_id 幂等 + normalize 响应归一化(双命名 / 金额分制 / 区划映射 / 薪资文本解析)
  • 多角色 RBAC 审核工作流、推荐官分销与五态佣金结算、隐私脱敏、三要素 + 人脸实名、技能画像与岗位匹配

项目结果

  • 打通「报名 → 集训 → 考证 → 推荐官分销 → 岗位推荐 → 就业意向 → 在岗跟踪 → 升段复训」全链路闭环,替代线下报名与人工推岗
  • 一个微信号可同时拥有学员 / 推荐官 / 用人单位三重身份,申请 — 审核 — 切换全流程隔离协同
  • token 过期对用户无感:不弹登录页、不丢填到一半的表单;并发接口不重复登录
  • request_id 幂等杜绝重复报名、重复发佣、重复提现;提现走可提余额校验 + 幂等 + 事务,账目一分不差
  • 沉淀可复用的 jjt 后端业务域骨架与小程序服务分层,登录自愈、幂等、归一化下沉为公共基建

Retrospective

复盘

这个项目让我确认了一件事:业务平台里最贵的不是写功能,而是功能上线后的每一次返工。把幂等、登录自愈和字段归一做成所有业务域共享的基建,后面每加一个功能的边际成本都在下降。

References

方法与参考

本案例用到的工程模式与模型能力,附权威出处,方便核对。