dingtalk-app-server

KO | EN

gitlite — search

#python #hacktoberfest #ai #go #android #docker #macos #nodejs #awesome #awesome-list #security #mcp #ios #openai

dingtalk-app-server

(★ 132)

🥝 基于钉钉的实验室绩效管理系统 (Spring Boot)

dingtalk-app-server Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img width="100" src="https://i.loli.net/2020/11/12/8pP5y6eHwX1VfLd.png" alt="logo">
 <h2 align="center">Dingtalk App Server</h2>
 
 <a href="https://www.codefactor.io/repository/github/nju-softeng/dingtalk-app-server"><img src="https://www.codefactor.io/repository/github/nju-softeng/dingtalk-app-server/badge" alt="CodeFactor" /></a>
 <a href="https://github.com/nju-softeng/dingtalk-app-server/actions?query=workflow%3ARelease">
 <img src="https://github.com/nju-softeng/dingtalk-app-server/actions/workflows/release.yml/badge.svg?branch=release">
 </a>
 <a href="https://github.com/nju-softeng/dingtalk-app-server/actions?query=workflow%3AMain">
 <img src="https://github.com/nju-softeng/dingtalk-app-server/actions/workflows/main.yml/badge.svg?branch=main">
 </a>

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

### 开发环境
<table>
 <tbody>
 <tr>
 <td align="center" valign="middle">
 <a href="https://spring.io/projects/spring-boot" target="_blank">
 <img width="50px" src="https://spring.io/images/spring-initializr-4291cc0115eb104348717b82161a81de.svg">
 </a>
 
 SpringBoot
 
 </td>
 <td align="center" valign="middle">
 <a href="https://spring.io/projects/spring-data-jpa#overview" target="_blank">
 <img width="50px" src="https://i.loli.net/2020/11/13/pR8OtwsSacyuDU7.png">
 </a>
 
 JPA
 
 </td>
 <td align="center" valign="middle">
 <a href="https://mybatis.org/mybatis-3/" target="_blank">
 <img width="50px" src="https://i.loli.net/2021/01/06/lSeIVLagyb4TFWN.png">
 </a>
 
 Mybatis
 
 </td>
 <td align="center" valign="middle">
 <a href="https://dev.mysql.com/downloads/mysql/">
 <img width="50px" src="https://i.loli.net/2020/11/13/GQE3xMAbWd72hVc.png">
 </a>
 
 MySQL 8
 
 </td>
 <td align="center" valign="middle">
 <a href="https://ding-doc.dingtalk.com/doc#/faquestions/vzbp02" target="_blank">
 <img width="50px" src="https://i.loli.net/2020/11/13/DVpc9nF2JToQyHg.png">
 </a>
 
 Dingtalk SDK
 
 </td>
 <td align="center" valign="middle">
 <a href="https://docs.docker.com/" target="_blank">
 <img width="50px" src="https://i.loli.net/2020/11/13/27eyNzt698aoilM.png">
 </a>
 
 Docker
 
 </td>
 <td align="center" valign="middle">
 <a href="https://docs.docker.com/compose/" target="_blank">
 <img width="50px" src="https://i.loli.net/2020/11/13/TcewOXGMWHLiNtE.jpg">
 </a>
 
 Docker Compose
 
 </td>
 <td align="center" valign="middle">
 <a href="https://github.com/features/actions" target="_blank">
 <img width="50px" src="https://i.loli.net/2021/01/06/EcsNSzQZl2TPyB6.png">
 </a>
 
 Github Actions
 
 </td>
 </tr>
 </tbody>
</table>

