70 Commits

Author SHA1 Message Date
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
b14de3193c fix: load production env for database migrations
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 22:50:59 +08:00
liufumingren
587a39507b fix: run migration cli without altering app dependencies
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 21:55:38 +08:00
liufumingren
948dc41134 fix: install migration cli during backend deploy
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 21:21:09 +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
liufumingren
95c268836e feat(shop-product): 店铺商品支持勾选批量绑定到同一个系统商品/组合商品
- 新增 POST /api/shop-products/batch-bind(body: ids + bind_type + product_id/combo_product_id)
  - 目标商品只校验一次(必须属于当前主体),单次最多 500 条
  - 已是目标绑定的行计入 skipped,不重复改库、不重复写日志
  - 不存在/跨主体的 id 计入 failed,其余正常处理
  - bind_type=0 支持统一解绑
- 明细同步抽出 syncOrderItemsOf(items, ...):批量时合并为一次重建
  (老表 order_items 一次 IN 更新 + order_status_items 一次 rebuildOrderItems),
  单条绑定仍走 syncOrderItems(item, ...),行为不变
- 批量绑定逐条写操作日志(标题带「批量」,detail 记录 before/after 与 order_items_updated)
- 前端店铺商品表加勾选列与「批量绑定(N)」按钮,绑定弹窗支持批量模式:
  批量提示条、确认后统一绑定、统一解绑,结果提示更新/跳过/失败/明细同步数量
- 点击勾选框不再误触发行点击的操作记录面板
- 接口契约补 batchBindShopProductRequest/Result/Response

实测(主体5/店铺18):3 条统一绑定 → updated 3;重复执行 → updated 0 / skipped 3;
组合商品绑定 → 明细按组合展开(qty 15);统一解绑 → 明细还原平台原样快照;
无效 id → failed 1,其余成功;测试后店铺商品已全部还原为未绑定。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 17:08:54 +08:00
liufumingren
e6d3f1ba8d fix(external-print): 来源订单号改用店管家系统编号(LogicOrderId)
问题:外部打单平台订单的来源订单号 / 去重键取的是 PlatformOrderId(平台单号),
但平台单号并不唯一(同一平台单可拆成多条逻辑单),唯一标识是店管家的「系统编号」LogicOrderId。
例如 订单编号 261023-105376715090914 的系统编号是 695351624597601813。

- normalizeOrder:external_order_id / order_no 改用 LogicOrderId(缺失时回落平台单号),
  平台单号以 platform_order_no 单独带出
- 订单表 extend_props 增加 platform_order_no,便于按店管家「订单编号」对账
- 订单详情抽屉新增「平台订单号」一行(有值才显示)
- 新增 scripts/migrate-logic-order-id.js(npm run orders:migrate-logic-id):
  把历史订单的来源订单号从平台单号迁移到系统编号,同时改写 orders / order_index /
  各状态表 / order_status_items / 配送单,并补写 extend_props.platform_order_no;默认 dry-run
- 修正 orders.external_order_id、order_index.parent_order_no、orderFields 的字段注释

已执行迁移 20 条(备份见会话 files/backup-before-logic-order-id-migration.json),
迁移后重新拉单 created=0 / updated=14,确认不会产生重复订单。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 04:36:14 +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
7f0651ed37 feat(product): 商品批量导入(12 字段,编码存在则更新)
- 后端新增 app/lib/productImport.js:模板列定义(含表头别名)、xlsx 解析、行校验、金额解析
- 新增 GET /api/products/import-template(下载仅含表头的模板)
- 新增 POST /api/products/import:同主体下商品编码已存在则更新(空单元格不覆盖原值,
  软删除的会恢复),否则新建;文件内重复编码按最后一行处理;未知列在结果中返回
- 导入结果返回 total/created/updated/restored/failed/duplicated/errors/ignored_columns,
  并写入操作日志、对更新的商品触发待审核订单明细重算
