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
图 1:聚智云系统总体架构图

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
图 2:核心业务数据流
人员入职 签订合同 考勤打卡 项目分配 成本核算 薪资结算 保险参保

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
图 3:多租户品牌定制与模块组合

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
图 4:聚智云分层功能结构图(L1 接入层 → L6 外部集成层)

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 服务编排、弹性伸缩