79 Commits

Author SHA1 Message Date
liufumingren
61a9587851 feat(pull): 拉单 0 单时给出「商家对不上」的排查提示
抖音平台订单拉不到排查结论:平台侧数据本身能拉到(意洁的 1688→抖店分销单
11-07 16:27 已入库 6 单 DYXD),问题出在「店铺声明的商家 FxUserId 与平台不一致」时
只回 0 单、看不出原因。本次让这种情况自己说话:

- dgj.listOrders:全量兜底扫描时记录平台实际出现的商家(UpFxUserId → 单量/店铺名),
  返回 merchantSeen / otherMerchants
- externalPrintOrder:新增 buildZeroOrderHint —— 0 单且本店商家没出现过时,
  输出「近 N 天没有出现 FxUserId=xxx(分区…),实际出现的是 意洁(953516,450 单)…」,
  并提示刷新店铺所在区/商家
- 自动拉取的 last_order_sync_msg、手动拉取响应 hint / 前端提示都带上该说明
- 单测 pullOrderHint.test.js(2 例:有提示/无误报,含分区去重)

排查记录(本地账号 1 实测):
- 意洁(953516):15 天待处理 10 单 = DYXD 6 + TB 3 + PDD 1,抖音分销单正常
- 抖店分区(fxdd) 近 90 天 1099+154 单全部已发货/关闭,0 条待发货 → 平台侧确实没得拉
- 两家「奇迹商贸」店铺绑的商家 1921984 / 1844767 在全部分区 90 天内 0 单;
  平台上真正有单的奇迹商贸商家是 401499 → 需要在 OMS 重新同步店铺

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 18:44:02 +08:00
liufumingren
c1d3e17188 fix(shop-product): 平台规格ID 统一取 SkuId,重新拉取时就地覆盖
店铺商品落库时 outer_sku_id 早期取 SpecId、后来取 SkuId,两种口径混在一张表里;
而订单明细侧的规格ID 一直是 SkuId(resolveOrderSkuId 优先 SkuId),
两边不一致会导致订单明细匹配不到店铺商品。

- dgj.normalizeProduct:平台规格ID 统一取 SKU.SkuId,不再使用 SpecId
  (SkuId 缺失时仍退化为店管家内部 ID,保持历史行为)
- saveShopProducts:新增 planShopProductRekey —— 老行按「平台商品ID + 规格名」唯一命中时
  就地改写 outer_sku_id,而不是插入新行;否则老行会因为旧键不在快照里被判「平台已下架」
  而删除/下架,绑定关系和订单溯源都会丢。同名规格不唯一、目标键已占用时不动,交给常规 upsert
- 先改键再 upsert,created/updated 统计与下架判定都按改键后的键计算
- 同步/补拉响应新增 rekeyed(校正行数),前端同步提示展示「校正规格ID N」
- 测试:shopProductRekey.test.js(4 例:SkuId 优先 / 就地改键 / 不猜同名 / 键未变);
  真实库验证:把某行改成 `SPEC_xxx` 后重新同步 → id 不变、值被覆盖、行数不变(41 → 41)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 17:56:42 +08:00
liufumingren
9826de2ad1 feat(ui): 标题改为天豹云OMS订单管理系统,登录页作为首页
- 浏览器标题、侧边栏 logo、登录页品牌名统一为「天豹云OMS订单管理系统」
- 登录页底部新增备案号(可点击跳转工信部核验)与版权信息;窄屏/极矮屏改为
  常规流排布,避免页脚压在登录卡片上
- 路由调整:根路径 / 直接渲染登录页(首页即登录),/login 重定向到 /;
  登录成功后进仪表盘 /dashboard,已登录访问 / 或 /login 同样回仪表盘
- 退出登录、401 失效统一回到首页(登录页)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:51:53 +08:00
liufumingren
1d29e03ba2 feat(log): 对外回调日志可查询
外部系统调用 OMS /openapi 的请求与返回一直有写 callback_logs,
但没有任何查询入口,WMS 侧排查「回调有没有到、报了什么」只能翻服务器日志。

- 新增 GET /api/callback-logs:按主体隔离,支持仓库/接口配置/方法/app_key/
  结果/IP/关键词/时间范围过滤 + 分页