- multipart 白名单增加 .xlsx
- 前端商品页新增「批量导入」:下载模板、选择 xlsx、展示导入结果与失败明细
- .eslintrc 为 config 目录放开 no-restricted-modules(config 需要 path 等核心模块)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:57:11 +08:00
liufumingren
2d98d5e7eb fix(order): 待审核 / 待推送 / 异常视图不再提供删除,删除仅限已取消订单
- 行内动作:待审核、异常去掉「删除」;待推送原本就没有;删除仅保留在「已取消」视图
- 后端 DELETABLE_STATUSES 收窄为仅 canceled,接口层同样拒绝(原来允许
  待审核 / 异常,与状态机设计冲突,可绕过流程把单据直接抹掉)
- 拒绝文案改为「仅「已取消」的订单允许删除(其余请先取消再删除)」
- 同步更新面板顶部动作说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:48:29 +08:00
liufumingren
bbbaa36310 style(frontend): 商品属性页底部分页与列表统一
- 属性页 el-tabs(左侧页签)的 __content 与 tab-pane 未设置高度,
  面板的 height:100% 因此失效,分页跟着表格滚走
- 补齐 .el-tabs__content / .el-tab-pane 的 height:100%(tab-pane 改为 flex 列 + min-height:0),
  与订单页同一套写法;面板内 .attr-panel 补 min-height:0
- 效果:商品分类/品牌/单位三个页签的分页均固定在底部,只有表格主体滚动

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:46:58 +08:00
liufumingren
81855f2cab fix(order): 修复状态表存在无索引记录的订单导致「列表可见但详情提示非本主体」
现象:异常/委外中/配送/已作废/已取消/历史等视图里能看到订单,
点「查看」却报「存在 1 条订单不存在或不属于当前主体」。

根因不是主体过滤缺失,而是数据不一致:
列表按状态表查询,详情按 order_index 校验主体;
历史迁移留下 25 条「状态表有行、order_index 无记录」的脏数据
(异常 8 / 委外中 5 / 配送 3 / 已作废 1 / 已取消 1 / 历史 7),
于是列表看得到、详情必然失败,报错文案又让人以为是跨主体。

改动:
- orderStatus.list:加 EXISTS(order_index) 条件,只返回索引表存在且主体一致的订单,
  杜绝同类脏数据再次「列表可见、点不开」
- 新增 scripts/repair-order-index(npm run order-index:repair):扫描各状态表补写缺失的
  索引记录(支持 --dry-run),已执行修复上述 25 条

验证:7 个视图列表与详情全部一致(pending 105 / exception 8 / outsourcing 5 / delivery 3 /
void 1 / canceled 1 / history 7,详情失败均为 0);principal=6 各视图均为 0 条;
人为插入孤儿行后列表不再显示该行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:46:00 +08:00
liufumingren
ce636c15f4 style(frontend): 列表页统一版式(分页固定底部)+ 操作记录面板
列表统一版式(对齐订单页):
- 所有列表页卡片撑满可视高度(flex:1 + min-height:0),el-card__body 改为 flex 列并 overflow:hidden
- 筛选区固定(flex:0 0 auto),表格区 flex:1 且 overflow:hidden,表格传 height="100%" 只在表体滚动
- 分页组件固定在底部,不再跟着表格滚走
- 涉及页面:商品、组合商品、主体管理、账号管理、外部打单平台
  (导出任务、库存单据、库存流水、店铺、店铺商品、出入库单此前已统一)

操作记录面板:
- 新增 components/OperationLogPanel.vue(分页表格:时间/操作/说明/操作人/来源)与 api/operationLog.ts
- 店铺商品页:点击商品行在表格下方展开操作记录,再次点击或「收起」关闭
- 商品、组合商品页:行内新增「日志」按钮,弹窗展示操作记录

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:43:35 +08:00
liufumingren
a9cca6aa6f feat(log): 新增操作日志(店铺商品/系统商品/组合商品),并修正明细口径
操作日志:
- 新增 operation_logs 表与 model/service/controller,接口 GET /api/operation-logs
  (按 target_type + target_id 分页查询,主体隔离,按时间倒序)
