wangmian/ONE-OS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(web): 租赁账单、安全培训扫码、提车应收款等模块更新与新增

Browse Source 
Made-with: Cursor
This commit is contained in:
王冕
2026-03-11 09:10:28 +08:00
parent 4bc7ad9741
commit 30e3d9f156
17 changed files with 3712 additions and 1384 deletions
Download Patch File Download Diff File Expand all files Collapse all files

200
web端/需求说明/Antd设计规范（v5）.md Normal file
View File

@@ -0,0 +1,200 @@
# Ant Design（AntD）设计规范导出（v5）
> 说明：本文档基于 Ant Design v5 官方文档与设计令牌（Design Token）整理，用于项目内统一 UI 口径。若与线上文档不一致，以官方文档与实际 `token` 输出为准。
>
> 参考：
> - Ant Design 文档：`https://ant.design/docs/react/introduce`
> - 主题定制（Design Token）：`https://ant.design/docs/react/customize-theme`
> - CSS Variables：`https://ant.design/docs/react/css-variables`
## 1. 设计原则（适用于业务后台）
- **清晰**：信息层级明确（标题/正文/辅助信息/弱提示），减少不必要装饰。
- **一致**：同类型组件在同场景下外观与交互一致（按钮语义、表单校验、弹窗页脚等）。
- **高效**：高频任务优先（表格筛选、快捷操作、批量处理），减少路径长度。
- **可控**：可预期的反馈（加载/成功/失败/空态），避免“无响应”与不可逆操作。
## 2. 视觉基础（Design Token 口径）
### 2.1 色彩（Color）
#### 语义色（常用）
- **主色（Primary）**：品牌/主要操作按钮/高亮状态
- AntD v5 默认：`colorPrimary = #1677ff`
- **成功（Success）**：成功态、完成态、正向结果
- **警告（Warning）**：需要注意但不阻断流程
- **错误（Error）**：失败、阻断、危险操作
- **信息（Info）**：中性提示（一般与 Primary 同系或更弱）
#### 文本与背景（建议层级）
- **正文主文本**：用于标题、正文关键值
- **次级文本**：用于说明、辅助信息
- **弱文本**：用于占位、不可用、次要信息
- **容器背景**：页面背景、卡片/表格容器背景
- **分割/边框**：分割线、边框、表格网格线
> 落地建议：**不要直接手写颜色值**，优先使用 AntD token（如 `colorText` / `colorBgContainer` / `colorBorder` / `colorPrimary`），避免暗色模式或主题切换时失控。
### 2.2 字体（Typography）
- **基础字号**：AntD v5 默认 `fontSize = 14px`
- **字号体系**：在正文 14 的基础上，常用 `12/14/16/20/24`（具体以 token 为准）
- **字重**：正文 400，标题/强调 500/600（按设计与字体实际支持）
- **行高**：正文建议 1.4–1.6 区间；表格/表单密集场景可略收紧但要保证可读性
落地建议：
- 表单 label、辅助说明、错误提示使用 **次级/弱** 文本层级，避免与正文抢占注意力。
- 数字与金额在表格中建议 **右对齐**，并用等宽数字特性（如字体支持 `font-variant-numeric: tabular-nums`）提升可扫读性。
### 2.3 间距（Spacing）
推荐用 8px 网格作为基础节奏（token 会覆盖实际值）：
- **4/8/12/16/24/32**：常用间距档位
- 表单项上下间距、卡片内边距、区块间距尽量统一
落地建议：
- 页面区块：24（区块间）
- 卡片/容器内边距：16 或 24
- 表单项间距：16（常规）/ 12（密集）
### 2.4 圆角（Radius）
- AntD v5 默认 `borderRadius = 6px`
常见分层：`2/4/6/8`（不同组件会使用不同层级）
落地建议：
- 不要在同一页面混用多个“视觉上相近但不一致”的圆角（例如 4 与 6 随意混用）。
### 2.5 阴影与层级（Shadow & Elevation）
典型层级：
- **容器浮层**：Popover/Dropdown/Tooltip
- **对话框**：Modal
- **抽屉**：Drawer（靠近边缘）
落地建议：
- 阴影仅用于表达“悬浮/层级”，不要把阴影当分割线使用。
### 2.6 动效（Motion）
- **有意义**：动效用于表达状态变化（展开/收起/加载/反馈），避免纯装饰。
- **短而稳**：后台系统建议偏短时长，降低等待感；重要确认可以稍长但不要拖沓。
- **可中断**：用户快速操作时动效不应叠加导致卡顿或错位。
## 3. 布局与栅格（Layout & Grid）
- 使用 `Row/Col` 或 `Space/Flex` 组织布局，避免大量手写 margin 拼接。
- 表单与筛选区建议固定结构：
- **筛选区**（可折叠）
- **操作区**（主按钮 + 次按钮 + 批量操作）
- **表格区**
- **分页/汇总**
- 页面建议采用“标题 + 关键指标/说明 + 主体内容”层级，减少首屏信息噪声。
## 4. 组件使用规范（后台高频）
### 4.1 Button（按钮）
- **主按钮（Primary）**：每个视图/弹窗**尽量只有一个**主按钮（最主要动作）。
- **次按钮（Default）**：辅助动作、返回、取消。
- **危险（Danger）**：删除/作废/清空等不可逆操作，必须配确认（Popconfirm/Modal.confirm）。
- **禁用态**：禁用必须有原因（提示或辅助文案），避免“为什么点不了”。
弹窗页脚建议顺序（从右到左）：**主操作** → 次操作（取消/关闭）。
### 4.2 Form（表单）
- 校验提示就近展示，错误文案可读且可执行（告诉用户怎么改）。
- 必填项统一标识；不要同页混用不同必填标记策略。
- 长表单建议分组（Card/Collapse/Steps），并提供保存草稿/分步提交（视业务复杂度）。
### 4.3 Table（表格）
- 列宽：关键列固定宽度，描述列可自适应；避免全自适应导致抖动。
- 对齐：金额/数量 **右对齐**；状态/标签可居中；文本默认左对齐。
- 操作列：避免超过 3 个直出操作；其余收纳到 Dropdown/More。
- 空态：提供原因与下一步（调整筛选/新建/刷新）。
### 4.4 Modal / Drawer（弹窗/抽屉）
- **Modal**：用于强打断、需要确认的任务；内容不宜过长。
- **Drawer**：用于不中断上下文的编辑/详情；适合较长内容或分区信息。
- 关闭方式：提供右上角关闭；重要内容关闭需二次确认（有未保存变更时）。
### 4.5 Message / Notification / Alert（反馈）
- **Message**：短反馈（保存成功/复制成功），不承载复杂信息。
- **Notification**：较长信息、异步结果、可操作提示（带按钮/链接）。
- **Alert**：页面内静态提示/规则说明/风险提示。
落地建议：错误信息尽量包含 **定位信息 + 原因 + 建议动作**（例如“金额格式不合法，请输入最多两位小数”）。
## 5. 主题与 Token “导出”（工程落地）
### 5.1 通过 `ConfigProvider` 统一主题
在应用入口用 `ConfigProvider` 设置全局 token（示意）：
```tsx
import { ConfigProvider, theme } from 'antd';
export function App() {
return (
<ConfigProvider
theme={{
algorithm: theme.defaultAlgorithm,
token: {
colorPrimary: '#1677ff',
borderRadius: 6,
fontSize: 14,
},
components: {
// 组件级 token 覆盖（按需）
},
}}
>
{/* routes */}
</ConfigProvider>
);
}
```
### 5.2 在页面/组件中打印当前 token（用于“导出当前主题规范”）
你可以在任意页面临时输出（开发态）：
```tsx
import { theme } from 'antd';
export function DebugTokens() {
const { token } = theme.useToken();
// 控制台复制即可作为“当前工程实际 token 导出”
console.log('antd token =>', token);
return null;
}
```
如果需要生成 JSON 文件，可以把 `token` 序列化后下载（浏览器端）：
```ts
export function downloadJson(filename: string, data: unknown) {
const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json;charset=utf-8' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url);
}
```
## 6. 默认关键值速查（AntD v5）
- **主色**：`#1677ff`
- **基础字号**：`14px`
- **默认圆角**：`6px`
> 注：完整 token 以 `theme.useToken()` 输出为准（因为你的工程可能有覆盖）。

