package jnpf.limsService;

import java.util.Map;

/**
 * 检验任务"要求完成日期"提醒 daily 任务。
 *
 * <p>触发方式：
 * <ul>
 *   <li>cron 自动触发：{@code @Scheduled(cron = "${lims.remind.cron:0 0 8 * * ?}")}</li>
 *   <li>手动触发：POST /lims/biz/jiance-task/remind/run-now（开发 / 紧急补发用）</li>
 * </ul>
 *
 * <p>提醒分支：
 * <ul>
 *   <li>D-7 / D-3 / D-1：检验员收到"剩 N 天"提醒，各精确一次</li>
 *   <li>EXPIRED：检验员 + 任务分配人各收一次过期告警</li>
 * </ul>
 */
public interface LimsJianceTaskRemindService {

    /**
     * 扫描并发送提醒。
     *
     * @param dryRun true 仅日志不发消息、不写 remind_flags
     * @return 各分支统计：key = "D7"/"D3"/"D1"/"EXPIRED"，value = {hit, sent, skipped}
     */
    Map<String, Map<String, Integer>> scanAndRemind(boolean dryRun);
}