# 苏心签电子合同-开源电子合同

**Repository Path**: chcm/sign

## Basic Information

- **Project Name**: 苏心签电子合同-开源电子合同
- **Description**: 基于Java的电子签章开源系统，提供合同管理、数字签名、骑缝章、区块链存证等企业级签署能力。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://suxin365.com
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 3
- **Created**: 2026-04-23
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Contract - 企业级合同管理系统

一个现代化的企业级合同管理系统，提供完整的合同全生命周期管理能力，支持多租户架构，适合各类企业快速部署和二次开发。

**核心亮点**
- 多租户架构：支持 SaaS 模式，同一系统服务多个企业
- 全流程管理：合同创建、审批、签署、归档、续约等完整生命周期
- 现代技术栈：后端 Spring Boot 3.5，前端 Vue 3 + Vite 7 + TDesign
- 集成丰富：支持微信支付、阿里云 OSS、阿里云短信等第三方服务
- 高性能：基于 QueryDSL 和 SqlToy 的优化查询方案

**商业版**
- 官方网站：[suxin365.com](https://suxin365.com)
- 演示地址：[pc.suxin365.com](https://pc.suxin365.com)

**主要功能**
- 合同管理：合同起草、审批流程、电子签署、归档管理
- 租户管理：企业入驻、用户权限、数据隔离
- 审批流程：自定义审批规则、流程跟踪、待办提醒
- 报表分析：合同统计、数据可视化、Excel 导出
- 系统管理：角色权限、用户管理、日志审计

**技术栈**
- 后端：`Spring Boot 3.5`、`Java 21`、`Gradle`、`JPA`、`QueryDSL`、`SqlToy`
- 前端：`Vue 3`、`Vite 7`、`TDesign Vue Next`、`TailwindCSS 4`
- 状态管理：`Pinia`、`Vue Router`
- 数据存储：`MySQL`、`Redis`
- 认证授权：`Sa-Token`
- 第三方集成：`微信支付`、`阿里云 OSS`、`阿里云短信`、`TinyMCE`、`ECharts`、`VXE Table`
**项目结构**
```
contract/
├─ tenant/                       # 租户端模块
│  ├─ tenant-front/              # 租户端前端（Vue 3 + Vite）
│  ├─ tenant-api/                # 租户端接口（Spring Boot）
│  └─ tenant-service/            # 租户端业务服务
├─ admin/                        # 管理端模块
│  ├─ admin-front/               # 管理端前端（Vue 3 + Vite）
│  ├─ admin-api/                 # 管理端接口（Spring Boot）
│  └─ admin-service/             # 管理端业务服务
├─ kernel/                       # 核心公共模块
│  ├─ entity/                    # 实体定义
│  ├─ domain/                    # 领域服务
│  ├─ service/                   # 公共服务
│  └─ web/                       # Web 配置
├─ docs/                         # 文档
├─ build.gradle                  # 根构建配置
├─ settings.gradle               # 多模块定义
└─ libs.version.toml             # 版本目录
```

**子项目结构（示例：tenant-front）**
```
tenant/tenant-front/
├─ src/
│  ├─ api/            # 业务接口封装
│  ├─ components/     # 通用组件
│  ├─ libs/           # 工具库封装
│  ├─ page/           # 页面模块
│  ├─ router/         # 路由配置
│  ├─ store/          # Pinia 状态管理
│  └─ style/          # 全局样式
└─ package.json       # 前端依赖与脚本
```

**环境要求**
- JDK 21+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+

**快速开始**

1. 克隆项目
```bash
git clone <repository-url>
cd contract
```

2. 后端启动
```bash
# 启动租户端接口服务
./gradlew :tenant:tenant-api:bootRun

# 启动管理端接口服务
./gradlew :admin:admin-api:bootRun
```

3. 前端启动
```bash
# 租户端
cd tenant/tenant-front
npm install
npm run dev

# 管理端
cd admin/admin-front
npm install
npm run dev
```

**构建与发布**

- 后端打包：
```bash
./gradlew :tenant:tenant-api:bootJar
./gradlew :admin:admin-api:bootJar
```

- 前端打包：
```bash
# 租户端
cd tenant/tenant-front && npm run build

# 管理端
cd admin/admin-front && npm run build
```

**配置说明**

- 后端配置：各模块 `src/main/resources/application.yaml`
- 数据库配置：`kernel/domain/src/main/resources/application-db.yaml`
- 前端环境变量：`VITE_BASE_API` 接口前缀
- 本地开发：可在 `vite.config.js` 配置反向代理

**核心依赖**

- Spring Boot 3.5.4
- Hutool 5.8.39
- Sa-Token 1.44.0
- QueryDSL 5.1.0
- SqlToy 5.6.51
- Vue 3.5.18
- TDesign Vue Next 1.15.2
- VXE Table 4.15.5

**贡献指南**

欢迎提交 Issue 反馈问题和建议，也欢迎提交 PR 参与代码贡献。

**许可证**

Apache License 2.0