29 Commits

Author SHA1 Message Date
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
liufumingren
489563a4b2 feat(backend): 仪表盘报表接口、配置裁剪、单号 5 位与账号名称/头像
- 仪表盘报表:新增 app/service/dashboard.js + app/controller/dashboard.js +
  app/lib/billStatus.js,注册 GET /api/dashboard/report(jwtAuth + principalCheck),
  一次聚合返回概览指标、发货单/入库单/出库单状态分布与待办、近 N 天单据量与
  出入库数量趋势、库存 Top 商品、最近出入库流水;warehouse_id 只过滤单据与流水
  (product_stocks 无仓库维度);契约 dashboard* 同步到 swagger
- 接口配置裁剪:仓库接口配置只保留 api_version 与 item_name_with_spec;
  历史 warehouse_apis.extra 冗余键、owner_code 配置、递交/回传设置一并清理
  (迁移 20260915002400~02800)
- 入库/出库/发货单报文与字段对齐 WMS 标准:去掉 ownerCode、operatorCode 等多余字段,
  入库明细补 itemId;发货单明细去掉无意义的 owner_code(迁移 20260915002600)
- 单号 5 位起:四张单据表 AUTO_INCREMENT 提到 10000(迁移 20260915002900)
- 账号名称/头像按主体维护:principal_users 增 name/avatar 并回填(迁移 20260915003000/03100),
  新增 app/lib/accountProfile.js(关联表名称/头像 → users 兜底);审核人写入 operator/operator_name;
  register 不再写 nickname、updateProfile 仅接受邮箱/手机号
- 出库单推送/锁库存链路的配套调整(outboundOrderPush、订单与发货单控制器)

Co-Authored-By: GitHub Copilot <noreply@github.com>
2026-09-14 16:09:35 +08:00
liufumingren
09a5d31220 fix(frontend): 出库单审核/推送后提示并刷新整单
- audit / push 走服务后按动作给出对应提示(审核成功进入推送队列、已推送仓库)
- 状态流转后重新拉取单据详情,刷新 pushed_at 与 wms_push_result 展示
2026-09-14 01:00:39 +08:00
liufumingren
5329aa8003 fix(backend): 出库单确认/取消时同步清空 stock_locked
- stockout.confirm 完成出库时置 stock_locked=0(与 stock_deducted 同步)
- order.cancel 回调:单据已推送(3)、或推送未成功但已锁定库存(stock_locked=1),且尚未扣减时释放锁定并置 0
2026-09-14 01:00:20 +08:00
liufumingren
92be712dbc refactor(backend): 出库单推送逻辑下沉到 outboundOrderPush 服务
- 控制器 push() 收敛为薄封装,改调 ctx.service.outboundOrderPush.pushOne / unlockStock
- 推送重试、库存锁定与释放统一由 app/service/outboundOrderPush.js 实现(与发货单推送服务同结构)
2026-09-14 01:00:01 +08:00
liufumingren
23d372aa52 feat(frontend): 出入库记录页、入库/出库创建页与仓库快递映射
- 新增出入库记录页:先用商品编码/名称关键词搜索锁定 product_id,再按商品查询流水;
  列表展示变动数量与总数量/锁定数量/可用数量「前→后」;菜单兜底同步
- 新增入库单/出库单创建独立页,出库单列表与明细适配快递、运单号字段
- 外部仓库页新增仓库快递映射配置;发货单列表支持运单号展示,恢复时提示换号后的新单号
- 登录失效处理:区分登录页校验失败与登录态失效,提示后端返回的具体原因
2026-09-14 00:59:27 +08:00
liufumingren
39c19a4de7 feat(backend): 出入库记录与库存锁定链路、出库单快递/收件人与推送队列
- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单;
  库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量)
- 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列);
  恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」)
- 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段;
  推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务
- 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移
- 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
2026-09-14 00:59:23 +08:00
liufumingren
d54d7a1ea6 feat(frontend): 登录失效返回首页并自动同步续期 token
- 响应拦截器读取 X-Refresh-Token 响应头并更新本地 token(成功响应与 4xx/5xx 均同步)

- 401 不再弹窗等确认:清空 token 与所选主体后自动跳回首页,登录成功再回到首页;并发 401 只处理一次

- 跳转延后一个事件循环执行,避免在路由守卫导航过程中插入新导航
2026-09-13 15:41:32 +08:00
liufumingren
58e17190ea feat(backend): JWT 自动续期(剩余有效期不足阈值时响应头下发新 token)
- config.jwt 新增 renewThreshold(默认 1800s,0=关闭)与 renewHeader(默认 X-Refresh-Token)

- jwt_auth 中间件校验通过后计算 exp 剩余秒数,低于阈值则用同一套登录参数签发新 token 写入响应头

  响应头在 next() 之前设置,业务接口返回 4xx/5xx 时也会带上;同时下发 Access-Control-Expose-Headers 供跨域读取
2026-09-13 15:41:27 +08:00
liufumingren
0e100b9698 feat(frontend): 发货单批量操作弹窗与店铺下拉默认首项
- 表头「批量操作」下拉:批量审核(入推送队列)/ 批量推送仓库 / 切换发货仓库 / 设置所属店铺

  弹窗统一支持「已选中 N 条」或「当前筛选条件(忽略勾选)」,先预览影响范围再确认执行

- 状态列新增推送失败标记(悬浮显示原因);审核文案改为进入推送队列

- 店铺下拉默认命中第一个、不可清除、无店铺时禁用且禁止提交(创建页与编辑弹窗、批量设置店铺一致)

