Files
GX.O3.WMS/WebApi/docs/04-研发采购看板.md

95 lines
4.2 KiB
Markdown
Executable File
Raw Permalink 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、dashboard.html、dashboard_detail.html |
## 功能说明
面向研发角色(YF01)的采购申请单列表看板,展示流程编号、申请日期、物料、申请人、专项名称、业务状态、策略/研发采购负责人、计划交付日期(策略/研发)等字段,支持多条件组合筛选与列宽拖动。点击行进入只读明细页,查看物料维护、采购订单/收料通知追溯与收货汇总。本轮新增业务状态多选、拆分搜索条件、4 列 Grid 排版、列宽拖动不压列。
## 配置项
> 敏感信息(密码/Token)不进 SVN,用 Web.config / 环境变量管理。
| 配置项 | 说明 | 示例 |
|--------|------|------|
| OAConnection | OA MySQL(ecology 库) | server=39.100.72.102;database=ecology;user=ecology |
| 金蝶 K3Cloud | 单据查询 API | http://金蝶地址/api/K3Cloud/ExecuteBillQuery |
## 用法
# 检出
svn checkout svn://地址/路径
# 编译
msbuild GXWebApi.csproj /p:Configuration=Release
# 部署
部署到 IIS,访问 dashboard.html(需 YF01 角色)
## 输入输出
- 输入:筛选条件(流程编号/申请人/专项名称/研发项目/物料/负责人/业务状态)
- 输出:看板列表、只读明细(物料维护 + 采购订单/收料追溯 + 收货汇总)
## 关键接口
| 接口 | 方法 | 说明 |
|------|------|------|
| /api/Procurement/GetDashboardList | GET | 研发采购看板列表(多条件筛选+分页) |
| /api/Procurement/GetTraceSummary | GET | 追溯汇总(含采购订单/收料/延期) |
| /api/Procurement/GetPurchaseOrders | GET | 金蝶采购订单追溯 |
| /api/Procurement/GetReceiveNotices | GET | 金蝶收料通知追溯 |
## 本轮新增/更新(v1.1.0)
### 搜索条件拆分
- 原单一"关键字"搜索拆分为 4 个独立字段:**流程编号 / 申请人 / 专项名称 / 研发项目**
- 加上原有 物料编码 / 物料名称 / 策略采购负责人 / 研发采购负责人,共 8 个筛选框
### 4 列 Grid 排版
- 搜索栏改为 CSS Grid `grid-template-columns: repeat(4, 1fr)`,每行 4 个,标题纵向对齐
- 每组 label+input 用 `<span class="field">` 包裹(inline-flex),折行不分离
- "共 N 条"显示在搜索栏第三行最右侧,与查询/重置按钮同行
### 业务状态多选(自定义下拉)
- 原单选 `<select>` 改为**自定义多选下拉框**(复选框列表)
- 选项:全部 + 9 个业务状态,勾选"全部"清空其他,全部取消自动回勾"全部"
- 选中多个状态框内显示前 2 个 + "等",筛选结果持久化到 sessionStorage
- 后端 `GetDashboardList` 的 `ywzt` 参数支持逗号分隔多值 → `IN ('1','2')`
### 列宽拖动 + 水平滚动
- 列宽拖动不压其他列:`mousedown` 记录 `st._origW`,`mousemove` 同步撑宽表格
- `table{min-width:100%}` 使列宽超容器时出现水平滚动条
### 列表字段调整
- 去掉"项目经理审批时间"列
- 新增"计划交付日期(策略采购)"和"计划交付日期(研发采购)"两列
- 数据源新增 `cnjhjfrq` / `yfjhjfrq` 字段
### 明细追溯兜底
- 采购订单页签兼容「无收料通知单时 traceDetails 为空」的场景,从 `poList` / `trace.purchaseOrders` 兜底
## 注意事项
- 只读界面不提供保存/报价修改
- 业务状态多选下拉 `.list-card` 需 `overflow: visible`,避免下拉被裁切
- 多选复选框使用原生 `accent-color` 渲染,"全部"与具体状态用独立 onchange 处理避免互相覆盖
## 变更记录
| 版本 | 日期 | 改了什么 |
|------|------|----------|
| v1.0.0 | 2026-08-04 | 初始版本:看板列表 + 只读明细追溯 |
| v1.1.0 | 2026-08-05 | 搜索条件拆分、4列Grid排版、业务状态多选、列宽拖动不压列、字段调整 |