49
web端/需求说明/财务管理/提车应收款 Normal file
View File

@@ -0,0 +1,49 @@
提车应收款（2026年3月10日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」模块
#面包屑：财务管理-提车应收款；
页面分为2个卡片；
1.筛选：
#支持合同编码/项目名称/客户名称/业务部门/业务负责人等筛选方式；
1.1.合同编码：选择器，支持输入框内手动输入下拉模糊匹配对应项；
1.2.项目名称：选择器，支持输入框内手动输入下拉模糊匹配对应项；
1.3.客户名称：选择器，支持输入框内手动输入下拉模糊匹配对应项；
1.4.业务部门：选择器，支持选择所有业务部门；
1.5.业务负责人：选择器，支持选择所有业务负责人；
2.列表：
#列表展示方式为：嵌套子表格，分为主表和子表，可点击主表展开子表，一个合同编码可以展开多个提车应收款明细；
2.1.主表显示字段为：合同编码、合同类型、项目名称、客户名称、合同生效日期、业务部门、业务负责人、操作；
2.1.1.合同编码：显示该提车应收款租赁合同对应合同编码；
2.1.2.合同类型：显示该租赁合同对应合同类型，显示该合同为试用合同还是正式合同；
2.1.3.项目名称：显示该租赁合同对应项目名称；
2.1.4.客户名称：显示该租赁合同对应客户名称；
2.1.5.合同生效日期：显示该租赁合同生效日期，格式为：YYYY-MM-DD；
2.1.6.业务部门：显示该租赁合同对应业务部门名称；
2.1.7.业务负责人：显示该租赁合同对应业务负责人；
2.1.8.操作：提车收款单；
2.1.8.1.提车收款单：点击提车收款单，跳转提车收款单页进行子表创建；
主表右下角为分页符，支持选择单页显示多少条数据；
2.2.子表显示字段为：序号、审批状态、创建时间、提车数量、应收款总额、实收款总额、减免总金额、实际到账金额、是否已开票、已开票金额、操作；
2.2.1.序号：按照提车首付款收费单据提交时间从最早开始显示第1条，按照顺序1.2.3....；
2.2.2.审批状态：审批通过、待审批、审批中、已驳回；
2.2.2.1.审批通过：该审批通过最终节点审批，显示为审批通过；
2.2.2.2.待审批：审批提车收款单仅保存，但未提交审批；
2.2.2.3.审批中：已发起审批流程，但未完成最终节点审批；
2.2.2.4.审批驳回：发起审批流程，但任意节点被驳回。被驳回的提车收款单支持重新修改后提交审批；
2.2.3.创建时间：显示提车收款单创建时间，格式为：YYYY-MM-DD HH:MM；
2.2.4.创建人：显示已提车收款单创建人姓名；
2.2.5.提车数量：显示该提车收费单对应提车数量，点击提车数量弹出气泡卡片，卡片中列表显示品牌、型号、车牌号；
2.2.6.应收款金额：按照该提车收费单据应收款金额，格式为：xx.xx元；
2.2.7.实收款金额：按照该提车收费单据实收款金额，格式为：xx.xx元；
2.2.8.减免金额：按照该提车收费单减免总金额，显示当前子表对应减免总额，格式为：xx.xx元；
2.2.9.实际到账金额：显示该提车收费单财务填写的实际到账金额，格式为：xx.xx元；
2.2.10.是否已开票：显示财务是否完成开票，已开票显示为：已开票，未开票显示为：未开票，部分开票显示为：部分开票；
2.2.11.已开票金额：显示财务已开票金额，格式为：xx.xx元；
2.2.12.总计：显示应收款总额、实收款总额、减免总金额、实际到账金额、已开票金额等所有子表求和数据；
2.2.13.操作：查看、编辑、删除、开票；
2.2.12.1.查看：点击查看后，跳转提车应收款-查看页面，审批通过、待审批、审批中、审批驳回均可点击查看来查看提车收款单详情；
2.2.12.2.编辑：点击编辑后，跳转提车应收款-编辑页面，待审批、审批驳回均可进行编辑操作；
2.2.12.2.删除：待审批、审批驳回状态子表支持删除功能，点击弹出二次确认，点击确认后删除该记录；
2.2.12.3.开票：点击开票后，进入提车应收款-开票页面，审批通过状态子表才显示，开票由财务人员操作，需要做权限控制，其他用户没有开票入口；

