feat(frontend): 审批与系统设置模块页面接入及业务列表调整

This commit is contained in:
liuwenxin 2026-10-16 09:32:12 +08:00
parent 8ef26e22fb
commit 74f1ef1cf9
15 changed files with 1215 additions and 28 deletions

Binary file not shown.

View File

@ -2,7 +2,7 @@
> **面向 AI 代理的工作者:** 首工作块(M1)实施时使用 subagent-driven-development(推荐)或 executing-plans 逐任务实现本计划第二章;步骤使用复选框(`- [ ]`)语法跟踪进度。第一章路线图供全局导航。
**目标:** 在需求裁决全部落定(2026-10-12)后,为剩余 5 大模块与 T+ 同步给出推进路线;并交付首个工作块「系统设置与参数体系(#28)」的可执行实施计划(任务级,含测试与验证)。
**目标:** 在需求裁决全部落定(2026-10-12)后,为剩余 5 大模块与 T+ 同步给出推进路线;并交付首个工作块「系统设置与参数体系(#28)」的可执行实施计划(任务级,含测试与验证)。2026-10-15 功能清单核查补充(二次分配方案、工作台、复核审批、月结与调整单、备份恢复运维、公司信息配置)已并入路线图(1.1/1.3/1.4)并收录为第三章。
**架构:** 沿用现有六层(api → services → repositories → models,schemas 承载请求/响应,core 横切);新增「公式模板注册表(代码内有限集合)+ 参数按生效日期时点化存储 + 计算预览」作为核算模块的输入契约,不引入规则引擎。
@ -40,11 +40,17 @@
### 1.1 推荐顺序与依赖
```text
① 系统设置与参数体系(#28) ← 地基:岗位角色 + 参数 + 公式模板
② 基础数据管理 ← 人员引用 ① 岗位角色(外键上游)
③ 业务数据管理 ← 引用 ② 人员/产品/客户
① 系统设置与参数体系(#28)✅ ← 地基:岗位角色 + 参数 + 公式模板
│ 增量(2026-10-15):公司信息配置;审批开关走参数体系
② 基础数据管理 ✅ ← 人员引用 ① 岗位角色(外键上游)
③ 业务数据管理 ✅ ← 引用 ② 人员/产品/客户
│ 增量(2026-10-15):二次分配方案(合同刚建立时录入)
④ 绩效工资核算 ← 消费 ① 参数快照(按回款到账日)+ ②③ 数据
⑤ 报表统计(∥ ⑥ T+ 同步) ← ⑤ 只读消费 ③④;⑥ 写入 ②③ 目标表,受 IT 字段映射制约
│ 增量(2026-10-15):月度结算/调整单/负数工资;二次分配分摊(语义待澄清)
⑦ 复核审批流(新) ← 月结/二次分配的审批链(营销后勤→财务→领导);登录角色体系扩展
⑤ 报表统计(∥ ⑥ T+ 同步) ← ⑤ 只读消费 ③④;签字导出模板依赖 ⑦ 与公司信息;⑥ 受 IT 字段映射制约
⑧ 工作台(新) ← 消费 ④⑤⑥⑦ 数据的聚合展示层
⑨ 备份恢复与运维检查(新) ← 独立于业务块,可与任一批次并行,建议尽早
```
### 1.2 顺序论证(要点)
@ -59,32 +65,37 @@
| 块 | 范围界定 | 验收标准(一句话) |
| --- | --- | --- |
| ① 系统设置与参数体系 | 岗位角色 CRUD + 模板绑定;参数目录/版本化存储/按日期取值/变更留痕/对比/导出;公式纯函数;计算预览 | 管理员可新增岗位并绑定模板;任一参数变更产生含变更人/时间/项/旧值/新值/生效日期的记录;任意业务日期可解析当时快照;预览精确复现 360 天=6‰、361 天=4‰;301 基线不回归 |
| ② 基础数据管理 | 人员(岗位/工资标准/团队/辐射区域/拓展计划)、产品类型与目录、业务(客户)与归属变更 | 三类数据可维护并留痕;人员岗位引用 ① 岗位表;表含 T+ 预留列;客户分类(个人户/经理个人户/企业户)与归属修改不回溯历史 |
| ③ 业务数据管理 | 业务明细+指导价、发货(批次/运费/发货日)、回款(批次号/到账日/以物抵顶/手动指定发货批次)、毛利润(不含运费)、客户评级计算器 | 一笔业务可多产品多批次发货、多笔回款;回款天数按「发货日首日=1」自动算;折算走精确分数;评级只出等级不影响金额 |
| ④ 绩效工资核算 | 核算引擎(按回款到账日取参数)、单笔台账+核销防重、经理 12.5%+5%、试用期/年累计 18000、起付 60% 与 R×R、预付款/以物抵顶、月工资(分岗口径)、重算授权留痕 | 任一笔回款可复算到分(零误差);同笔回款不重复核算;08-13 前后企业户 2‰/3‰ 回溯正确;月工资表可生成 |
| ⑤ 报表统计 | 个人绩效明细、部门汇总、业务统计、回款区间统计、Excel 导出与打印 | 四表口径与台账一致且可下钻单笔;导出精度与页面一致 |
| ① 系统设置与参数体系 | 岗位角色 CRUD + 模板绑定;参数目录/版本化存储/按日期取值/变更留痕/对比/导出;公式纯函数;计算预览。**✅ 已完成**。增量(2026-10-15):公司信息配置(公司名称、logo 等基本信息);审批开关配置走参数体系;新增参数一律进参数注册表(用户重申:参数配置尽量灵活) | (原验收已达成)增量:公司信息可配置并用于登录页与导出页眉;审批开关参数化,关闭直接生效、开启走审批 |
| ② 基础数据管理 | 人员(岗位/工资标准/团队/辐射区域/拓展计划)、产品类型与目录、业务(客户)与归属变更。**✅ 已完成** | 三类数据可维护并留痕;人员岗位引用 ① 岗位表;表含 T+ 预留列;客户分类(个人户/经理个人户/企业户)与归属修改不回溯历史 |
| ③ 业务数据管理 | 业务明细+指导价、发货(批次/运费/发货日)、回款(批次号/到账日/以物抵顶/手动指定发货批次)、毛利润(不含运费)、客户评级计算器。**✅ 已完成**。增量(2026-10-15):二次分配方案 —— 只出现在合同刚建立时;合同建立时可手动选择参与二次分配的业务员;分配比例不要求合计 100%;审批开关开启时走审批 | (原验收已达成)增量:合同建立时可录入参与业务员与比例(不强制合计 100%);开关关闭直接生效;方案修改不影响已结算月份 |
| ④ 绩效工资核算 | 核算引擎(按回款到账日取参数)、单笔台账+核销防重、经理 12.5%+5%、试用期/年累计 18000、起付 60% 与 R×R、预付款/以物抵顶、月工资(分岗口径)、重算授权留痕。增量(2026-10-15):月度结算(按确认回款和计算快照生成);支持负数工资、扣补说明和调整单;结算后锁定 —— 修改源数据不影响已结算结果,只产生提示、历史记录和后续调整;二次分配分摊(语义待澄清,见 3.3) | 任一笔回款可复算到分(零误差);同笔回款不重复核算;08-13 前后企业户 2‰/3‰ 回溯正确;月工资表可生成。增量:任一月份可出月结快照并锁定;已锁月份源数据变更只产生提示与历史,金额不变;调整单留痕可追溯 |
| ⑤ 报表统计 | 个人绩效明细、部门汇总、业务统计、回款区间统计、Excel 导出与打印。增量(2026-10-15):导出模板围绕财务复核和领导签字设计 | 四表口径与台账一致且可下钻单笔;导出精度与页面一致。增量:导出模板含复核/签字栏与公司信息页眉 |
| ⑥ T+ 数据同步 | 五类数据抓取/清洗/入库、唯一键去重、失败重试、同步日志、周定时+手动触发 | 手动同步幂等(重跑不重复入库);失败有日志与重试;不覆盖人工字段 |
| ⑦ 复核审批流(新) | 月结与二次分配的审批链:营销后勤提交 → 财务复核 → 领导审核;审批开关配置(参数化,关闭直接生效);审批意见与版本;登录角色体系扩展(营销后勤/财务/领导为系统新登录角色,激活闲置的 permissions/role_permissions) | 开关关闭时提交即生效;开启时三级流转全程留痕;每级意见与版本可追溯;重算/改单产生新版本,不覆盖既有审批记录 |
| ⑧ 工作台(新) | 经营绩效总览、待办事项、风险预警、最近同步/计算/审批动态 | 四区块出数口径与台账/审批/同步日志一致可下钻;预警规则参数化可配置 |
| ⑨ 备份恢复与运维检查(新) | MySQL 定时备份与恢复演练、运维检查(容器/磁盘/日志/Redis/同步状态)、检查清单与脚本 | 任一备份可按文档恢复成功;检查项脚本化输出健康报告 |
### 1.4 里程碑(交付批次)
| 批次 | 内容 | 说明 |
| --- | --- | --- |
| **M1** | ① 系统设置与参数体系 | 独立可交付;预览工具可作业务对账入口先行验收 |
| **M2** | ② + ③ | 合并交付:一次表结构评审把 T+ 预留列与报表字段清单同时定稿 |
| **M3** | ④ 绩效工资核算 | 核心钱袋子;测试重点在精度与参数回溯 |
| **M4** | ⑤ 报表 + ⑥ T+ 同步(并行) | ⑥ 受 IT 制约,谁先就绪谁先交 |
| **M1** | ① 系统设置与参数体系 | ✅ 已完成(2026-10-13 推送 feat/system-params) |
| **M2** | ② + ③ | ✅ 已完成(2026-10-13 分支 feat/base-business-data) |
| **M3** | ① 增量(公司信息/审批开关)+ ③ 增量(二次分配录入)+ ④ 绩效工资核算(含月结/调整单/负数工资)+ ⑦ 复核审批流 | 核心闭环「核算 → 提交 → 财务复核 → 领导审核 → 锁定」;开工前必须澄清:二次分配分摊语义(3.3-1)、经理个人户基数(开放问题 #7);内部建议顺序 ①增量 → ③增量 → ⑦ 审批框架 → ④ 核算 → 月结与审批串联 |
| **M4** | ⑤ 报表(含财务复核/领导签字导出模板)+ ⑥ T+ 同步(并行)+ ⑧ 工作台 | ⑥ 受 IT 制约,谁先就绪谁先交;⑧ 消费 ④⑤⑥⑦ 出数,排其后 |
| **⑨ 备份恢复与运维检查** | 不占独立批次,随任一批次并行(建议 M3 期间并行交付) | 数据持续积累,备份先行;不依赖业务模块进度 |
### 1.5 需求依据对照
| 块 | 依据 | 关联作废条款(不引用) |
| --- | --- | --- |
| ① | 需规 2.3.1(四)/2.5.2/2.1.2;对照表 #28/#5/#8/#20–#24 | 经理个人户 8‰(不设参数);含运费口径;协助 25%(不设参数) |
| ① | 需规 2.3.1(四)/2.5.2/2.1.2;对照表 #28/#5/#8/#20–#24;增量见 3.1(五)(六) | 经理个人户 8‰(不设参数);含运费口径;协助 25%(不设参数) |
| ② | 需规 2.1.1–2.1.3;对照表 #9/#19/#26 | 信息部负责人条款(信息员独立角色) |
| ③ | 需规 2.2.1–2.2.5;对照表 #1/#2/#12/#13/#14/#18/#25 | 26 天示例;含运费公式(2.2.4/2.3.3 整段) |
| ④ | 需规 2.3.1–2.3.3;对照表 #3/#4/#6/#7/#11/#15/#16/#17/#20–#24 | 协助 25%;经理 8‰;26 天示例;含运费公式 |
| ⑤ | 需规 2.4.1–2.4.3;对照表 #22(明细展示 R) | — |
| ③ | 需规 2.2.1–2.2.5;对照表 #1/#2/#12/#13/#14/#18/#25;增量见 3.1(一) | 26 天示例;含运费公式(2.2.4/2.3.3 整段) |
| ④ | 需规 2.3.1–2.3.3;对照表 #3/#4/#6/#7/#11/#15/#16/#17/#20–#24;增量见 3.1(一)(四) | 协助 25%;经理 8‰;26 天示例;含运费公式 |
| ⑤ | 需规 2.4.1–2.4.3;对照表 #22(明细展示 R);增量见 3.1(四) | — |
| ⑥ | 需规各「同步 T+」条;对照表 #10/#26/#27 | — |
| ⑦⑧⑨ 及各块增量 | **2026-10-15 功能清单核查补充(本文第三章,原文照录)**——尚未回填需规与对照表,引用以第三章原文为准 | 二次分配 ≠ 协助 25%:#15 作废的是「协助 25% 分成」条款,二次分配是合同建立时的新机制,关系待业务澄清(3.3-1) |
---
@ -599,6 +610,118 @@ git commit -m "test(system): 参数体系模块用例与测试记录"
| 6 | 导出格式与列集合(是否含批次说明/操作人) | 以需规 2.3.1(四) 字段为准,导出前与业务对一次列 |
| 7 | 经理个人户业绩如何进入 12.5%+5%(裁决 #7 的具体衔接:该业绩是否计入「本人带领业务员」基数) | ④ 开工前必须确认(影响台账归属字段设计) |
---
## 第三章 2026-10-15 功能清单核查补充(新增需求)
> **来源与地位:** 用户以现有功能清单核查后补充的需求(2026-10-15)。本章 3.1 为**原文照录**(未做任何改写),3.2 起为开发侧归属与推演,**两者严格区分**;引用新需求一律以 3.1 原文为准。本批内容尚未回填需规文档与《问题与解决方案对照表》,是否回填由用户决定。任务级实施计划在对应里程碑开工前按第二章同粒度补齐。
### 3.1 需求原文(照录)
#### (一)二次分配方案
- 二次分配只出现在合同刚建立时。
- 合同建立时可手动选择参与二次分配的业务员。
- 分配比例不要求合计 100%。
- 审批流程可增加开关配置;关闭时直接生效,开启时走审批。
- 修改二次分配方案不影响已经结算的月份。
- 已结算月份如需调整,只能通过调整单或后续月份扣补处理。
#### (二)工作台
- 经营绩效总览
- 待办事项
- 风险预警
- 最近同步/计算/审批动态
#### (三)复核审批
- 营销后勤提交
- 财务复核
- 领导审核
- 审批开关配置
- 审批意见与版本
#### (四)月结、审批、报表
- 月度结算按确认回款和计算快照生成。
- 支持负数工资、扣补说明和调整单。
- 结算后锁定,修改源数据不影响已结算结果,只产生提示、历史记录和后续调整。
- 导出模板围绕财务复核和领导签字设计。
#### (五)备份恢复与运维检查
- (标题级条目,无细则,用户强调「这个备份恢复很重要」)
#### (六)系统设置
- 公司信息配置:公司名称、logo 等基本信息
#### (七)参数配置强调
- (用户原话):「业务强调参数配置尽量还是灵活一点,能省去以后很多麻烦」
### 3.2 模块归属与设计要点(开发侧推演,非需求原文)
#### (一) 二次分配方案 → ③ 录入 + ④ 分摊消费 + ⑦ 审批联动 + ④ 调整单衔接
- 「只出现在合同刚建立时」→ 录入入口放业务创建流程(与 `businesses` 创建同事务或紧随其后);合同建立后是否允许补录/修改未明说,方案修改的留痕方式待设计;
- 「分配比例不要求合计 100%」→ 余额归属规则需求未说明(3.3-1),存储上只存各参与人比例、不强制校验合计;
- 「修改不影响已结算月份」→ 月结快照天然隔离(快照固化当月结果),方案表需支持编辑 + 修改留痕;
- 「已结算月份调整只能通过调整单或后续月份扣补」→ 调整单为统一承载机制,见 (四)。
#### (二) 工作台 → ⑧ 新页面(升级现有 Bento 仪表盘占位)
| 区块 | 数据源(推演) |
| --- | --- |
| 经营绩效总览 | ④ 台账/月结(按人/团队/月份汇总) |
| 待办事项 | ⑦ 待审批单、⑥ 同步失败、回款未指定批次(M2 已有该状态可复用) |
| 风险预警 | 规则未定义(3.3-5),先落参数化规则容器 |
| 最近同步/计算/审批动态 | ⑥ 同步日志 + ④ 核算/月结记录 + ⑦ 审批记录 |
#### (三) 复核审批 → ⑦ 新模块
- 三级节点:营销后勤提交 → 财务复核 → 领导审核;
- 审批对象:月度结算((四) 联动);二次分配方案审批((一) 开关联动);
- 「审批开关配置」→ 进 ① 参数体系(BOOL 参数,按审批对象各一);「关闭时直接生效」= 提交即生成自动通过的审批记录(留痕不断链);
- 「审批意见与版本」→ 审批单带版本号:重算/改单产生新版本,旧版本与意见留痕不覆盖;
- **登录角色体系扩展**:营销后勤/财务/领导是系统新登录角色(`roles` 表基础设施已有;`permissions`/`role_permissions` 自 M1 起闲置待权限清单,此处激活)——打破一期「营销人员不登录」的前提,但与该原则不矛盾(营销人员仍不登录,后勤/财务/领导是职能角色)。
#### (四) 月结、审批、报表 → ④ 月结子块 + ⑦ 审批 + ⑤ 导出模板
- 月度结算 = 台账之上的月度汇总快照(按月生成、含状态机:草稿/待审/已审定/已锁定);「确认回款」定义待澄清(3.3-3);
- 「支持负数工资」与既有裁决「负绩效按公式正常计算(不归零)」一致,无需改公式口径;
- 调整单:新单据类型(补发/扣减方向、关联月份、扣补说明、审批状态);
- 「结算后锁定」:已锁月份的快照金额不可变;源数据修改只产生提示、历史记录和后续调整 —— 与 #19「归属变更不回溯历史」同一哲学,扩展到全部源数据;
- 导出模板含财务复核栏、领导签字栏、公司信息页眉(依赖 (六) 公司信息配置)。
#### (五) 备份恢复与运维检查 → ⑨(原文无细则,范围由开发定义后交用户确认)
- 备份:MySQL 定时全量(mysqldump,命名卷外置)+ 保留策略 + **恢复演练文档与脚本**(备份不演练 = 没有备份);
- 运维检查:容器状态、磁盘空间、备份新鲜度、Redis 键 TTL 抽查、同步日志异常、登录日志异常 → 脚本化健康报告;
- 用户强调重要 → 建议 M3 期间并行尽早交付(不依赖业务模块)。
#### (六) 系统设置-公司信息 + 参数灵活性 → ① 增量
- 公司信息配置:公司名称、logo(登录页与 ⑤ 导出页眉消费);
- 参数灵活性(用户重申方向):新增审批开关、二次分配、月结相关配置**一律进参数注册表**(16 项清单将扩充),沿用「公式模板(代码内有限集合)+ 参数绑定」既定路线;新增公式形态仍需加模板(一期接受,与「不引入规则引擎」一致)。
### 3.3 待澄清问题(不阻塞收录,对应模块开工前须澄清)
| # | 事项 | 影响模块 | 建议默认处理 |
| --- | --- | --- | --- |
| 1 | 二次分配的**分配标的**(绩效金额?折算毛利润?业绩额?)与**余额归属**(合计 ≠100% 时差额归谁);与已作废的「协助 25%」(#15)是何关系 | ④ 分摊逻辑与台账归属字段 | 未确认前 ④ 只落录入与存储,不实现分摊 |
| 2 | 二次分配审批开关默认值(开/关) | ⑦ 参数种子 | 按「支付环节按需规默认值参数化」先例:默认关闭(直接生效),可开 —— 待业务确认 |
| 3 | 「确认回款」的定义:登记即确认 / T+ 同步即确认 / 需人工确认动作? | ④ 月结取数口径 | 建议需人工确认动作(可在回款确认状态上扩展),待确认 |
| 4 | 审批角色权限清单:营销后勤/财务/领导的账号归属、可见菜单、操作权限点 | ⑦ 与系统管理 | 开工前业务方给出清单;技术侧激活 permissions/role_permissions |
| 5 | 风险预警规则:哪些情形预警、阈值多少 | ⑧ | ④⑤ 落地后与业务确认首批规则,先落参数化容器 |
| 6 | 调整单是否走同一审批链;能否跨月调整已锁定月份 | ④⑦ | 建议走同一审批链;「后续月份扣补」为默认路径,跨月调整需授权留痕 —— 待确认 |
| 7 | 待办事项的范围(除审批/同步失败外还含哪些,回款未指定批次是否算待办) | ⑧ | 按 3.2(二) 默认清单起步,业务确认后扩充 |
### 3.4 对路线图的影响(本次已修订)
1.1 依赖图、1.3 范围与验收、1.4 里程碑、1.5 依据对照均已并入本批内容;第三章待 3.3 各项澄清后,按第二章同粒度补齐 M3 各增量块的任务级实施计划。
## 验证方式
1. 计划内容与 `ai-aux/AI_CONTEXT.md` 需求裁决节逐条核对(口径无冲突、无遗漏作废条款);

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -0,0 +1,91 @@
import request from './request'
import type { PageData } from './types'
/** 审批单状态:1待财务复核 2待领导审核 3已通过 4已驳回 5已撤回 */
export const APPROVAL_STATUS = {
PENDING_FINANCE: 1,
PENDING_LEADER: 2,
APPROVED: 3,
REJECTED: 4,
WITHDRAWN: 5,
} as const
export function approvalStatusLabel(status: number): string {
return (
{
1: '待财务复核',
2: '待领导审核',
3: '已通过',
4: '已驳回',
5: '已撤回',
}[status] ?? String(status)
)
}
export function approvalStatusTagType(status: number): 'primary' | 'success' | 'danger' | 'info' {
return (
({ 1: 'primary', 2: 'warning', 3: 'success', 4: 'danger', 5: 'info' } as const)[status] ??
'info'
) as 'primary' | 'success' | 'danger' | 'info'
}
/** 节点动作:1通过 2驳回 3自动通过(系统) 4撤回 */
export function stepActionLabel(action: number): string {
return ({ 1: '通过', 2: '驳回', 3: '自动通过', 4: '撤回' } as const)[action] ?? String(action)
}
/** 节点名:0 仅用于撤回留痕 */
export function stepNodeLabel(node: number): string {
return ({ 0: '撤回', 1: '财务复核', 2: '领导审核' } as const)[node] ?? `节点${node}`
}
export interface ApprovalStep {
id: number
node: number
action: number
opinion: string | null
operator_id: number | null
operator_name: string
create_time: string
}
export interface ApprovalOrder {
id: number
order_no: string
/** 1二次分配方案 2月度结算(预留) */
order_type: number
ref_id: number
refer_no: string
status: number
submitter_id: number | null
submitter_name: string
create_time: string
}
export interface ApprovalOrderDetail extends ApprovalOrder {
steps: ApprovalStep[]
}
export interface ApprovalQueryParams {
pageNum?: number
pageSize?: number
/** 审批单号/引用单号,模糊 */
keyword?: string
status?: number
order_type?: number
}
export function listApprovals(params: ApprovalQueryParams): Promise<PageData<ApprovalOrder>> {
return request({ url: '/v1/system/approvals', method: 'get', params })
}
export function getApproval(orderId: number): Promise<ApprovalOrderDetail> {
return request({ url: `/v1/system/approvals/${orderId}`, method: 'get' })
}
export function actApproval(
orderId: number,
data: { action: 1 | 2; opinion?: string | null },
): Promise<ApprovalOrderDetail> {
return request({ url: `/v1/system/approvals/${orderId}/action`, method: 'post', data })
}

View File

@ -50,9 +50,20 @@ export interface BusinessItem {
remark: string | null
}
/** 业务详情:附产品明细行(编辑弹窗一次回显) */
/** 二次分配参与人(2026-10-15 补充需求;比例不强制合计 100%) */
export interface SecondaryAllocationRow {
personnel_id: number
personnel_name: string
/** 百分比数字字符串(两位小数) */
ratio: string
}
/** 业务详情:附产品明细行与二次分配方案(编辑弹窗一次回显) */
export interface BusinessDetail extends BusinessItem {
items: BusinessItemRow[]
secondary_allocations: SecondaryAllocationRow[]
/** 方案合计/余额提示(余额归属待澄清 #2,仅展示) */
allocation_hint: string | null
}
export interface BusinessQueryParams {
@ -96,6 +107,8 @@ export interface BusinessCreateParams {
is_special?: number
special_note?: string | null
items: BusinessItemParams[]
/** 二次分配方案(只出现在合同刚建立时;空=不设置) */
secondary_allocations?: { personnel_id: number; ratio: string }[]
remark?: string | null
}
@ -111,6 +124,8 @@ export interface BusinessUpdateParams {
is_special?: number
special_note?: string | null
items: BusinessItemParams[]
/** 二次分配方案(全量替换;空数组=清空) */
secondary_allocations?: { personnel_id: number; ratio: string }[]
remark?: string | null
}

View File

@ -0,0 +1,40 @@
import service, { request } from './request'
/** 公司信息(管理端) */
export interface CompanySettings {
company_name: string
/** 未上传时为 null */
logo_url: string | null
}
/** 匿名端点出参(登录页消费;与后端 SettingPublicOut 白名单一致) */
export interface PublicSettings {
company_name: string
logo_url: string | null
}
export function getSettings(): Promise<CompanySettings> {
return request({ url: '/v1/system/settings', method: 'get' })
}
export function updateSettings(companyName: string): Promise<CompanySettings> {
return request({
url: '/v1/system/settings',
method: 'put',
data: { company_name: companyName },
})
}
/** logo 上传走独立的 FormData(multipart,非 JSON) */
export function uploadLogo(file: File): Promise<CompanySettings> {
const form = new FormData()
form.append('file', file)
return service.post('/v1/system/settings/logo', form, {
headers: { 'Content-Type': 'multipart/form-data' },
})
}
/** 登录页消费:无令牌也可调用(后端白名单端点) */
export function getPublicSettings(): Promise<PublicSettings> {
return request({ url: '/v1/system/settings/public', method: 'get' })
}

View File

@ -31,12 +31,18 @@ export function useAppMenu() {
const userStore = useUserStore()
const isAdmin = computed(() => userStore.roles.includes(ROLE_ADMIN))
const userRoles = computed(() => userStore.roles)
const menuNodes = computed<MenuNode[]>(() =>
router
.getRoutes()
.filter((record) => Boolean(record.meta.title) && record.meta.menu !== false)
.filter((record) => !record.meta.requiresAdmin || isAdmin.value)
// 职能页面(审批等):任一列入角色命中即可见(admin 须显式列入集合)
.filter(
(record) =>
!record.meta.allowedRoles || record.meta.allowedRoles.some((role) => userRoles.value.includes(role)),
)
.map((record) => ({
path: record.path,
title: record.meta.title ?? '',

View File

@ -12,6 +12,9 @@ declare module 'vue-router' {
title?: string
/** 仅管理员可访问 —— 菜单隐藏 + 守卫兜底(直接输 URL 会被弹回首页) */
requiresAdmin?: boolean
/** 任一角色可访问(与 requiresAdmin 互斥使用;admin 须显式列入)——
* 菜单按角色过滤 + 守卫兜底,用于审批等职能页面 */
allowedRoles?: string[]
/** 是否出现在侧边菜单(默认 true);false 用于排除登录页等 */
menu?: boolean
/** 菜单分组名(同名聚合为一个子菜单);不设则为顶层菜单项 */
@ -64,49 +67,67 @@ const routes: RouteRecordRaw[] = [
component: () => import('@/views/system/params/index.vue'),
meta: { title: '计提参数', group: '系统管理', requiresAdmin: true, order: 6 },
},
{
path: '/system/settings',
name: 'system-settings',
component: () => import('@/views/system/settings/index.vue'),
meta: { title: '公司信息', group: '系统管理', requiresAdmin: true, order: 7 },
},
{
// 审批管理:管理员/财务/领导可见(营销后勤待权限清单答复后放开)
path: '/system/approvals',
name: 'system-approvals',
component: () => import('@/views/system/approvals/index.vue'),
meta: {
title: '审批管理',
group: '系统管理',
allowedRoles: [ROLE_ADMIN, 'finance', 'leader'],
order: 8,
},
},
{
path: '/system/logs',
name: 'system-logs',
component: () => import('@/views/system/logs/index.vue'),
meta: { title: '日志查询', group: '系统管理', requiresAdmin: true, order: 7 },
meta: { title: '日志查询', group: '系统管理', requiresAdmin: true, order: 9 },
},
{
// 基础数据属业务操作:登录即可访问,不设 requiresAdmin(对照后端 api/v1/base)
path: '/base/personnel',
name: 'base-personnel',
component: () => import('@/views/base/personnel/index.vue'),
meta: { title: '人员管理', group: '基础数据', order: 8 },
meta: { title: '人员管理', group: '基础数据', order: 10 },
},
{
path: '/base/products',
name: 'base-products',
component: () => import('@/views/base/products/index.vue'),
meta: { title: '产品管理', group: '基础数据', order: 9 },
meta: { title: '产品管理', group: '基础数据', order: 11 },
},
{
path: '/base/customers',
name: 'base-customers',
component: () => import('@/views/base/customers/index.vue'),
meta: { title: '客户管理', group: '基础数据', order: 10 },
meta: { title: '客户管理', group: '基础数据', order: 12 },
},
{
// 业务数据组一律为业务操作:登录即可访问,不设 requiresAdmin
path: '/business/businesses',
name: 'business-businesses',
component: () => import('@/views/business/businesses/index.vue'),
meta: { title: '业务管理', group: '业务数据', order: 11 },
meta: { title: '业务管理', group: '业务数据', order: 13 },
},
{
path: '/business/shipments',
name: 'business-shipments',
component: () => import('@/views/business/shipments/index.vue'),
meta: { title: '发货管理', group: '业务数据', order: 12 },
meta: { title: '发货管理', group: '业务数据', order: 14 },
},
{
path: '/business/receipts',
name: 'business-receipts',
component: () => import('@/views/business/receipts/index.vue'),
meta: { title: '回款管理', group: '业务数据', order: 13 },
meta: { title: '回款管理', group: '业务数据', order: 15 },
},
{
// 业务数据组首个页面:评级计算器是打分工具,不影响绩效金额,
@ -114,7 +135,7 @@ const routes: RouteRecordRaw[] = [
path: '/business/rating',
name: 'business-rating',
component: () => import('@/views/business/rating/index.vue'),
meta: { title: '客户评级计算器', group: '业务数据', order: 14 },
meta: { title: '客户评级计算器', group: '业务数据', order: 16 },
},
],
},
@ -163,6 +184,12 @@ router.beforeEach(async (to) => {
return { path: '/dashboard' }
}
// 职能页面(审批等):任一角色命中即可进;菜单隐藏之外的第二道防线
if (to.meta.allowedRoles && !to.meta.allowedRoles.some((role) => userStore.roles.includes(role))) {
ElMessage.error('无权访问该页面')
return { path: '/dashboard' }
}
return true
})

View File

@ -131,6 +131,69 @@ const form = reactive({
remark: '',
})
// ==================== 二次分配方案(合同刚建立时可录入;不强制合计 100%) ====================
interface AllocationDraft {
personnel_id: number | undefined
/** 百分比数字字符串(两位小数),与后端 NUMERIC(5,2) 同口径 */
ratio: string
}
const allocationRows = ref<AllocationDraft[]>([])
/** 合计(0-999.99 不做上限:需求原文不要求合计 100%);余额 = 100 - 合计 */
const allocationTotal = computed(() => {
let total = 0
for (const row of allocationRows.value) {
const value = Number(row.ratio)
if (Number.isFinite(value)) total += value
}
return total
})
const allocationHint = computed(() => {
if (allocationRows.value.length === 0) return ''
const total = Number(allocationTotal.value.toFixed(2))
if (total === 100) return `二次分配合计 ${total.toFixed(2)}%`
const rest = Number((100 - total).toFixed(2))
return `二次分配合计 ${total.toFixed(2)}%,余额 ${rest.toFixed(2)}%(归属待业务确认)`
})
function addAllocationRow(): void {
allocationRows.value.push({ personnel_id: undefined, ratio: '' })
}
function removeAllocationRow(index: number): void {
allocationRows.value.splice(index, 1)
}
/** 分配行校验:人员非重、比例 0-100 两位小数;空行(未选人员且比例为 0)自动忽略 */
function validateAllocationRows(rows: AllocationDraft[]): string | null {
const active = rows.filter((r) => r.personnel_id !== undefined || Number(r.ratio) > 0)
const seen = new Set<number>()
for (let i = 0; i < active.length; i += 1) {
const row = active[i]
const no = `第 ${i + 1} 个`
if (row.personnel_id === undefined) return `${no}参与人未选择`
if (seen.has(row.personnel_id)) return `${no}参与人重复`
seen.add(row.personnel_id)
const value = row.ratio.trim()
if (!value) return `${no}分配比例未填写`
if (!AMOUNT_PATTERN.test(value) || ZERO_PATTERN.test(value)) {
return `${no}分配比例须为大于 0 的数字,最多两位小数`
}
if (Number(value) > 100) return `${no}分配比例不能超过 100%`
}
return null
}
/** 提交行:空行剔除;人员/比例均按提交格式直出 */
function buildAllocationParams(rows: AllocationDraft[]): { personnel_id: number; ratio: string }[] {
return rows
.filter((r) => r.personnel_id !== undefined)
.map((r) => ({ personnel_id: r.personnel_id as number, ratio: r.ratio.trim() }))
}
/** 默认落在首个类别上,避免空类别提交被后端拒 */
function emptyItem(): ItemDraft {
return {
@ -172,6 +235,7 @@ function openCreate(): void {
remark: '',
})
itemRows.value = [emptyItem()] // 预置一空行,用户可直接填写
allocationRows.value = []
dialogVisible.value = true
formRef.value?.clearValidate()
}
@ -203,6 +267,10 @@ async function openEdit(row: BusinessItem): Promise<void> {
cost_amount: it.cost_amount ?? '',
guided_price: it.guided_price ?? '',
}))
allocationRows.value = (detail.secondary_allocations ?? []).map((a) => ({
personnel_id: a.personnel_id,
ratio: a.ratio,
}))
formRef.value?.clearValidate()
}
@ -266,6 +334,11 @@ async function handleSubmit(): Promise<void> {
ElMessage.warning(rowError)
return
}
const allocError = validateAllocationRows(allocationRows.value)
if (allocError) {
ElMessage.warning(allocError)
return
}
submitting.value = true
try {
@ -277,6 +350,7 @@ async function handleSubmit(): Promise<void> {
is_special: form.is_special,
special_note: form.is_special === 1 ? form.special_note.trim() || null : null,
items: buildItemParams(itemRows.value),
secondary_allocations: buildAllocationParams(allocationRows.value),
remark: form.remark.trim() || null,
})
ElMessage.success('已保存')
@ -289,6 +363,7 @@ async function handleSubmit(): Promise<void> {
is_special: form.is_special,
special_note: form.is_special === 1 ? form.special_note.trim() || null : null,
items: buildItemParams(itemRows.value),
secondary_allocations: buildAllocationParams(allocationRows.value),
remark: form.remark.trim() || null,
})
ElMessage.success('业务已创建')
@ -752,6 +827,58 @@ onMounted(() => {
</el-row>
</el-form>
<!-- 二次分配方案:合同刚建立时可录入(编辑为全量替换);不强制合计 100% -->
<div class="items-head">
<span class="items-title">
二次分配方案
<span class="alloc-note">(可选;比例不要求合计 100%,分摊计算待业务确认后另批)</span>
</span>
<el-button size="small" @click="addAllocationRow">添加参与人</el-button>
</div>
<el-table :data="allocationRows" stripe size="small" class="items-table">
<el-table-column label="参与业务员" min-width="200">
<template #default="{ row }">
<el-select
v-model="row.personnel_id"
placeholder="选择参与人"
clearable
filterable
style="width: 100%"
>
<el-option
v-for="option in personnelOptions"
:key="option.id"
:label="personnelLabel(option)"
:value="option.id"
:disabled="option.status !== 1"
/>
</el-select>
</template>
</el-table-column>
<el-table-column label="分配比例(%)" min-width="140">
<template #default="{ row }">
<el-input
v-model="row.ratio"
placeholder="两位小数,0-100"
maxlength="6"
/>
</template>
</el-table-column>
<el-table-column label="操作" width="70" align="center">
<template #default="{ $index }">
<el-button link type="danger" size="small" @click="removeAllocationRow($index)">
删除
</el-button>
</template>
</el-table-column>
<template #empty>
<span class="alloc-empty">未设置二次分配 —— 该业务的全部绩效归负责营销人员。</span>
</template>
</el-table>
<div v-if="allocationRows.length > 0" class="alloc-total" :class="{ 'is-full': allocationTotal === 100 }">
{{ allocationHint }}
</div>
<div class="items-head">
<span class="items-title">产品明细(至少 1 行,编辑为全量替换)</span>
<el-button size="small" @click="addItemRow">添加一行</el-button>
@ -1209,6 +1336,32 @@ onMounted(() => {
font-size: 13px;
}
.alloc-note {
margin-left: 6px;
font-weight: 400;
font-size: 11px;
color: var(--ys-ink-3);
}
.alloc-total {
margin: -8px 0 16px;
padding: 6px 10px;
font-size: 12px;
color: var(--ys-ink-3);
background: #f4f5f8;
border-radius: 0 0 6px 6px;
}
.alloc-total.is-full {
color: var(--ys-indigo);
background: rgba(46, 75, 168, 0.07);
}
.alloc-empty {
font-size: 12px;
color: var(--ys-ink-3);
}
.items-table {
margin-bottom: 16px;
}

View File

@ -4,6 +4,7 @@ import { onMounted, reactive, ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { getCaptcha } from '@/api/auth'
import { getPublicSettings } from '@/api/settings'
import { useUserStore } from '@/store/user'
const router = useRouter()
@ -23,6 +24,20 @@ const form = reactive({
const captchaId = ref('')
const captchaImage = ref('')
/** 品牌名:默认衍水集团,公司信息设置页改了以后登录页同步生效(public 端点) */
const brandName = ref('衍水集团')
const brandLogo = ref<string | null>(null)
async function loadBrand(): Promise<void> {
try {
const data = await getPublicSettings()
if (data.company_name) brandName.value = data.company_name
brandLogo.value = data.logo_url
} catch {
// 登录页必须可用:公司信息接口失败时静默回退默认品牌名,不阻断登录
}
}
const rules: FormRules = {
username: [{ required: true, message: '请输入用户名', trigger: 'blur' }],
password: [{ required: true, message: '请输入密码', trigger: 'blur' }],
@ -72,7 +87,10 @@ async function handleSubmit(): Promise<void> {
}
}
onMounted(refreshCaptcha)
onMounted(() => {
refreshCaptcha()
loadBrand()
})
</script>
<template>

View File

@ -0,0 +1,416 @@
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { ElMessage } from 'element-plus'
import {
actApproval,
approvalStatusLabel,
approvalStatusTagType,
getApproval,
listApprovals,
stepActionLabel,
stepNodeLabel,
type ApprovalOrder,
type ApprovalOrderDetail,
} from '@/api/approvals'
import AppPagination from '@/components/table/AppPagination.vue'
import { useConfirmAction } from '@/composables/useConfirmAction'
import { usePagedList } from '@/composables/usePagedList'
import { handledError } from '@/utils/error'
import { formatDateTime } from '@/utils/format'
/**
* 审批管理(2026-10-15 复核审批补充需求)。
*
* 提单不在此页:创建/编辑业务带二次分配方案时由后端自动生成审批单
* (开关关闭=自动通过留痕,开启=待财务复核)。本页负责查看与两级
* 节点动作;节点准入由后端按角色与单据状态双重校验。
*
* 签名元素是抽屉里的竖排节点时间线 —— 财务复核 → 领导审核的处理链
* 一眼可读(节点/动作/操作人/意见按发生顺序排列)。
*/
const { confirmAndRun } = useConfirmAction()
const filters = reactive({
keyword: '',
status: undefined as number | undefined,
order_type: undefined as number | undefined,
})
const { records, total, pageNum, pageSize, loading, load, search, onPageChange, onSizeChange } =
usePagedList<ApprovalOrder, { keyword?: string; status?: number; order_type?: number }>(
listApprovals,
() => ({
keyword: filters.keyword.trim() || undefined,
status: filters.status,
order_type: filters.order_type,
}),
)
function resetFilters(): void {
filters.keyword = ''
filters.status = undefined
filters.order_type = undefined
search()
}
// ==================== 详情抽屉(节点时间线) ====================
const detailVisible = ref(false)
const detailLoading = ref(false)
const detail = ref<ApprovalOrderDetail | null>(null)
async function openDetail(row: ApprovalOrder): Promise<void> {
detailVisible.value = true
detailLoading.value = true
detail.value = null
try {
detail.value = await getApproval(row.id)
} catch (error) {
handledError(error)
detailVisible.value = false
} finally {
detailLoading.value = false
}
}
// ==================== 节点动作 ====================
const actingId = ref<number | null>(null)
const actionSubmitting = ref(false)
const actionForm = reactive({
action: 1 as 1 | 2,
opinion: '',
})
/** 仅在途单展示动作表单;动作随单据状态定(1 待财务 / 2 待领导) */
const canAct = (order: ApprovalOrderDetail): boolean =>
order.status === 1 || order.status === 2
function openAction(order: ApprovalOrderDetail, action: 1 | 2): void {
actingId.value = order.id
actionForm.action = action
actionForm.opinion = ''
}
async function submitAction(): Promise<void> {
if (actingId.value === null) return
if (actionForm.action === 2 && !actionForm.opinion.trim()) {
ElMessage.warning('驳回必须填写审批意见')
return
}
actionSubmitting.value = true
try {
const run = () =>
actApproval(actingId.value as number, {
action: actionForm.action,
opinion: actionForm.opinion.trim() || null,
})
await confirmAndRun(run, {
successMessage: actionForm.action === 1 ? '已通过' : '已驳回',
})
// 动作后刷新抽屉与列表(状态可能已流转或终态)
detail.value = await getApproval(actingId.value)
actingId.value = null
await load()
} catch (error) {
handledError(error)
} finally {
actionSubmitting.value = false
}
}
</script>
<template>
<div class="page">
<el-form inline class="filters" @submit.prevent>
<el-form-item label="关键词">
<el-input
v-model="filters.keyword"
placeholder="审批单号 / 业务编号"
clearable
style="width: 200px"
@keyup.enter="search"
/>
</el-form-item>
<el-form-item label="状态">
<el-select v-model="filters.status" placeholder="全部" clearable style="width: 150px">
<el-option label="待财务复核" :value="1" />
<el-option label="待领导审核" :value="2" />
<el-option label="已通过" :value="3" />
<el-option label="已驳回" :value="4" />
<el-option label="已撤回" :value="5" />
</el-select>
</el-form-item>
<el-form-item label="类型">
<el-select v-model="filters.order_type" placeholder="全部" clearable style="width: 150px">
<el-option label="二次分配方案" :value="1" />
</el-select>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="search">查询</el-button>
<el-button @click="resetFilters">重置</el-button>
</el-form-item>
</el-form>
<el-table v-loading="loading" :data="records" stripe>
<el-table-column prop="order_no" label="审批单号" min-width="150" />
<el-table-column label="类型" width="120">
<template #default="{ row }">
{{ row.order_type === 1 ? '二次分配方案' : `类型${row.order_type}` }}
</template>
</el-table-column>
<el-table-column prop="refer_no" label="业务编号" min-width="140" />
<el-table-column label="状态" width="110">
<template #default="{ row }">
<el-tag :type="approvalStatusTagType(row.status)" size="small" disable-transitions>
{{ approvalStatusLabel(row.status) }}
</el-tag>
</template>
</el-table-column>
<el-table-column prop="submitter_name" label="提交人" width="110" />
<el-table-column label="提交时间" min-width="150">
<template #default="{ row }">{{ formatDateTime(row.create_time) }}</template>
</el-table-column>
<el-table-column label="操作" width="90" fixed="right">
<template #default="{ row }">
<el-button link type="primary" @click="openDetail(row)">详情</el-button>
</template>
</el-table-column>
</el-table>
<AppPagination
v-model:page-num="pageNum"
v-model:page-size="pageSize"
:total="total"
@change="load"
@size-change="onSizeChange"
@page-change="onPageChange"
/>
<el-drawer v-model="detailVisible" title="审批详情" size="480px">
<div v-loading="detailLoading">
<template v-if="detail">
<div class="detail-head">
<span class="detail-no">{{ detail.order_no }}</span>
<el-tag
:type="approvalStatusTagType(detail.status)"
size="small"
disable-transitions
>
{{ approvalStatusLabel(detail.status) }}
</el-tag>
</div>
<div class="detail-meta">
<span>业务编号:{{ detail.refer_no }}</span>
<span>提交人:{{ detail.submitter_name }}</span>
<span>提交时间:{{ formatDateTime(detail.create_time) }}</span>
</div>
<!-- 签名元素:竖排节点时间线(财务复核 → 领导审核的处理链) -->
<div class="timeline">
<div
v-for="step in detail.steps"
:key="step.id"
class="timeline-row"
:class="{ 'is-withdraw': step.node === 0 }"
>
<div class="timeline-rail">
<span
class="timeline-dot"
:class="{ 'is-auto': step.action === 3, 'is-reject': step.action === 2 }"
></span>
<span v-if="step.id !== detail.steps[detail.steps.length - 1].id" class="timeline-line"></span>
</div>
<div class="timeline-body">
<div class="timeline-head">
<span class="timeline-node">{{ stepNodeLabel(step.node) }}</span>
<span class="timeline-action" :class="{ 'is-reject-text': step.action === 2 }">
{{ stepActionLabel(step.action) }}
</span>
</div>
<div class="timeline-meta">
{{ step.operator_name }} · {{ formatDateTime(step.create_time) }}
</div>
<p v-if="step.opinion" class="timeline-opinion">「{{ step.opinion }}」</p>
</div>
</div>
<p v-if="detail.steps.length === 0" class="timeline-empty">暂无节点记录</p>
</div>
<!-- 节点动作:仅在途单展示 -->
<template v-if="canAct(detail)">
<div class="action-bar">
<el-button
type="primary"
size="small"
:loading="actionSubmitting && actionForm.action === 1"
@click="openAction(detail, 1)"
>
通过
</el-button>
<el-button
type="danger"
plain
size="small"
:loading="actionSubmitting && actionForm.action === 2"
@click="openAction(detail, 2)"
>
驳回
</el-button>
</div>
<el-form v-if="actingId === detail.id" label-position="top" class="action-form">
<el-form-item :label="actionForm.action === 2 ? '驳回意见(必填)' : '审批意见(选填)'">
<el-input
v-model="actionForm.opinion"
type="textarea"
:rows="2"
maxlength="255"
placeholder="审批意见将随节点留痕"
/>
</el-form-item>
<el-button type="primary" :loading="actionSubmitting" @click="submitAction">
确认{{ actionForm.action === 1 ? '通过' : '驳回' }}
</el-button>
</el-form>
</template>
<p v-else class="readonly-note">该单已结束,节点记录只读。</p>
</template>
</div>
</el-drawer>
</div>
</template>
<style scoped>
.filters {
margin-bottom: 4px;
}
.detail-head {
display: flex;
align-items: center;
gap: 10px;
}
.detail-no {
font-size: 15px;
font-weight: 600;
color: var(--ys-ink);
}
.detail-meta {
display: flex;
flex-direction: column;
gap: 2px;
padding: 10px 0 4px;
font-size: 12px;
color: var(--ys-ink-3);
}
/* 竖排时间线:左侧轨道 + 节点圆点,动作色区分人工/自动/驳回 */
.timeline {
margin-top: 14px;
}
.timeline-row {
display: flex;
gap: 12px;
}
.timeline-rail {
display: flex;
flex-direction: column;
align-items: center;
width: 14px;
}
.timeline-dot {
flex-shrink: 0;
width: 10px;
height: 10px;
margin-top: 5px;
background: var(--ys-indigo);
border-radius: 50%;
}
.timeline-dot.is-auto {
background: var(--ys-ink-3);
}
.timeline-dot.is-reject {
background: #c0392b;
}
.timeline-line {
flex: 1;
width: 1px;
min-height: 26px;
background: rgba(28, 35, 51, 0.14);
}
.timeline-body {
flex: 1;
padding-bottom: 16px;
}
.timeline-head {
display: flex;
align-items: baseline;
gap: 8px;
}
.timeline-node {
font-weight: 600;
color: var(--ys-ink);
}
.timeline-action {
font-size: 12px;
color: var(--ys-indigo);
}
.timeline-action.is-reject-text {
color: #c0392b;
}
.timeline-meta {
margin-top: 2px;
font-size: 12px;
color: var(--ys-ink-3);
}
.timeline-opinion {
margin: 6px 0 0;
padding: 6px 10px;
font-size: 12px;
color: var(--ys-ink);
background: #f4f5f8;
border-radius: 6px;
}
.timeline-empty {
font-size: 12px;
color: var(--ys-ink-3);
}
.is-withdraw .timeline-node {
color: var(--ys-ink-3);
}
.action-bar {
display: flex;
gap: 10px;
padding-top: 6px;
border-top: 1px solid var(--ys-line);
}
.action-form {
margin-top: 12px;
}
.readonly-note {
margin-top: 14px;
font-size: 12px;
color: var(--ys-ink-3);
}
</style>

View File

@ -0,0 +1,298 @@
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, type FormInstance, type FormRules } from 'element-plus'
import type { UploadRawFile } from 'element-plus'
import * as settingsApi from '@/api/settings'
import { handledError } from '@/utils/error'
/**
* 公司信息设置(2026-10-15 补充需求:公司名称、logo)。
*
* 签名元素是右侧「登录页实景预览」:品牌名与 logo 改动即时反映在一张
* 缩比登录卡上 —— 所见即所得,避免「保存后去登录页核对」的往返。
* logo 校验(png/jpg ≤2MB)与后端三重校验同口径,前端先拦一道。
*/
const formRef = ref<FormInstance>()
const submitting = ref(false)
const form = reactive({
company_name: '',
})
const rules: FormRules = {
company_name: [
{ required: true, message: '请输入公司名称', trigger: 'blur' },
{ max: 64, message: '公司名称最长 64 个字符', trigger: 'blur' },
],
}
const logoUrl = ref<string | null>(null)
const uploading = ref(false)
async function loadSettings(): Promise<void> {
try {
const data = await settingsApi.getSettings()
form.company_name = data.company_name
logoUrl.value = data.logo_url
} catch (error) {
handledError(error)
}
}
async function handleSubmit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) return
submitting.value = true
try {
const data = await settingsApi.updateSettings(form.company_name.trim())
form.company_name = data.company_name
ElMessage.success('已保存')
} catch (error) {
handledError(error)
} finally {
submitting.value = false
}
}
function beforeUpload(file: UploadRawFile): boolean {
const okType = ['image/png', 'image/jpeg'].includes(file.type)
if (!okType) {
ElMessage.warning('logo 仅支持 png / jpg 格式')
return false
}
if (file.size > 2 * 1024 * 1024) {
ElMessage.warning('logo 文件不能超过 2MB')
return false
}
return true
}
async function handleUpload(options: { file: UploadRawFile }): Promise<void> {
uploading.value = true
try {
const data = await settingsApi.uploadLogo(options.file)
logoUrl.value = data.logo_url
ElMessage.success('logo 已更新')
} catch (error) {
handledError(error)
} finally {
uploading.value = false
}
}
/** 预览品牌名:跟随输入(空时回退占位,与登录页默认一致) */
const previewName = computed(() => form.company_name.trim() || '衍水集团')
</script>
<template>
<div class="page">
<div class="settings-grid">
<el-card shadow="never" class="settings-card">
<template #header>
<span class="card-title">公司信息</span>
</template>
<el-form
ref="formRef"
:model="form"
:rules="rules"
label-width="88px"
@submit.prevent
>
<el-form-item label="公司名称" prop="company_name">
<el-input
v-model="form.company_name"
maxlength="64"
placeholder="展示在登录页与导出页眉"
clearable
/>
</el-form-item>
<el-form-item label="logo">
<div class="logo-field">
<el-upload
class="logo-uploader"
:show-file-list="false"
:http-request="handleUpload"
:before-upload="beforeUpload"
accept="image/png,image/jpeg"
>
<div v-loading="uploading" class="logo-box" title="点击上传 png / jpg(≤2MB)">
<img v-if="logoUrl" :src="logoUrl" alt="公司 logo" />
<span v-else class="logo-plus">+</span>
</div>
</el-upload>
<p class="logo-hint">png / jpg,不超过 2MB;<br />展示于登录页品牌位与导出页眉。</p>
</div>
</el-form-item>
<el-form-item>
<el-button type="primary" :loading="submitting" @click="handleSubmit">保存</el-button>
</el-form-item>
</el-form>
</el-card>
<!-- 签名元素:登录页实景预览(缩比登录卡,品牌名/logo 即时反映) -->
<el-card shadow="never" class="preview-card">
<template #header>
<span class="card-title">登录页预览</span>
<span class="preview-note">保存后对所有人生效</span>
</template>
<div class="login-mock">
<div class="mock-brand">
<img v-if="logoUrl" :src="logoUrl" alt="" class="mock-logo" />
<div class="mock-name">{{ previewName }}</div>
<p class="mock-slogan">把每一笔回款,算成一份踏实。</p>
<span class="mock-waterline"></span>
</div>
<div class="mock-field"></div>
<div class="mock-field"></div>
<div class="mock-submit">登 录</div>
</div>
<p class="preview-caption">登录页品牌位实景(示意,非交互)</p>
</el-card>
</div>
</div>
</template>
<style scoped>
.settings-grid {
display: grid;
grid-template-columns: minmax(360px, 460px) minmax(300px, 380px);
gap: 16px;
align-items: start;
}
.card-title {
font-weight: 600;
}
.preview-note {
float: right;
font-size: 12px;
color: var(--ys-ink-3);
}
.logo-field {
display: flex;
align-items: flex-start;
gap: 14px;
}
.logo-box {
display: flex;
align-items: center;
justify-content: center;
width: 96px;
height: 96px;
overflow: hidden;
cursor: pointer;
background: linear-gradient(180deg, #f7f8fb, #f1f3f8);
border: 1px dashed rgba(28, 35, 51, 0.22);
border-radius: 10px;
transition: border-color 150ms ease;
}
.logo-box:hover {
border-color: var(--ys-indigo);
}
.logo-box img {
max-width: 100%;
max-height: 100%;
object-fit: contain;
}
.logo-plus {
font-size: 26px;
font-weight: 300;
line-height: 1;
color: var(--ys-ink-3);
}
.logo-hint {
margin: 4px 0 0;
font-size: 12px;
line-height: 1.7;
color: var(--ys-ink-3);
}
/* ── 登录页实景预览:按登录卡视觉 0.8 缩比重建(非 iframe 截图) ── */
.login-mock {
padding: 22px 26px 24px;
background: linear-gradient(180deg, #ffffff, #fcfcfe);
border: 1px solid var(--ys-line);
border-radius: 12px;
box-shadow:
0 2px 4px rgba(28, 35, 51, 0.04),
0 10px 26px rgba(28, 35, 51, 0.08);
}
.mock-brand {
text-align: center;
}
.mock-logo {
display: block;
max-width: 64px;
max-height: 40px;
margin: 0 auto 8px;
object-fit: contain;
}
.mock-name {
font-family: var(--ys-font-brand);
font-size: 14px;
letter-spacing: 0.34em;
color: var(--ys-ink);
}
.mock-slogan {
margin: 6px 0 0;
font-size: 11px;
color: var(--ys-ink-3);
}
.mock-waterline {
display: block;
width: 34px;
height: 2px;
margin: 10px auto 0;
border-radius: 1px;
background: linear-gradient(90deg, var(--ys-indigo), rgba(46, 75, 168, 0));
}
.mock-field {
height: 32px;
margin-top: 12px;
background: #f4f5f8;
border: 1px solid rgba(28, 35, 51, 0.07);
border-radius: 6px;
}
.mock-submit {
height: 32px;
margin-top: 14px;
font-size: 12px;
line-height: 32px;
letter-spacing: 0.4em;
text-align: center;
color: #fff;
background: var(--ys-indigo);
border-radius: 6px;
}
.preview-caption {
margin: 10px 0 0;
font-size: 11px;
text-align: center;
color: var(--ys-ink-3);
}
@media (max-width: 900px) {
.settings-grid {
grid-template-columns: 1fr;
}
}
</style>