feat(erp): 采购计划/采购审核/到货跟踪 + 供应商管理
- 采购计划:选合同自动带出明细、合同/供应商表格选择器、批量填充(可生成N行)、卷号/数量列、送审/重新送审流程 - 采购审核:通过/驳回 + 申请意见,每次审核留痕(erp_purchase_plan_audit_log),计划详情展示审核历史/驳回理由 - 到货跟踪:上传到货Excel按牌号+规格回填明细到货量与状态,列校验/kg→t纠正,满额自动归档 - 供应商管理页(复用既有 erp_supplier 后端) - 综合搜索(计划号/供货商/合同号)、左右分栏工作台、全局表单按钮对齐修复 - 清理无用旧 erp 页面(看板/需求/订单/收货/退货/汇总) - DDL 与菜单脚本:docs/purchase-plan-ddl.sql(按 path 解析父目录、可重复执行) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
package com.klp.erp.service;
|
||||
|
||||
import com.klp.common.core.domain.PageQuery;
|
||||
import com.klp.common.core.page.TableDataInfo;
|
||||
import com.klp.erp.domain.bo.ErpPurchasePlanAuditBo;
|
||||
import com.klp.erp.domain.bo.ErpPurchasePlanBo;
|
||||
import com.klp.erp.domain.vo.ErpContractOptionVo;
|
||||
import com.klp.erp.domain.vo.ErpPurchasePlanAuditLogVo;
|
||||
import com.klp.erp.domain.vo.ErpPurchasePlanDeliveryVo;
|
||||
import com.klp.erp.domain.vo.ErpPurchasePlanItemVo;
|
||||
import com.klp.erp.domain.vo.ErpPurchasePlanVo;
|
||||
|
||||
import java.io.InputStream;
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* 采购计划Service接口
|
||||
*
|
||||
* @author klp
|
||||
* @date 2026-06-22
|
||||
*/
|
||||
public interface IErpPurchasePlanService {
|
||||
|
||||
/** 查询采购计划详情(含明细、关联合同、进度) */
|
||||
ErpPurchasePlanVo queryById(Long planId);
|
||||
|
||||
/** 按销售合同ID批量取明细(来自 crm_order_item),用于「选合同自动带出明细」 */
|
||||
List<ErpPurchasePlanItemVo> queryItemsByOrders(List<Long> orderIds);
|
||||
|
||||
/** 合同列表分页(含每个合同已有的采购计划数),用于采购计划页左侧 */
|
||||
TableDataInfo<ErpContractOptionVo> queryContractPage(String keyword, PageQuery pageQuery);
|
||||
|
||||
/** 某合同下的所有采购计划 */
|
||||
List<ErpPurchasePlanVo> queryPlansByContract(Long orderId);
|
||||
|
||||
/** 分页查询采购计划 */
|
||||
TableDataInfo<ErpPurchasePlanVo> queryPageList(ErpPurchasePlanBo bo, PageQuery pageQuery);
|
||||
|
||||
/** 查询采购计划列表 */
|
||||
List<ErpPurchasePlanVo> queryList(ErpPurchasePlanBo bo);
|
||||
|
||||
/** 新增采购计划(含明细、合同挂接) */
|
||||
Boolean insertByBo(ErpPurchasePlanBo bo);
|
||||
|
||||
/** 修改采购计划(含明细、合同挂接) */
|
||||
Boolean updateByBo(ErpPurchasePlanBo bo);
|
||||
|
||||
/** 校验并批量删除采购计划 */
|
||||
Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
|
||||
|
||||
/** 审核(通过/驳回 + 申请意见),每次审核留痕 */
|
||||
Boolean audit(ErpPurchasePlanAuditBo bo, String operator);
|
||||
|
||||
/** 送审 / 重新送审:待送审(3) 或 已驳回(2) → 待审核(0),之后才进入审核页 */
|
||||
Boolean submitForAudit(Long planId);
|
||||
|
||||
/** 某计划的审核历史 */
|
||||
List<ErpPurchasePlanAuditLogVo> queryAuditLogs(Long planId);
|
||||
|
||||
/**
|
||||
* 导入到货 Excel:校验列/数值、kg→t 单位纠正,写入并刷新进度归档。
|
||||
* 返回 {count: 入库条数, message: 回执文案, kgConverted: 是否做了单位换算}
|
||||
*/
|
||||
Map<String, Object> importDelivery(Long planId, InputStream inputStream, String operator);
|
||||
|
||||
/** 查询某计划的到货明细 */
|
||||
List<ErpPurchasePlanDeliveryVo> queryDeliveryList(Long planId);
|
||||
|
||||
/** 删除到货明细,并刷新进度 */
|
||||
Boolean deleteDelivery(Long deliveryId);
|
||||
|
||||
/** 刷新到货进度:arrivedWeight = Σ单卷重量;满 100% 自动归档 */
|
||||
void refreshProgress(Long planId);
|
||||
|
||||
/** 总体到货进度统计(已完成 N / 共 M) */
|
||||
Map<String, Object> statistics(ErpPurchasePlanBo bo);
|
||||
}
|
||||
Reference in New Issue
Block a user