- 补 contract schema(callbackLogItem / callbackLogPage / callbackLogListResponse)
- 外部接口页新增「回调日志」tab:展开可看请求参数、请求报文、返回报文、
  异常信息、来源IP 与 app_key,并支持按当前仓库导出

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:43:14 +08:00
liufumingren
8b4fe94bbf feat(external-api): 配置列表不再展示「基础地址」,按日志核对即可
接口调用日志里已有「请求地址」列,配置列表再放一列基础地址是重复信息:
- 配置列表去掉「基础地址」列
- 弹窗本来就已隐藏该字段,保存时按接口类型预设写入
- 导出的「接口地址」列保留(对账/归档用)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:34:08 +08:00
liufumingren
cd7a621aff feat(external-api): 弹窗不再展示「基础地址」,按接口类型自动写入
接口类型已经能带出地址,表单里再放一个只读又改不了的输入框是噪音:

- 弹窗去掉「基础地址」输入项;保存时用类型预设值写入(老配置保留库里的现有值)
- 列表与导出仍保留「基础地址」列,方便核对实际使用地址

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:29:05 +08:00
liufumingren
6b320a94b2 feat(external-api): 接口类型改为下拉「天豹云WMS」,选中自动带出基础地址
- 接口类型从只读文案改成下拉,选项为「天豹云WMS」(值仍为 qimen,服务端照旧固定写入)
- 选中后自动填基础地址 https://qimen.wms.gztbyc.com/openapi,不用手填;
  已手工改过的地址不会被覆盖
- 新增配置时默认就是天豹云WMS + 对应基础地址
- 列表「接口类型」列按类型显示中文;导出同口径(qimen → 天豹云WMS)
- contract / api 注释同步改成「天豹云WMS(类奇门JSON接口)」

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:25:57 +08:00
liufumingren
2b60136443 feat(order): 筛选栏把「平台单号」提到默认行,与「订单号」互换位置
- 默认筛选行第一位改为「平台单号」(批量查询,最常用),订单号收进「展开」区
- 展开区顺序:订单号 → 来源订单号 → 店铺 → 收货人 → …
- 配送异常视图隐藏「外部发货」下拉(该视图固定筛 2,3,避免误以为是可改的筛选)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:22:38 +08:00
liufumingren
91e90cc7e2 feat(order): 新增「配送异常」视图,回传平台失败可看原因并重试
订单页左侧「配送」下面新增「配送异常」tab:
- 数据 = 配送表 + external_send_status IN (2 待重试, 3 同步异常),不用再进配送页自己筛
- 新增「回传失败原因」列(红色 + tooltip 全文),状态列保留「第 N 次」
- 行内「重试」按钮(单条重试),批量重试仍走原 resend_external
- tab 上带红色数量徽标(待重试 + 同步异常),重试后自动刷新
- 导出:配送异常视图导出时按 2,3 过滤;导出面板新增「回传平台状态」多选

后端导出补充 external_send_status 过滤(与列表接口同口径)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:18:34 +08:00
liufumingren
9cc301916e fix(external-send): 发货同步失败给出完整原因,前端可看全文
现象:配送列表只显示「店管家发货同步失败:请先」,看不出到底缺什么。

- dgj.sendOrders:失败时拼上平台 ErrorCode、逐单错误(Data[].IsError/ErrMsg/Message),
  并在订单没有运单号时补一句「N 单在店管家还没有运单号(可能未取号/未打印面单)」
- StatusPanel:同步失败原因加 tooltip,鼠标悬停可看完整文案(原来只有 CSS 省略号)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:01:42 +08:00
liufumingren
ba0d03414a feat(order): 电商平台筛选可遍历实际平台,数据库店铺与手工单默认淘宝
- 订单筛选项新增 platforms:系统预设 ∪ 当前主体订单里实际出现过的编码(带数量,
  未收录进预设的标记 preset=false),下拉按用量排序,店管家新增平台类型时不会「筛不到」
- 手工单默认 source_platform_code=TB(淘宝),新建/编辑弹窗新增「电商平台」下拉;
  编辑改平台时按系统预设同步名称;外部打单平台拉取的订单该字段置灰不可改
- 数据库店铺拉单按店铺配置的平台落库(未配置时默认淘宝),待审核订单可见可筛
- 迁移 20261107010000:把「数据库店铺订单(extend_props.source=shop_database)」与
  「手工单(extend_props.labels 含手工单)」里为空的电商平台回填为 TB/淘宝

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 01:18:21 +08:00
liufumingren
9a944be886 feat(order): 订单列表展示电商平台,支持按电商平台筛选与平台单号批量查询
- 列表新增「电商平台」列(优先用落库的平台名称,缺失时按编码映射中文名),详情面板同口径展示
- 筛选新增电商平台多选(platform_codes)与平台单号批量精确匹配(platform_order_nos,最多 200 个)
- 平台单号批量查询复用 MultiValueFilter:收起时英文逗号拼接、展开后一行一个,与店铺商品的商家编码一致
- 订单导出同步支持这两个筛选,并新增「电商平台」导出列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 00:28:42 +08:00
liufumingren
3a4eebb71d feat(shop): 店铺所在区刷新与解绑自动禁用,禁用时作废待审核订单
- 新增 shopAreaSync:按账号拉一次商家列表(同账号多店铺共享,PageSize=200 翻页),
  把最新商家结构(FxUserId、分区声明 DbAreas)写回 shops.external_data;
  商家已不在合作列表时自动把店铺置为禁用,并写明原因
