95 lines
4.2 KiB
Markdown
Executable File
95 lines
4.2 KiB
Markdown
Executable File
# [研发采购看板]
|
||
|
||
> 研发采购申请单列表看板,按多条件筛选(流程编号/申请人/专项名称/研发项目等),并可进入只读明细追溯界面。
|
||
|
||
## 基本信息
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| 类型 | 接口 + 前端页面(系统二开) |
|
||
| 版本 | 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排版、业务状态多选、列宽拖动不压列、字段调整 |
|