SYSTEM ARCHITECTURE
聚智云 - 人力资源综合服务平台
微服务架构 / 多租户 / 模块化可组合 / 多端接入
1 系统总体架构
聚智云采用微服务架构,所有业务模块独立部署、独立数据库,通过API网关统一接入,支持按客户需求自由组合功能模块。
graph TB
subgraph access["接入层 Access Layer"]
direction LR
A1["管理后台 Web"]
A2["客户企业 Web/APP"]
A3["员工小程序"]
A4["开放 API"]
end
subgraph gateway["网关层 Gateway Layer"]
direction LR
G1["API 网关
路由 / 限流 / 日志"]
G2["统一认证中心
OAuth2 / JWT"]
G3["租户路由
品牌 / 小程序配置"]
end
subgraph biz["业务服务层 Business Services"]
direction LR
subgraph core["核心业务服务"]
direction TB
S1["签约服务
Contract"]
S2["考勤服务
Attendance"]
S3["人员服务
Personnel"]
S4["项目服务
Project"]
S5["成本服务
Cost"]
S6["结算服务
Settlement"]
S7["保险服务
Insurance"]
end
subgraph common["公共服务"]
direction TB
C1["认证授权服务"]
C2["租户管理服务"]
C3["消息通知服务"]
C4["文件存储服务"]
C5["报表引擎服务"]
C6["工作流引擎"]
end
end
subgraph infra["基础设施层 Infrastructure"]
direction LR
I1["服务注册与发现"]
I2["配置中心"]
I3["消息队列 MQ"]
I4["熔断 / 限流"]
I5["链路追踪"]
end
subgraph data["数据层 Data Layer"]
direction LR
D1["MySQL
每服务独立库"]
D2["Redis
缓存 / 会话"]
D3["OSS
文件 / 图片"]
D4["ELK
日志 / 搜索"]
end
subgraph ext["外部集成层 External Integration"]
direction LR
E1["社保局接口"]
E2["保险公司接口"]
E3["银行代发接口"]
E4["税务系统接口"]
E5["客户自有小程序"]
end
access --> gateway
gateway --> biz
biz --> infra
biz --> data
biz --> ext
style access fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style gateway fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#0f172a
style biz fill:#f0fdf4,stroke:#059669,stroke-width:2px,color:#0f172a
style core fill:#dcfce7,stroke:#059669,stroke-width:1px,color:#0f172a
style common fill:#fef9c3,stroke:#d97706,stroke-width:1px,color:#0f172a
style infra fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#0f172a
style data fill:#e0e7ff,stroke:#4f46e5,stroke-width:2px,color:#0f172a
style ext fill:#fce7f3,stroke:#db2777,stroke-width:2px,color:#0f172a
2 核心业务服务
7个核心微服务覆盖人力资源全业务链条,每个服务拥有独立数据库,可按客户需求自由组合启用。
| 服务 | 核心职责 | 核心实体 | 关键能力 |
|---|---|---|---|
| 签约服务 | 合同全生命周期管理 | 客户合同、派遣协议、劳动合同、合同模板 | 合同起草 / 审批 / 签章 / 续签 / 到期提醒 |
| 考勤服务 | 出勤数据采集与统计 | 打卡记录、请假单、加班单、排班表 | 多方式打卡 / 排班管理 / 异常标记 / 出勤报表 |
| 人员服务 | 员工全生命周期管理 | 员工档案、证照、技能证书 | 入职 / 转正 / 调岗 / 离职 / 档案管理 |
| 项目服务 | 客户项目与工时管理 | 项目、人员分配、工时记录、里程碑 | 项目立项 / 人员调配 / 工时填报 / 进度跟踪 |
| 成本服务 | 人工成本与利润分析 | 成本模型、费用归集、利润报表 | 成本核算 / 预算管理 / 利润分析 / 趋势预警 |
| 结算服务 | 账单与薪资管理 | 客户账单、薪资明细、银行流水 | 账单生成 / 薪资计算 / 银行代发 / 对账核销 |
| 保险服务 | 社保与商业保险管理 | 社保台账、雇主责任险、理赔记录 | 参保登记 / 缴费核算 / 理赔申请 / 到期续保 |
3 服务间通信与数据流
核心业务服务通过消息队列异步通信,形成完整的人力资源业务闭环。
flowchart LR
S3["人员服务
入职登记"] --> S1["签约服务
签订合同"]
S1 --> S2["考勤服务
开始打卡"]
S2 --> S4["项目服务
分配项目"]
S4 --> S5["成本服务
成本核算"]
S5 --> S6["结算服务
薪资发放"]
S6 --> S7["保险服务
参保管理"]
style S3 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S1 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S2 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S4 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S5 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S6 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
style S7 fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#0f172a
人员入职
➔
签订合同
➔
考勤打卡
➔
项目分配
➔
成本核算
➔
薪资结算
➔
保险参保
4 多租户与品牌定制
每个客户企业作为独立租户,支持自定义品牌标识、对接自有小程序,实现"一套系统,千人千面"。
graph TB
subgraph tenant["租户管理服务"]
direction LR
T1["品牌配置
Logo / 名称 / 主题色"]
T2["小程序配置
AppID / AppSecret"]
T3["模块授权
按需启用功能"]
T4["数据隔离
租户级逻辑隔离"]
end
subgraph client_a["客户 A"]
direction LR
CA1["自定义 Logo"]
CA2["自有小程序"]
CA3["签约 + 考勤 + 结算"]
end
subgraph client_b["客户 B"]
direction LR
CB1["自定义 Logo"]
CB2["自有小程序"]
CB3["人员 + 项目 + 保险"]
end
tenant --> client_a
tenant --> client_b
style tenant fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#0f172a
style client_a fill:#dbeafe,stroke:#2563eb,stroke-width:1px,color:#0f172a
style client_b fill:#dcfce7,stroke:#059669,stroke-width:1px,color:#0f172a
5 用户角色与权限
平台支持四类用户角色,通过统一认证中心实现多角色登录与细粒度权限控制。
平台管理员 / 运营
管理客户企业、合同、人员、结算等全流程,配置系统参数,监控运营数据。
客户企业(用工方)
查看项目人员、考勤数据、成本报表,管理自有品牌和对接小程序。
员工 / 劳动者
查看劳动合同、考勤记录、工资条,提交请假/加班申请,在线签合同。
外部机构对接
通过开放API对接社保局、保险公司、银行、税务等外部系统。
6 公共服务
公共服务为所有业务模块提供基础能力支撑,避免重复建设。
| 服务 | 核心职责 | 服务对象 |
|---|---|---|
| 认证授权服务 | 多角色登录、RBAC权限管理、Token签发与刷新 | 所有用户角色 |
| 租户管理服务 | 客户品牌配置(Logo/名称/主题色)、小程序对接、模块授权 | 客户企业 |
| 消息通知服务 | 站内信、短信、邮件、小程序模板消息推送 | 所有用户角色 |
| 文件存储服务 | 证照、合同扫描件、品牌素材的上传/下载/预览 | 所有用户角色 |
| 报表引擎服务 | 统一报表生成、多格式导出(Excel/PDF)、定时推送 | 管理员、客户企业 |
| 工作流引擎 | 审批流配置(入职审批、合同审批、报销审批等) | 管理员、客户企业 |
7 外部系统集成
通过集成层对接外部机构系统,实现数据互通和业务协同。
社保局接口
社保增减员申报、缴费查询、参保状态同步。
保险公司接口
雇主责任险投保、理赔申请、保单查询。
银行代发接口
薪资批量代发、转账流水查询、到账通知。
税务系统接口
个税申报、发票管理、税务数据同步。
8 分层功能结构图
以下结构图从上到下分层展示聚智云平台的功能模块关系,每一层对应系统中的一个逻辑层级,层与层之间通过明确的接口通信。
L1
接入层 — 多端入口
Access Layer
管理后台 Web
Vue 3
客户企业 Web/APP
H5 + APP
员工小程序
微信/客户自有
开放 API
RESTful
L2
网关层 — 统一接入管控
Gateway Layer
API 网关
路由 / 限流 / 日志
统一认证中心
OAuth2 / JWT
租户路由
品牌 / 小程序分发
接口文档
Swagger
L3
核心业务服务层 — 可自由组合
Core Business Services
签约服务
合同管理
考勤服务
打卡 / 排班
人员服务
档案 / 生命周期
项目服务
工时 / 进度
成本服务
核算 / 分析
结算服务
账单 / 薪资
保险服务
社保 / 雇主责任险
L4
公共服务层 — 基础能力支撑
Common Services
认证授权
RBAC
租户管理
品牌 / 模块授权
消息通知
短信 / 邮件 / 推送
文件存储
OSS / 预览
报表引擎
Excel / PDF
工作流引擎
审批流
L5
数据层 — 存储与缓存
Data Layer
MySQL
每服务独立库
Redis
缓存 / 会话
OSS
文件 / 图片
ELK
日志 / 搜索
L6
外部集成层 — 机构对接
External Integration
社保局接口
增减员 / 缴费
保险公司接口
投保 / 理赔
银行代发接口
薪资代发
税务系统接口
个税 / 发票
客户自有小程序
SDK / API
9 推荐技术选型
以下为各层推荐技术方案,具体选型可根据团队技术栈灵活调整。
| 层级 | 推荐方案 | 说明 |
|---|---|---|
| 前端(管理后台) | Vue 3 + Element Plus | 企业级后台首选,生态成熟 |
| 前端(客户/员工端) | UniApp / 微信小程序原生 | 支持客户自有小程序对接 |
| API 网关 | Spring Cloud Gateway / Kong | 路由、限流、日志统一管理 |
| 业务服务 | Spring Boot / Spring Cloud | Java生态,企业级微服务标准 |
| 服务注册 | Nacos / Consul | 服务发现 + 配置中心一体化 |
| 消息队列 | RabbitMQ / RocketMQ | 服务间异步通信 |
| 数据库 | MySQL 8.0(每服务独立库) | 数据隔离,独立扩展 |
| 缓存 | Redis Cluster | 会话、热点数据缓存 |
| 文件存储 | MinIO / 阿里云 OSS | 合同、证照、品牌素材 |
| 容器化 | Docker + Kubernetes | 服务编排、弹性伸缩 |