- 手动刷新入口:POST /api/shops/{id}/refresh-area(货主权限)、
  POST /api/external-print-accounts/{id}/refresh-shops-area(集团权限)
- 新增定时任务 refreshExternalShopAreas:每小时巡检,按账号 6 小时刷新一次
  (DGJ_AREA_REFRESH_HOURS 可调),自动禁用店铺后不再参与自动拉单与一键拉单
- 新增 shopOrderGuard:店铺禁用立即作废该店铺待审核订单
  (void_reason 前缀「店铺已禁用,暂停处理」),重新启用时只恢复因此暂停的订单;
  禁用店铺再拉单直接拒绝,避免又拉回待审核单
- externalPrintOrder 待审核单核对改用 LogicOrderId 批量回读(50 单/批,最多 300 单)
- orderStatus.restore 支持显式 principalId,供无登录态的系统任务调用
- 前端:店铺列表新增「所在区」列与行内/详情「刷新所在区」按钮,
  系统自动禁用的店铺状态带原因提示,启停与刷新后提示作废/恢复了多少订单
- 文档:新增 §4.2.2「所在区」刷新、§4.2.3 店铺禁用/启用与待审核订单
  (原 LastWaybillCode 小节顺延为 §4.2.4,WMS 对接文档引用同步)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 00:19:02 +08:00
liufumingren
f5b717f612 perf(print): 店管家拉单按「待发货+商家」过滤,时间窗对齐平台 15 天
- NewOrder/List 带上 ErpState=waitsellersend 与商家 FxUserId 过滤,只拉待发货单
- 老分区不支持过滤(返回「服务器繁忙」)时退化为按时间窗全量,窗口封顶 15 天;
  分区能力用进程内缓存记住,避免每小时反复撞接口
- 按商家分区声明 DbAreas[].IsNewSystem 跳过该平台的老分区,不再白拉迁移前的历史数据
- 首次拉单回看天数 7 → 15 天(对齐平台「待发货订单」页默认下单时间范围),
  一键拉单/单店拉单前端下拉新增「最近 15 天(平台默认)」并默认选中

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 00:18:53 +08:00
liufumingren
74ddeca3c0 feat(shop): 店铺支持设置默认发货仓库,拉单与未审核订单自动带仓库
- shops 新增 default_warehouse_id(迁移 + 模型 + 契约),仓库须存在、启用且属于店铺货主

- 新增 PUT /api/shops/:id/default-warehouse 单独维护该字段,外部打单平台店铺的货主权限也可配置

- 新增 shopWarehouse 服务:保存后把该店铺待审核订单中仓库为空或是旧默认值的订单回填为新仓库(手工改过的不覆盖)

- 打单平台与数据库店铺拉单落待审核时自动带上默认仓库(含 warehouse_code 快照);一键拉单店铺查询补 default_warehouse_id

- 前端:店铺列表新增「默认仓库」列与配置弹窗,新增/编辑表单增加默认发货仓库下拉(按货主过滤),详情面板展示

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 22:23:23 +08:00
liufumingren
fe97be2893 feat(shop-product): 店铺商品支持店铺/平台类型/商家编码多值筛选
- 列表接口支持 shop_ids / platform_types / outer_codes(逗号分隔或数组,去重、上限 200),店铺与平台类型为 IN 条件,商家编码为多值精确匹配;保留单值 shop_id 与关键词模糊查询

- 前端:店铺改为多选虚拟下拉、新增平台类型多选、新增商家编码多值控件(收起英文逗号拼接、展开一行一个)

- 导出同步支持多值筛选(多选控件按 CSV 提交)并补上「平台类型」列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 22:22:41 +08:00
liufumingren
262d9d4203 feat(order): 一键拉单进度在订单页卡片头部持续显示
- 新增 useOrderSyncTask 组合式函数:拉单任务轮询从弹窗抽为模块级单例,弹窗关闭后仍继续轮询

