Files
GX.O3.WMS/WebApi/docs/03-采购物料交付状态看板.md
T

92 lines
4.0 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# [采购物料交付状态看板]
> 按研发项目汇总物料交付状态(未转单/无交付目标/无交付计划/进行中/延期中/需求取消),并下钻到负责人、时间范围、明细的看板模块。
## 基本信息
| 项目 | 内容 |
|------|------|
| 类型 | 接口 + 前端页面(系统二开) |
| 版本 | v1.2.0 |
| 负责人 | Damon |
| SVN路径 | svn://地址/路径 |
| .NET版本 | .NET Framework 4.7.2 |
| 对应文件 | Controllers/ProcurementController.cs、delivery_dashboard.html、delivery_dashboard_L21/L22/L31/L32.html、delivery_dashboard_noorder2/3/4.html |
## 功能说明
针对今年的采购申请单(YFCGSQ 前缀),按研发项目(uf_gxyfxm)汇总各项交付状态数量,支持多条下钻链路:未转单 → 时间范围 → 负责人 → 明细;无交付目标/无交付计划 → 负责人 → 明细;进行中/延期中 → 供应商 + 时间范围 → 明细。交付时间基于计划交付日期(研发采购,yfjhjfrq)与当前日期差值计算。
## 配置项
> 敏感信息(密码/Token)不进 SVN,用 Web.config / 环境变量管理。
| 配置项 | 说明 | 示例 |
|--------|------|------|
| OAConnection | OA MySQL(ecology 库) | server=39.100.72.102;database=ecology;user=ecology |
## 用法
# 检出
svn checkout svn://地址/路径
# 编译
msbuild GXWebApi.csproj /p:Configuration=Release
# 部署
部署到 IIS,访问 delivery_dashboard.html
## 输入输出
- 输入:研发项目、状态类型、时间范围、负责人/供应商等参数
- 输出:交付状态汇总、各级明细数据
## 关键接口
| 接口 | 方法 | 说明 |
|------|------|------|
| /api/Procurement/GetDeliveryDashboard | GET | 一级:按研发项目汇总 7 列状态 |
| /api/Procurement/GetDeliveryNoOrder2 | GET | 未转单二级:按研发项目+时间范围汇总 |
| /api/Procurement/GetDeliveryNoOrder3 | GET | 未转单三级:按研发采购负责人汇总 |
| /api/Procurement/GetDeliveryNoOrder4 | GET | 未转单四级:明细数据 |
| /api/Procurement/GetDeliveryLevel21/L31 | GET | 1号 二级/三级(无交付目标/计划 → 负责人) |
| /api/Procurement/GetDeliveryLevel22/L32 | GET | 2号 二级/三级(进行中/延期 → 供应商) |
## 本轮新增/更新(v1.2.0)
### 未转单四级下钻链路(全新)
- 一级"未转单"列改为超链接,点击进入 `delivery_dashboard_noorder2.html`
- 未转单二级:按研发项目统计 1天以内 / 1-3天 / 3天以上
- 未转单三级:点击某时间段数量,按研发采购负责人汇总
- 未转单四级:点击负责人数量,展示采购申请明细数据
### 无效日期处理(关键修复)
- 数据库中 `yfjhjfrq` 存在 `0000-00-00` 等无效值,`DATEDIFF` 返回 NULL 导致记录漏算
- 修复:空值/无效日期归入"3天以上",并加 `DATEDIFF IS NULL` 判断,确保每条未转单记录恰好落入一个区间,二级 r1+r2+r3 之和 = 一级未转单数
### 时间计算
- 交付时间 = `DATEDIFF(yfjhjfrq, CURDATE())`(计划交付日期 - 当前日期)
- 未转单分段:1天以内 / 1-3天 / 3天以上
- 交付分段:0-3天 / 3-7天 / 7-14天 / 14天以上
### 需求取消口径调整
- 由 `ywzt IN ('7','8')`(撤回+取消)改为 **`ywzt IN ('8','9')`**(研发-采购申请取消 + 研发-量产复用件)
### 全量分页
- 一级/二/三/四级列表均支持每页条数选择(20/50/100/200)+ 页码导航
### 一级统计条件
- 增加 `lcbh LIKE 'YFCGSQ%'` 过滤,只统计采购申请类数据
## 统计口径
- 未转单:`LEFT JOIN formtable_main_39_dt1`(采购订单明细)无匹配(S2.id IS NULL)
- 只统计 `YEAR(sqrq)=YEAR(CURDATE())` 且 `lcbh LIKE 'YFCGSQ%'`
## 变更记录
| 版本 | 日期 | 改了什么 |
|------|------|----------|
| v1.0.0 | 2026-08-04 | 初始版本:交付状态看板 + 多条下钻链路 |
| v1.2.0 | 2026-08-05 | 新增未转单四级下钻、无效日期处理、需求取消口径调整、全量分页 |