package com.qqflow.engine.domain.flow.service;

import java.util.List;

/**
 * 通知服务接口：用于向用户发送流程相关的通知
 * 目前预留企业微信对接，后续可扩展邮件、短信、站内信等
 */
public interface NotificationService {

    /**
     * 发送任务分配通知（待我处理）
     *
     * @param assigneeIds   接收人ID列表
     * @param processName   流程名称
     * @param instanceTitle 实例标题
     * @param nodeName      当前节点名称
     */
    void notifyTaskAssigned(List<Long> assigneeIds, String processName, String instanceTitle, String nodeName);

    /**
     * 发送任务完成通知（审批结果通知）
     *
     * @param instanceId    实例ID
     * @param processName   流程名称
     * @param instanceTitle 实例标题
     * @param nodeName      节点名称
     * @param operatorName  操作人姓名
     * @param action        操作类型（通过/拒绝/退回/转办）
     */
    void notifyTaskCompleted(Long instanceId, String processName, String instanceTitle,
                             String nodeName, String operatorName, String action);

    /**
     * 发送流程结束通知
     *
     * @param applicantId   发起人ID
     * @param processName   流程名称
     * @param instanceTitle 实例标题
     * @param result        结果（通过/拒绝）
     */
    void notifyProcessCompleted(Long applicantId, String processName, String instanceTitle, String result);
}