- 店铺商品:采集进系统、平台已无此商品被移出/下架、绑定/解绑均留痕(含原绑定与受影响订单数)
- 系统商品:新增 / 修改(记录变更字段与前后值)/ 删除
- 组合商品:新增 / 修改(含子商品构成前后值)/ 删除
- 日志为旁路能力:写入失败只告警,不影响业务操作

明细口径修正:
- 已审核订单(待推送及之后)的明细在审核时已锁定,重算时按状态过滤,
  重新拉单与改绑定都不再波及(原先会覆盖老表 order_items 的解析结果)
- 组合商品构成/系统商品资料变更后,重建绑定方的待审核订单明细与商品摘要;
  并修正重建时读不到同事务内未提交构成的问题(loadBindings/loadComboItems 传事务)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:43:30 +08:00
liufumingren
b946d09a03 style(frontend): 列表表格改为表体内部滚动,分页默认 20 条
- 各列表 el-table/DataTable 传 height="100%",让表头固定、表体滚动
  (原先只写了 CSS height,Element Plus 不会生成内部滚动容器,行多时被父容器裁掉)
- 每页条数选项改为 20/50/100/200,默认 20;移除硬编码的 10 条/页
  (外打平台商家列表、店铺商品绑定弹窗、商品选择弹窗统一走 DEFAULT_PAGE_SIZE)
- 清理因此失效的 .fill-table 样式

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:29:15 +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
ab630e7c01 feat(external-print): 订单拉取与定时同步,组合商品拆分为最小单位
后端能力:
- 接入店管家订单接口(/NewOrder/List),明细归一化后按店铺商品匹配系统商品/组合商品
- 新增 service/externalPrintOrder:手动与定时拉单共用入库逻辑,同时写入待审核状态分表
- 新增 schedule/fetchExternalShopOrders:按店铺配置的间隔自动拉单(最小 3 分钟,起点重叠 10 分钟)
- 新增 lib/orderItemExpand + service/orderItemResolve:平台行与最小单位行互转;
  绑定组合商品时按「数量 = 平台数量 x 组合内数量、单价取子商品零售价」拆成子商品行,解绑可还原
- 明细新增 platform_snapshot,保留平台原样(编码/名称/规格/图片/原行号/原数量/原单价)
- 店铺商品列表支持 has_unbound_order 筛选,订单列表支持 exclude_unbound(均已同步导出定义)
- 店铺商品只读化:移除新增/编辑/删除动作,仅保留查询与绑定;
  同步商品时平台已不存在的商品自动清理(未绑定且未被订单引用直接删除,已绑定或被引用仅下架)
- 新增 scripts/rebuild-order-items 存量明细重建脚本,新增 orderItemExpand 单测(8 项)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:29:09 +08:00
liufumingren
969c68f5f9 feat(external-print): 新增外部打单平台与账号管理(接入店管家登录)
- 新增 external_print_platforms(平台基础资料,开发者维护)与 external_print_accounts(账号/密码/cookie/token/登录状态)
- 新增平台账号 CRUD、登录态检查、登录接口;店铺管理下新增「外部打单平台」菜单
- 平台服务按 code 独立存放于 app/lib/printPlatform(dgj.js 实现店管家登录与 GetUserInfo 登录态检查)
- 平台接口 401 自动记录账号登录状态,前端展示状态并支持检查/登录

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 18:02:34 +08:00
liufumingren
49fec97526 feat(frontend): 新增 OMS 站点图标 favicon(矢量 + 多尺寸 ICO)
- 设计:深蓝圆角底 + 等轴测立方体,语义对应包裹 / 仓储 / 订单履约
- public/favicon.svg(矢量源,现代浏览器优先用)、public/favicon.ico(16/24/32/48/64/128/256 七档)、
  public/apple-touch-icon.png(180)