- 订单页卡片头部在任务进行中显示进度条与店铺进度,结束后自动隐藏并刷新列表;刷新页面可恢复进度

- OrderSyncDialog 复用共享状态,去掉自持 timer 与 done 事件;StatusPanel 改为订阅任务结束通知

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 22:22:18 +08:00
liufumingren
809d1e9feb feat(shop-product): 店铺商品列表展示平台商品图片,支持点击大图预览
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 19:34:38 +08:00
liufumingren
137a3ed1f3 feat(principal): 主体启用/停用改为仅数据库维护,页面与接口不可操作
- PUT /api/principals/{id} 不再接受 status 变更(变更时返回 403「主体的启用/停用只能由平台运维在数据库中维护」)
- POST /api/principals 状态固定为启用,创建时传 status=0 直接 403;其它非白名单字段忽略
- 集团设置页面状态改为只读展示并提示由平台运维维护(去掉启用/禁用开关)
- 前端 updatePrincipal 类型移除 status,接口契约说明同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 00:21:52 +08:00
liufumingren
463b7cd1bc feat(employee): 新增员工邮箱改为选填,支持临时账号与微信扫码绑定已有账号
- 新增员工不填邮箱时创建临时账号:自动生成 tmp_ 前缀登录名、邮箱留空、返回初始密码(temporary 标记)
- 员工档案绑定微信:该微信已绑定过账号则把员工切换到该账号(同主体已存在则冲突提示),
  原临时账号无任何主体关联时自动禁用;该微信未绑定账号时直接绑定到员工当前(临时)账号
- 员工编辑支持为临时账号补填邮箱(已绑定邮箱的账号需员工自行在个人设置维护)
- 列表邮箱列对临时账号显示「临时账号」标记;新增结果弹窗提示扫码绑定/补填邮箱
- 接口契约与前端类型同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 23:58:53 +08:00
liufumingren
e49c25cd19 feat: 主体停用后下拉置灰不可切换、数据只读、定时任务跳过
- principalCheck 中间件加载主体状态:停用主体只放行读请求(GET/HEAD/OPTIONS)与导出任务提交,
  其余写操作(新建/编辑/推送/删除)一律 403「主体已停用,仅可查看与导出」
- 可选主体列表包含停用主体并按「启用优先」排序;/api/auth/profile 返回 status/disabled
- 顶栏主体下拉显示「xxx(已停用)」且不可选择;当前主体停用时在顶栏下方显示只读提示条
- 定时任务跳过停用主体:自动拉单、订单推送 WMS、发货推送、出库推送、发货结果回传平台、一键拉单任务
- 主体自身的 GET/PUT 未加主体状态校验,运维仍可通过接口重新启用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 23:31:45 +08:00
liufumingren
739506da58 feat: 仓库接口配置一仓库一份、员工微信绑定管理、停用员工不再展示主体
1) 仓库接口配置
- 新增时校验同一仓库只允许一份接口配置(含唯一索引兜底,迁移会先清理历史重复数据)
- 接口配置页在有配置时禁用「新增配置」并提示

2) 员工档案微信绑定
- 列表返回 wechat_bound / 脱敏 openid / 绑定时间,页面新增「微信」列
- 新增员工微信绑定码、轮询结果、解绑接口(按员工系统账号绑定,绑定码仅操作人可轮询)
- 导出增加「微信绑定」列

