钉钉微应用开发 SpringBoot + VUE

[zhanyye]

• 后端： https://github.com/zhanyeye/dingtalk-springboot
• 前端： https://github.com/zhanyeye/dingtalk-vue

Dingtalk Springboot

目标与期望

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

涉及的技术

SpringBoot

JPA

Mybatis

MySQL 8

Dingtalk SDK

Docker

Docker Compose

Github Actions

• 钉钉 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 日志恢复误删数据

前端预览

[zarvin]

感谢开源，打破零回复

[hflyf123]

学习一下

[neighbads]

支持下！

[idlewater]

厉害

[steptodream]

拿来学习一波

[zhanyye]

谢谢 star 呀~，感谢~🧡

[webmasterisadog]

好东西

[webmasterisadog]

看了一圈，没看到配置钉钉 key 和 id 的入口在哪里

[zhanyye]

@webmasterisadog 入口在这里：
1. https://github.com/zhanyeye/dingtalk-springboot/blob/c058268fe8465915cd5f9b3c69ad6cd67440af06/src/main/java/com/softeng/dingtalk/api/BaseApi.java#L35-L70
2. https://github.com/zhanyeye/dingtalk-springboot/blob/master/src/main/resources/application-dev.properties