ZhuaTech EHR — 知华科技 EHR 社区源码版

本次升级：假期按在岗月折算与已用余额核对

按制度输入的年度假期、在岗月份及结转天数计算候选额度，核对累计已用，避免把折算结果当作法定权益认定。

新增已认证的结构化录入工作台（/operations.html），支持批量核算、逐条结果依据、分级复核和CSV/完整JSON导出。结果由真实后端算法计算，不是预置演示数字。所有数值精确传递，不调用外部模型。

这是只读核算：不写库、不审批、不自动执行财务、签署、销毁或设备控制。输入条件满足不是执行授权。算法、输入边界与接口说明。

本次升级：员工入离职日期与合同效期预检

支持 UTF-8 CSV 文件/粘贴预检、物理行定位、批次重复业务键检查、模板下载和安全 CSV 导出。

合同截止不能早于入职日期。
合同效期提醒。

入口：/preflight.html（沿用现有后端认证）。预检不写库、不执行审批，也不替代主数据存在性、库存/余额锁定及正式入库事务校验。规则、接口与边界说明。

简体中文 | English

企业级增强：薪酬变更治理

新增职级带宽、预算、合同、经理/人力/薪资审批、职责分离、税社保、敏感权限、幂等和追溯调薪治理，详见薪酬变更治理。

企业级增强：员工离职清算治理

新增普通/特权访问回收、资产、薪资、费用、知识交接和双重确认门禁，详见离职清算治理。

企业级增强：员工主数据变更

新增员工身份、组织岗位、薪酬、工资账户、个税社保、生效周期、隐私最小化、下游影响、人事审批、职责分离和审计证据联合控制，详见员工主数据变更治理。

ZhuaTech EHR（知华 EHR）是由 知华科技（上海如静知华信息科技有限公司） 提供源码的电子人力资源管理系统。项目采用 Java、Spring Boot、Vue 3、移动 H5 和 MySQL 构建，覆盖员工档案、组织架构、考勤、请假、薪资与招聘等基础 EHR / HRM 能力，可用于个人学习 Java 人力资源系统、Vue EHR、员工管理和招聘管理系统的设计与实现。

[!IMPORTANT] 本工程仅允许个人用于非商业性的学习、研究与技术交流，不得用于任何商业用途。 企业内部使用、生产部署、SaaS、项目交付、咨询实施、二次开发后销售或其他直接、间接商业使用，均须事先取得上海如静知华信息科技有限公司的书面商业授权。完整条款请阅读 LICENSE。

本项目为“源码开放/社区源码版”，因包含非商业限制，不属于 OSI 定义的开源软件。

官方网站：https://www.zhuatech.cn/ · 商业授权、深度开发、私有化部署与定制功能，请联系知华科技。

员工留任风险预警

新增 POST /api/ehr/insights/retention-risk，依据敬业度、薪酬差距、月度加班、近 90 天缺勤、晋升等待和司龄生成留任风险分值。接口仅返回业务解释和关怀建议，不使用姓名等无关个人属性，便于人事团队进行访谈、负荷调整和职业发展跟进。

功能特性

员工花名册：工号、部门、岗位、入职日期、联系方式与在职状态
组织架构：部门数据、员工归属和组织人员统计
考勤管理：签到、签退、迟到判断与最近考勤记录
假勤审批：年假、事假、病假申请，员工进度查询，人事/管理员审批
薪资管理：基本工资、津贴、奖金、扣款、实发工资和发放状态
招聘管理：招聘职位、需求人数、候选人来源和招聘阶段流转
人事工作台：在职员工、待审批、在招职位和面试候选人统计
角色权限：管理员、人事、员工三级角色及敏感薪资数据隔离
移动 H5：面向手机端的员工服务、人事工作台和卡片化操作体验
工程能力：JWT、Flyway、MySQL、Docker Compose、Nginx 和 CI

技术架构

层级	技术
H5 前端	Vue 3、Vite、Vant、Pinia、Vue Router、Axios
Java 后端	Java 21、Spring Boot、Spring Security、Spring Data JPA、Flyway
数据库	MySQL 8.4（测试环境可使用 H2）
部署	Docker、Docker Compose、Nginx

后端统一使用 cn.zhuatech.ehr 根包名，前后端通过 REST API 解耦。详细设计见架构文档和 API 文档。

5 分钟启动

前置条件：Docker Desktop / Docker Engine 24+ 与 Docker Compose v2。以下方式仅供个人非商业学习环境使用；商业或生产部署前须取得书面授权。

cp .env.example .env
docker compose up --build -d

浏览器访问：http://localhost:8088

类型	账号	密码
员工体验	`demo`	`Demo@2026`
人事体验	`hr`	`Demo@2026`
管理员	`admin`	`ZhuaTech@2026`

首次启动会创建示例部门、员工、考勤、请假、薪资、招聘职位和候选人数据，方便体验完整 EHR 流程。

演示密码和示例数据仅用于个人本地学习。部署到公网前必须修改初始化账号、数据库密码和 JWT_SECRET，并清除示例数据。

数据库 SQL 与初始化数据

项目现已提供可直接执行的 MySQL 8.4 脚本：

