提交
This commit is contained in:
1 parent
c8cec132bf
commit
19c5aaa8f5
95 files changed
+309129
-9838
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# 合同详情 · 运输计划联动 Design
|
||||
|
||||
**Date:** 2026-08-30
|
||||
**Demo:** `docs/fresh-mint-crm-contract-detail-plan-tab-demo.html`
|
||||
**Primary UI:** `ContractDetailDialog.vue`(合同管理列表打开详情的主路径)
|
||||
|
||||
## Goals
|
||||
|
||||
1. 合同详情新增 Tab「运输计划」:列表样式对齐运输计划页(合并单元格),点击计划编号打开只读详情。
|
||||
2. 「合同信息」产品明细在「税费(元)」后新增三列(绿色字):已归档数量、未归档已安排、已安排合计。
|
||||
3. 安排运输时,若关联合同状态为 `approved`,自动开始执行(`executing`)。
|
||||
|
||||
## Quantity rules
|
||||
|
||||
关联计划:`pl_plan_contract.contract_id = :cid` ∪ 遗留 `pl_plan.contract_id`;排除 `follow_status=cancelled`、`del_flag=1`。
|
||||
|
||||
按**该合同挂接的停靠段**汇总 `plan_qty`(按 `product_id` 对齐合同产品行):
|
||||
|
||||
| 字段 | 条件 |
|
||||
|------|------|
|
||||
| `archivedQty` | `archive_status = archived` |
|
||||
| `arrangedUnarchivedQty` | `transport_status = arranged`(或 follow 为 arranged/completed)且 `archive_status ≠ archived`,且非 wait_notice/pending_arrange/cancelled |
|
||||
| `arrangedTotalQty` | `archivedQty + arrangedUnarchivedQty` |
|
||||
|
||||
无 `stop_id` 的旧关联:取该计划全部装/送货段产品 `plan_qty`(与计数 API 一致优先并入遗留合同)。
|
||||
|
||||
## APIs
|
||||
|
||||
- `GET /transport/plan/by-contract/{contractId}`:分页列表,响应用现有计划详情结构(含 load/deliveries),便于复用 `flattenPlanListRows`。
|
||||
- 合同详情 `products[]` 增加三数量字段,或独立 `GET .../contract-product-plan-qty?contractId=`;优先嵌在合同详情以免二次请求。
|
||||
- `POST .../arrange/{plan_id}` 成功后:对关联且 `status=approved` 的合同调用内部 `start_execute`(已 executing 跳过)。
|
||||
|
||||
## UI
|
||||
|
||||
- Tab 复用 `flattenPlanListRows` + span-method + `PlPlanViewDialog`;不复刻整页工具栏/筛选。
|
||||
- 三列样式:表头浅绿底、字色 `#059669`。
|
||||
- 全页 `detail.vue` 本期一并补齐,避免双入口不一致。
|
||||
|
||||
## Out of scope
|
||||
|
||||
- 合同侧编辑计划、从合同直接新增计划。
|
||||
- 改动运输计划列表页本身。
|
||||
@@ -0,0 +1,40 @@
|
||||
# 运输计划保存同步地磅日期 + 已安排禁仅保存
|
||||
|
||||
**日期:** 2026-08-30
|
||||
**状态:** 已确认(方案 A + B)
|
||||
**范围:** `backend` 运输计划更新接口 + 地磅桥接服务;`web-admin` 计划表单底栏按钮
|
||||
|
||||
## 1. 背景
|
||||
|
||||
编辑已安排运输计划(仅「保存」)会更新计划/段次,但地磅出入库的日期、往来单位等不会完整联动,导致两侧数据不一致(如 PO20260830002)。
|
||||
|
||||
## 2. 决策
|
||||
|
||||
### 方案 A(前端流程)
|
||||
|
||||
| 项 | 决策 |
|
||||
|----|------|
|
||||
| 已安排计划 | 隐藏「保存」,只保留「保存并安排」或「调整运输」 |
|
||||
| 未安排 / 新建 | 仍可「保存」或「创建」 |
|
||||
|
||||
### 方案 B(后端兜底)
|
||||
|
||||
| 项 | 决策 |
|
||||
|----|------|
|
||||
| 触发点 | `PUT` 更新计划,`commit` 前,存在有效 `pl_transport_db_link` 时 |
|
||||
| 日期算法 | 与安排时一致:装货 `load_time`、送货 `delivery_time`,否则回退计划日期 |
|
||||
| 可回写条件 | 出入库状态可作废集合 + 无有效过磅单 |
|
||||
| 不可回写 | 计划仍保存成功,经 `warnings` 提示 |
|
||||
| 同月 | 仅更新 `db_inbound_outbound.date` |
|
||||
| 跨月 | 回减旧月计划量 → 查找/新建新月计划 → 改挂出入库与 link |
|
||||
|
||||
## 3. 非目标
|
||||
|
||||
- 不重建批次号、不改已过磅单据
|
||||
- 方案 B 不覆盖往来单位/车辆等全量字段(依赖方案 A 走安排链路)
|
||||
|
||||
## 4. 实现要点
|
||||
|
||||
- 前端:`pl-plan-form-dialog` 增加 `showSaveButton`(`transportStatus !== 'arranged'`)
|
||||
- 后端:`sync_linked_dibang_dates_for_plan`;`update_plan` 合并 warnings
|
||||
- 单测:同月改日、跨月改挂、已过磅跳过
|
||||
@@ -0,0 +1,27 @@
|
||||
# 门户首页侧栏选中项会话记忆
|
||||
|
||||
## 背景与目标
|
||||
|
||||
门户首页(`web-admin/src/views/portal/home/index.vue`)侧栏 `activeModule` 默认「收藏」。组件重建(KeepAlive 挤出、刷新等)后会丢失上次选中的业务模块(如「CRM管理」)。目标:在**当前浏览器会话**内记住侧栏选中项。
|
||||
|
||||
## 已确认决策
|
||||
|
||||
| 项 | 决策 |
|
||||
|----|------|
|
||||
| 持久范围 | 仅 sessionStorage;关标签页自动清空 |
|
||||
| 退出登录 | 清除该 key;下次登录仍默认「收藏」 |
|
||||
| 换用户登录 | 与收藏预开 flag 一并清除 |
|
||||
| 实现形态 | 方案 A:sessionStorage,不新建 Pinia store |
|
||||
| 后端 | 无 |
|
||||
|
||||
## SHALL
|
||||
|
||||
1. 用户点击侧栏(收藏 / 待办列表 / 一级模块)时写入 `sessionStorage`。
|
||||
2. 首页初始化时读回;若 key 缺失或对应模块已不存在,回退「收藏」。
|
||||
3. `logOut` 与「不同用户登录」清理路径须 `removeItem`。
|
||||
4. 不改变侧栏顺序、卡片交互与角标逻辑。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不跨浏览器会话长期记住(不用 localStorage)。
|
||||
- 不把选中项同步到服务端。
|
||||
Reference in new issue
Block a user