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 @@
-
+
-

+