TduckAppearance
社区版项目介绍
特别说明： 社区版为开源学习与体验版本，不提供 1v1 即时技术支持，请理解。
如在使用过程中遇到问题，可通过社区 Issue 寻求帮助： 👉 提交问题
如果本项目对您有所帮助，欢迎 👉 给项目 Star！，您的支持是我们持续维护的动力
🚀 部署选型与环境要求
在准备部署 Tduck 社区版之前，请先查阅以下运行环境要求，并根据您的技能水平选择最合适的部署方案：
💻 1. 运行环境要求 (Prerequisites)
- 操作系统：CentOS / Ubuntu / Debian / macOS / Windows
- Java 环境：JDK 1.8 ⚠️ (核心依赖，不支持 JDK 11/17+)
- 数据库：MySQL 5.7 或以上 (需要支持 JSON 字段类型)
- 缓存服务：无额外中间件依赖 (社区版使用 Ehcache 本地缓存，自动管理登录 Token 和验证码，不需要安装 Redis)
📦 2. 部署方式选型建议
| 部署方式 | 适合人群 | 推荐指数 | 优点 | 缺点 |
|---|---|---|---|---|
| 宝塔一键部署 (新) | 小白用户 / 站长 | ⭐⭐⭐⭐⭐ | 傻瓜式一键完成部署，有可视化控制面板 | 较难在容器层面进行精细管理 |
| Docker 部署 | 运维人员 / 容器爱好者 | ⭐⭐⭐⭐ | 环境隔离，一键安装依赖，不污染宿主机环境 | 需要具备一定的 Docker 基础知识 |
| 前后端分离部署 | 开发者 / 定制化企业 | ⭐⭐⭐ | 前后端独立编译，适合进行功能扩展和二次开发 | 编译步骤相对较多，需手动配置 Nginx |
您可以点击左侧侧边栏对应的部署指南，开启您的部署之旅。
一、项目仓库
| 项目类型 | Gitee | GitHub |
|---|---|---|
| 后端项目地址 | tduck-platform | tduck-platform |
| 前端项目地址 | tduck-front | tduck-front |
二、版本说明
- v4 / v5 表单设计器基于 Pro 版表单编辑器能力
- 该部分通过 npm 方式引入，不支持修改源码
- 可 永久免费使用
三、体验地址
- 预览地址：https://demo.tduckapp.com
- 登录方式：微信扫码登录
默认账号（部署后）
| 版本 | 账号 | 密码 |
|---|---|---|
| v3 | test@tduckapp.com | 12345678 |
| v4 | admin@tduckcloud.com | 123456 |
| v5 | admin@tduckcloud.com | 123456 |
| v6 | admin@tduckcloud.com | 123456 |
成熟的开发者要学会先看文档 😤 每个人都来问一遍，真的会谢。
重要通知
社区版体验环境会 定期重置数据， 请勿用于正式业务场景，如出现数据丢失概不负责。
四、技术体系
服务端
SpringBoot
Mybatis-Plus
Lombok
Hutool
Guava
客户端
Vue2
ElementUI
Echarts
Axios
nprogress
五、后端模块结构
- tduck-common：通用模块 (包含基础异常、通用常量、系统参数配置、Ehcache缓存工具类)
- tduck-account：账号体系 (用户登录注册、图形/邮箱验证码校验、JWT认证)
- tduck-storage：文件与存储 (统一上传接口，支持本地、阿里云OSS、七牛云、又拍云、S3等存储)
- tduck-form：问卷表单核心业务 (表单设计、数据收集、数据统计大屏后台)
- tduck-webhook：Webhook数据推送 (实现表单数据新增、修改、删除时实时推送到指定URL接口)
- tduck-wx-mp：微信公众号模块 (扫码登录、模板消息推送、微信授权与交互)
- tduck-ai：AI 问卷助手核心 (集成 DeepSeek 实现通过自然语言提示词生成表单)
- tduck-api：对外 API 接口层 (核心打包部署模块)
六、进阶文档
七、开源社群说明
八、免责声明
近期接到有关单位反馈，部分用户将填鸭表单用于非法用途。 为维护平台合规与用户权益，TDUCK 特作如下声明：
TDUCK 填鸭表单仅通过官网 tduckcloud.com 展示产品信息，并提供官方联系方式进行销售。 我们 未授权任何分销商、代理商、分公司或经销机构。
用户必须在合法合规前提下使用 TDUCK 产品。 如发现任何违法行为，我们将全力配合有关机关调查或向相关部门举报。
因用户违法使用所产生的一切法律责任，均由用户自行承担，TDUCK 不承担任何连带责任。
TDUCK 不对社区版提供任何形式的担保， 与使用本站资源相关的风险由用户自行承担。
TDUCK 将持续坚持合法合规的产品开发与服务理念， 也期待所有用户在法律允许范围内合理使用本产品。
特此声明。