liufumingren
|
c73cc826d7
|
fix(order): 商品同步/补拉后自动重匹配未采集的订单明细
问题:拉单早于商品入库(新店铺第一次拉单,或商品是事后才补拉的)时,明细会停在
shop_product_id=null(parse_msg「未采集到该店铺商品」),之后商品补齐也不会自动
变化 —— 订单页一直显示未绑定,还被「仅已绑定」过滤掉,看起来像「有商品却匹配不上」。
另外「重新解析」旧接口只回写 order_items,改不动订单页读的状态明细表。
- 新增 lib/shopProductMatch:把「店铺 + 平台商品ID + 平台规格ID」等值匹配抽成纯函数,
明细带规格ID时必须精确命中同规格,不退化按商品ID乱取(避免不同规格绑成一行)
- orderItemResolve.rematchUnboundItems:商品写入后在同一事务里补匹配该店铺
shop_product_id 为空的明细,并重建命中订单(只动待审核/异常,已审核随审核锁定)
- saveShopProducts 调用它并返回 rematched;同步/单品补拉两个接口与前端提示都带上
- 文档补 §4.2.5:明细 → 店铺商品 → 系统商品的匹配口径、两种 parse_status=2 的区别
- 单测 shopProductMatch.test.js(精确命中 / 不退化 / 无规格取首行 / 空输入)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:30:29 +08:00 |
|
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
|
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
|
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
|
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
|
baa89a7509
|
feat(dashboard): 首页看板按货主收窄 + 店铺货主创建后不可变更
- dashboard 服务新增货主范围(_ownerScope/_scopeBillWhere),概览、趋势、库存流水、
Top 商品、最近流水均按当前账号所属货主收窄;首页加货主范围标签
- 店铺编辑禁止修改所属货主(历史无货主可补齐一次并联动店铺商品),详情返回 subsidiary_name
- 更新店铺契约描述
|
2026-11-05 03:09:26 +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
|
107b81bb6a
|
feat(external-print): 支持「全部待处理」拉单,修复订单分页 500 条截断
背景:店管家「待发货」页的条件是 ErpState=waitsellersend(+ IsPdd/OrderByField),
但实测该 Filters 仅 fxali 域名接受,fxdd / fxpdd 会返回「登录信息过期,请重新登录」,
无法直接复用服务端过滤;改为「宽时间窗拉取 + 本地按平台发货状态过滤」,结果与平台一致。
- 手动拉单新增「全部待处理(不限下单时间)」(days=0):覆盖店铺历史积压的未发货订单
- 修复分页截断:平台不返回 PageCount(多为 null),原逻辑只取第一页,
任何分区超过 500 单时会被静默截断;改为以 Total + 满页判断翻页
- 拉单遇「登录信息过期 / token is invalid」自动重新登录并重试一次,
避免定时任务因会话到期整天失败
- 契约与头部注释同步更新
实测店铺 19(意洁):全部待处理 → 未发货 18 单(PDD 11 / Alibaba 4 / KuaiShou 1 / Taobao 2),
跳过平台已发货 3637 单;与逐分区直连平台的统计完全一致(18 单)。
DB 待审核合计 20 单(含店铺 18 的 2 单 WxVideo)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:32:57 +08:00 |
|
liufumingren
|
5762c13b2f
|
fix(external-print): 手动/首次拉单改用滚动时间窗,修复凌晨拉单提示 0 单
问题:手动拉单的「最近 N 天」被按自然日对齐(今天 00:00 起),
凌晨拉单只覆盖当天几小时,明明平台有待发货订单也提示「0 单」;
店铺首次自动拉单也只回看一个间隔(默认 3 分钟),历史待处理订单永远拉不进来。
- sync-orders 改为滚动时间窗:end=此刻(或指定时间),start=end - days×24h
- 手动拉单下拉增加「最近 90 天」,默认值 1 天 → 7 天
- 弹窗说明与结果提示补充实际拉取时间窗;窗口内无数据时用 warning 提示而不是成功
- 定时任务首次拉取(last_order_sync_at 为空)回看 7 天,命中店铺历史未发货订单
- 移除不再使用的 alignDay 辅助函数
实测:店铺 19(13668975305 意洁)最近 1 天 → 未发货 8 单(原为 0),
最近 30 天 → 未发货 12 单(跳过平台已发货 1329 单),订单页待审核可见 14 单
(含店铺 18 的 2 单)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:18:16 +08:00 |
|
liufumingren
|
a4213bfd0d
|
fix(external-print): 拉单只取平台未发货订单,已发货/已终结不再进待审核
问题:店管家 /NewOrder/List 只支持按时间窗查询,不提供发货状态过滤,
原实现仅按 UpFxUserId 归属就整批入库,导致 sended/success/close 的订单
全部堆进「待审核」(实测店铺 19 近 7 天平台返回 385 单,真正待发货只有 11 单)。
- dgj 新增 isOrderFinished():ErpState∈sended/success/close(及各平台等价状态)、
有 OnlineSendTime、面单 IsSended=true、LogisticStatus>0 任一命中即视为已处理;
PrintState/ExpressPrintTime 仅表示已打印面单,不作为判定依据
- listOrders 过滤未发货订单,返回 skipped 与 finished 列表
- externalPrintOrder.syncOrders 新增 voidFinishedOrders():本地仍处于待审核、
平台侧已发货的副本自动作废(写 void_at/void_reason + 操作日志),已审核订单不动
- orderStatus.voidOrder 支持 principalId(定时任务无登录态)
- 手动/自动拉单消息、接口返回、接口契约、前端提示补充「跳过已发货 / 自动作废」统计
- 新增 scripts/cleanup-shipped-pending-orders.js(npm run orders:cleanup-shipped):
按同一口径清理历史脏单,默认 dry-run,--apply 才删除
- 新增 isOrderFinished 单测(7 项)
已清理历史脏单 103 条(备份见会话 files/backup-shipped-pending-orders.json),
清理后待审核仅剩 2 单真实的平台待发货订单。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:14:02 +08:00 |
|
liufumingren
|
266c01538e
|
feat(frontend): 订单与店铺商品交互完善
- 待审核订单增加「含未绑定」开关(默认只显示已绑定),列表与导出条件保持一致
- 店铺商品增加「只看有订单未绑定」筛选与「待处理订单」列;绑定弹窗改为左侧页签 + 右侧可搜索分页列表
- 订单切换仓库改为弹窗选择,新增通用 RecordPickerDialog 组件
- 订单与店铺商品表格改为表体内部滚动,筛选栏与分页固定
- 手工建单必须选择非平台店铺;平台订单编辑时店铺不可修改
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 03:29:12 +08:00 |
|
liufumingren
|
907df04070
|
feat(frontend): 商品属性、订单状态与导出任务界面
- 新增商品属性页(分类/品牌/单位)与商品表单的品牌/单位选择
- 新增订单状态页:状态分视图列表、新建/编辑弹窗、明细维护、审核/驳回/取消/作废/恢复/推送仓库等操作
- 导出任务按类型动态渲染筛选表单与任务进度;导出按钮/筛选组件抽为公共组件
- 旧地址 order-split / order-create / order-delivery 重定向到 /order,导航与多标签页适配新页面
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-10-30 23:06:31 +08:00 |
|
liufumingren
|
cc7cd0f107
|
feat(frontend): 仪表盘报表页、全局统一时间格式化与 UI 紧凑化
- 仪表盘(views/Home.vue 重写):区间切换(近 7/30/90 天)+ 概览指标卡 + 待办提醒
+ 三类单据状态卡(点击跳对应状态列表)+ 两个趋势图 + 库存 Top 商品 + 最近流水;
新增 api/dashboard.ts;趋势用纯 CSS 柱状条实现,不引入图表库
- 列表页支持仪表盘带筛选跳转:Order/InboundOrder/OutboundOrder 的 Index.vue
在 onMounted 读取 route.query.status
- 时间统一格式化:新增 utils/datetime.ts(formatDateTime/formatDate),
各页面时间字段一律走该工具(修正 ISO 串直接展示问题,按本地时区还原挂钟时间)
- UI 紧凑化:App.vue 全局覆盖 Element Plus 内边距到 10px 左右;各页面/组件
偏大的 padding 收紧,把空间留给内容
- 账号名称/头像:登录注册去昵称、我的页去掉昵称/头像 URL、账号页支持设置名称与头像、
右上角按头像 → 名称首字符 → 账号首字符降级展示
- 出库单/入库单/发货单列表与创建页:去掉操作人输入、物流公司下拉、推送失败标记等
Co-Authored-By: GitHub Copilot <noreply@github.com>
|
2026-09-14 16:09:41 +08:00 |
|
liufumingren
|
a51cb4df15
|
feat(frontend): 初始化 Vue3 + Vite 前端工程与业务页面
- 工程脚手架:Vite、TypeScript 配置、路由、Pinia store(auth/principal/menu)、请求封装
- 布局与通用组件:BasicLayout、SideMenu、DataTable/VirtualTable、VirtualSelect、ProductSelect、ImageUploader 等
- 业务页面:登录、首页、商品、店铺、店铺商品、组合商品、仓库/接口配置、库存、入库单、出库单、发货单(列表 + 创建)、外部接口、主体/主体用户、个人资料
- API 层:api/*.ts 与后端接口一一对应
|
2026-09-13 02:23:51 +08:00 |
|