# isp_autopunch

**Repository Path**: arcadia666/isp_autopunch

## Basic Information

- **Project Name**: isp_autopunch
- **Description**: 成都大学ISP自动化打卡
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-08-11
- **Last Updated**: 2023-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 1.项目背景

- 本项目设计的想法最初是受一位学长启发，并不是本人首创。当时看了那位学长的仓库，采用的是Python技术栈以及部分爬虫相关技术。发现使用起来需要一定编程基础，比如需要自己搭建py运行环境等，对小白不是很友好。为了降低使用门槛，也想锻炼自己Java编程能力因此有了开发此项目的想法。
- 设计初心只是为了偷懒（bushi

### 2.项目特点

- 采用Java主流开发框架springboot、mybatis-plus、selenium自动化测试等相关技术栈。
- 结合业务和使用场景，本项目更注重功能和实用性。结构简单，容易理解。
- 项目特点：
  - 无需登陆，拆箱即用
  - 信息一次收集无需再次填写
  - 自动化打卡，结果通过邮件通知
  - 多线程异步处理打卡任务
  - 打卡失败补偿机制：
    1. 因为程序异常或服务器拥堵等不可控因素导致打卡失败，不消耗补偿次数并间隔一小时触发重新打卡
    2. 若是由于用户填写信息错误导致的打卡失败，消耗一次补偿打卡次数并间隔一小时触发重新打卡
    3. 补偿次数设限为3次
    4. 可通过更新填写的信息或每日零点触发重置次数

### 3.使用说明

- 可能导致打卡失败的原因：
  - 学号，密码，地区名称（有些是以县结尾，有些是区）等个人信息填写错误
  - 已经存在打卡记录
  - ~~我写了bug…~~
  - ISP或者服务器问题 
- 打卡失败补偿机制：
  - 打卡失败 会有3次打卡补偿次数，每次打卡结果以邮件形式通知
  - 每小时触发一次补偿打卡 超过三次不再补偿
  - 补偿次数可通过更新信息或者次日凌晨自动重置3. 如何判断打卡是否成功：
  - 通知邮件若出现一次打卡成功则视为成功，否则失败。
- 关于哪些人需不需要填写信息问题：
  - 不管是否打过卡都可以填写，确保信息正确的前提下只需填写一次 后续每日自动打卡 结果通过邮件通知
  - 若一直出现打卡失败，先检查信息是否填写正确 然后可以反馈给我
### 4.注意事项

- 由于是旧项目更新，设计之初欠缺考虑（偷懒），密码没做加密存储，说人话就是填写的密码只有我看得到，不过所有数据在开学之后会清除掉，担心隐私泄露或介意的用户谨慎填写！
- ~~脚本执行需要时间，因此点了提交需要过几秒才有反应是正常的，不用重复提交。十块钱一个月的服务器经不起兄弟们折腾…~~ 
- 新增多线程异步处理打卡任务解决了响应慢的问题
- 本项目仅供学习交流使用，请勿将isp_autopunch项目的任何内容用于商业或非法目的，否则后果自负。