3) 停用员工后不再展示该主体
- 主体ID列表与可选主体列表只取启用(status=1)的关联,停用后登录不显示该主体且无该主体权限
- 权限解析对停用关联直接返回空权限兜底

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 18:11:11 +08:00
liufumingren
4cba1a152a feat(shop): 新增线下店铺类型,平台店铺平台改为必填
- 店铺类型新增 4 线下店铺(手工建单用,无自动拉单/平台对接)
- 线下店铺不展示也不保存自动拉取订单与拉取间隔,平台字段一并清空
- 平台店铺新增/编辑都强制校验平台必填(前后端一致)
- 列表与详情的「自动拉取」「平台」列对线下店铺显示为 -

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 17:07:23 +08:00
liufumingren
797bbbcd82 feat(shop): 数据库店铺商品表/订单表支持拉取状态过滤(可填多个状态值)
- shop_database_configs 增加 product_filter_column/values、order_filter_column/values
- 配置弹窗在商品表、订单表下新增「状态字段 + 状态值」:状态字段选源表列,状态值可填多个(回车追加)
- 拉取时按状态列 IN (多个状态值) 过滤,订单表与时间窗条件同时生效;未配置状态列表示不过滤
- 保存时校验状态列存在、填了状态列必须至少填一个状态值(最多 100 个)
- 修复 DATASETS 数据集缺失 key 导致过滤校验窜到订单明细表的问题

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:54:36 +08:00
liufumingren
873527d556 style(shop): 数据库配置弹窗固定高度,内容在窗口内滚动
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:36:39 +08:00
liufumingren
23a7715dc9 feat(shop): 数据库店铺新增回传单号设置,发货确认后把运单号写回客户库
- shop_database_configs 增加回传设置:方式(不回传/写回字段/写回行)、目标表、运单号字段、定位字段、间隔符、写回行字段映射
- 配置弹窗新增「回传单号」区块:写回字段选表+字段+定位字段+间隔符;写回行按回传值(订单号/运单号/快递公司编码/快递公司名称/回传时间)逐项选列
- 保存时校验回传表与列在客户库中存在,回传行必填项(订单号、运单号)
- 发货确认(WMS 回推运单号)后自动回传:写回字段按间隔符合并写单值,写回行按订单号先删后插保证幂等;失败只记日志不影响发货确认

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:33:15 +08:00
liufumingren
c7a3a01faf feat(shop): 数据库店铺支持拉取商品与订单,一键拉单纳入数据库店铺并收紧货主范围
- 新增 shopDatabaseSync 服务:按商品表/订单表/明细表字段映射读取客户库,写入店铺商品与待审核订单(含明细重建、幂等更新、无明细跳过、已流转单只刷新平台侧数据)
- shop_database 控制器新增 pull-products / pull-orders 接口与路由、contract
- 一键拉单任务新增 database / all 范围,resolveShops 支持按货主收窄,runShop 走数据库店铺分支
- 店铺列表新增「拉取商品」「拉取订单」,订单页一键拉单可按范围选择店铺

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:20:50 +08:00
liufumingren
eb8c94eacf feat(shop): 新增数据库店铺类型与连接/选表/字段映射配置
- 迁移 shop_database_configs:一店一条,存数据库类型/IP/端口/库名/账号/密码、
  商品表/订单表/订单明细表名、三份字段映射与最近校验结果
- 新增 shopDatabase 控制器与 lib:服务端用 mysql2 连接客户库(8s 超时、utf8mb4),
  提供配置读取/保存、测试连通、连接拉表、拉表列表与表字段;表名走白名单校验
- 保存时连得上则校验表与列真实存在(不存在拒绝保存),连不上则保存并提示未校验
- 店铺新增支持 type=3 数据库店铺;删除店铺时一并清理数据库配置
- 前端:新增店铺可选「数据库店铺」,创建后自动打开配置弹窗;列表对数据库店铺
  显示「配置」,弹窗内填写连接信息、测试连通、连接拉表、选三张表并逐个字段映射
- 契约与路由:补数据库店铺配置相关接口定义

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:44:06 +08:00
liufumingren
f8421e4441 feat(product): 商品选择列表补充货主/SKU规格/条码/图片字段
- 商品选择弹窗(出入库、订单、记录与导出筛选复用)列改为:图片 / 商品编码 /
  商品名称 / 货主 / SKU规格 / 条码 / 操作,弹窗加宽以容纳新增列
- 组合商品「系统商品」与「已添加组合明细」新增图片、条码列,编辑可回显
- 店铺商品绑定弹窗「系统商品」新增图片、货主、条码列
- /api/products/search 与组合明细商品字段补充 image

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:28:36 +08:00
liufumingren
6e1e7a0f19 fix(stock): 清空商品后解锁仓库下拉,并新增创建页重置按钮
- 货主判定只统计仍持有商品的明细行,清空商品后仓库下拉/商品搜索范围立即解除
- 商品清空时同步清掉货主快照;自动带出的编码/名称/规格/单位一并清空,
  手工改过的编码保留
- 提交前货主一致性校验只针对已选商品的行
- 入库/出库创建页新增「重置」按钮:清空单据头与明细、清除校验提示,不离开页面

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:20:23 +08:00
liufumingren
9774ee1414 feat(stock): 出入库单/记录增加货主并按货主隔离,创建人显示员工名称
- 迁移:inbound_orders / outbound_orders 增加 subsidiary_id 与索引,按仓库回填
- 单据货主由仓库决定:创建写入、改仓库同步,接口不接受直写 subsidiary_id
- 入库单/出库单列表返回 subsidiary_name 并新增货主筛选;详情/编辑/删除/审核/
  推送/完成/取消/恢复/作废/驳回与明细接口统一加货主越界 403
