Dingtalk App Back End

• 后端： https://github.com/nju-softeng/dingtalk-app-back-end
• 前端： https://github.com/nju-softeng/dingtalk-app-font-end

目标与期望

基于钉钉微应用开发的实验室绩效管理系统，将实验室的绩效、学分、论文评审管理与钉钉对接。
主要功能有：绩效、学分申请与审核，论文评审投票及学分管理，实验室助研金计算等，导出绩效和助研金报表。

开发环境

<sub>SpringBoot</sub>

<sub>JPA</sub>

<sub>Mybatis</sub>

<sub>MySQL 8</sub>

<sub>Dingtalk SDK</sub>

<sub>Docker</sub>

<sub>Docker Compose</sub>

<sub>Github Actions</sub>

• 钉钉 SDK 的封装 👉 ：com.softeng.dingtalk.api
• 项目前端代码 👉 ：dingtalk-vue

注意事项

• 使用了 lombok 插件简化代码，idea 需要安装 lombok 插件，否则编译过不去
• 由于目前钉钉小程序只支持 GET/POST, 考虑到兼容性这里的接口全部为 GET/POST 方式
• 系统启动时，初始化操作会调用钉钉 SDK ，拉取钉钉组织的所有用户, 请先在开发平台设置出口 IP

持续部署

本项目使用 GitHub Actions 实现 CI ，受外网网速限制，没有采用在 GitHub 机器上构件镜像，再拉取到服务器上运行的方式。而是在每次 CI 触发后，GitHub 机器 ssh 登陆服务器，执行脚本来拉取最新代码，构建镜像，并运行容器，具体如下：

1. 从 GitHub 仓库中拉去最新代码到服务器本地仓库
2. 使用 mvn 构建项目
3. docker-compose build 构建镜像
4. docker-compose up -d 在后台启动容器
5. docker image prune -f 清理无用的镜像

GitHub Actions 的 CI 脚本如下

• 生产环境 CI 脚本：.github/workflows/prod.yml
• 测试环境 CI 脚本：.github/workflows/test.yml
• 与 CI 脚本对应的项目结构如下

  .
  |__ dingtalk
      |__ dingtalk-springboot  // 后端代码
      |__ dingtalk-vue         // 前端代码
      |__ docker-compose.yml   // docker-compose 配置文件
  

docker-compose 编排配置如下：

• docker-compose.yml 配置文件

系统运维

• 定时备份 docker 中的数据库
• bin log 日志恢复误删数据

前端预览