支持钉钉同步！一款MIT协议开源的合同管理系统，内置合同审批、履约跟踪、资料归档、流程管理一站式管理功能，可开箱即用

简介

zContract是一款MIT协议、开源免费的企业合同管理系统，专为企业合同应用场景设计，可有效解决传统模式下Word模板合同起草效率低、审批流程纸质化、台账记录不完整等难题。

系统集合同起草、模板管理、审批流转、合同编号、在线编辑、看板台账、文档处理、多渠道通知、钉钉组织同步等功能于一体，内置可视化Web管理界面，支持 OnlyOffice 和 WPS 双引擎在线编辑，帮助用户直观掌握合同全生命周期状态流转。

系统采用前后端分离架构设计，基于主流技术栈 RuoYi-Vue-Plus + SpringBoot + Vue + Activiti + OnlyOffice + MySQL构建，功能全面，界面美观大气，可二次开发和私有化部署，十分适合中小企业、大型企业部门级应用、数字化转型服务商等用户搭建企业个性化合同管理使用。

功能列表

• 相对方管理：

  • 内置统一管理签约对方单位盒联系人信息，支持进行增删改数据等基础操作。

  • 支持合同模块自动关联，可自动匹配对方签约主体，减少人工操作。

  • 支持对接天眼查接口，实时获取相对方工商、抵押、违法等信息，做好事前风险防范，全方位保障合同安全有效。

• 模板管理：

  • 支持合同模板统一创建、分类、存储和版本记录。

  • 支持自定义标准化的合同流程和模板，一键复用，保障合同的一致性和合规性。

• 合同起草和在线编辑：

  • 支持在线起草合同，选择模板后快速生成合同初稿，简单快捷。

  • 默认集成 OnlyOffice + WPS 双引擎，支持多人实时在线协同编辑、评论和修改。

  • 支持文档要素绑定，可将合同内容和数据源、条款进行绑定，方便查看。

  • 支持合同在线合成，可将审批单信息和合同正文合并生成最终文档。

• 审批流转：

  • 内置 Activiti 6.x 工作流引擎，支持动态流程配置。可根据合同类型、金额、角色等设置不同审批路径，满足不同用户的使用需求。

  • 支持动态审批单配置，企业可自定义审批单字段。

  • 支持审批进度实时查询，支持移动端 H5 审批操作。

• 合同管理：

  • 支持合同起草后自动生成规范的合同编号，方便检索和记录。

  • 内置统一的合同台账管理，支持检索、查看、下载等操作。支持移动端 H5 查看台账。

• 风险管理：

  • 支持合同到期提醒、任务到期提醒、预警提醒等多种消息推送。

  • 支持站内消息、短信、邮件等多渠道通知，可对接钉钉、企业微信等即时通讯工具，方便快捷。

  • 内置合同全流程操作审计日志，记录创建、编辑、审批、变更、借阅、查看、下载等关键操作，方便问题追溯和排查。

• 权限管理：

  • 采用基于角色的数据权限配置，用户只能访问与其角色相关的合同数据，全方位保障用户安全。

  • 支持分级分权管理和多租户模式，可实现集团内不同部门、子公司的数据隔离。

  • 支持私有化部署，提高更高级别的数据安全和隐私保护。

• 第三方系统集成：

  • 支持对接钉钉开放平台，实现组织架构同步、OAuth 登录、消息推送等功能。

  • 支持对接内部办公系统、电子签系统等其他系统，方便用户统一整合企业内部数据，最大化数据价值。

• RuoYi-Vue-Plus二开：

  • 基于RuoYi-Vue-Plus二次开发，系统架构清晰明了，便于二次拓展

  • 内置Sa-Token+JWT无状态Token认证、MyBatis-Plus ORM、Redis缓存、代码生成器等通用能力，功能可开箱即用，无需需重复造轮子。

功能截图

登录页面：

系统首页：

合同起草：

审批流程：

在线编辑：

合同审批：

系统架构