69
web端/需求说明/财务管理/提车应收款-审批 Normal file
View File

@@ -0,0 +1,69 @@
提车应收款-审批（2026年3月4日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「审批」模块
#面包屑：财务管理-提车应收款-审批；
页面分为4个卡片，业务流程请参考流程图；
1.项目信息：
#显示项目详细信息，包括：
1.1.合同编码：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同编码；
1.3.项目名称：显示该租赁合同对应项目名称；
1.4.客户名称：显示该租赁合同对应客户名称；
1.5.付款方式：显示该租赁合同对应付款方式，分为：预付、后付两种，根据实际合同反写；
1.6.付款周期：显示该租赁合同对应付款周期，格式为：x个月；
1.7.合同生效时间：显示该租赁合同对应合同生效时间；
1.8.合同结束时间：显示该租赁合同对应合同结束时间；
1.9.业务部门：显示该租赁合同对应业务部门名称；
1.10.业务负责人：显示该租赁合同对应业务负责人；
2.提车应收款信息：
#上方显示应收款总额、实收款总额；
2.1.应收款总额：显示提交审核时的应收款总额，格式为：xx.xx元，点击金额弹出气泡卡片，卡片中显示列表，字段为：
2.1.1.项目：包括总计应收车辆月租金、总计应收车辆保证金、总计应收服务费三项；
2.1.2.金额：显示该项目对应应收金额；
2.2.实收款总额：显示提交审核时的实收款总额，格式为：xx.xx元，点击金额弹出气泡卡片，卡片中显示列表，字段为：
2.2.1.项目：包括总计实收车辆月租金、总计应收车辆保证金、总计实收服务费、总计减免金额四项；
2.2.2.金额：显示该项目对应实收金额；
#中间为车辆应收款明细，以列表展示提车应收款已选中所有车辆明细，包括以下字段：
2.1.序号：根据租赁合同中车辆对应序号顺序展示；
2.2.品牌：显示租赁合同中车辆对应品牌；
2.3.型号：显示租赁合同中车辆对应型号；
2.4.车牌号：显示租赁合同中车辆对应车牌号，如果车牌号为空则显示为-（后续如果交车成功，则车牌号会反显在该处）；
2.5.应收车辆月租金：根据租赁合同付款周期自动计算，例如：付款周期为6个月，则这里显示金额为：车辆月租金*6；
2.6.实收车辆月租金：显示提交审核时的实收车辆月租金，格式为：xx.xx元；
2.7.车辆租金备注：显示提交审核时的车辆租金备注，超长则显示...，悬浮时显示全部详细内容；
2.8.减免金额：显示提交审核时的减免金额，格式为：xx.xx元；
2.9.减免金额备注：显示提交审核时的减免金额备注，超长则显示...，悬浮时显示全部详细内容；
2.10.减免证明：显示所有附件，可点击预览；
2.11.应收车辆保证金：显示租赁合同中当前车辆保证金金额，格式为：xx.xx元；
2.12.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.12.1.服务项目：显示租赁合同中所有服务项目名称；
2.12.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.12.3.实收费用：显示提交审核时的实收费用金额，格式为：xx.xx元；
2.12.4.减免费用：显示提交审核时的减免费用金额，格式为：xx.xx元；
2.12.4.备注：显示提交审核时的服务费减免备注，超长则显示...，悬浮时显示全部详细内容；
2.13.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.14.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.15.列表下方对应字段下方显示总计数据，包括：总计应收车辆月租金、总计实收车辆月租金、总计应收车辆保证金、总计应收服务费、总计实收服务费、总计减免金额；
列表不支持分页功能；
#下方为氢费预付款情况，以列表展示租赁合同中所有氢费预付款明细，包括以下字段，如租赁合同氢费非预付款模式，则不显示该部分内容：
2.19.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.20.氢费预付款实收金额：显示提交审核时的氢费预付款实收金额，格式为：xx.xx元；
2.21.减免金额：显示提交审核时的减免金额，格式为：xx.xx元；
2.22.减免金额备注：显示提交审核时的氢费预付款减免备注，超长则显示...，悬浮时显示全部详细内容；
#最底部为开票方式、开票备注；
2.23.开票方式：显示提交审核时的开票方式；
2.24.开票备注：显示提交审核时的开票备注；
3.审核情况：
#上方为纵向步骤条，显示所有审批步骤
3.1.步骤中显示部门名称，部门名称后方显示审批状态、审批人、审批时间；
3.1.1.部门名称：当前节点部门名称；
3.1.2.审批状态：分为待审批、审批通过、审批驳回；
3.1.3.审批人：步骤节点对应审批人姓名；
3.1.4.审批时间：显示审批通过/驳回时间，格式为：YYYY-MM-DD HH:MM；
3.2.当前步骤的审批人下方为审批说明：非必填，文本域，支持自定义输入；
3.3.底部为审批通过、驳回、取消；
3.3.1.审批通过：点击提示：审批完成，同时下个流程节点审批人工作台待办任务中收到审批任务和消息提示；如当前已是最后节点，则完成审批，同时进入财务开票环节；
4.3.2.驳回：点击进行二次确认，二次确认后提示：驳回成功，同时该任务在列表中显示为审核驳回，发起人可重新编辑；
4.3.3.取消：点击返回提车应收款列表页；