- 出入库记录按仓库归属货主:列表与导出收窄、返回 subsidiary_id/subsidiary_name、
  新增货主列与筛选
- 导出:入库单/出库单/出入库记录新增货主列并按所在公司权限收窄
- 新增 resolveAccountNameMap:列表/详情返回 creator_name/auditor_name/voider_name,
  创建人展示员工名称(principal_users.name),不再回退成邮箱账号
- 前端:三个列表新增货主列与筛选,创建人/作废人展示改为员工名称

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:13:22 +08:00
liufumingren
4e56077770 feat(stock): 出入库单仓库与商品按货主双向限制并校验防注入
- 新增 app/lib/billOwnerScope.js:仓库可访问性(主体 + 所在公司)、明细商品/组合
  与仓库同货主校验、按单据仓库取货主
- 入库单/出库单 create:仓库可访问且明细商品必须与仓库同货主
  (原明细校验未带 principal_id,一并修正)
- 入库单/出库单 update:改仓库时校验新仓库可访问且已有明细同货主
- 明细接口(stock_items create/update):按所属单据仓库货主校验商品,堵住
  单据建好后再塞入其它货主商品的路径
- 前端新增 useWarehouseGoodsScope:仓库与商品双向约束(先选仓库限制商品、
  先选商品限制仓库、同单明细不得跨货主)
- 入库/出库创建页与单据明细编辑区接入该约束并给出提示
- ProductSelect 新增 beforeSelect 前置校验与受控显示值,校验不通过时回滚显示
2026-11-05 15:02:12 +08:00
liufumingren
d68ee9905d feat(order): 建单仓库/商品按店铺货主限制并校验防注入
- create:仓库必须与店铺同货主;新增 _assertItemsOwner 校验明细商品/组合货主
  (兼容 item_id / product_id 两种明细口径)
- update:先处理店铺变更并推导生效货主(越权换店铺 403),仓库与明细按生效货主校验,
  货主变更同步 order_index;subsidiary_id 禁止接口直写
- saveItems / changeWarehouse:补充同货主校验
- filters:货主权限下仓库下拉同步收窄,店铺/仓库下拉返回 subsidiary_id
- 前端:建单弹窗仓库按店铺货主过滤、切店铺自动回落并清空跨货主商品,
  ProductSelect 新增 subsidiaryId 透传商品搜索与查询弹窗
- 契约:店铺/仓库下拉项补 subsidiary_id,建单店铺/仓库字段说明同货主约束
2026-11-05 03:09:34 +08:00
liufumingren
baa89a7509 feat(dashboard): 首页看板按货主收窄 + 店铺货主创建后不可变更
- dashboard 服务新增货主范围(_ownerScope/_scopeBillWhere),概览、趋势、库存流水、
  Top 商品、最近流水均按当前账号所属货主收窄;首页加货主范围标签
- 店铺编辑禁止修改所属货主(历史无货主可补齐一次并联动店铺商品),详情返回 subsidiary_name
- 更新店铺契约描述
2026-11-05 03:09:26 +08:00
liufumingren
2d2f781f09 feat(order): 订单关联货主与越界操作拦截
- order_index 与各订单状态表新增 subsidiary_id(跟随店铺货主),历史数据按店铺回填
- 订单列表/详情/导出按货主范围过滤,货主权限仅可见自己所属公司的订单
- 订单 id 级操作统一在 _loadIndexRows 校验货主:审核/推送/驳回/取消/作废/恢复/改仓库物流/删除/明细维护越界返回 403
- 新建订单货主跟随店铺,货主权限只能为自己公司店铺建单;平台拉单写入时同步店铺货主
- 内部任务/平台回调无登录态时按系统操作处理,不受货主范围限制
- 订单列表与导出新增货主列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:46 +08:00
liufumingren
7c8e531362 feat(shop): 店铺/店铺商品关联货主与打单平台权限限制
- shops、shop_products 新增 subsidiary_id,店铺商品货主跟随店铺并按店铺回填历史数据
- 店铺列表/详情/新增/编辑/删除按货主范围隔离:货主权限仅可见/可维护自己所属公司的店铺,
  新增必须选货主,货主下拉仅自己所属公司;集团改店铺货主时店铺商品同步跟随