架构图：

项目结构：

├── ruoyi-admin                # 启动入口、Web 控制层
├── ruoyi-base                 # 基础框架聚合（基于 RuoYi-Vue-Plus）
│   ├── ruoyi-common           # 通用工具
│   ├── ruoyi-framework        # 框架核心配置
│   ├── ruoyi-system           # 系统管理（用户、角色、菜单、字典等）
│   ├── ruoyi-generator        # 代码生成器
│   └── ruoyi-tenant           # 多租户支持
├── zxcm-contract              # 合同核心业务（合同、模板、在线编辑等）
├── zxcm-form                  # 合同类型配置
├── zxcm-workflow              # 合同工作流（基于 Activiti）
├── zxcm-notify                # 消息通知（邮件、短信）
├── zxcm-third                 # 第三方能力
│   ├── zxcm-excel             # Excel/Word 导入导出
│   └── zxcm-syncData          # 钉钉组织架构/用户同步、第三方账号映射
└── zxcm-ui                    # PC 前端（Vue 2 + Element UI）

技术栈：

前端：
  核心框架: Vue
  UI 组件库: Element UI
  构建工具: Vue CLI
  HTTP 客户端: Axios
  端口: 80（默认账号 zxcmAdmin / 123456）

后端：
  核心框架: Spring Boot
  权限认证: Sa-Token + JWT
  ORM 框架: MyBatis-Plus
  工作流引擎: Activiti
  数据库: MySQL
  缓存: Redis
  文档处理: docx4j / iText / POI
  通知组件: 邮件 + 短信 sms4j
  在线编辑: OnlyOffice / WPS
  构建工具: Maven
  JDK 版本: Java


企业通讯：
  钉钉开放平台（组织架构同步、OAuth登录、消息推送）
  JustAuth（第三方OAuth登录）

部署：
  Docker + Compose 容器化部署

快速开始

1、环境准备：

- JDK 11
- Maven 3.8+
- MySQL 8.x
- Redis
- Node.js（前端）
- OnlyOffice（合同在线编辑，可选）

2、数据库初始化： 创建utf8mb4数据库，导入初始化脚本，本地开发时建议统一改库名为zxcm。

mysql -u <账号> -p zxcm < script/sql/zxcm_init.sql

3、修改后端配置： 打开ruoyi-admin的application-dev.yml，配置MySQL、Redis、OnlyOffice等基础连接信息。

# ruoyi-admin/src/main/resources/application-dev.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/zxcm?useUnicode=true
    username: root
    password: 你的密码
  redis:
    host: localhost
    port: 6379

4、编译启动后端： 使用Maven编译打包后启动jar，后端默认端口8080。

mvn clean package -DskipTests

java -jar ruoyi-admin/target/zxcm-admin.jar

5、启动前端： 进入zxcm-ui安装依赖并启动，前端默认端口80，默认账号zxcmAdmin / 123456，首次登录立即修改。

cd zxcm-ui
npm install
npm run dev

6、系统初始化配置： 首次登录后按顺序完成租户、部门、岗位、角色、用户、签约主体、合同类型、审批流程、编号规则、合同模板等基础配置，验证基础数据链路是否打通。

租户 → 部门 → 岗位 → 角色 → 用户 → 签约主体 → 合同类型 → 审批流程 → 编号规则 → 合同模板

7、验证OnlyOffice在线编辑（可选）： 部署OnlyOffice Document Server，配置回调地址后，在合同起草页面验证多人协同编辑与回调保存是否正常。

# OnlyOffice Document Server（Docker 方式）
docker run -d --name onlyoffice \
  -p 8088:80 \
  onlyoffice/documentserver

8、Docker部署验证： 部署脚本与编排文件位于script目录，部署前请修改docker-compose.yml与各application-*.yml中的默认账号、密码与密钥，验证容器化部署链路。

# script/docker-compose.yml

# 修改默认账号、密码、JWT 密钥后再部署
docker compose up -d