82
web端/需求说明/财务管理/提车应收款-开票信息 Normal file
View File

@@ -0,0 +1,82 @@
提车应收款-开票信息（2026年3月5日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「开票信息」模块
#面包屑：财务管理-提车应收款-开票信息；
页面分为3个卡片，业务流程请参考流程图；
1.项目信息：
#显示项目详细信息，包括：
1.1.合同编码：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同编码；
1.3.项目名称：显示该租赁合同对应项目名称；
1.4.客户名称：显示该租赁合同对应客户名称；
1.5.付款方式：显示该租赁合同对应付款方式，分为：预付、后付两种，根据实际合同反写；
1.6.付款周期：显示该租赁合同对应付款周期，格式为：x个月；
1.7.合同生效时间：显示该租赁合同对应合同生效时间；
1.8.合同结束时间：显示该租赁合同对应合同结束时间；
1.9.业务部门：显示该租赁合同对应业务部门名称；
1.10.业务负责人：显示该租赁合同对应业务负责人；
22.提车应收款信息：
#上方显示应收款总额、实收款总额；
2.1.应收款总额：显示提交审核时的应收款总额，格式为：xx.xx元，点击金额弹出气泡卡片，卡片中显示列表，字段为：
2.1.1.项目：包括总计应收车辆月租金、总计应收车辆保证金、总计应收服务费三项；
2.1.2.金额：显示该项目对应应收金额；
2.2.实收款总额：显示提交审核时的实收款总额，格式为：xx.xx元，点击金额弹出气泡卡片，卡片中显示列表，字段为：
2.2.1.项目：包括总计实收车辆月租金、总计应收车辆保证金、总计实收服务费、总计减免金额四项；
2.2.2.金额：显示该项目对应实收金额；
#中间为车辆应收款明细，以列表展示提车应收款已选中所有车辆明细，包括以下字段：
2.1.序号：根据租赁合同中车辆对应序号顺序展示；
2.2.品牌：显示租赁合同中车辆对应品牌；
2.3.型号：显示租赁合同中车辆对应型号；
2.4.车牌号：显示租赁合同中车辆对应车牌号，如果车牌号为空则显示为-（后续如果交车成功，则车牌号会反显在该处）；
2.5.应收车辆月租金：根据租赁合同付款周期自动计算，例如：付款周期为6个月，则这里显示金额为：车辆月租金*6；
2.6.实收车辆月租金：显示提交审核时的实收车辆月租金，格式为：xx.xx元；
2.7.车辆租金备注：显示提交审核时的车辆租金备注，超长则显示...，悬浮时显示全部详细内容；
2.8.减免金额：显示提交审核时的减免金额，格式为：xx.xx元；
2.9.减免金额备注：显示提交审核时的减免金额备注，超长则显示...，悬浮时显示全部详细内容；
2.10.减免证明：显示所有附件，可点击预览；
2.11.应收车辆保证金：显示租赁合同中当前车辆保证金金额，格式为：xx.xx元；
2.12.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.12.1.服务项目：显示租赁合同中所有服务项目名称；
2.12.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.12.3.实收费用：显示提交审核时的实收费用金额，格式为：xx.xx元；
2.12.4.减免费用：显示提交审核时的减免费用金额，格式为：xx.xx元；
2.12.4.备注：显示提交审核时的服务费减免备注，超长则显示...，悬浮时显示全部详细内容；
2.13.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.14.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.15.列表下方对应字段下方显示总计数据，包括：总计应收车辆月租金、总计实收车辆月租金、总计应收车辆保证金、总计应收服务费、总计实收服务费、总计减免金额；
列表不支持分页功能；
#下方为氢费预付款情况，以列表展示租赁合同中所有氢费预付款明细，包括以下字段，如租赁合同氢费非预付款模式，则不显示该部分内容：
2.19.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.20.氢费预付款实收金额：显示提交审核时的氢费预付款实收金额，格式为：xx.xx元；
2.21.减免金额：显示提交审核时的减免金额，格式为：xx.xx元；
2.22.减免金额备注：显示提交审核时的氢费预付款减免备注，超长则显示...，悬浮时显示全部详细内容；
#最底部为开票方式、开票备注；
2.23.开票方式：显示提交审核时的开票方式；
2.24.开票备注：显示提交审核时的开票备注；
3.开票信息：
#上方显示该租赁合同客户信息（如果该合同转为三方合同，则未开票部分开票信息修改为丙方开票信息），包括：
3.1.客户名称：显示租赁合同客户名称；
3.2.纳税人识别号：显示该客户对应纳税人识别号；
3.3.地址：显示该客户对应地址；
3.4.电话：显示该客户对应电话；
3.5.账户：显示该客户对应账户；
3.6.开户行：显示该客户对应开户行；
3.7.邮寄地址：显示该客户对应邮寄地址；
#下方显示列表，包括以下字段，列表上方显示未付金额，格式为xx.xx元（计算方式为：实收款总额-（所有到账金额记录总和）），列表显示过往提交的历史记录，同时默认一行可编辑，支持继续新增一行和删除行操作（过往提交的历史记录无法删除）：
3.8.到账时间：时间选择器，格式为：YYYY-MM-DD HH:MM，新增未提交的记录支持删除，但之前已完成提交的记录无法删除；
3.9.到账金额：输入框，支持2位小数，格式为：xx.xx元，新增未提交的记录支持删除，但之前已完成提交的记录无法删除；；
3.10.开票时间：时间选择器，格式为：YYYY-MM-DD HH:MM，默认为打开页面的时间，新增未提交的记录支持删除，但之前已完成提交的记录无法删除；
3.11.发票附件：附件上传按钮，支持多附件上传，上传后显示附件名称，新增未提交的记录支持删除，但之前已完成提交的记录无法删除；
3.12.备注：输入框，新增未提交的记录支持删除，但之前已完成提交的记录无法删除；；
3.13.开票人：显示上传发票的操作用户姓名；
3.14.支持新增一行、删除一行（新增未提交的记录可以删除，已完成提交的历史记录不能删除）；
4.审批情况：
#上方为纵向步骤条，显示所有审批步骤
4.1.步骤中显示部门名称，部门名称后方显示审批状态、审批人、审批时间，所有审批记录已完成；
5.底部为提交，取消；
5.1.提交：点击提交，进行二次确认，文案为：请仔细核对提车首付款到账和开票信息，提交后无法修改；
5.2.取消：点击取消，进行二次确认，文案为：取消将会丢失所有已填写数据，是否确认，点击确认则跳转至提车应收款列表页；

