diff --git a/README.md b/README.md index 4de5244..8ff4646 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,16 @@ # 云仓视频溯源系统 -前后端分离 + 一个浏览器扩展 + 一个 Windows 本机软件(WPF)+ 一个 Android 设备端,五个目录: +前后端分离 + 一个浏览器扩展 + 一个 Windows 本机软件(WPF)+ 一个 Android 设备端 + 一个手机网页: ``` packService/ ├── backend/ # Egg.js 3(纯 API;MySQL + Redis) ├── frontend/ # Vite + Vue3 + TypeScript(用户端 SPA) -├── extension/ # Chrome MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 +├── extension/ # Chrome/Edge MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 ├── desktop/ # WPF 本机软件:HTTP 16000(查询/唤起/下载)+ WS 16001(拉通道/预览/云台)+ yuncang:// 启动协议 -└── AndroidStation/ # Android 设备端:UDP 48899 被桌面端发现 + TCP 8087 推送 USB 扫码结果 +├── AndroidStation/ # Android 设备端:UDP 48899 被桌面端发现 + TCP 8087 推送 USB 扫码结果 +├── mobile-web/ # 手机网页(Vue3 + WeUI):登录 / 首页 / 我的,独立工程(还没接入发布流程) +└── tools/ # 现场排查脚本:scan-web-viewer.ps1(按网页标题扫局域网 80 端口) ``` ## 端口约定(⚠️ 本机项目多,不要用 Vite 默认的 5173) @@ -18,10 +20,14 @@ packService/ | 前端 dev(Vite) | **7301** | `cd frontend && npm run dev` | | 前端 preview(dist) | **7302** | `cd frontend && npm run preview` | | 后端 dev | **7300** | `cd backend && npm run dev` | +| 手机网页 dev | **7303** | `cd mobile-web && npm run dev` | +| 手机网页 preview | **7304** | `cd mobile-web && npm run preview` | | 本机软件(WPF,只监听 loopback) | **16000**(HTTP)/ **16001**(WebSocket) | `cd desktop && dotnet run`(详见 [`desktop/README.md`](desktop/README.md)) | +| 后台服务(Windows 服务,局域网) | **16100**(UDP 发现)/ **16101**(TCP 取流) | 随桌面端安装,`YUNCANG_EDGE_UDP_PORT` / `YUNCANG_EDGE_HTTP_PORT` 可覆盖 | | 扩展自测页(可选) | **7310** | `npx --yes http-server extension/test -p 7310` | -- 前端端口可用 `VITE_PORT=7303 npm run dev` 覆盖;`strictPort: true` → 端口被占用时**直接报错**,不会偷偷换端口(否则代理会对不上)。 +- 前端端口可用 `VITE_PORT=7311 npm run dev` 覆盖;`strictPort: true` → 端口被占用时**直接报错**,不会偷偷换端口(否则代理会对不上)。 +- 手机网页端口可用 `VITE_MOBILE_PORT` / `VITE_MOBILE_PREVIEW_PORT` 覆盖,`/api` 同样反代到 `127.0.0.1:7300`。 - 后端端口可用 `PORT=7400 npm run dev` 覆盖(默认 **7300**,配置在 `backend/config/config.default.js` 的 `config.cluster.listen.port`)。 - 前端调接口走**同源代理**:Vite 把 `/api`、`/health` 反代到后端(默认 `127.0.0.1:7300`,用 `VITE_BACKEND` 覆盖)。 - 联调更方便的做法:直接开后端 `:7300`,由后端(dev)把 `/` 反代到前端 dev server(`FRONTEND_DEV_SERVER`,默认 `http://127.0.0.1:7301`)。 @@ -38,7 +44,7 @@ packService/ | --- | --- | --- | | 前端 SPA(用户端,toC:用户只管自己的设备/记录) | `Authorization: Bearer `(typ=user) | `/api/web/*`(登录/资料/设备/记录) | | 设备(扫描枪、中控) | `Authorization: Bearer `(typ=scanner) | `/api/device/login`、`/api/scanner/*`、`/api/scan/*` | -| 公开 | 无 | `/api/wechat-gateway/notify`(网关回调,**靠签名**)、`/api/wechat-gateway/qrcode.{svg,gif}`、`/api/wechat/{status,qrcode.svg}`(设备扫码登录的登录码)、`/api/web/auth/*` | +| 公开 | 无 | `/api/wechat-gateway/notify`(网关回调,**靠签名**)、`/api/pay/wechat/notify`(微信支付回调,**靠 APIv2 验签**)、`/api/wechat-gateway/qrcode.{svg,gif}`、`/api/wechat/{status,qrcode.svg}`(设备扫码登录的登录码)、`/api/web/auth/*` | 扫码登入用到的 `WX_GATEWAY_*` 只配在**服务端**(appSecret 绝不能进前端/二维码):服务端申请二维码、验签收网关回调, 前端只负责显示二维码和长轮询结果。 @@ -50,7 +56,7 @@ packService/ - [x] 目录拆分为 `backend/` + `frontend/` - [x] 前端脚手架(Vite + Vue3 + TS)跑通,登录页走通 `/api/web/auth/*` -- [x] 浏览器扩展 `extension/`(MV3,零构建):注入第三方 WMS 页面,在运单号**旁边**渲染「查看打包视频」按钮 → 点按钮打开溯源页 +- [x] 浏览器扩展 `extension/`(MV3,**源码零构建**;分发用 esbuild 压缩产物 `extension/dist`,不合并文件):注入第三方 WMS 页面,在运单号**旁边**渲染「查看打包视频」按钮 → 点按钮打开溯源页 - [x] **后端去掉服务端渲染**:删除 `app/controller/page/`、`app/view/`、`app/lib/page.js`、nunjucks / session / CSRF 配置与依赖,后端只剩 JSON 接口 - [x] 页面全部迁移到前端:登录 / 注册 / 找回密码 / 扫码 / 扫码确认 / 首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页(仅开发构建,生产不打包) - [x] 后端 dev 反代前端(`app/middleware/frontend.js`);生产由 nginx 直接托管前端构建产物(Egg 只提供 API) @@ -93,7 +99,25 @@ packService/ - [x] **工作台 OSD 字幕(2026-11-01)**:设备服务按工作台把「摄像头名 + 运单号」写进每路摄像头的 OSD (= 录像机通道名,录像/回放都带);运单号没变不重写,连续 60 秒没扫到还原成摄像头名; 配置由 GET /api/scanner/workstations 下发(详见 [desktop/README.md](desktop/README.md) 的「工作台 OSD 字幕」) -- [ ] 扩展:目标地址换成真实打包视频页(现在指向百度占位)—— 在扩展「设置」里改「目标地址模板」即可,需要真实地址 +- [x] **扩展上架 Edge 应用商店(2026-11-01)**:拓展走商店分发(桌面端菜单一键打开商店页), + Chrome 用「复制插件路径 + 开发者模式」;**企业策略强制安装已下线**(老机器残留的 HKLM 策略需手工清理) +- [x] **手机网页 `mobile-web/`(2026-11-01)**:独立的 Vue3 + WeUI 手机端(登录 / 首页 / 我的), + 接口反代到后端 7300;目前只在本地开发,没有接入发布流程 +- [x] **微信 Native 扫码支付(2026-11-07)**:续期下单直接出微信二维码(服务端本地生成 SVG,不跳外部收银台), + 前端按 2 秒轮询支付结果;同主体 + 同套餐复用未超时待支付单,回调 / 查单 / 手工确认统一走 `payNotify`; + 凭证 `WXPAY_APP_ID` / `WXPAY_MCH_ID` / `WXPAY_API_KEY` 只配服务端,缺任意一项 = 未开通(详见 [`backend/README.md`](backend/README.md)) +- [x] **工作台多路面单摄像头(2026-11-08)**:一台工作台可绑多路面单摄像头,识别配置按「工作台 + 摄像头」逐路下发、 + 多路共用上报通道;绑定管理新增画布尺寸(宽×高)编辑,已摆放的摄像头按比例缩放 +- [x] **面单多码同框(2026-11-10)**:一帧里的候选全部解码(两张面单并排不再只报旧码), + 新增条码历史(最多 4 个)判断「新码 / 最后出现」,一直看得见的码不重排、离开 45 秒再回来才算新码 +- [x] **NVR 唯一性按主体(2026-11-16)**:唯一键从全局 `(host, port, username)` 改为 `(subject_id, host, port, username)`, + 不同仓库内网地址相同时不再互相顶掉 +- [x] **回放合并提速 + 硬件编码(2026-11-17)**:链式 `overlay` 改为一条 `xstack` 一次合成(同画质、耗时约 -35%), + 编码优先 h264_qsv / nvenc / amf,失败自动回落 libx264(详见 [desktop/README.md](desktop/README.md)) +- [x] **端口迁出 173xx(2026-11-18)**:本机服务 17300/17301 → **16000/16001**, + 后台服务局域网 17310/17311 → **16100/16101**(16010 被向日葵占用,统一避开 160xx); + 前端、扩展、安装包同步,安装/升级时自动清理旧防火墙规则 +- [x] 扩展默认目标地址已切到线上 `https://pack.wms.gztbyc.com/local?code={code}`(可在扩展「设置」里改「目标地址模板」) 后端接口细节见 [`backend/README.md`](backend/README.md),扩展用法见 [`extension/README.md`](extension/README.md)。 @@ -149,5 +173,9 @@ npm run build # typecheck + vite build(产物 dist/,发布时由 nginx | `VITE_PORT` / `VITE_BACKEND` | `7301` / `http://127.0.0.1:7300` | 前端 dev 端口 / 代理目标 | | `WX_GATEWAY_BASE` | `https://gateway.gztbyc.com` | 微信登录网关地址 | | `WX_GATEWAY_APP_KEY` / `WX_GATEWAY_APP_SECRET` | 空 | 网关应用的 appKey / appSecret(**只配服务端**);不配则扫码相关接口返回 503 | +| `WXPAY_ENABLED` | `true` | 微信 Native 支付的开关(`false` 时仍可建单,只是不出二维码) | +| `WXPAY_APP_ID` / `WXPAY_MCH_ID` / `WXPAY_API_KEY` | 空 | 微信支付凭证(**只配服务端**);缺任意一项 = 未开通 | +| `WXPAY_NOTIFY_URL` | 空 | 支付回调地址(公网 HTTPS,不带参数);不配则用 `SITE_URL/api/pay/wechat/notify` | +| `PAY_ORDER_TTL` | `7200` | 待支付订单有效期(秒),超时自动关单 | > ⚠️ 运维接口的默认白名单是**内置管理员(id=1)**:上线前请配 `INTERNAL_TOKEN`,或把真正的管理员 id 写进 `INTERNAL_ADMIN_IDS`。 diff --git a/desktop/README.md b/desktop/README.md index 5037e43..cdaf8b6 100644 --- a/desktop/README.md +++ b/desktop/README.md @@ -163,8 +163,6 @@ dotnet publish -c Release -r win-x64 -p:ServerBaseUrl=https://trace.example.com ## 构建 / 运行 / 发布 -## 构建 / 运行 / 发布 - ```powershell cd desktop @@ -406,6 +404,11 @@ cd desktop\installer | **16000** | HTTP | 运单查询 / 唤起登录 / 按运单下载录像(低频、无状态) | | **16001** | WebSocket | 拉通道 / 实时预览(推 JPEG 帧)/ 云台 / 满帧率窗口(预览相关全在这里) | +> 另外**后台服务**(`--service` 身份,含 `--hik-worker` 子进程)在局域网上开两个端口: +> **16100/UDP**(收桌面端的发现询问、回 `edge.reply`)和 **16101/TCP**(取流健康端点 `/health` 与跨网取流), +> 只对同主体、同后端的询问作答。可用 `YUNCANG_EDGE_UDP_PORT` / `YUNCANG_EDGE_HTTP_PORT` 覆盖, +> 装/卸载服务时自动增删对应防火墙规则。**不要用 16010** —— 它经常被向日葵(AweSun)等远控软件占用。 + ### HTTP 16000(前端 `/local` 页用的就是这两个) 服务固定监听 `http://localhost:16000`(端口写在前端页面与插件里)。