From 90bd48b2f9fa9018c6b462558f0e48c062d2b1bd Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Tue, 8 Sep 2026 18:04:27 +0800 Subject: [PATCH] 1 --- docs/前端独立部署-接口落实任务清单.md | 123 ++++ docs/前端独立部署-操作与部署说明.md | 135 ++++ src/api/frontconfig/frontConfig.ts | 47 ++ src/api/order.wave/orderwave.ts | 13 +- src/api/order/order.ts | 15 +- src/api/setting.warehouse/settingwarehouse.ts | 102 ++- src/api/storage.entry/entry.ts | 93 ++- src/components/ScanBox/index.vue | 24 +- src/layout/component/Navbar.vue | 7 +- src/main.ts | 4 + src/permission.ts | 4 +- src/settings.ts | 2 +- src/stores/modules/frontBrand.ts | 154 +++++ src/utils/get-page-title.js | 2 +- src/utils/get-page-title.ts | 9 +- .../shipperSigning/index.vue | 2 +- src/views/login/index.vue | 32 +- .../waveOrder/GroupWaveBatchListPanel.vue | 46 +- .../waveOrder/SandanWaveBatchListPanel.vue | 46 +- .../order/waveOrder/WavePickTaskListPanel.vue | 19 +- .../order/waveOrder/WaveStrategyListPanel.vue | 18 +- .../order/waveOrder/config/wave-config.ts | 37 +- .../component/BindReceivingToEntryDialog.vue | 10 +- .../UnbindReceivingToEntryDialog.vue | 629 ++++++++++++++++++ src/views/storage/entry/entry-config.ts | 31 + src/views/storage/entry/index.vue | 38 ++ src/views/store/shipperSigning/index.vue | 2 +- .../newview/pages/WarehouseSettingsForm.vue | 392 ++++++++++- 28 files changed, 1973 insertions(+), 63 deletions(-) create mode 100644 docs/前端独立部署-接口落实任务清单.md create mode 100644 docs/前端独立部署-操作与部署说明.md create mode 100644 src/api/frontconfig/frontConfig.ts create mode 100644 src/stores/modules/frontBrand.ts create mode 100644 src/views/storage/entry/component/UnbindReceivingToEntryDialog.vue diff --git a/docs/前端独立部署-接口落实任务清单.md b/docs/前端独立部署-接口落实任务清单.md new file mode 100644 index 00000000..dd73a22f --- /dev/null +++ b/docs/前端独立部署-接口落实任务清单.md @@ -0,0 +1,123 @@ +# 前端独立部署 4 接口 · 项目落实任务清单 + +> 关联接口(`pending-updates.json` 2026-09-08 added): +> `frontConfig.getByDomain`、`setting.warehouse.getFrontConfig`、`setting.warehouse.saveFrontConfig`、`setting.warehouse.saveFrontCert` +> 目标:按后端「SaaS 仓库前端独立部署 + 按域名品牌化」设计把 4 接口在本项目全部落实。 + +--- + +## 1. 接口矩阵与角色 + +| 接口 | 角色 | 鉴权 | 状态 | +|---|---|---|---| +| `setting.warehouse.getFrontConfig` | 仓库侧配置回显 | 登录 + 仓库主体 | ✅ 已接入 | +| `setting.warehouse.saveFrontConfig` | 仓库侧保存品牌 | 登录 + 仓库主体 | ✅ 已接入 | +| `setting.warehouse.saveFrontCert` | 仓库侧上传域名+证书 | 登录 + 仓库主体 | ✅ 已接入 | +| `frontConfig.getByDomain` | 公网按域名拉品牌 | 免登录/免鉴权 | ❌ 未接入(消费端缺口) | + +--- + +## 2. 现状盘点 + +### 2.1 已完成 +- **API 封装** + - `src/api/frontconfig/frontConfig.ts`(新目录,`frontConfigGetByDomain` + `FrontConfigPublicItem`) + - `src/api/setting.warehouse/settingwarehouse.ts` 新增 3 个封装与 `SettingWarehouseFrontConfig` 等类型 +- **配置管理页面(基础设置)**:`src/views/system/setting/basicManagement/newview/pages/WarehouseSettingsForm.vue` + - 底部「前端独立部署」区块:品牌表单(title/logo/favicon/login_bg + 主题键值编辑)+ 保存品牌配置(`saveFrontConfig`) + - 自持域名&证书表单(domain/pem/key)+ 上传证书(`saveFrontCert`) + - 加载即 `getFrontConfig` 回显;meta 展示 `domain / cert_expire_at / sync_status` +- 已通过 type-check / build。 + +### 2.2 未落实 / 缺口 +- `frontConfig.getByDomain` 的**消费端**完全没有(登录页/入口仍用静态品牌,`index.html` 的 favicon/title 固定)。 +- 配置页**同步状态展示不完整**:`last_sync_error / sync_attempts / last_synced_at` 未回显、无证书到期提醒。 +- 缺少“按域名品牌”的全局承载层(品牌状态/store、动态 favicon & `document.title` 应用点)。 +- 缺少端到端验收步骤与登记核对项。 + +--- + +## 3. 任务清单 + +> 分级:P0=核心闭环必须;P1=建议;P2=可选优化。括号为建议涉及文件(最终以实现为准)。 + +### 模块 A:品牌消费端(frontConfig.getByDomain)【P0 · 主要缺口】 +| # | 任务 | 涉及文件 | 说明 / 验收 | +|---|---|---|---| +| A1 | 新建「前端品牌」store(或 composable) | `src/stores/modules/frontBrand.ts`(新建) | 保存 getByDomain 结果:`{ domain,title,logo_url,login_bg_url,favicon_url,theme, configured }`;提供 `loadBrandByDomain()`:取 `location.hostname` → `frontConfigGetByDomain({domain})`;404/异常/空结果时置默认(不报错) | +| A2 | 登录前/入口初始化触发加载 | `src/main.ts` 或 `src/permission.ts` 或 `src/views/login/index.vue` | 免鉴权时机(登录页挂载 / 路由守卫放行白名单段);成功才应用品牌,失败静默走默认;可加本地短缓存避免每次刷新请求 | +| A3 | 登录页品牌化 | `src/views/login/index.vue` | 左侧品牌图/标题/Logo 用 store 值替换静态资源;登录背景图用 `login_bg_url` | +| A4 | 全局 favicon / document.title 动态化 | `index.html`、`src/permission.ts`、布局入口 | 有 `favicon_url` 时替换 ``;`document.title`(页面标题前缀)用 `title` 覆盖默认系统名;无则维持现状 | +| A5 | theme 应用(CSS 变量级联) | 主题相关(settings/样式入口) | 若返回 `theme` 对象有既定 CSS 变量约定则写入 `:root`/`html`;暂无字段约定时仅记录、不强行映射(与后端确认字段后补) | +| A6 | 多仓库同部署的域名解析说明 | ✅ 已落地:并入 `docs/前端独立部署-操作与部署说明.md` §5 第 5 点 | 同一部署访问不同仓库自持域名 → 后端按 hostname 区分返回;前端无需感知 | + +> ✅ **进度(2026-09-08):A1 ~ A6 已全部落地** +> - A1 `src/stores/modules/frontBrand.ts`(新增 Pinia store):`loadBrandByDomain()` 按 `location.hostname` 拉品牌,404/异常/`configured=false` 静默回退默认;`loaded` 幂等;`applyBrandGlobals()` 应用 favicon、登录页标题 +> - A2 触发:`src/main.ts` `app.mount` 后调用 `useFrontBrandStore(pinia).loadBrandByDomain()`(免鉴权) +> - A4 全局标题/favicon:`src/utils/get-page-title.ts` 支持第二参 `baseTitle`;`src/permission.ts` 路由守卫标题前缀用 `frontBrand.siteTitle`;favicon `` 动态替换(仅当品牌有效) +> - A3 登录页品牌化:`src/views/login/index.vue` Logo(`:src=brandLogo`)、站点标题(`brand-name` h1,仅品牌 title 存在时显示)、登录背景(`:style=loginBgStyle` 用 `login_bg_url`) +> - A5 theme→CSS 变量:`src/stores/modules/frontBrand.ts` `applyThemeCssVars(theme)` 将 theme 顶层键写入 `--` 至 ``(仅标量值;非法键/嵌套对象忽略;键需 `[A-Za-z_][A-Za-z0-9_-]*`);brand 为空/换品牌时清除已应用变量(无残留)。约定:theme 键即 CSS 变量名(如 `primary`→`--primary`,`bgColor`→`--bgColor`) +> - 验证:type-check 通过 + +### 模块 B:配置管理页完善(基础设置)【P1】 +| # | 任务 | 涉及文件 | 说明 / 验收 | +|---|---|---|---| +| B1 | 同步状态详情回显 | `.../newview/pages/WarehouseSettingsForm.vue` | meta 区补充 `sync_attempts / last_sync_error / last_synced_at`;`sync_status=2` 时红色展示 `last_sync_error` 文案 | +| B2 | 证书到期提醒 | 同上 | `cert_expire_at` 距当前 <30 天(或已过期)时给出 `el-alert`/tag 提醒;未上传显示“未上传” | +| B3 | 保存/上传后处理核对 | ✅ 已落地:`WarehouseSettingsForm.vue` 品牌/证书按钮区补语义提示文案(品牌留空即清空、主题删空即清空、保存/上传成功后自动重新加载),实现已符合(空值清空 + 成功后 loadFrontConfig) | +| B4 | 接口登记核对 | `workflows/api-doc-agent/config/接口.md` | 4 个 method 应 `启用=是、占位=否`(api-list-update 已自动同步;人工复核一次) | + +> ✅ **进度(2026-09-08):B1 ~ B4 已全部落地** +> - B1 同步状态详情:`WarehouseSettingsForm.vue` meta 区新增「同步详情」列(`last_synced_at` · 尝试 `sync_attempts` 次);`sync_status=2` 时顶部红 `el-alert` 展示 `last_sync_error` +> - B2 证书状态:meta「证书状态」列按 `cert_expire_at` 显示 tag(未上传→灰、正常→绿、≤30 天→黄「剩 N 天」、过期→红);过期/临期在配置区顶部显示 `el-alert` 提醒 +> - B4 接口登记核对:`workflows/api-doc-agent/config/接口.md` 人工复核通过 —— 4 个 method(frontConfig.getByDomain / setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert)均 `启用=是、占位=否`,归属路径正确 +> - 验证:type-check 通过 + +### 模块 C:文档与端到端验收【P1】 +| # | 任务 | 说明 / 验收 | +|---|---|---| +| C1 | 端到端验收用例 | ① 仓库设置保存 title/logo → `frontConfig.getByDomain(该域名)` 返回新值;② 上传证书成功 → `domain` 生效、`sync_status=0`;③ 未登记域名访问 getByDomain → 404/`configured=false` → 前端默认品牌;④ 品牌字段留空保存 → 返回空串清空;⑤ theme 键值保存后回显一致(对象结构);⑥ 换域名后无旧品牌残留(后端已清缓存,前端无本地旧值) | +| C2 | 操作/部署说明(可选) | ✅ 已落地:`docs/前端独立部署-操作与部署说明.md`(登记流程 / 证书格式与 SAN / 错误码对照 / 前端部署验证 / 代码落点) | + +> ✅ **进度(2026-09-08):C1、C2 已落地**(C1 清单见下;C2 操作/部署说明见 `docs/前端独立部署-操作与部署说明.md`) +> +> **C1 端到端验收清单(可执行)** +> +> 0. 环境准备:在仓库设置登记自持域名并保存品牌;浏览器访问对应域名(或临时改 hosts 把域名指向该部署)。 +> +> | # | 操作 | 预期结果 | +> |---|---|---| +> | ① | 仓库设置保存 title/logo_url/login_bg_url/favicon_url/theme | `getFrontConfig` 回显与保存一致;theme 键值回显一致(对象结构) | +> | ② | 用登记域名访问登录页(无缓存/新会话) | 登录页显示品牌 Logo/标题/背景;`` href 变为 favicon_url;`document.title` 使用品牌 title;theme 标量键已作为 `--` 写入 ``(DevTools 验证) | +> | ③ | 未登记域名 / 主域名访问 | `getByDomain` 404/`configured=false` → 登录页保持系统默认品牌与主题(无报错) | +> | ④ | 上传证书(domain+pem+key) | `getFrontConfig` 返回 `domain` 生效、`cert_expire_at` 有值、`sync_status=0`;配置页“证书状态”为绿/黄并显示有效期 | +> | ⑤ | 将证书改成即将过期/过期的时间(或造数) | 配置页顶部出现对应 warning/error `el-alert`;证书状态 tag 变黄/红 | +> | ⑥ | 触发同步失败(如证书不可用) | 配置页顶部红 alert 显示 `last_sync_error`;“同步详情”展示尝试次数与最近同步 | +> | ⑦ | 切换/清除域名配置后刷新 | 前端无旧品牌残留:favicon/标题/主题 CSS 变量恢复默认 | +> +> **getByDomain 请求示意(免鉴权公共接口)** +> +> ```bash +> POST /system +> {"method":"frontConfig.getByDomain","v":"1.0","data":{"domain":"<自持域名>"}} +> # 命中:code=200 + domain/title/logo_url/login_bg_url/favicon_url/theme +> # 未登记:404 / configured=false +> ``` + +--- + +## 4. 建议执行顺序 +1. **A1 + A2**:建 store 并接入入口加载(形成闭环主干) +2. **A3 + A4**:登录页品牌化 + favicon/title 动态化(可直观验证) +3. **B1 + B2**:配置页同步状态与到期提醒(让后台能自助排查) +4. **A5 / B4 / C1**:theme 映射(需确认字段)、登记核对、验收回归 +5. **C2**:部署/操作文档(收尾) + +--- + +## 5. 风险与边界(后端约束提醒) +- `saveFrontCert`:`domain` 全局唯一(占用→409);pem/key 成对必填;证书须可解析、未过期、SAN/CN 覆盖 domain,任一失败统一「证书不合法」(400) —— 前端不要过度拆解错误。 +- `saveFrontConfig`:只受理品牌字段,`domain`/证书字段传了也会被白名单忽略;`theme` 须合法 JSON 对象或 JSON 字符串。 +- `getByDomain`:仅返回公开品牌字段,绝不返回证书/同步内部字段;未登记域名返回 404 + 60s 空缓存防穿透。 +- 证书 PEM/私钥:禁止出现在前端响应/日志;前端只需展示由 `getFrontConfig` 返回的 `cert_expire_at/sync_status` 等。 +- 主题结构:已确定 4 个约定默认字段(`siteName` 网页名称 / `mainLogoUrl` 主页面 Logo / `loginLogoUrl` 登录页 Logo / `loginText` 登录页文字),**允许留空**(留空不写入 `theme` → 前端用系统默认值:站点默认标题“天豹云仓”、登录标语默认“现代化仓储管理系统 - 助力企业高效运营”等);其余 theme 键仍作动态 CSS 变量(`--`)应用,约定 4 键不映射 CSS 变量。 diff --git a/docs/前端独立部署-操作与部署说明.md b/docs/前端独立部署-操作与部署说明.md new file mode 100644 index 00000000..963f0da3 --- /dev/null +++ b/docs/前端独立部署-操作与部署说明.md @@ -0,0 +1,135 @@ +# 前端独立部署 · 操作与部署说明(C2) + +> 适用:仓库「自持域名 + 品牌化」的配置与部署运维。关联任务清单 `docs/前端独立部署-接口落实任务清单.md`。 +> 关联接口:`setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert`(仓库侧管理)、`frontConfig.getByDomain`(公网品牌拉取)。 + +--- + +## 1. 使用链路(速览) + +``` +仓库侧(本系统 · 基础设置) 后端 部署后的浏览器 +────────────────────────────────────────────────────────────────────────────── +1 保存品牌 title/logo/favicon/login_bg/theme → wms_warehouse_front_config +2 上传域名 domain + 证书 pem/key(saveFrontCert) + → 校验证书/写 cert_expire_at + → 定时任务部署证书并回填 cert_path/key_path + → Redis 缓存 front:config:domain:{domain} +3 访问 https://<自持域名>/... │ + ▼ + 免鉴权 frontConfig.getByDomain(domain) ← 按 hostname 拉品牌 + 应用:网页名称/登录页 Logo·文字/主页面 Logo(theme 4 约定字段)、 + 品牌 Logo/背景/favicon、document.title、其余 theme 键→CSS 变量 +``` + +- 品牌与「域名+证书」**分开保存**;变更域名必须走 `saveFrontCert`(重新校验证书)。 +- 证书的部署落地由**后端定时任务**完成,前端不处理 PEM/私钥明文。 + +--- + +## 2. 仓库侧操作(网页后台) + +入口:**系统设置 → 基础设置(仓库设置)→ 底部「前端独立部署」**(`basicManagement/newview` 的 `WarehouseSettingsForm`)。 + +### 2.1 保存品牌配置(saveFrontConfig) +- 字段: + - 站点标题 `title`(≤100) + - Logo `logo_url`、favicon `favicon_url`、登录背景 `login_bg_url`(各 ≤255) + - 主题 `theme`:分两组编辑,保存时组装为 JSON 对象 + - 约定 4 个默认字段(页面按语义消费,均**允许留空**): + - 网页名称 `siteName`(对应系统默认标题“天豹云仓”,留空=用默认) + - 主页面 Logo `mainLogoUrl`(顶栏 Logo,留空=用默认图片) + - 登录页 Logo `loginLogoUrl`(登录页 Logo,留空=用品牌 `logo_url`) + - 登录页文字 `loginText`(登录页标语,留空默认“现代化仓储管理系统 - 助力企业高效运营”) + - 约定键留空时**不写入** `theme`,前端使用系统默认值/默认文案 + - 自定义键值:主题键即前端 CSS 变量名,值支持文本或 JSON(对象/数组/数字/布尔);应用时顶层标量键写入 `--`(约定 4 字段不映射 CSS 变量) +- 品牌字段留空即清空该字段;主题约定键留空=用默认,自定义键删空全部行=清空该部分。 +- 点击「保存品牌配置」→ 成功后自动刷新回显。 +- 说明:此处不受理 `domain`/证书字段(后端白名单忽略)。 + +### 2.2 上传自持域名与证书(saveFrontCert) +1. 填写 自持域名 `domain`(≤100,全局唯一)。 +2. 粘贴 证书 PEM `pem`(≤65536)。 +3. 粘贴 私钥 PEM `key`(≤65536)。 +4. 点击「上传证书」。 + +成功后自动: +- 写入 `cert_expire_at`(以证书 validTo 为准); +- 重置同步状态 `sync_status=0`(页面「同步详情」可看尝试次数/最近同步); +- 清空旧/新域名的公共缓存(后端处理)。 + +页面 meta 会展示:证书状态(未上传/正常/临期/过期)、同步状态与失败原因,便于自助排查。 + +--- + +## 3. 证书准备(PEM 与 SAN) + +- 证书 `pem`:X.509 证书的 PEM 文本,形如 + ``` + -----BEGIN CERTIFICATE----- + ... + -----END CERTIFICATE----- + ``` +- 私钥 `key`:证书对应私钥的 PEM 文本,形如 + ``` + -----BEGIN PRIVATE KEY----- (或 -----BEGIN RSA PRIVATE KEY-----) + ... + -----END PRIVATE KEY----- + ``` +- 必须满足: + - 证书可解析、当前已生效、未过期; + - 私钥与证书成对(后端按 SPKI 公钥指纹比对); + - 证书 `SAN DNS` / `CN` 覆盖所填 `domain`(支持精确匹配与 `*.example.com` 通配)。 +- 生成(示意,正式环境请用 CA 签发): + ```bash + # 自签测试证书(SAN 包含 domain) + openssl req -x509 -newkey rsa:2048 -nodes -days 365 \ + -keyout key.pem -out cert.pem \ + -subj "/CN=self.example.com" \ + -addext "subjectAltName=DNS:self.example.com,DNS:*.example.com" + # 分别把 cert.pem、key.pem 内容填入页面 + ``` +- 提示:同一证书可在 SAN 里放多个域名;换域名/加域名都需重新走 `saveFrontCert`。 + +--- + +## 4. 常见错误对照 + +| 现象 / 返回 | 原因 | 处理 | +|---|---|---| +| 400「证书不合法」(统一文案,不返回细节) | 证书无法解析 / 未生效或已过期 / 私钥与证书不匹配 / SAN 或 CN 未覆盖 domain | 检查 PEM 完整性与配对、有效期、SAN 是否包含 domain;用 `openssl x509 -in cert.pem -noout -text` 核对 | +| 409 | 该 `domain` 已被其他仓库占用 | 换未占用域名,或联系占用方释放 | +| 400「domain 长度不能超过 100 字符」 | domain 超长 | 缩短域名 | +| 400「pem/key 内容长度不能超过 65536 字符」 | 证书/私钥文本过大 | 检查是否误粘贴多个证书 | +| 保存品牌后 `getByDomain` 仍返回旧值 | 缓存 600s 内 | 等缓存过期或由后端保存时清缓存(saveFrontConfig/saveFrontCert 已清旧域名缓存) | +| 上传成功但 `sync_status=1/2` | 证书部署/同步中或失败 | 看「同步详情」`last_sync_error`,按需重新上传 | +| 域名已生效但 `cert_expire_at` 为空 | 证书未上传(仅登记 domain?) | 补传证书(saveFrontCert) | + +--- + +## 5. 前端侧部署与验证 + +1. 把本系统部署(或已有部署)解析到自持域名:`<自持域名> -> 部署 IP/负载`,并配置 HTTPS(证书由后端部署链路提供,前端不需持证)。 +2. 浏览器访问 `https://<自持域名>`:前端入口自动按 `location.hostname` 调 `frontConfig.getByDomain` 应用品牌。 + - 生效项:网页名称(登录页标题与 document.title)、主页面 Logo(顶栏)、登录页 Logo/登录页文字(theme 4 约定字段,空=默认)、品牌 Logo/背景、favicon、其余 `theme` 键→CSS 变量(`--`)。 +3. 未登记域名 / 直连主域名:接口返回 404 / `configured=false` → 前端静默使用系统默认品牌(无报错)。 +4. 本地联调建议:改 hosts 把自持域名指向本机测试环境即可看到品牌效果;确认无旧品牌残留可清理站点数据后刷新。 +5. **多仓库同一部署的域名解析(A6)**:一套前端部署可同时服务多个仓库—— + - 各仓库在各自基础设置里登记自己的 `domain`(一仓一行、`domain` 全局唯一),并各自保存品牌/证书; + - 后端按访问 hostname 从 `wms_warehouse_front_config` 及缓存 `front:config:domain:{domain}` 返回对应仓库的公开品牌; + - 前端仅按 `location.hostname` 调 `frontConfig.getByDomain`,对“多仓库同部署”无感知; + - `saveFrontConfig`/`saveFrontCert` 保存成功后后端会自动清理新旧域名缓存,因此换域名/改品牌基本即时生效(600s 缓存窗口内读到旧值属正常,无需前端处理); + - 访问主域名或未登记域名 → 返回 404 / `configured=false` → 前端走系统默认品牌。 + +--- + +## 6. 前端已落点速查(代码) + +| 层 | 文件/位置 | +|---|---| +| API 封装 | `src/api/frontconfig/frontConfig.ts`;`src/api/setting.warehouse/settingwarehouse.ts`(3 个管理接口) | +| 配置管理 | `src/views/system/setting/basicManagement/newview/pages/WarehouseSettingsForm.vue`「前端独立部署」区块 | +| 品牌 store | `src/stores/modules/frontBrand.ts`(loadBrandByDomain / applyThemeCssVars / applyBrandGlobals) | +| 入口触发 | `src/main.ts` | +| 登录页品牌 | `src/views/login/index.vue` | +| 标题/favicon | `src/permission.ts` + `src/utils/get-page-title.ts` | diff --git a/src/api/frontconfig/frontConfig.ts b/src/api/frontconfig/frontConfig.ts new file mode 100644 index 00000000..5b1901a7 --- /dev/null +++ b/src/api/frontconfig/frontConfig.ts @@ -0,0 +1,47 @@ +import request from '@/utils/request' + +const v = '1.0' + +/** frontConfig.getByDomain 响应:仓库前端公开品牌配置(不含证书/同步等内部字段) */ +export type FrontConfigPublicItem = { + /** 仓库自持域名 */ + domain?: string + /** 站点标题(未配置为空字符串) */ + title?: string + /** Logo 地址(未配置为空字符串) */ + logo_url?: string + /** 登录页背景图地址(未配置为空字符串) */ + login_bg_url?: string + /** 站点 favicon 图标地址(未配置为空字符串) */ + favicon_url?: string + /** 主题配置对象(未配置为 null) */ + theme?: Record | null + /** 未登记域名时为 false(并返回 404) */ + configured?: boolean + [key: string]: unknown +} + +/** + * 按域名拉取仓库前端公开配置(公共接口:免登录、免鉴权、免权限)。 + * Redis 缓存 front:config:domain:{domain},命中 TTL 600s;未登记域名写空缓存 60s 防穿透并返回 404。 + */ +export function frontConfigGetByDomain(data: { + /** 待查询域名(必填,≤100 字符) */ + domain: string +}): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'frontConfig.getByDomain', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + +export const frontConfig = { + getByDomain: frontConfigGetByDomain +} diff --git a/src/api/order.wave/orderwave.ts b/src/api/order.wave/orderwave.ts index 71e9e48b..dcd43e00 100644 --- a/src/api/order.wave/orderwave.ts +++ b/src/api/order.wave/orderwave.ts @@ -2,11 +2,14 @@ import request from '@/utils/request' const v = '1.0' -import type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListWhere, WaveListPagination } from '@/api/order/order' +import type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListSort, WaveBatchListWhere, WaveListPagination } from '@/api/order/order' -export type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListWhere, WaveListPagination } +export type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListSort, WaveBatchListWhere, WaveListPagination } export { unwrapWaveBatchListResponse } from '@/api/order/order' +/** order.wave 系列 RPC 列表统一排序结构(对齐 stock.warehouse.list / order.wave.batchList) */ +export type WaveListRpcSort = WaveBatchListSort + export type WavePickTaskListParams = { warehouse_id: number pagination?: { @@ -31,6 +34,8 @@ export type WavePickTaskListParams = { /** 人员名称(operator_name 操作人/pick_user_name/review_user_name/claim_operator)与关联波次号 wave_no 通过 where 传 { operator, value },由后端按 operator 处理(默认模糊 like) */ where?: Record strategy_id?: number + /** 后端排序:sortField 取列 prop(如 order_count),结构对齐 stock.warehouse.list */ + sort?: WaveListRpcSort } /** order.wave.wavePickTaskList 列表项(与 wms_wave_pick_task 主表字段对齐) */ @@ -215,6 +220,8 @@ export type WaveStrategyListParams = { calculateNextFetchOrderCount?: number /** 0-不启用(默认),1-启用调试输出,返回每条策略的 next_fetch_order_list */ debug?: number + /** 后端排序:sortField 取列 prop(如 matched_order_count_filtered),结构对齐 stock.warehouse.list */ + sort?: WaveListRpcSort } export type WaveStrategyRecord = Record & { @@ -262,6 +269,8 @@ export type WaveStrategyListResponse = { hasPrevious?: boolean hasNext?: boolean } + /** 查询汇总信息对象(成功路径恒存在;含当前查询条件下全部策略命中的去重订单总数) */ + info?: Record } export type WaveStrategyCreateParams = { diff --git a/src/api/order/order.ts b/src/api/order/order.ts index dbf8e76b..4e3a7194 100644 --- a/src/api/order/order.ts +++ b/src/api/order/order.ts @@ -11,11 +11,12 @@ export type WaveBatchListWhere = { | string | Array | { operator?: string; value: number | string | Array } - wave_no?: string + /** 文本模糊字段:支持标量或 { operator, value } 标准结构(操作符由后端解析,默认模糊 like;contains/in/notin 的 value 为数组) */ + wave_no?: string | { operator?: string; value: string | string[] } wave_type?: number wave_status?: number - creator?: string - logistics_name?: string + creator?: string | { operator?: string; value: string | string[] } + logistics_name?: string | { operator?: string; value: string | string[] } item_part_type?: number item_part?: string item_snapshot_key?: string @@ -39,6 +40,12 @@ export type WaveBatchListWhere = { review_assignment_status?: 'unreviewed' | 'partially_reviewed' | 'reviewed' } +/** order.wave.batchList 排序(对齐 stock.warehouse.list 等 RPC 列表接口) */ +export type WaveBatchListSort = { + sortField?: string + sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' +} + export type WaveBatchListParams = { pagination?: { page?: number @@ -48,6 +55,8 @@ export type WaveBatchListParams = { only_todo?: number | boolean | string /** 白名单见 WaveBatchListWhere;与列表页动态 where 构建兼容 */ where?: WaveBatchListWhere | Record + /** 后端排序:sortField 取列 prop(如 total_orders / order_count / processed_orders / unreviewed_order_count) */ + sort?: WaveBatchListSort } export type WaveListPagination = { diff --git a/src/api/setting.warehouse/settingwarehouse.ts b/src/api/setting.warehouse/settingwarehouse.ts index a753e503..15579a01 100644 --- a/src/api/setting.warehouse/settingwarehouse.ts +++ b/src/api/setting.warehouse/settingwarehouse.ts @@ -286,8 +286,108 @@ export function settingWarehouseSaveSettings( } as any) } +/** 前端独立部署配置记录(getFrontConfig / saveFrontConfig / saveFrontCert 响应,一仓一行) */ +export type SettingWarehouseFrontConfig = { + warehouse_id?: number + domain?: string + title?: string + logo_url?: string + favicon_url?: string + login_bg_url?: string + theme?: Record | string | null + cert_path?: string + key_path?: string + cert_expire_at?: string | null + sync_status?: number + sync_attempts?: number + last_sync_error?: string + last_synced_at?: string | null + updated_at?: string | null + [key: string]: unknown +} + +export type SettingWarehouseSaveFrontConfigParams = { + /** 站点标题(≤100,空值清空) */ + title?: string + /** Logo 地址(≤255,空值清空) */ + logo_url?: string + /** 站点 favicon 地址(≤255,空值清空) */ + favicon_url?: string + /** 登录页背景图地址(≤255,空值清空) */ + login_bg_url?: string + /** 主题配置(合法 JSON 对象或 JSON 字符串;空值清空) */ + theme?: Record | string | null +} + +export type SettingWarehouseSaveFrontCertParams = { + /** 仓库自持域名(必填 ≤100,全局唯一) */ + domain: string + /** 证书 PEM 文本(必填 ≤65536,须可解析 X.509、未过期且 SAN/CN 覆盖 domain) */ + pem: string + /** 私钥 PEM 文本(必填 ≤65536,须与 pem 成对,SPKI 公钥指纹比对) */ + key: string +} + +/** 查询当前仓库前端独立部署配置(settings 页回显;无记录返回默认空配置) */ +export function settingWarehouseGetFrontConfig(): Promise< + { code?: number; message?: string; data?: SettingWarehouseFrontConfig } & Record +> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'setting.warehouse.getFrontConfig', + v, + timestamp: new Date().getTime() + }, + data: {}, + isSystemApi: true + } as any) +} + +/** 保存当前仓库前端独立部署品牌配置(仅受理 title/logo/favicon/login_bg/theme,空值清空;domain/证书字段不受理) */ +export function settingWarehouseSaveFrontConfig( + data: SettingWarehouseSaveFrontConfigParams = {} +): Promise< + { code?: number; message?: string; data?: SettingWarehouseFrontConfig } & Record +> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'setting.warehouse.saveFrontConfig', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + +/** 上传当前仓库前端独立部署证书(domain + pem/key 成对必填;通过后回填 cert_expire_at) */ +export function settingWarehouseSaveFrontCert( + data: SettingWarehouseSaveFrontCertParams +): Promise< + { code?: number; message?: string; data?: SettingWarehouseFrontConfig } & Record +> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'setting.warehouse.saveFrontCert', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + export const settingWarehouse = { getSettings: settingWarehouseGetSettings, getFieldMeta: settingWarehouseGetFieldMeta, - saveSettings: settingWarehouseSaveSettings + saveSettings: settingWarehouseSaveSettings, + getFrontConfig: settingWarehouseGetFrontConfig, + saveFrontConfig: settingWarehouseSaveFrontConfig, + saveFrontCert: settingWarehouseSaveFrontCert } diff --git a/src/api/storage.entry/entry.ts b/src/api/storage.entry/entry.ts index 27c35ff0..20e1af4b 100644 --- a/src/api/storage.entry/entry.ts +++ b/src/api/storage.entry/entry.ts @@ -586,31 +586,47 @@ export type BindReceivingParams = { receiving_ids: number[] } -export type BindReceivingSuccessItem = { +export type BindReceivingBoundItem = { receiving_id?: number receiving_number?: string + /** CREATED 绑定:本次新建绑定行时为 true */ + created?: boolean + /** COMPLETED 绑定:软删除恢复时为 true */ + restored?: boolean + /** COMPLETED 绑定:入库进度同步结果(stored_total / matched_item_count / unmatched_items) */ + storage_sync?: { + stored_total?: number + matched_item_count?: number + unmatched_items?: Array> + [key: string]: unknown + } [key: string]: unknown } -export type BindReceivingFailedItem = { +export type BindReceivingSkippedItem = { receiving_id?: number + receiving_number?: string + /** 可能值:ALREADY_BOUND(绑定已存在,COMPLETED 幂等跳过进度同步)、BINDING_WRITE_FAILED(CREATED 写入绑定失败) */ error_code?: string message?: string [key: string]: unknown } export type BindReceivingResponse = { + flag?: string code?: number message?: string - success?: BindReceivingSuccessItem[] - failed?: BindReceivingFailedItem[] - success_count?: number - failed_count?: number + /** 绑定/进度同步成功列表 */ + bound?: BindReceivingBoundItem[] + /** 跳过列表(含 ALREADY_BOUND 等) */ + skipped?: BindReceivingSkippedItem[] + /** 汇总统计 */ + summary?: Record + timestamp?: number data?: { - success?: BindReceivingSuccessItem[] - failed?: BindReceivingFailedItem[] - success_count?: number - failed_count?: number + bound?: BindReceivingBoundItem[] + skipped?: BindReceivingSkippedItem[] + summary?: Record } } @@ -628,6 +644,63 @@ export function bindReceiving(data: BindReceivingParams): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'storage.entry.unbindReceiving', + v, + timestamp: new Date().getTime(), + }, + data, + }) +} + /** storage.entry.reviewEntry 参数 */ export type ReviewEntryParams = { /** 入库单ID */ diff --git a/src/components/ScanBox/index.vue b/src/components/ScanBox/index.vue index ec5a8d79..d12eaf55 100644 --- a/src/components/ScanBox/index.vue +++ b/src/components/ScanBox/index.vue @@ -650,7 +650,11 @@
-
+