68
web端/需求说明/财务管理/提车应收款-提车收款单-编辑 Normal file
View File

@@ -0,0 +1,68 @@
提车应收款-提车收款单-编辑（2026年3月10日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「提车收款单」「编辑」模块
#面包屑：财务管理-提车应收款-提车收款单-编辑；
页面分为3个卡片，业务流程请参考流程图；
1.项目信息：
#显示项目详细信息，包括：
1.1.合同编码：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同类型；
1.3.项目名称：显示该租赁合同对应项目名称；
1.4.客户名称：显示该租赁合同对应客户名称；
1.5.付款方式：显示该租赁合同对应付款方式，分为：预付、后付两种，根据实际合同反写；
1.6.付款周期：显示该租赁合同对应付款周期，格式为：x个月；
1.7.合同生效时间：显示该租赁合同对应合同生效时间；
1.8.合同结束时间：显示该租赁合同对应合同结束时间；
1.9.业务部门：显示该租赁合同对应业务部门名称；
1.10.业务负责人：显示该租赁合同对应业务负责人；
2.提车应收款信息：
#上方显示应收款总额、实收款总额；
2.1.应收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆应收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆应收服务费总和」；
点击应收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.1.1.项目：包括总计应收车辆月租金、总计应收车辆保证金、总计应收服务费三项；
2.1.2.金额：显示该项目对应应收金额；
2.2.实收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆实收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆实收服务费总和」-「选中车辆减免金额总和」；
点击实收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.2.1.项目：包括总计实收车辆月租金、总计应收车辆保证金、总计实收服务费、总计减免金额四项；
2.2.2.金额：显示该项目对应实收金额；
#中间为车辆应收款明细，以列表展示租赁合同中所有车辆明细，包括以下字段：
2.1.全选/多选：多选按钮组，支持表头点击全选，编辑页面显示此前保存时已选中相关车辆，支持重新选择车辆；
提车应收款支持分批次进行收款，如果该车辆之前已提交提车应收款流程，则多选框不能勾选，悬浮多选框时提示：该车辆已完成提车应收款；
2.2.序号：根据租赁合同中车辆对应序号顺序展示；
2.3.品牌：显示租赁合同中车辆对应品牌；
2.4.型号：显示租赁合同中车辆对应型号；
2.5.车牌号：显示租赁合同中车辆对应车牌号，如果车牌号为空则显示为-（后续如果交车成功，则车牌号会反显在该处）；
2.6.应收车辆月租金：根据租赁合同付款周期自动计算，例如：付款周期为6个月，则这里显示金额为：车辆月租金*6；
2.7.实收车辆月租金：必填项，输入框，默认反写实收车辆月租金，支持修改，由业务员自行输入车辆月租金金额，精确至2位小数，后缀为元；
2.8.车辆租金备注：选填项，输入框，由业务员自行输入；
2.9.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.10.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.11.应收车辆保证金：显示租赁合同中当前车辆保证金金额；
2.12.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.12.1.服务项目：显示租赁合同中所有服务项目名称；
2.12.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.12.3.实收费用：必填项，输入框，默认反写应收费用，支持修改，由业务员自行输入实收费用金额，精确至2位小数，后缀为元；
2.12.4.减免费用：选填项，输入框，默认为：0.00，精确至2位小数，后缀为元；
2.12.4.备注：选填项，输入框，由业务员自行输入备注信息；
2.13.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.14.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.15.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.16.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.17.减免证明：选填项，附件上传按钮，点击后上传本地文件，支持：jpg、png、pdf等格式，支持多附件上传；
列表不支持分页功能；
#下方为氢费预付款情况，以列表展示租赁合同中所有氢费预付款明细，包括以下字段，如租赁合同氢费非预付款模式，则不显示该部分内容：
2.19.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.20.氢费预付款实收金额：必填项，输入框，默认反写氢费预付款应收金额，支持修改，由业务员自行输入金额，格式为：xx.xx元，支持2位小数；
2.21.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为：0.00元，格式为：xx.xx元，支持2位小数；
2.22.减免金额备注：选填项，输入框，由业务员自行输入减免金额备注信息；
#最底部为开票方式、开票备注；
2.23.开票方式：选择器，选项包括：先开票后付款、先付款后开票，默认为先开票后付款；
2.24.开票备注：必填项，文本域，默认提示文本为：请输入开票项目、税率以及其他备注信息，财务将以此进行开票；
3.底部为提交审核，保存，取消；
3.1.提交审核：点击提交审核，进行二次确认，文案为：请仔细核对提车首付款实收金额，点击确认则进入工作流；
3.2.保存：点击保存，提示保存成功，跳转至提车应收款列表页，同时该条数据审核状态为：待提交：
3.3.取消：点击取消，进行二次确认，文案为：取消将会丢失所有已填写数据，是否确认，点击确认则跳转至提车应收款列表页；

