package cn.iocoder.yudao.module.mes.service.pd.document;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.pd.document.vo.MesPdDocumentPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.pd.document.vo.MesPdDocumentSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.pd.document.MesPdDocumentDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * MES 设计资料 Service 接口
 *
 * @author 芋道源码
 */
public interface MesPdDocumentService {

    /**
     * 创建设计资料
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createDocument(@Valid MesPdDocumentSaveReqVO createReqVO);

    /**
     * 更新设计资料
     *
     * @param updateReqVO 更新信息
     */
    void updateDocument(@Valid MesPdDocumentSaveReqVO updateReqVO);

    /**
     * 删除设计资料
     *
     * @param id 编号
     */
    void deleteDocument(Long id);

    /**
     * 获得设计资料
     *
     * @param id 编号
     * @return 设计资料
     */
    MesPdDocumentDO getDocument(Long id);

    /**
     * 获得设计资料分页
     *
     * @param pageReqVO 分页查询
     * @return 设计资料分页
     */
    PageResult<MesPdDocumentDO> getDocumentPage(MesPdDocumentPageReqVO pageReqVO);

    /**
     * 获得指定设计项目下的资料列表
     *
     * @param projectId 设计项目ID
     * @return 资料列表
     */
    List<MesPdDocumentDO> getDocumentListByProjectId(Long projectId);

    /**
     * 删除指定设计项目下的所有资料
     *
     * @param projectId 设计项目ID
     */
    void deleteByProjectId(Long projectId);

}