- index.html 增加 icon / apple-touch-icon 链接与 theme-color
- scripts/make-favicon.py 保留生成脚本,改配色或形状后可一键重出

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 01:25:14 +08:00
liufumingren
7254125088 fix(frontend): 极矮窗口不再让卡片内部滚动
- 移除登录卡片的 overflow:auto(避免嵌套滚动导致按钮点不到)
- 新增 max-height:560px 断点:交给页面整体滚动,其余高度仍然一屏不滚动

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 00:30:44 +08:00
liufumingren
dc8f0dadf3 fix(frontend): 登录页改为纯 SVG 插画,并修正整页高度(去掉滚动条)
- 左侧插画改为 inline SVG 组件 LoginIllustration(货架/纸箱/摄像头/扫码枪/单据/数据流,
  虚线流动与光点呼吸动画,prefers-reduced-motion 时关闭),不再依赖任何 png/jpg
- 整页背景改为 CSS 径向渐变 + 网点纹理,删除 login-page-bg.jpg 依赖
- 微信登录按钮图标改为 inline SVG,删除 frontend/public/static/login 素材目录
- 修正滚动条:.login-page 用 box-sizing: border-box + height:100% 锁定一屏,
  卡片自身可内部滚动;新增矮屏(max-height:760px)紧凑规则;窄屏上下布局仍可滚动

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 00:23:20 +08:00
liufumingren
d2fbd216e9 feat(frontend): 登录页改为左右分栏(左插画 + 右白色表单卡片)
- 深蓝底图 + 网点纹理铺满整页,左侧放设计交付的透明插画(素材缺失时退化为纯 CSS 文案区,不留破图)
- 右侧白色卡片:输入框、按钮、分割线、微信登录全部代码实现,不用切图;
  微信登录为「图标 + 文字」横排按钮,hover/active 交互用 CSS
- 微信扫码从 tab 改为独立弹窗入口,保留原有二维码轮询、倒计时、未配置提示逻辑
- 移动端(<=960px)自动上下布局:插画在上、表单卡片在下
- 新增 frontend/public/static/login/ 素材目录与清单说明(命名:小写 + 横杠,无中文)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 00:08:46 +08:00
liufumingren
e064cb6f24 chore(deploy): 前后端发布目录统一到 oms.gztbyc.com 站点下
- 后端 deployRoot 改为 /www/wwwroot/oms.gztbyc.com/api(前端 releases/current 的兄弟目录),
  UPLOAD_DIR 同步为 .../api/uploads,nginx 扩展配置的 include 指向新 upstream
- 工具默认值与示例配置、DEPLOY.md 目录结构与示例路径一并更新
- 旧目录 /www/wwwroot/api.oms.gztbyc.com/ 迁移后可直接删除

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:46:39 +08:00
liufumingren
ed98349ea2 chore: 清理指向 api.oms.gztbyc.com 的残留引用
- env 样板:OMS_CALLBACK_BASE_URL 改为 https://oms.gztbyc.com(后端/发布两处)
- 前端:env.d.ts 示例与 mediaUrl() 注释改为同源说明(生产 /api 不再跨域)
- DEPLOY.md:旧域名章节改为「已下线」,说明目录 /www/wwwroot/api.oms.gztbyc.com/
  只是发布目录名、与域名无关;同源章节去掉「保留 CORS 给老域名」的过时说明
- deploy.config.example.cjs:注明 include 路径与域名是否对外服务无关

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:41:08 +08:00
liufumingren
3404543418 refactor(backend): 同源部署后收窄 CORS 默认白名单
- 生产前后端同源(/api),浏览器不再触发跨域;默认只放行本地开发 localhost:5173
- 移除 api.oms.gztbyc.com 相关默认来源(该域名已退役),仍需跨域时用 CORS_ORIGINS 覆盖
- 同步更新 cors 中间件注释与 env.production.example 说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:34:44 +08:00
liufumingren
8fb24211df docs(deploy): 单域名部署补充 /openapi 反代与旧域名退役步骤
- Nginx 示例增加 location = /openapi(外部系统回推入口),OMS_CALLBACK_BASE_URL 指向站点域名
- 新增「旧域名 api.oms.gztbyc.com 的处置」:改回调地址 → 观察日志 → 删站点与 DNS,
  但 deployRoot 目录必须保留(v1/v2、shared-config、nginx-upstream.conf、backups)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:30:21 +08:00