78
web端/需求说明/财务管理/提车应收款-收款
View File

@@ -1,12 +1,12 @@
提车应收款-收款（2026年3月4日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「收款」模块
#面包屑：财务管理-提车应收款-收款；
提车应收款-提车收款单（2026年3月10日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「提车收款单」模块
#面包屑：财务管理-提车应收款-提车收款单；
页面分为3个卡片，业务流程请参考流程图；
1.项目信息：
#显示项目详细信息，包括：
1.1.合同编码：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同类型；
1.3.项目名称：显示该租赁合同对应项目名称；
1.4.客户名称：显示该租赁合同对应客户名称；
1.5.付款方式：显示该租赁合同对应付款方式，分为：预付、后付两种，根据实际合同反写；
@@ -18,17 +18,19 @@
2.提车应收款信息：
#上方显示应收款总额、实收款总额；
2.1.应收款总额：格式为：xx.xx元，重点色，计算方式为：「总计应收车辆月租金」+「总计应收车辆保证金」+「总计应收服务费」；
2.1.应收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆应收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆应收服务费总和」；
点击应收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.1.1.项目：包括总计应收车辆月租金、总计应收车辆保证金、总计应收服务费三项；
2.1.2.金额：显示该项目对应应收金额；
2.2.实收款总额：格式为：xx.xx元，重点色，计算方式为：「总计实收车辆月租金」+「总计应收车辆保证金」+「总计实收服务费」-「总计减免金额」；
2.2.实收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆实收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆实收服务费总和」-「选中车辆减免金额总和」；
点击实收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.2.1.项目：包括总计实收车辆月租金、总计应收车辆保证金、总计实收服务费、总计减免金额四项；
2.2.2.金额：显示该项目对应实收金额；
#中间为车辆应收款明细，以列表展示租赁合同中所有车辆明细，包括以下字段：
2.1.全选/多选：多选按钮组，支持表头点击全选；
2.1.全选/多选：多选按钮组，支持表头点击全选，默认为取消勾选（整个车辆清单）；
选择代表本次提车应收款只收取该部分车辆费用，可以编辑以下相应字段，不选择则代表本次提车应收款不收取该部分车辆费用，不能编辑车辆相应字段；
提车应收款支持分批次进行收款，如果该车辆之前已提交提车应收款流程，则多选框不能勾选，悬浮多选框时提示：该车辆已完成提车应收款；
2.2.序号：根据租赁合同中车辆对应序号顺序展示；
2.3.品牌：显示租赁合同中车辆对应品牌；
2.4.型号：显示租赁合同中车辆对应型号；
@@ -36,44 +38,32 @@
2.6.应收车辆月租金：根据租赁合同付款周期自动计算，例如：付款周期为6个月，则这里显示金额为：车辆月租金*6；
2.7.实收车辆月租金：必填项，输入框，默认反写实收车辆月租金，支持修改，由业务员自行输入车辆月租金金额，精确至2位小数，后缀为元；
2.8.车辆租金备注：选填项，输入框，由业务员自行输入；
2.9.应收车辆保证金：显示租赁合同中当前车辆保证金金额；
2.10.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.10.1.服务项目：显示租赁合同中所有服务项目名称；
2.10.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.10.3.实收费用：必填项，输入框，默认反写应收费用，支持修改，由业务员自行输入实收费用金额，精确至2位小数，后缀为元；
2.10.4.减免费用：选填项，输入框，默认为：0.00，精确至2位小数，后缀为元；
2.10.4.备注：选填项，输入框，由业务员自行输入备注信息；
2.11.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.12.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.13.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.14.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.15.减免证明：选填项，附件上传按钮，点击后上传本地文件，支持：jpg、png、pdf等格式；
2.16.列表下方对应字段下方显示总计数据，包括：总计应收车辆月租金、总计实收车辆月租金、总计应收车辆保证金、总计应收服务费、总计实收服务费、总计减免金额；
2.9.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.10.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.11.应收车辆保证金：显示租赁合同中当前车辆保证金金额；
2.12.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.12.1.服务项目：显示租赁合同中所有服务项目名称；
2.12.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.12.3.实收费用：必填项，输入框，默认反写应收费用，支持修改，由业务员自行输入实收费用金额，精确至2位小数，后缀为元；
2.12.4.减免费用：选填项，输入框，默认为：0.00，精确至2位小数，后缀为元；
2.12.4.备注：选填项，输入框，由业务员自行输入备注信息；
2.13.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.14.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.15.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.16.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.17.减免证明：选填项，附件上传按钮，点击后上传本地文件，支持：jpg、png、pdf等格式，支持多附件上传；
列表不支持分页功能；
#下方为氢费预付款情况，以列表展示租赁合同中所有氢费预付款明细，包括以下字段，如租赁合同氢费非预付款模式，则不显示该部分内容：
2.17.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.18.氢费预付款实收金额：必填项，输入框，默认反写氢费预付款应收金额，支持修改，由业务员自行输入金额，格式为：xx.xx元，支持2位小数；
2.19.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为：0.00元，格式为：xx.xx元，支持2位小数；
2.20.减免金额备注：选填项，输入框，由业务员自行输入减免金额备注信息；
2.19.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.20.氢费预付款实收金额：必填项，输入框，默认反写氢费预付款应收金额，支持修改，由业务员自行输入金额，格式为：xx.xx元，支持2位小数；
2.21.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为：0.00元，格式为：xx.xx元，支持2位小数；
2.22.减免金额备注：选填项，输入框，由业务员自行输入减免金额备注信息；
#最底部为开票方式、开票备注；
2.21.开票方式：选择器，选项包括：先开票后付款、先付款后开票，默认为先开票后付款；
2.22.开票备注：必填项，文本域，默认提示文本为：请输入开票项目、税率以及其他备注信息，财务将以此进行开票；
2.23.开票方式：选择器，选项包括：先开票后付款、先付款后开票，默认为先开票后付款；
2.24.开票备注：必填项，文本域，默认提示文本为：请输入开票项目、税率以及其他备注信息，财务将以此进行开票；
3.开票信息：
#上方显示该租赁合同客户信息（如果该合同转为三方合同，则未开票部分开票信息修改为丙方开票信息），包括：
3.1.客户名称：显示租赁合同客户名称；
3.2.纳税人识别号：显示该客户对应纳税人识别号；
3.3.地址：显示该客户对应地址；
3.4.电话：显示该客户对应电话；
3.5.账户：显示该客户对应账户；
3.6.开户行：显示该客户对应开户行；
3.7.邮寄地址：显示该客户对应邮寄地址；
#下方显示
3.8.开票时间：格式为：YYYY-MM-DD HH:MM ，如未上传发票则显示未上传；
3.9.发票附件：显示已上传发票附件，格式为：发票文件名称.文件类型，如未上传发票附件，则显示未上传；
3.10.开票人：显示上传发票的操作用户姓名，如未上传则显示-；
4.底部为提交审核，保存，取消；
4.1.提交审核：点击提交审核，进行二次确认，文案为：请仔细核对提车首付款实收金额，点击确认则进入工作流；
4.2.保存：点击保存，提示保存成功，跳转至提车应收款列表页，同时该条数据审核状态为：待提交：
4.3.取消：点击取消，进行二次确认，文案为：取消将会丢失所有已填写数据，是否确认，点击确认则跳转至提车应收款列表页；
3.底部为提交审核，保存，取消；
3.1.提交审核：点击提交审核，进行二次确认，文案为：请仔细核对提车首付款实收金额，点击确认则进入工作流；
3.2.保存：点击保存，提示保存成功，跳转至提车应收款列表页，同时该条数据审核状态为：待提交：
3.3.取消：点击取消，进行二次确认，文案为：取消将会丢失所有已填写数据，是否确认，点击确认则跳转至提车应收款列表页；