database/01-schema.sql：建库、核心业务表、约束和索引；
database/02-demo-data.sql：部门、账号、考勤、假勤、薪资、职位和候选人演示数据；
database/03-repair-demo-accounts.sql：为已有演示数据库补齐或重置基础体验账号；
database/README.md：导入顺序、初始化账号、数据检查和生产安全说明。

mysql -uroot -p < database/01-schema.sql
mysql -uroot -p < database/02-demo-data.sql

使用 Spring Boot 启动时，Flyway 会自动执行 V1__init.sql 和 V2__demo_data.sql，无需再手工导入。所有初始化人员和业务记录均为虚构数据。

已有数据库若缺少体验账号，可执行：

docker compose exec -T mysql sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" "$MYSQL_DATABASE"' \
  < database/03-repair-demo-accounts.sql

通过 127.0.0.1:8088 或其他地址访问时如遇登录 403，请确认已执行 docker compose up --build -d --force-recreate，并按 database/README.md 配置 CORS_ORIGINS；403 通常是来源地址未放行，而不是账号或密码错误。

停止服务：

docker compose down

删除数据库卷会永久清除数据，仅在明确需要重置演示数据时执行：docker compose down -v。

本地开发

后端需要 JDK 21、Maven 3.9 和 MySQL 8：

cd backend
mvn spring-boot:run

前端需要 Node.js 24 与 npm 11：

cd frontend
npm install
npm run dev

默认开发地址为 http://localhost:5173，Vite 会将 /api 代理到 http://localhost:8080。环境变量说明见 .env.example。

项目结构

zhuatech-ehr/
├── backend/        # cn.zhuatech.ehr Java 后端
├── frontend/       # Vue 3 移动端 H5
├── database/       # MySQL 建库脚本、演示数据与导入说明
├── deploy/         # 部署说明
├── docs/           # 架构与 REST API 文档
├── compose.yaml    # MySQL、后端与前端编排
└── README.md

路线图

入职、转正、调岗、离职等员工全生命周期流程
排班、加班、出差、调休与年假余额
社保、公积金、个税和工资条通知
绩效目标、考核周期、评分校准与人才盘点
培训课程、学习计划、证书与发展路径
PC 人事管理后台、操作审计和细粒度数据权限
企业微信、钉钉、邮件、短信和电子签集成
多租户、开放 API、Webhook 与可配置审批流

欢迎按贡献指南提交 Issue 和 Pull Request。安全问题请不要公开披露，处理方式见安全策略。

使用许可与商业授权

本项目版权归 上海如静知华信息科技有限公司 所有，并按照 ZhuaTech EHR 社区源码许可协议提供源码：

允许自然人用于个人、非商业性的学习、研究、实验和技术交流。
允许为上述目的在个人设备上运行和修改，但必须保留许可证、版权与 NOTICE 声明。
未经我方事先书面授权，不得用于任何商业用途。 企业内部使用、生产环境部署、SaaS、托管、项目交付、商业集成、收费或免费商业产品、咨询实施以及可产生直接或间接商业利益的使用，均属于商业使用。
商业使用、私有化部署或基于本工程进行商业二次开发，须联系知华科技取得书面商业授权。
“知华科技”“ZhuaTech”相关名称及标识不因源码可见而授予商标许可。

如果你需要商业授权、EHR 系统深度开发、人事流程定制、私有化部署、系统集成或技术支持，请访问 知华科技官网 联系上海如静知华信息科技有限公司。

微信咨询

扫描下方任一二维码添加微信，可咨询 ZhuaTech EHR 部署、二次开发、功能定制及企业数字化解决方案。

知华科技微信咨询二维码一｜上海如静知华信息科技有限公司知华科技微信咨询二维码二｜上海如静知华信息科技有限公司

任选一个二维码扫码添加微信，联系知华科技

人力风险不再只看离职率

新增加的部门风险评估会综合编制缺口、加班率、缺勤率和关键技能断层，输出稳定、观察、高风险或紧急等级，并生成对应的人才补位动作。接口仅对 HR 与管理员角色开放：POST /api/workforce/risk-assessment。

示例场景和权限边界均由 MockMvc 集成测试验证，可直接作为人才驾驶舱的数据服务使用。

部门人力产能规划

POST /api/ehr/insights/workforce-capacity 按需求工时、可用工时、缺勤、加班与关键岗位空缺计算产能缺口和负荷风险，输出排班、备岗和招聘建议。该能力只服务团队产能规划，不用于自动化雇佣或人员淘汰决策。

AI 人岗匹配与结构化面试

新增 POST /api/ehr/ai/talent-match，按岗位必备技能、候选人技能、经验、证书和薪资区间生成匹配分、能力缺口与结构化面试建议。默认规则不调用外部模型；配置 DeepSeek/OpenAI 兼容模型后可增强面试问题，但系统明确排除性别、年龄等歧视性属性，最终录用必须由授权人员决策。

检索关键词：AI EHR、AI HR、智能招聘系统、人岗匹配、简历技能匹配、结构化面试、DeepSeek 人力资源、知华科技 EHR。

试用期转正治理

新增 POST /api/enterprise/ehr/probation-confirmation，把截止日、目标完成度、主管评分、考勤、纪律案件、必修培训、编制和薪酬对齐纳入可审计的转正决策。详见试用期转正治理。