liufumingren
378e1bf7b1 docs(deploy): 补充 /api 反代与生产迁移的踩坑说明
- 静态站点默认没有 /api/ 反代,前端同源 /api 后会全部命中 SPA 回退返回 index.html,
  补充现象描述与宝塔「扩展配置」放置位置(面板重写主配置不丢)
- 新增「数据库迁移」小节:runMigrations=false 时如何手动执行(含 sequelize-cli 临时安装与 prune)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:26:06 +08:00
liufumingren
1847e17ba7 feat(auth): 接入微信扫码登录与微信绑定
- 新增网关客户端与通知验签(sha256(appSecret) 派生 HMAC-SHA256,5 分钟防重放),
  扫码会话与一次性结果存 Redis,openid 仅服务端保存
- 新增 user_wechat_binds 表与迁移:openid 唯一(一个微信只绑一个账号)、
  user_id 唯一(重新绑定覆盖旧微信)
- 新增 /api/auth/wechat/* 接口与 /api/wx/notify 网关回调;登录二维码按 IP 限流,
  未配置网关时相关接口返回 400 提示,不影响账号密码 / 邮箱验证码登录
- 前端:「微信登录」tab(二维码 + 倒计时 + 轮询)与「我的」页微信绑定 / 解绑
- 开发与生产各出一份 WX_GATEWAY_* 配置样板,生产权威副本走 shared-config 覆盖
- 同步补充 swagger 契约与请求日志脱敏字段(bind_code / sign)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:17:11 +08:00
liufumingren
122eb9ccc9 feat(frontend): 生产改为同源 /api,前端挂到后端域名的根目录
- frontend/.env.production: VITE_API_BASE_URL 由 https://api.oms.gztbyc.com/api 改为 /api
- tools/DEPLOY.md: 新增单站点 Nginx 配置(root=current、/api/ include upstream、SPA try_files 回退),
  域名/CORS 章节改为同源说明
- tools/config/deploy.config.example.cjs: Nginx 前置说明同步为单站点

同源后不再需要 CORS,后端切换 v1/v2 端口时前端产物无需重新构建。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:13:44 +08:00
liufumingren
e2d7f04999 feat(tools): 新增 dev 命令,一键启动前后端开发环境
- npm run dev 同时启动 egg-bin dev(6090) 与 vite(5173),日志按 [backend] / [frontend] 前缀分区
- Ctrl+C / SIGTERM 时结束整棵进程树(Windows 用 taskkill /T /F)
- --backend / --frontend 可只启动一端,--no-color 关闭彩色前缀
- 任一端退出时保留另一端继续运行,全部退出后以首个非零退出码返回

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:10:21 +08:00
liufumingren
4b5c228f46 chore: 忽略编辑器工作区文件(*.code-workspace)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:07:30 +08:00
liufumingren
42a40d0325 chore: 忽略本地运行日志并补充订单拆分需求文档
- .gitignore 增加 *.err(egg-bin 启动失败转储等本地运行产物,不入库)
- 新增《订单拆分需求文档》记录订单拆分的业务规则与数据口径

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:35 +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
4343bcdd17 feat(backend): 导出任务按类型声明筛选字段与导出模板
- exportDefs 为每种导出类型声明可传筛选字段与导出列模板,前端据此动态渲染提交表单
- /api/export-tasks/types 返回类型 + 字段 schema;提交时按 schema 过滤参数(cleanFilters)
- 扩充订单/商品等导出列定义与格式化规则

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:26 +08:00
liufumingren
6c03a20364 feat(backend): 订单状态分表、WMS 推送与归档
- 新增 order_index 索引表 + 6 张同构状态表(待审核/异常/委外中/配送/已作废/已取消)与历史表,
  订单 ID 全局唯一,状态由业务事务推动:审核、驳回、取消、作废、恢复、归档
- 明细表 order_status_items、收件人文本智能解析、批量切换仓库/店铺并刷新快照
- WMS deliveryorder.create 推送(单条/批量)、推送失败定时重试、订单归档定时任务
- 迁移:建表、旧发货单数据迁入新表、菜单合并与迁移记录清理
- routes / swagger contract 补充订单状态接口

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:18 +08:00
liufumingren
d22f3e1f0a feat(backend): 新增商品分类/品牌/单位字典与属性菜单
- 按主体隔离的分类/品牌/单位 CRUD 与 /select 下拉接口
- 商品模型增加 brand_id / unit_id,属性被商品引用时禁止删除(attributeUsage)
- 迁移:建三张字典表、商品表加字段、种子属性菜单、is_system 保护内置项

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:09 +08:00
liufumingren
406e5f3b58 refactor(tools): 发布工具统一到 tools(前后端同时发布 + git 约束 + 共享配置)
- 新增 tools TypeScript 发布 CLI:deploy / deploy:backend / deploy:frontend / rollback / init
- 删除 backend/script 与 frontend/scripts 旧发布脚本,前后端 npm scripts 转发到 tools
- 发布配置独立为 tools/config/deploy.config.local.cjs(模板入库,真实配置与生产 env 不入库)
- 发布受限于 git:工作区有未提交改动默认中止(--allow-dirty 放行),版本记录含 commit/branch
- 后端配置集中到 <deployRoot>/shared-config,本地 env 发布时覆盖共享配置;端口由 EGG_PORT 注入
- 前端服务器端脚本迁至 tools/remote,失败时清理未上线版本目录
- .gitignore 改为忽略 tools 本地配置与临时发布包

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:04:54 +08:00
liufumingren
5908cacdf5 docs(backend): 补充生产 .env 模板说明(SMTP 必填、LF 行尾、端口来源)
- SMTP 段标注为生产必填,并说明未配置时 sendCode 走「仅记录日志」分支:
  邮件不会发出,但 email_logs 仍写 status=1,排查时不要只看这张表
- 补充行尾警告:本文件必须为 LF,CRLF 会让 dotenv 把 \r 带进值里,
  典型症状是 getaddrinfo ENOTFOUND smtp.qq.com(主机名尾部多了 \r)
- 修正端口说明:EGG_PORT 由 config.default.js 的 config.cluster 读取
  (config.local.js 只在 env=local 时加载,生产不生效)
2026-09-14 22:20:02 +08:00
liufumingren
640f39ed2e feat(frontend): 新增导出任务页面与多标签页导航
- 新增 views/ExportTask/Index.vue:发起导出、轮询进度、完成后自动下载、历史列表,
  以及 api/exportTask.ts
- 新增 store/tabs.ts:顶部多标签页(打开/关闭/固定),BasicLayout 接入;顶栏账号头像
  改走 mediaUrl 拼 API origin
- 路由新增 /export-tasks,默认落地与已登录访问登录页时跳转改为 /dashboard
  (动态路由尚未注册时由守卫重新解析当前目标)
- 登录页标题改为「天豹 OMS 管理系统」
2026-09-14 22:14:31 +08:00
liufumingren
441659d303 feat(frontend): 新增蓝绿发布脚本与生产 API 地址
发布:
- 新增 scripts/deploy.mjs、rollback.mjs、init-config.mjs 与 scripts/remote/{deploy,rollback}.sh
  · 服务器上按 releases/<版本号> 存放,current 软链原子切换,发布/回滚都不中断服务
  · 切换前校验 index.html 与引用的 /assets 资源完整,并补齐历史版本静态资源(旧 chunk 不 404)
  · 真实配置 scripts/deploy.config.json 已加入忽略清单,模板 deploy.config.example.json 入库
- package.json 增加 deploy / rollback / deploy:init

接口地址:
- 新增 .env.production(VITE_API_BASE_URL=https://api.oms.gztbyc.com/api)与 .env.development
  (/api,继续走 vite 代理到本地 6090)
- request.ts 的 baseURL 改为读 VITE_API_BASE_URL;env.d.ts 声明 ImportMetaEnv
- 新增 utils/media.ts#mediaUrl:跨域部署时把后端返回的相对地址(/api/files/raw/…)
  补全为 API 站点绝对地址,用于 ImageUploader、商品列表图片、主体账号头像渲染

工程:
- tsconfig 去掉已弃用的 baseUrl(TS 7 将移除;paths 自 TS 4.1 起不再依赖它)
- .gitignore 增加 dist.tar.gz 与真实部署配置
2026-09-14 22:14:27 +08:00
liufumingren
fc58f79b42 feat(backend): 新增商品导出任务
- 新增 export_tasks 表与模型(迁移 20260916000000),记录导出类型、状态、进度、
  文件名与错误信息
- app/service/exportTask.js:生成 CSV(exceljs)并落盘到 upload/exports/<主体>/<年>/<月>/<日>
- app/schedule/exportWorker.js 定时执行待处理任务,cleanupExport.js 清理过期文件
- 接口:POST /api/export-tasks 提交、GET /api/export-tasks 列表与进度、
  GET /api/export-tasks/:id/download 下载
- app/utils/exportDefs.js 定义各导出类型的数据源;warehouseProduct / stockRecord 补充
  库存相关数据
- 契约补 exportTask 系列与 apikey 安全定义;.eslintrc 放行相关文件与 apikey 标签
- package-lock 同步
2026-09-14 22:14:23 +08:00
liufumingren
3daa95c96f feat(backend): 新增蓝绿发布脚本与跨域支持
跨域:
- 新增 app/middleware/cors.js:按白名单回 Access-Control-Allow-Origin,OPTIONS 预检直接
  204,使用 Bearer Token 鉴权故不回 Allow-Credentials
- config.default.js 注册全局中间件 cors(置于 requestLog 之前),并新增 config.cors.origins
  (可用环境变量 CORS_ORIGINS 覆盖,默认放行 http/https 的 oms.gztbyc.com 与本地 vite)

端口:
- config.default.js 新增 config.cluster(读 EGG_PORT,默认 6090)
  原因:egg 只在 env=local 时加载 config.local.js,生产(env=prod)不加载它,
  原先把端口写在 config.local.js 会让生产退回框架默认的 7001

发布(参考 WMS 后端的 v1/v2 双实例蓝绿):
- 新增 script/deploy-lib.cjs、deploy-remote.cjs、rollback-remote.cjs、init-deploy-config.cjs
- 目标目录:清理旧代码(保留 logs/run/node_modules/.env)→ 解压 → 缺 .env 时从
  deployRoot/.env 复制 → npm install --production → 释放端口 → 启动 → 健康检查 →
  改写 nginx-upstream.conf 并 reload → 停旧实例;健康检查失败则不切换、回滚 current.md
  并清理新实例,线上不受影响
- 回滚 = 切回另一套版本目录(npm run rollback [-- --to=v1|v2]),秒级完成
- 发布包按 git 文件清单 + include/exclude 白名单生成,.env/uploads/logs 等不入包
  (含 .sequelizerc,便于服务器上直接跑迁移)

配置与依赖:
- 新增 config/deploy.config.example.cjs(模板入库;真实配置 deploy.config.local.cjs 已忽略)
- 新增 env.production.example:生产 .env 模板,说明 MySQL 端口、Redis 密码、
  JWT_SECRET、UPLOAD_DIR(必须放版本目录之外以让 v1/v2 共用)等
- package.json 增加 deploy/deploy:prod/deploy:init/rollback/rollback:prod;
  顺带登记导出任务用到的 exceljs 依赖
- .gitignore 增加:真实部署配置、backend/temp/(本地发布包)、backend/upload/(导出产物)
2026-09-14 22:14:20 +08:00
liufumingren
57f55c0974 fix(backend): 修正历史搬迁迁移在全新库上的列依赖
- 20260915000300 的统计回填要写 order_deliveries.item_total/item_amount/item_kind,
  但这三列由后续迁移 20260915000400 添加
- 全新库上本迁移先于它执行,必然报 Unknown column 'd.item_total' 并中断整个迁移流程
- 改为先用 describeTable 判断列是否存在,不存在则跳过回填(全新库 orders 为空、搬迁本就是 0 行)
2026-09-14 22:14:16 +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