### 立项原因
旨在解决学校校园卡管理和学生信息查询的痛点问题，为学生和教职工提供便捷的自助服务，减少人工窗口排队时间，提高校园服务效率。
### 行业场景
该系统应用于教育行业，主要服务于中小学校园。随着校园信息化建设的不断推进，传统的人工服务模式已经无法满足日益增长的校园服务需求，尤其是在校园卡管理、学生信息查询等高频服务场景下，自助终端系统的引入成为必然趋势。
### 业务背景
学校日常管理中，学生经常需要查询个人信息、办理校园卡补卡等业务，这些业务传统上需要到相关部门的人工窗口办理，不仅效率低下，而且容易造成排队拥堵。自助终端系统的出现，使得学生可以在任何时间、任何地点（校内）自助完成这些业务，大大提高了服务效率和用户体验。
### 核心功能模块
1. 学生信息查询模块 ：通过身份证号查询学生的基本信息，包括姓名、手机号码、证件号码、校园卡号、余额、校园卡状态、入学年度、入学季度、年级、班级等。
2. 校园卡补卡模块 ：支持学生通过身份证号和新校园卡号办理补卡业务，实现校园卡的快速更换。
3. 身份证识别模块 ：预留身份证读卡器SDK接入点，支持自动读取身份证信息，减少手动输入错误。
4. 自动登录模块 ：实现系统的自动登录，包括验证码获取、识别和登录请求提交。
5. 日志记录模块 ：记录系统运行状态和操作日志，支持异常信息的详细记录和分析。
6. 配置管理模块 ：通过JSON配置文件管理系统参数，包括应用配置、读卡器配置、UI配置、性能配置、登录配置和API配置等。
### 主要功能描述
- 身份证号输入与验证 ：支持手动输入身份证号，并实时验证身份证号的长度和格式，确保输入的准确性。
- 学生信息查询 ：根据输入的身份证号，查询并显示学生的详细信息，包括基本信息、校园卡信息和余额信息。
- 校园卡补卡 ：在学生校园卡丢失或损坏时，支持通过输入新校园卡号办理补卡业务，快速更换校园卡。
- 自动登录 ：系统启动时自动执行登录流程，包括获取初始Cookie、获取initKey公钥、获取验证码、识别验证码和提交登录请求等步骤。
- 身份证读卡器支持 ：预留身份证读卡器SDK接入点，支持自动读取身份证信息，提高操作效率和准确性。
- 日志记录与错误处理 ：详细记录系统运行状态和操作日志，支持异常信息的捕获和处理，确保系统的稳定运行。
- 配置管理 ：通过JSON配置文件管理系统参数，支持灵活的配置调整，适应不同场景的需求。
### 负责的具体任务
全代码编写
### 技术栈与实现亮点 技术栈
- 开发语言 ：C#
- UI框架 ：Windows Forms
- 网络通信 ：HttpClient
- 数据序列化 ：JSON
- 配置管理 ：JSON配置文件
- 日志记录 ：自定义日志系统
- 验证码识别 ：Coze API 实现亮点
1. HttpClient管理 ：实现单例模式与连接池管理，减少网络开销，提升性能。
2. 异常处理 ：自定义异常类（如StudentNotFoundException、ApiCallException），细化错误类型，提供清晰提示。
3. 数据脱敏 ：身份证号等敏感信息脱敏处理（前6位+后4位），保护用户隐私。
4. API缓存 ：实现响应缓存机制，包含缓存键生成、过期管理与清理，减少重复调用。
5. 并行处理 ：使用Task.WhenAll并行查询校园卡与余额信息，缩短响应时间。
6. 配置管理 ：通过JSON文件集中管理系统参数（应用、读卡器、UI等配置），支持灵活调整。
7. 自动登录 ：集成Coze API识别验证码，自动化完成登录流程（Cookie获取、公钥获取、验证码处理等）。
8. 线程安全 ：使用lock语句确保缓存操作线程安全，保障系统稳定。
9. 性能监控 ：实现内存管理器，监控系统内存使用，防止资源泄漏。 技术难点
1. 自动登录流程 ：处理多步骤登录（Cookie、公钥、验证码等）的异常与边界情况，确保流程稳定。
2. 缓存策略 ：设计合理的缓存键生成与过期机制，平衡缓存有效性与系统性能。
3. 敏感数据保护 ：在脱敏处理的同时，确保系统正常读取与使用数据。
4. 验证码识别 ：集成Coze API处理响应解析与结果过滤，保证识别准确性。
5. 多线程并发 ：在并行任务与缓存操作中避免并发冲突，确保数据一致性。
评论