83
web端/需求说明/财务管理/提车应收款-查看 Normal file
View File

@@ -0,0 +1,83 @@
提车应收款-查看（2026年3月10日版本）
一个「数字化资产ONEOS运管平台」中的「财务管理」「提车应收款」「提车收款单」模块
#面包屑：财务管理-提车应收款-提车收款单；
页面分为3个卡片，业务流程请参考流程图；
1.项目信息：
#显示项目详细信息，包括：
1.1.合同编码：显示该租赁合同对应合同编码；
1.2.合同类型：显示该租赁合同对应合同类型；
1.3.项目名称：显示该租赁合同对应项目名称；
1.4.客户名称：显示该租赁合同对应客户名称；
1.5.付款方式：显示该租赁合同对应付款方式，分为：预付、后付两种，根据实际合同反写；
1.6.付款周期：显示该租赁合同对应付款周期，格式为：x个月；
1.7.合同生效时间：显示该租赁合同对应合同生效时间；
1.8.合同结束时间：显示该租赁合同对应合同结束时间；
1.9.业务部门：显示该租赁合同对应业务部门名称；
1.10.业务负责人：显示该租赁合同对应业务负责人；
2.提车应收款信息：
#上方显示应收款总额、实收款总额；
2.1.应收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆应收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆应收服务费总和」；
点击应收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.1.1.项目：包括总计应收车辆月租金、总计应收车辆保证金、总计应收服务费三项；
2.1.2.金额：显示该项目对应应收金额；
2.2.实收款总额：格式为：xx.xx元，重点色，计算方式为：「选中车辆实收车辆月租金总和」+「选中车辆应收车辆保证金总和」+「选中车辆实收服务费总和」-「选中车辆减免金额总和」；
点击实收款总额金额，弹出气泡卡片，气泡卡片列表展示：项目、金额；
2.2.1.项目：包括总计实收车辆月租金、总计应收车辆保证金、总计实收服务费、总计减免金额四项；
2.2.2.金额：显示该项目对应实收金额；
#中间为车辆应收款明细，以列表展示租赁合同中所有车辆明细，包括以下字段：
2.1.全选/多选：多选按钮组，支持表头点击全选，默认为取消勾选（整个车辆清单）；
选择代表本次提车应收款只收取该部分车辆费用，可以编辑以下相应字段，不选择则代表本次提车应收款不收取该部分车辆费用，不能编辑车辆相应字段；
提车应收款支持分批次进行收款，如果该车辆之前已提交提车应收款流程，则多选框不能勾选，悬浮多选框时提示：该车辆已完成提车应收款；
2.2.序号：根据租赁合同中车辆对应序号顺序展示；
2.3.品牌：显示租赁合同中车辆对应品牌；
2.4.型号：显示租赁合同中车辆对应型号；
2.5.车牌号：显示租赁合同中车辆对应车牌号，如果车牌号为空则显示为-（后续如果交车成功，则车牌号会反显在该处）；
2.6.应收车辆月租金：根据租赁合同付款周期自动计算，例如：付款周期为6个月，则这里显示金额为：车辆月租金*6；
2.7.实收车辆月租金：必填项，输入框，默认反写实收车辆月租金，支持修改，由业务员自行输入车辆月租金金额，精确至2位小数，后缀为元；
2.8.车辆租金备注：选填项，输入框，由业务员自行输入；
2.9.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.10.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.11.应收车辆保证金：显示租赁合同中当前车辆保证金金额；
2.12.服务费项目：点击管理，弹出气泡卡片，气泡卡片标题为服务费项目，下方为列表，显示服务项目、应收费用、实收费用、备注；
2.12.1.服务项目：显示租赁合同中所有服务项目名称；
2.12.2.应收费用：显示租赁合同中所有服务项目对应费用；
2.12.3.实收费用：必填项，输入框，默认反写应收费用，支持修改，由业务员自行输入实收费用金额，精确至2位小数，后缀为元；
2.12.4.减免费用：选填项，输入框，默认为：0.00，精确至2位小数，后缀为元；
2.12.4.备注：选填项，输入框，由业务员自行输入备注信息；
2.13.应收服务费：显示当前车辆所有服务费应收费用总和，格式为：xx.xx元；
2.14.实收服务费：显示当前车辆所有服务费实收费用总和，格式为：xx.xx元；
2.15.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为0.00，支持2位小数，后缀为元；
2.16.减免金额备注：选填项，输入框，由业务员自行输入备注信息；
2.17.减免证明：选填项，附件上传按钮，点击后上传本地文件，支持：jpg、png、pdf等格式，支持多附件上传；
2.18.列表下方对应字段下方显示总计数据，包括：总计应收车辆月租金、总计实收车辆月租金、总计应收车辆保证金、总计应收服务费、总计实收服务费、总计减免金额；
列表不支持分页功能；
#下方为氢费预付款情况，以列表展示租赁合同中所有氢费预付款明细，包括以下字段，如租赁合同氢费非预付款模式，则不显示该部分内容：
2.19.氢费预付款应收金额：显示租赁合同中氢费预付款金额，格式为：xx.xx元，支持2位小数；
2.20.氢费预付款实收金额：必填项，输入框，默认反写氢费预付款应收金额，支持修改，由业务员自行输入金额，格式为：xx.xx元，支持2位小数；
2.21.减免金额：选填项，输入框，由业务员自行输入减免金额，默认为：0.00元，格式为：xx.xx元，支持2位小数；
2.22.减免金额备注：选填项，输入框，由业务员自行输入减免金额备注信息；
#最底部为开票方式、开票备注；
2.23.开票方式：选择器，选项包括：先开票后付款、先付款后开票，默认为先开票后付款；
2.24.开票备注：必填项，文本域，默认提示文本为：请输入开票项目、税率以及其他备注信息，财务将以此进行开票；
3.客户付款信息：
#显示列表，包括以下字段，列表上方显示未付金额，格式为xx.xx元（计算方式为：实收款总额-（所有到账金额记录总和）），列表显示过往提交的历史记录；
该部分数据由V1.2版本从YS系统对接获取；
3.1.到账时间：显示实际到账时间，格式为：YYYY-MM-DD HH:MM；
3.2.到账金额：显示实际到账金额，支持2位小数，格式为：xx.xx元；
3.3.开票时间：显示实际开票时间，格式为：YYYY-MM-DD HH:MM；
3.4.发票附件：显示附件名称，支持点击预览，支持多附件；
3.5.备注：显示实际开票备注信息，超长则显示...，悬浮时显示全部详细内容；
4.审批情况：
#显示竖向步骤条，显示各流程节点部门、审批状态、审批人、审批时间；
4.1.部门：显示部门名称；
4.2.审批状态：显示当前节点审批状态；
4.3.审批人：显示当前节点审批人；
4.4.审批时间：显示当前节点审批时间，格式为：YYYY-MM-DD HH:MM；
5.底部为返回；
5.1.返回：点击跳转提车应收款列表页；