package cn.iocoder.yudao.module.mes.service.pro.maintenanceplan;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.pro.maintenanceplan.vo.MesProMaintenancePlanPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pro.maintenanceplan.vo.MesProMaintenancePlanSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.maintenanceplan.MesProMaintenancePlanDO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.maintenanceplan.MesProMaintenancePlanItemDO;

import java.util.Collection;
import java.util.List;

/**
 * MES 电力作业计划 Service 接口
 *
 * @author xiaoyi
 */
public interface MesProMaintenancePlanService {

    /**
     * 创建电力作业计划
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createPlan(MesProMaintenancePlanSaveReqVO createReqVO);

    /**
     * 更新电力作业计划
     *
     * @param updateReqVO 更新信息
     */
    void updatePlan(MesProMaintenancePlanSaveReqVO updateReqVO);

    /**
     * 删除电力作业计划
     *
     * @param ids 编号数组
     */
    void deletePlan(Collection<Long> ids);

    /**
     * 获得电力作业计划
     *
     * @param id 编号
     * @return 电力作业计划
     */
    MesProMaintenancePlanDO getPlan(Long id);

    /**
     * 获得电力作业计划明细列表
     *
     * @param planId 计划编号
     * @return 明细列表
     */
    List<MesProMaintenancePlanItemDO> getPlanItemListByPlanId(Long planId);

    /**
     * 按计划编号集合获得明细列表
     *
     * @param planIds 计划编号集合
     * @return 明细列表
     */
    List<MesProMaintenancePlanItemDO> getPlanItemListByPlanIds(Collection<Long> planIds);

    /**
     * 获得电力作业计划分页
     *
     * @param pageReqVO 分页查询
     * @return 分页结果
     */
    PageResult<MesProMaintenancePlanDO> getPlanPage(MesProMaintenancePlanPageReqVO pageReqVO);

    /**
     * 下发电力作业计划（草稿 -> 已下发）
     *
     * @param id 编号
     */
    void issuePlan(Long id);

    /**
     * 完成电力作业计划（已下发 -> 已完成）
     *
     * @param id 编号
     */
    void finishPlan(Long id);

    /**
     * 根据计划备件/物资需求生成 ERP 采购计划
     *
     * @param id 电力作业计划编号
     * @return 采购计划编号
     */
    Long generatePurchasePlan(Long id);

    /**
     * 生成生产工单（运维/发电/检修类）
     *
     * @param id 电力作业计划编号
     * @return 工单编号
     */
    Long generateWorkOrder(Long id);

}