#ifndef __ATTENDANCE_H #define __ATTENDANCE_H #include "stm32f10x.h" // 同步状态枚举 typedef enum { SYNC_PENDING = 0, // 待同步(新记录) SYNC_SYNCING, // 同步中 SYNC_SYNCED, // 已同步成功 SYNC_FAILED // 同步失败(等待重试) } SyncStatus; // 考勤记录结构体 typedef struct { char student_id[20]; // 学号 char student_name[32]; // 学生姓名 float confidence; // 识别置信度 uint32_t timestamp; // 打卡时间戳(秒) uint8_t time_slot; // 打卡时段编号 SyncStatus sync_status; // 同步状态 uint8_t retry_count; // 重试次数 uint32_t last_retry_time; // 上次重试时间(毫秒) } AttendanceRecord; // 人脸识别结果结构体 typedef struct { uint8_t success; // 识别是否成功 (1=成功, 0=失败) char student_id[20]; // 学号 char student_name[32]; // 学生姓名 float confidence; // 置信度 (0.0-1.0) } FaceRecognitionResult; // 考勤状态 typedef enum { ATTENDANCE_SUCCESS = 0, // 打卡成功 ATTENDANCE_DUPLICATE, // 重复打卡(本时段已打卡) ATTENDANCE_UNKNOWN, // 未识别到人脸 ATTENDANCE_LOW_CONFIDENCE, // 置信度过低 ATTENDANCE_OUT_OF_TIME // 不在考勤时间段内 } AttendanceStatus; // 时间段定义结构体 typedef struct { uint8_t enabled; // 是否启用该时间段(1=启用, 0=禁用) uint8_t start_hour; // 开始小时 (0-23) uint8_t start_minute; // 开始分钟 (0-59) uint8_t end_hour; // 结束小时 (0-23) uint8_t end_minute; // 结束分钟 (0-59) char name[20]; // 时段名称(如"上午签到") } TimeSlot; // 函数声明 void Attendance_Init(void); void Attendance_SetCurrentTime(uint8_t hour, uint8_t minute); // 设置当前时间 void Attendance_UpdateTimeSlots(TimeSlot* slots, uint8_t count); // 更新时间段配置(从服务器下载后调用) uint8_t Attendance_ParseTimeSlotsJSON(const char* json_str); // 从JSON字符串解析时间段配置 AttendanceStatus Attendance_ProcessFaceResult(FaceRecognitionResult* result); uint8_t Attendance_IsDuplicate(const char* student_id); uint8_t Attendance_IsDuplicateOnServer(const char* student_id); // 服务器端查重 void Attendance_GetCurrentSlotTime(char* start_time, char* end_time); // 获取当前时段时间 uint8_t Attendance_LoadTodayRecordsFromServer(void); // 新增:从服务器加载今日签到记录 uint8_t Attendance_IsDuplicateInCache(const char* student_id); // 新增:在本地缓存中查重 void Attendance_AddToCache(const char* student_id); // 新增:添加学号到缓存 void Attendance_ClearCache(void); // 新增:清空缓存 void Attendance_ClearRecords(void); uint16_t Attendance_GetTotalCount(void); // 获取累计考勤总数 uint16_t Attendance_GetActiveCount(void); // 获取当前缓存记录数 int8_t Attendance_GetCurrentTimeSlot(void); // 获取当前时段编号(-1表示不在考勤时段) // 数据同步相关函数 uint16_t Attendance_GetPendingCount(void); // 获取待同步记录数量(PENDING状态) AttendanceRecord* Attendance_GetNextPendingRecord(uint16_t* index); // 获取下一个待同步记录 void Attendance_MarkSyncStatus(uint16_t index, SyncStatus status); // 更新记录的同步状态 void Attendance_IncrementRetry(uint16_t index); // 增加重试计数 AttendanceRecord* Attendance_GetRecordByIndex(uint16_t index); // 按索引获取记录 void Attendance_ResetFailedRecords(void); // 将所有FAILED记录重置为PENDING #endif