# tduck-platform
**Repository Path**: ArrayEdu/tduck-platform
## Basic Information
- **Project Name**: tduck-platform
- **Description**: TDUCK开源问卷表单系统采用使用范围最广的SpringBoot+Vue技术栈方案，ElementUI加持，功能强大界面清新，支持一键部署。注释完善，代码低耦合，方便剥离集成；PRO版本新功能即将更新，支持多端填报
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.tduckcloud.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1470
- **Created**: 2022-08-14
- **Last Updated**: 2022-08-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## _TDUCK_ 填鸭表单收集器
[](https://gitee.com/TDuckApp/tduck-platform)
[](https://gitee.com/TDuckApp/tduck-platform/members)
目前市面上的表单平台虽然功能强大，但是部分业务组件或者额外收取存储等费用，且费用较高，在数据隐私性较强且有特殊表单需求的场景下无法满足业务需求，国内的开源表单系统比较少，tduck表单应运而生。愿景能够让企业低成本拥有独立自定义表单问卷，快速赋能业务。
### 开源版演示地址
- 演示地址：[www.tduckcloud.com](http://www.tduckcloud.com)
- 登录方法：扫码登录即可
- 文档地址：[点击查看文档](http://www.yuque.com/tduck/home)
- 部署默认账号： test@tduckapp.com/12345678
### PRO版演示地址
- 演示地址：[www.tduckcloud.com](http://www.tduckcloud.com)
- 演示账号密码：test/12345678
## 快速启动
1. 配置最小开发环境：
* [MySQL5.7或以上](https://dev.mysql.com/downloads/mysql/)
* [JDK1.8或以上](http://www.oracle.com/technetwork/java/javase/overview/index.html)
* [Maven](https://maven.apache.org/download.cgi)
* [Nodejs](https://nodejs.org/en/download/)
2. 创建一个tduck的数据库 **版本选择mysql5.7** ，并执行项目目录下doc/tduck.sql文件
3. 启动后端服务
打开命令行，输入以下命令
```bash
mvn clean install -DskipTests
cd tduck-platform/tduck-api
mvn clean package -DskipTests
java -Dfile.encoding=UTF-8 -jar target/tduck-api.jar
```
4. 启动管理后台前端
打开命令行，输入以下命令
```bash
npm install -g cnpm --registry=https://registry.npm.taobao.org
cd tduck-front
cnpm install
cnpm run serve
```
此时，浏览器打开，输入网址`http://localhost:8888`, 进入页面。
## :star: 一键部署：
部署文件下载方式：关注公众号 **"TDUCK填鸭"** ，回复“部署文件”，下载我们提供的简化部署文件
注意事项：部署之前需要先安装JDK8
## 部署步骤：
##### 1. 导入数据库 目前只支持mysql5.7及以上版本
创建数据名为 **`tduck`**
下载`tduck-v3.sql`文件 并且导入创建的数据中
##### 2. 下载项目jar文件
下载项目jar包文件`tduck-api.jar`到本地
##### 3.修改配置并启动项目
下载`application-custom.yml `配置文件
把下载的jar包和配置文件放在同一个目录下
修改为自己的配置，主要修改位置为数据库以及文件存储配置
##### 4.运行项目
运行如下命令启动项目
```bash
java -Dfile.encoding=UTF-8 -jar tduck-api.jar --spring.profiles.active=custom
```
出现如下提示代表启动完成
##### 5.访问项目
浏览器地址栏输入http://localhost:8999/
默认账号密码：test@tduck.com/12345678
### 宝塔部署教程
视频教程：https://www.bilibili.com/video/BV1gS4y1Y7bw/
宝塔配置参数：
``` bash
/usr/local/btjdk/jdk8/bin/java -jar -Xmx1024M -Xms256M /www/wwwroot/xxxx.jar --server.port=5097 --spring.datasource.url=jdbc:mysql://localhost:3306/tduck --spring.datasource.username=root --spring.datasource.password=root
```
:warning: 注意事项：上述参数需要改成自己的路径，且mysql版本需要选择 **5.7**
## 技术体系
### 服务端
```
- SpringBoot
- Mybatis-Plus
- Lombok
- Hutool
- Guava
```
### 客户端
```
- Vue2
- ElementUI
- Echarts
- Axios
- nprogress
```
### 后端项目结构
- tduck-common 通用模块
- tduck-account 账号模块
- tduck-storage 存储模块
- tduck-project 项目模块
- tduck-wx-mp 微信公众号模块
- tduck-api 客户端API
### 项目源码
| 后端源码 | 前端源码 |
|--- | --- |
| https://gitee.com/TDuckApp/tduck-platform | https://gitee.com/TDuckApp/tduck-front |
| https://github.com/TDuckCloud/tduck-platform | https://github.com/TDuckCloud/tduck-front |
### TDUCK社区
### 了解更多
- [来看看TDUCK的新面孔](https://mp.weixin.qq.com/s/pLltfRv-KvStMxKefAvD_g)
- [参与TDUCK项目，贡献一份力量！](https://gitee.com/TDuckApp/tduck-platform/issues/I4ZC6R)
- [JAR包部署修改前端内容](https://www.yuque.com/mawuhui/kgacqz/zpubyn)
- [宝塔Jar包部署如何指定配置文件](https://www.yuque.com/mawuhui/kgacqz/paqc6g)