- 外部打单平台导入的店铺(type=2)在货主权限下只读:仅保留拉取订单、同步商品,不可编辑/删除
- 打单平台相关接口(平台资料、账号、商家、快递接口、外部发货)加集团权限门禁;添加店铺必须指定货主
- 货主权限菜单隐藏「外部打单平台」;店铺商品列表/绑定按货主范围隔离
- 店铺与店铺商品导出新增货主列并按范围收窄

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:42 +08:00
liufumingren
e8e83c714b feat(combo): 组合商品关联货主与同货主明细约束
- combo_products 新增 subsidiary_id(由组合明细的商品货主推导),列表展示货主
- 组合明细只允许来自同一货主的系统商品,混货主直接拒绝(接口 + 页面提示)
- 组合商品按货主范围隔离:货主权限仅可见/可维护自己所属公司的组合,创建也不能越界
- 组合编码可留空,由系统生成 ZH + 时间戳 + 随机数(主体内唯一);更新不可清空
- 组合导出新增货主列并按范围收窄;商品选择列表带出货主,选定货主后候选商品自动收窄

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:38 +08:00
liufumingren
d8539c0e3a feat(product): 商品按货主隔离与货主不可变更
- 商品列表/搜索按货主范围过滤:货主权限仅可见自己所属公司的商品,可按货主筛选
- 详情/编辑/删除对越权商品返回 403;新增只能建到自己所属公司下
- 商品创建后不可更改所属货主(历史无货主商品允许补齐一次,导入时忽略变更并提示)
- 批量导入按货主范围校验,不能导入或修改其它公司的商品
- 删除限制:被组合商品引用、或仍有库存(正品/残次品数量 > 0)时禁止删除
- 导出新增货主列并按范围收窄;商品表单货主下拉仅在新建时可选

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:32 +08:00
liufumingren
9c9a81f168 feat: 商品属性(分类/品牌/单位)关联货主
- product_categories / product_brands / product_units 新增 subsidiary_id(NULL 表示主体级、全集团共用)
- 列表与下拉按货主范围过滤:货主权限仅可见「主体级 + 自己所属公司」,并支持按货主筛选
- 新增/编辑支持选择货主,货主权限只能选主体或自己所属公司;同货主范围内名称唯一
- 详情/更新/删除对越权属性返回 403;导出新增货主列并收窄到可见范围

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:25 +08:00
liufumingren
b59ca6a0a8 feat(warehouse): 外部仓库货主权限收敛与库存同步口径
- 新增 groupScope 中间件:接口配置、字段、快递映射、调用日志仅集团权限可用,仓库维护只读放行
- 仓库列表/下拉/详情限定为自己所属公司(货主),越权访问返回 403
- 仓库商品与库存仅展示、推送、同步该仓库所属货主的商品,越界商品直接拒绝
- 「外部仓库」页在所在公司范围下收起新增/导出/接口配置/操作列与无关标签页,默认进入商品页
- 所属公司文案统一为「货主」
- 库存同步结果按商品统计(skipped/skipped_kinds/invalid_count),提示改为「N 个商品数量一致无需同步」

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 00:50:49 +08:00
liufumingren
b4b7c56729 feat: 权限范围收束与员工档案规则
- 新增 access 服务与 /api/access/context:按角色组权限判定集团 / 所在公司范围
- 菜单树按范围裁剪:所在公司范围仅保留「员工档案」,其余系统管理菜单隐藏
- 员工档案:角色组与所属公司必填;所在公司范围仅可见、仅可关联自己所属公司
- 创建者(所有者)行禁止编辑与解绑,且不可被移出主体;禁止新建所有者
- 所在公司范围禁止修改自己或他人的角色组、所属公司
- 新增员工时邮箱已注册则复用既有账号(reused),不再报「该邮箱已注册」
- 迁移:将所有者 role_id 统一指向系统管理员角色组

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 00:50:42 +08:00
liufumingren
839b81f661 feat: 商品与外部仓库关联所属货主(下属公司)
- products、warehouses 新增 subsidiary_id(下属公司),创建/更新必填并校验归属当前主体
- 商品批量导入新增「所属货主」列,按下属公司名称匹配,缺失时报错
- 商品、外部仓库列表与导出新增所属货主列、筛选与下拉控件
- 仓库下拉与详情接口返回 subsidiary_id / subsidiary_name

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 00:50:27 +08:00
liufumingren
e1e3bb638f feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:53:35 +08:00
liufumingren
85938c81ec feat: 组织架构、权限管理与员工档案
- 组织架构:主体管理改为组织架构页(左侧 tab:集团设置 / 下属公司),主体列表仅保留顶部下拉切换
  - 新增下属公司表 principal_subsidiaries、接口与页面,按当前主体隔离
  - 集团设置读取/编辑当前主体基础信息,补所属主体校验与更新字段白名单
