package zbooksoft.fams.service; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import zbooksoft.fams.common.FormDataUtils; import zbooksoft.fams.dao.RemindDao; import java.sql.Timestamp; import java.time.LocalDate; import java.time.temporal.ChronoUnit; import java.util.HashMap; import java.util.HashSet; import java.util.LinkedHashMap; import java.util.LinkedHashSet; import java.util.List; import java.util.Map; import java.util.Set; /** * 资产到期提醒:每日扫描质保、维保、检定/年检、借用到期,维护提醒记录并发送系统消息 * @author ycq * @date 2026-10-16 */ @Service public class RemindService { public static final int DEFAULT_DAYS_AHEAD = 30; public static final String[] REMIND_TYPES = {"质保到期", "维保到期", "检定/年检到期", "借用到期"}; public static final String STATE_PENDING = "待处理"; public static final String STATE_HANDLED = "已处理"; public static final String STATE_EXPIRED = "已失效"; private static final int MAX_DAYS_AHEAD = 365; private static final int DATE_TEXT_LENGTH = 10; @Autowired private RemindDao remindDao; /** * 提前多少天提醒:关键字「到期提醒设置 / 提前天数」,未配置或非法时取默认30天 * @return 天数 */ public int daysAhead() { String value = remindDao.findDaysAhead(); if (value != null && value.trim().matches("\\d{1,3}")) { int days = Integer.parseInt(value.trim()); if (days > 0 && days <= MAX_DAYS_AHEAD) { return days; } } return DEFAULT_DAYS_AHEAD; } /** * 扫描到期资产:新到期项生成提醒并通知使用人和资产管理员;已有的刷新剩余天数;到期日已顺延或资产已不在清单的提醒置为已失效 * @param today 今天 * @param daysAhead 提前天数 * @return created/updated/expired/notified 计数 */ public Map scan(LocalDate today, int daysAhead) { Map> pendingByKey = new HashMap<>(); Set handledKeys = new HashSet<>(); for (Map remind : remindDao.findActiveReminds()) { String key = key(remind.get("ASSET_ID"), remind.get("REMIND_TYPE"), remind.get("DUE_DATE")); if (STATE_PENDING.equals(FormDataUtils.toText(remind.get("REMIND_STATE")))) { pendingByKey.put(key, remind); } else { handledKeys.add(key); } } int created = 0; int updated = 0; int notified = 0; Set dueKeys = new HashSet<>(); List admins = null; Long cardFormId = null; for (Map item : remindDao.findDueItems(today.plusDays(daysAhead))) { String dueDate = dateText(item.get("DUE_DATE")); String key = key(item.get("ASSET_ID"), item.get("REMIND_TYPE"), dueDate); dueKeys.add(key); if (handledKeys.contains(key)) { continue; } int daysLeft = (int) ChronoUnit.DAYS.between(today, LocalDate.parse(dueDate)); Map pending = pendingByKey.get(key); if (pending != null) { Map values = new HashMap<>(); values.put("DAYS_LEFT", daysLeft); values.put("USER_NAME", FormDataUtils.toText(item.get("USER_NAME"))); values.put("USE_DEPT_NAME", FormDataUtils.toText(item.get("USE_DEPT_NAME"))); values.put("LOCATION_NAME", FormDataUtils.toText(item.get("LOCATION_NAME"))); remindDao.updateRemind(FormDataUtils.toLong(pending.get("ID")), values); updated++; continue; } remindDao.insertRemind(newRemind(item, dueDate, daysLeft)); created++; if (admins == null) { admins = remindDao.findAdminUserIds(); cardFormId = remindDao.findCardFormId(); } notified += notify(item, dueDate, daysLeft, admins, cardFormId); } int expired = 0; for (Map.Entry> entry : pendingByKey.entrySet()) { if (!dueKeys.contains(entry.getKey())) { Map values = new HashMap<>(); values.put("REMIND_STATE", STATE_EXPIRED); remindDao.updateRemind(FormDataUtils.toLong(entry.getValue().get("ID")), values); expired++; } } Map result = new LinkedHashMap<>(); result.put("created", created); result.put("updated", updated); result.put("expired", expired); result.put("notified", notified); return result; } private static Map newRemind(Map item, String dueDate, int daysLeft) { Map row = new LinkedHashMap<>(); row.put("ASSET_ID", FormDataUtils.toLong(item.get("ASSET_ID"))); row.put("ASSET_NO", FormDataUtils.toText(item.get("ASSET_NO"))); row.put("ASSET_NAME", FormDataUtils.toText(item.get("ASSET_NAME"))); row.put("REMIND_TYPE", FormDataUtils.toText(item.get("REMIND_TYPE"))); row.put("DUE_DATE", dueDate); row.put("DAYS_LEFT", daysLeft); row.put("USER_ID", FormDataUtils.toLong(item.get("USER_ID"))); row.put("USER_NAME", FormDataUtils.toText(item.get("USER_NAME"))); row.put("USE_DEPT_NAME", FormDataUtils.toText(item.get("USE_DEPT_NAME"))); row.put("LOCATION_NAME", FormDataUtils.toText(item.get("LOCATION_NAME"))); row.put("REMIND_STATE", STATE_PENDING); row.put("NOTIFY_TIME", new Timestamp(System.currentTimeMillis())); return row; } private int notify(Map item, String dueDate, int daysLeft, List admins, Long cardFormId) { String content = "资产【" + FormDataUtils.toText(item.get("ASSET_NO")) + " " + FormDataUtils.toText(item.get("ASSET_NAME")) + "】" + FormDataUtils.toText(item.get("REMIND_TYPE")).replace("到期", "") + "到期日为 " + dueDate + "," + (daysLeft < 0 ? "已过期 " + (-daysLeft) + " 天" : "还剩 " + daysLeft + " 天") + ",请及时处理。"; String url = cardFormId == null ? "" : "general/editFormData?formId=" + cardFormId + "&keyId=" + FormDataUtils.toLong(item.get("ASSET_ID")) + "&openUrlType=0"; Map receivers = new LinkedHashMap<>(); Long userId = FormDataUtils.toLong(item.get("USER_ID")); if (userId != null) { receivers.put(userId, FormDataUtils.toText(item.get("USER_NAME"))); } for (Long admin : admins) { receivers.putIfAbsent(admin, ""); } for (Map.Entry receiver : receivers.entrySet()) { remindDao.insertMessage(receiver.getKey(), receiver.getValue(), content, url); } return receivers.size(); } /** * 把待处理的提醒标记为已处理(如已安排检定、已续保) * @param ids 提醒ID * @param operatorName 处理人 * @return 标记的条数 */ public int handle(List ids, String operatorName) { int count = 0; for (Long id : new LinkedHashSet<>(ids)) { Map remind = remindDao.findRemind(id); if (remind == null || !STATE_PENDING.equals(FormDataUtils.toText(remind.get("REMIND_STATE")))) { continue; } Map values = new HashMap<>(); values.put("REMIND_STATE", STATE_HANDLED); values.put("HANDLE_TIME", new Timestamp(System.currentTimeMillis())); values.put("HANDLE_USER_NAME", operatorName); remindDao.updateRemind(id, values); count++; } return count; } private static String key(Object assetId, Object type, Object dueDate) { return FormDataUtils.toLong(assetId) + "|" + FormDataUtils.toText(type) + "|" + dateText(dueDate); } private static String dateText(Object value) { String text = FormDataUtils.toText(value); return text.length() >= DATE_TEXT_LENGTH ? text.substring(0, DATE_TEXT_LENGTH) : text; } }