+ 钉钉SDK的封装 👉 ：[com.softeng.dingtalk.api](https://github.com/nju-softeng/dingtalk-app-server/tree/main/src/main/java/com/softeng/dingtalk/api)
+ 项目前端代码  👉 ：[dingtalk-app-web](https://github.com/nju-softeng/dingtalk-app-web)

### 注意事项  
+ 使用了lombok 插件简化代码，idea 需要安装lombok 插件，否则编译过不去
+ 系统启动时，[初始化操作](https://github.com/nju-softeng/dingtalk-app-server/blob/9e302075e2e8d55eb3736162066bf4bf203232c9/src/main/java/com/softeng/dingtalk/service/InitSys.java#L20)会调用钉钉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` 清理无用的镜像 
   
部署相关脚本如下
+ 生产环境CI脚本：[.github/workflows/release.yml](https://github.com/nju-softeng/dingtalk-app-server/blob/main/.github/workflows/release.yml)  
+ 测试环境CI脚本：[.github/workflows/main.yml](https://github.com/nju-softeng/dingtalk-app-server/blob/main/.github/workflows/main.yml)  
+ 对应的构建部署脚本：[dingtalk-app-build (private)](https://github.com/nju-softeng/dingtalk-app-build)
+ docker-compose 配置：[docker-compose.yml 配置文件](https://github.com/nju-softeng/dingtalk-app-server/wiki/docker_compose.yml)

### 系统运维  
+ [定时备份docker中的数据库](https://www.yuque.com/zhanyeye/devops/gii4pk)
+ [bin log日志恢复误删数据](https://www.cnblogs.com/dslx/p/11578972.html)

### 前端预览  
![01](https://user-images.githubusercontent.com/35565811/147812078-ee6d23d6-183b-46ee-9cab-fa511a9db3e1.png)
![02](https://user-images.githubusercontent.com/35565811/147812086-3de4a6d8-0951-45fa-b954-012c1bdecf0e.png)
![03](https://user-images.githubusercontent.com/35565811/147812088-b7efadb5-4cb7-492b-8b91-3fdcf1d45f33.png)
![04](https://user-images.githubusercontent.com/35565811/147812093-98630a58-0f5c-4f57-b004-e63d017ad573.png)
![05](https://user-images.githubusercontent.com/35565811/147812102-c0d0771b-5260-4475-89fe-6a5ca2e70bc5.png)
![06](https://user-images.githubusercontent.com/35565811/147812111-2b46366e-be0a-4ab1-9790-32e8346afccc.png)
![07](https://user-images.githubusercontent.com/35565811/147812115-381fe5c5-5090-44ba-8adb-fe4126f702b8.png)
![08](https://user-images.githubusercontent.com/35565811/147812121-983cac86-4d19-42c8-8c79-d72117603c46.png)
![09](https://user-images.githubusercontent.com/35565811/147812126-3a237f3d-3305-4428-b9f2-7ad2b36075eb.png)
![10](https://user-images.githubusercontent.com/35565811/147812129-0294e664-6eed-46cf-b04e-128b153b974d.png)
![11](https://user-images.githubusercontent.com/35565811/147812136-f8fea23c-0d52-4af9-a017-cc8cfaf2b4aa.png)
![12](https://user-images.githubusercontent.com/35565811/147812141-fcc1ba3f-5b27-4c92-b311-148117e31aef.png)
![13](https://user-images.githubusercontent.com/35565811/147812148-e3b09cc8-3499-402b-b45c-087d2651b205.png)
![14](https://user-images.githubusercontent.com/35565811/147812150-7f8a93a7-a6b8-4e73-82ab-24d17210b46c.png)
![15](https://user-images.githubusercontent.com/35565811/147812155-ad4aadc4-9e23-4595-983e-7f648cd888cc.png)
![16](https://user-images.githubusercontent.com/35565811/147812167-b1e5ee61-550b-49fe-be29-75db3e656a8c.png)
![17](https://user-images.githubusercontent.com/35565811/147812171-74e74dc2-a89e-4efe-9792-32894b697004.png)
![18](https://user-images.githubusercontent.com/35565811/147812176-5587bd9a-8297-43bf-9941-64204d07f6e6.png)
![19](https://user-images.githubusercontent.com/35565811/147812180-e26104c1-cff6-4faa-b190-bffc4e793b43.png)

![project-detail-1.png](https://i.loli.net/2021/01/11/w8Tr7lUkK1pOaL9.png)
![project-detail-2.png](https://i.loli.net/2021/01/11/UihclBsEJA5wZab.png)

| <img src="https://i.loli.net/2020/12/12/j4s6RKzX7JTqyiM.png"/> | <img src="https://i.loli.net/2020/12/12/FTiDv3c1HGk5eKM.png"/> | <img src="https://i.loli.net/2020/12/12/GqWDFnU4dLmwXa7.png"/> |
| ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ |

dingtalk-app-server

dingtalk-app-server Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

dingtalk-app-server

dingtalk-app-server Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README