- 权限管理:新增 permissions / roles / role_permissions 表
  - 权限以现有顶级菜单为分类,每个菜单两种范围:集团全部 / 所在公司
  - 系统预设角色:系统管理员(全部集团权限)、货主权限(全部所在公司权限)
  - 权限管理页只展示角色组,支持按菜单勾选权限;系统预设角色只读
- 员工档案:账号菜单改为员工档案
  - 新增员工-下属公司多对多关联(principal_user_companies)
  - 创建/编辑员工必须选择角色组;除所有者外必须至少关联一家公司
- 菜单重命名与旧地址重定向;账号导出新增角色组、所属公司

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:52:43 +08:00
liufumingren
eaf957ed14 feat(express): 外部打单快递接口、自定义快递编码与回 OMS 取号
- 外部打单平台快递接口:按账号同步平台模板、绑定快递编码、查看模板明细;打开列表只读库,仅「从平台同步数据」时拉取
- 系统管理新增自定义快递编码字典,订单改快递 / 物流下拉合并系统与自定义编码,推送奇门沿用订单上的编码
- 新增 OpenAPI deliveryorder.getwaybill:WMS 批量回取号(单次≤100、并发4、逐单结果),快递编码只取 WMS 报文,取消/作废/归档返回失败,已取号直接复用
- 新增 openapi_request_idempotency 请求级幂等:request_id 回放、报文摘要校验、30 分钟 stale 接管、7 天定时清理
- 外部打单平台订单按平台 fetch_waybill_no 下发 need_oms_waybill,推送时实时判定并回写单据
- 店铺、打单账号平台配置与「平台+编码→模板」绑定走 Redis 缓存,绑定/账号变更主动失效,避免批量推送与取号逐单查库

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:10:37 +08:00
liufumingren
581fa926df feat: add batch courier update for pending orders
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 20:34:47 +08:00
liufumingren
a15c91f5a1 显示平台订单号 2026-11-03 20:00:02 +08:00
liufumingren
5376dff3de feat(order): 平台订单号落库 oaid_order_source_code 并在订单列表展示
- 拉单写入状态表时,把店管家「订单编号」(PlatformOrderId)落 oaid_order_source_code
  (来源订单号仍是平台「系统编号」),随单推 WMS 的 deliveryOrder.oaidOrderSourceCode
- 新增迁移 20261103000300:把历史行 extend_props.platform_order_no 回填到
  oaid_order_source_code(已执行:pending 17 条 / void 12 条)
- 订单列表新增「平台订单号」列(手工单显示 -),订单详情、导出列同步使用该字段
- 前端 OrderStatusItem 补充 oaid_order_source_code 类型

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 18:01:02 +08:00
liufumingren
69b26bf7cc feat(platform): 统一系统预设平台编码,外部平台标识按预设转换
- 新增 app/lib/platformCode.js:17 个预设平台(1688/DW/DYCS/DYGX/DYXD/JD/KS/MAOCHAO/
  MTYYJK/OFFLINE/OTHER/PDD/SPH/TB/TGC/TM/XHS)+ 别名表(中英文、大小写)+ 未知落 OTHER
- 店管家硬编码 PlatformType → 预设映射(Pinduoduo→PDD、TouTiao→DYXD、WxVideo→SPH、
  Alibaba→1688、Taobao→TB、KuaiShou→KS、Tmall→TM、JingDong→JD…)
- 拉单落库统一:orders.platform_type、order_status_*.source_platform_code/name
  写预设编码与本系统中文名(推 WMS 的 sourcePlatformCode/Name 同源)
- 店铺商品 platform_type 同样落预设编码
- 新增 scripts/migrate-platform-codes.js(npm run platforms:migrate):
  按同一口径迁移历史数据,默认 dry-run;已执行迁移 14 类(订单 27 / 店铺商品 44 / 状态表 15+13)
- 前端新增 constants/platform.ts(code→中文名):店铺商品「平台类型」列显示中文名,
  订单详情新增「来源平台」行
- 新增 platformCode 单测(5 项,含未知平台落 OTHER)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 17:31:44 +08:00
liufumingren
d2724643e7 style(frontend): 商品 / 组合商品的操作记录改为点击行下方展开
与店铺商品页统一风格:
- 去掉操作列的「日志」按钮(操作列宽度 180 → 140)
- 点击行在表格下方(分页之后)展开操作记录面板,再次点击同一行收起
- 表格保持内部滚动,展开面板后表格自动让出高度
- 点击行内「编辑 / 删除」按钮不会误触发展开
- 移除原日志弹窗与 log-dialog-body 样式,补充 log-wrap / log-head / log-body 样式

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 17:20:41 +08:00