- api/orderDelivery.ts 补充批量接口、批量结果与店铺相关类型,筛选用 from_shop_id
2026-09-13 02:42:27 +08:00
liufumingren
77da5e1c69 feat(backend): 发货单批量操作与店铺必填/推送校验
- 新增批量审核 audit-batch、批量推送 push-batch、切换发货仓库 change-warehouse、设置所属店铺 change-shop

  统一由 _buildScope 解析范围(scope_by=ids 按勾选 / filter 按筛选条件),支持 dry_run 预览影响范围

- 手工单必须选店铺:create/update 必填且不允许清空、audit 校验、pushOne 无店铺直接跳过;shop_nick 为空时按 shop_id 兜底补齐并回写快照

- 修复范围解析与「目标店铺」字段重名导致命中 0 条:店铺筛选取 from_shop_id,changeShop 前剔除 shop_id

- 契约新增 changeDeliveryWarehouseRequest/changeDeliveryShopRequest/orderDeliveryBatchRequest 等,createOrderDeliveryRequest 的 warehouse_id/shop_id 改为必填
2026-09-13 02:42:23 +08:00
liufumingren
8ef79914f9 feat(backend): 订单明细模块(order_items)与订单店铺字段
- 订单明细控制器与模型(controller/model/orderItem.js)
- 迁移:创建 order_items 表、orders 增加 shop_id
- 说明:旧 orders/order_items 模块保留启用,发货单已改用 order_deliveries
2026-09-13 02:24:01 +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
liufumingren
0a9ee3c593 feat(backend): 对外通用回调接口 /openapi 与回调日志
- POST /openapi 入口(controller/openapi.js),协议与 WMS openapi 对齐(method/app_key/sign)
- 方法注册表 lib/openapiMethods.js:index.ping、entryorder.confirm/match、deliveryorder.confirm、stockout.confirm、order.cancel
- 单据处理公共逻辑 lib/orderCallback.js;请求/响应封装 lib/apiResponse.js、lib/openapiCallback.js
- WMS 回调入口 controller/wmsNotify.js 改为复用公共模块
- 回调日志:callback_logs 表 + lib/callbackLog.js(脱敏、fire-and-forget)
2026-09-13 02:23:49 +08:00
liufumingren
11e7b26ced feat(backend): 发货单模块与 WMS 定时推送队列
- 发货单主表/明细表(order_deliveries / order_delivery_items)控制器与模型
- 表头金额与明细派生字段重算(utils/recalcOrderDelivery.js)
- 状态流转:审核/驳回/取消/恢复/作废、批量审核、批量切换仓库
- 审核入队 + 定时推送:service/orderDeliveryPush.js(乐观锁 CAS 防重、失败重试上限 3 次、业务失败退回待审核)+ schedule/orderDeliveryPush.js
- 收件人 AI 智能识别(service/ai.js,DeepSeek)
- 相关迁移:建表、站内字段、明细表、订单类型默认值、快递字典、菜单种子、历史数据搬迁
2026-09-13 02:23:47 +08:00
liufumingren
ec81f8b3cd feat(backend): 入库单/出库单全流程与 WMS 对接
- 入库单、出库单控制器与模型(状态流转、审核、驳回换号、作废、删除约束)
- 明细共用 stock_items:应/已数量、行级库存类型 ZP/CC、明细锁定
- lib/wms:单据类型常量(orderTypes)、奇门/openapi 客户端(qimenClient)、签名(sign)
- 库存联动:utils/stock.js、utils/completeInbound.js(入库完成加库存,幂等)
- 驳回换号:utils/rejectBillNo.js;旧 orders 模块同步调整
- 相关迁移:入库单 WMS 字段/审核/推送结果、明细计划与实际数量、单据类型落 WMS 编码、出库库存扣减标记等
2026-09-13 02:23:44 +08:00
liufumingren
cbd16752a5 feat(backend): 商品、店铺、组合商品、仓库与库存模块
- 商品/商品图片、店铺、店铺商品、组合商品及明细
- 仓库、仓库商品(WMS itemId 映射)、仓库接口配置与字段定义(warehouseApi/warehouseApiField)
- 库存:stock_items、product_stocks(ZC/CC 双维度)与库存重算工具(utils/recalcStock.js)
- 库存单据与对接日志:stock orders、api_outbound_logs
- 相关迁移:shops/shop_products/stock_orders/warehouses/warehouse_apis/warehouse_products/product_stocks/files-images 等表与字段
2026-09-13 02:23:39 +08:00
liufumingren
8597cf5ac9 feat(backend): 用户鉴权、菜单权限、主体与系统基础模块
- 登录/邮箱验证码/密码流程(controller/auth.js、lib/emailCode.js、middleware/jwt_auth.js)
- 主体(principal)隔离与主体用户、对外接口配置模块及 principalCheck 中间件
- 菜单、用户、文件上传、快递公司字典(express_companies)等基础模块
- 通用工具:分页(lib/pagination.js)、缓存(service/cache.js)
- 全量接口契约(contract/index.js)与路由注册(router.js)、config.default.js 配置
- 相关迁移:菜单组件调整与菜单种子、创建 files 表
2026-09-13 02:23:34 +08:00
liufumingren
b246cd44ec chore: 忽略本地开发运行日志与上传目录
- .gitignore 增加 .dev.err/.dev.out/*.dev.err/*.dev.out/boot*.err/fdev.err 规则
- 停止跟踪 backend/.dev.err(运行时错误转储,不应入库)
2026-09-13 02:22:53 +08:00
liufumingren
b1f90b1c15 refactor: relocate backend into backend/ directory 2026-09-09 20:00:54 +08:00
liufumingren
7fc414e06f chore: init Egg.js OMS backend with sequelize, redis, swagger and eslint 2026-09-09 15:58:56 +08:00