Files
GX.O3.WMS/WebApi/docs/02-采购看板.md
T

87 lines
3.6 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.1.0 |
| 负责人 | Damon |
| SVN路径 | svn://地址/路径 |
| .NET版本 | .NET Framework 4.7.2 |
| 对应文件 | Controllers/ProcurementController.cs、procurement_dashboard.html、procurement_dashboard_detail.html、procurement_dashboard_detail_items.html、procurement_dashboard_level4.html |
## 功能说明
针对今年的采购申请单(YFCGSQ 前缀),按月份、业务状态(ywzt 1~9)汇总数量并展示为看板,支持四级下钻:一级按月+ywzt 汇总 → 二级按研发项目汇总报价/负责人分配 → 三级按供应链状态(待供应商报价/待ED审批)统计时效 → 四级展示物料明细。本轮新增左右排版、二级/四级分页、列宽拖动不压列、水平滚动。
## 配置项
> 敏感信息(密码/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,访问 procurement_dashboard.html
## 输入输出
- 输入:月份、业务状态、研发项目等参数
- 输出:各级汇总列表、物料明细数据
## 关键接口
| 接口 | 方法 | 说明 |
|------|------|------|
| /api/Procurement/GetProcurementDashboard | GET | 一级:按月+ywzt 汇总 |
| /api/Procurement/GetProcurementDashboardDetail | GET | 二级:按研发项目汇总+策略采购负责人分布 |
| /api/Procurement/GetProcurementDashboardDetailItems | GET | 三级:按时效范围汇总(ywzt=2/3) |
| /api/Procurement/GetProcurementDashboardLevel4 | GET | 四级:物料明细数据 |
## 本轮新增/更新(v1.1.0)
### 三级页面左右排版
- 待供应商报价(ywzt=2)和 待ED审批(ywzt=3)两个时效汇总卡片**左右并排**显示
- `.main` 改为 flex 布局,卡片 `flex:1; min-width:420px`
### 二级/四级分页
- 新增每页条数选择(20/50/100/200)+ 页码导航(首页/‹/页码/›/末页)+ 总数显示
- 客户端分页,不额外请求
### 列宽拖动 + 水平滚动
- 所有列表支持**列宽拖动且不压其他列**:拖拽时同步撑宽表格 `st.style.width=(st._origW+d)+'px'`
- `table{width:100%}` → `table{min-width:100%}`,列宽超容器时出现水平滚动条
- 三级时效汇总默认 1天以内/1-3天/3天以上 时间分段
### 三级时效统计
- 按 ywzt=2/3 分开统计,时间段:3天以内 / 3-7天 / 7天以上(当前日期 - 项目经理审批时间)
- 数量为超链接,点击跳转四级明细
### 四级明细字段
- 展示流程编号、单据编号(djbh)、行号、物料、报价、供应商、负责人、要求交付日期、审批日期、天数
## 统计口径
- 只统计 `YEAR(sqrq)=YEAR(CURDATE())` 且 `lcbh LIKE 'YFCGSQ%'` 的数据
- 二级「未分配采购策略」= 第二轮报价为空或 0 且策略采购负责人为空
- 三级时效 = 当前日期 - 项目经理审批时间(只取年月日)
## 变更记录
| 版本 | 日期 | 改了什么 |
|------|------|----------|
| v1.0.0 | 2026-08-04 | 初始版本:四级下钻看板 |
| v1.1.0 | 2026-08-05 | 三级左右排版、二级/四级分页、列宽拖动不压列、水平滚动 |