A(查询机)和 B(仓库)不同网络、B 无公网 IP。B 出站领任务后把成片传回云端中转, A 再从云端取回本地 —— 全程不需要任何一方有公网入口。 云端 - POST /api/web/edge/download 建任务(按主体选在线设备 → 下发 download) - GET /api/web/edge/download/:id 查进度(queued/uploading/done/failed) - GET /api/web/edge/download/:id/file 取成片,支持 Range(浏览器播放要拖动进度条) - POST /api/scanner/tasks/:id/upload 设备分片上传(原始字节流,不是 base64) - bodyParser 对该上传路由禁用:否则原始请求体会被解析掉 - 成片落 run/edge-files(run/ 属部署保留目录,不会被发布覆盖) - 每次建任务顺手清理过期文件;元数据按主体校验,越权一律 404 桌面端 - AgentHost 新增 download 任务执行:worker 拉流合并 → 分片上传 → 传完删本地临时文件 - 失败时把 uploadTaskId 带回云端,立刻落 failed,查询机不用干等到超时 - ApiClient 新增建任务 / 查状态 / 取文件 / 分片上传 - PlaybackDownloadService 改为三级选路: LAN 设备管理服务 → 云端中转 → 本机直连 实测(真实 NVR) 建任务 → 设备拉流 1.9MB → 上传 → 下载:7.5 秒,字节数一致,ftypisom Range: bytes=0-99 → HTTP 206 + Content-Range 正确 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
224 lines
16 KiB
JavaScript
224 lines
16 KiB
JavaScript
'use strict';
|
||
|
||
/**
|
||
* 路由定义
|
||
* @param {Egg.Application} app - egg application
|
||
*/
|
||
module.exports = (app) => {
|
||
const { router, controller, middleware } = app;
|
||
const apiAuth = middleware.apiAuth();
|
||
const subjectAuth = middleware.subjectAuth();
|
||
const subjectAdmin = middleware.subjectAdmin();
|
||
const subjectActive = middleware.subjectActive();
|
||
const internalAuth = middleware.internalAuth();
|
||
const scannerAuth = middleware.scannerAuth();
|
||
|
||
// ==================== JSON 接口 ====================
|
||
// 控制器按「谁在调」分模块(app/controller/<模块>/):
|
||
// web/ 前端 SPA(用户端,toC:用户自己管自己的设备/记录)—— header 令牌(user JWT)
|
||
// device/ 设备(长期 JWT,typ=scanner)
|
||
// auth/ 公开的登录码接口(发码/查码/确认)
|
||
// internal/ 运维/内部(用户与配置的 CRUD)—— 需内部令牌
|
||
// home / health 放在根(公共)
|
||
//
|
||
// ⚠️ 后端**不再渲染任何页面**:`/` 这一侧由 app/middleware/frontend.js 处理
|
||
// (开发时反代到前端 dev server,生产时托管 frontend/dist)。
|
||
router.get('/api/info', controller.home.index);
|
||
router.get('/health', controller.health.index);
|
||
|
||
// ---------- 安装包分发(软件自动更新) ----------
|
||
// 安装包本体由 egg-static 提供(config.static):
|
||
// 桌面端 `GET /download/desktop/YuncangTraceSetup-x.y.z.msi`
|
||
// Android `GET /download/android_client/YuncangScan-x.y.z.apk`
|
||
// version.json **必须走路由**:static 命中后不会 next(),改不了缓存头(会被缓存一年)。
|
||
router.get('/download/version.json', controller.download.version);
|
||
router.get('/download/android_client/version.json', controller.download.androidVersion);
|
||
|
||
// ---------- 协议(公开读取;同意记录在登录时落库) ----------
|
||
router.get('/api/agreements/current', controller.agreement.current);
|
||
|
||
// ---------- web 用户端(前端 SPA 调;登录/注册等公开,其余要令牌) ----------
|
||
router.post('/api/web/auth/login', controller.web.auth.login);
|
||
router.post('/api/web/auth/register/code', controller.web.auth.sendRegisterCode);
|
||
router.post('/api/web/auth/register', controller.web.auth.register);
|
||
router.post('/api/web/auth/forgot', controller.web.auth.forgot);
|
||
router.post('/api/web/auth/reset', controller.web.auth.reset);
|
||
|
||
// ---------- 微信小程序登录(code2Session → openid → 绑定/新建平台账号) ----------
|
||
router.post('/api/web/auth/wechat/login', controller.web.wechatMp.login);
|
||
router.post('/api/web/auth/wechat/bind', apiAuth, controller.web.wechatMp.bind);
|
||
router.get('/api/web/auth/wechat/bindings', apiAuth, controller.web.wechatMp.bindings);
|
||
router.delete('/api/web/auth/wechat/bindings/:id', apiAuth, controller.web.wechatMp.unbind);
|
||
|
||
router.get('/api/web/me', apiAuth, controller.web.profile.show);
|
||
router.put('/api/web/me', apiAuth, controller.web.profile.update);
|
||
router.put('/api/web/me/password', apiAuth, controller.web.profile.changePassword);
|
||
|
||
// ---------- 主体(租户):不输主体 id,靠「当前用户是否是成员」判定 ----------
|
||
// 除这几个以外的业务接口都要额外带 `X-Subject-Id`(middleware/subjectAuth)
|
||
router.get('/api/web/subjects', apiAuth, controller.web.subject.index);
|
||
router.post('/api/web/subjects', apiAuth, controller.web.subject.create);
|
||
router.get('/api/web/subjects/:id', apiAuth, controller.web.subject.show);
|
||
router.put('/api/web/subjects/:id', apiAuth, controller.web.subject.update);
|
||
router.get('/api/web/subjects/:id/members', apiAuth, controller.web.subject.members);
|
||
router.post('/api/web/subjects/:id/members', apiAuth, controller.web.subject.addMember);
|
||
router.delete('/api/web/subjects/:id/members/:memberId', apiAuth, controller.web.subject.removeMember);
|
||
// 设/取消管理员(一个主体可多名管理员;创建者恒为管理员,不能降级)
|
||
router.put('/api/web/subjects/:id/members/:memberId/role', apiAuth, controller.web.subject.updateMemberRole);
|
||
// 给未绑定账号/微信的成员生成绑定码(手机扫码后绑定)
|
||
router.post('/api/web/subjects/:id/members/:memberId/bind-code', apiAuth, controller.web.subject.memberBindCode);
|
||
|
||
// 续期订单:选套餐下单不改变期限,支付结果由渠道回调 `POST /api/pay/notify` 驱动
|
||
// ⚠️ 不挂 subjectAuth:主体已过期也要能下单续期
|
||
router.get('/api/web/subject-plans', apiAuth, controller.web.subjectPlan.index);
|
||
router.get('/api/web/subjects/:id/orders', apiAuth, controller.web.subjectOrder.index);
|
||
router.post('/api/web/subjects/:id/orders', apiAuth, controller.web.subjectOrder.create);
|
||
router.get('/api/web/subjects/:id/orders/:orderNo', apiAuth, controller.web.subjectOrder.show);
|
||
router.post('/api/web/subjects/:id/orders/:orderNo/close', apiAuth, controller.web.subjectOrder.close);
|
||
|
||
// 成员绑定:手机扫码页(公开查状态)+ 登录后确认绑定
|
||
router.get('/api/subject/member-bind', controller.auth.memberBind.status);
|
||
router.post('/api/subject/member-bind/confirm', apiAuth, controller.auth.memberBind.confirm);
|
||
|
||
// 首页统计(只统计当前主体的数据)
|
||
router.get('/api/web/stats', apiAuth, subjectAuth, controller.web.stats.index);
|
||
|
||
// 本主体设备:列表 / 详情 / 通道 / 解绑 / 删除(越权访问一律 404)
|
||
// ⚠️ 业务数据(设备 / 录像机 / 摄像头 / 工作台 / 扫码记录)**只有主体管理员能看**,
|
||
// 普通成员访问一律 403(subjectAdmin),前端菜单也同步隐藏
|
||
// ⚠️ /devices/active 与 /devices/activate 必须在 /devices/:id 之前
|
||
router.get('/api/web/devices', apiAuth, subjectAuth, subjectAdmin, controller.web.device.index);
|
||
router.get('/api/web/devices/active', apiAuth, subjectAuth, subjectAdmin, controller.web.device.active);
|
||
router.post('/api/web/devices/activate', apiAuth, subjectAuth, subjectAdmin, controller.web.device.activate);
|
||
router.get('/api/web/devices/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.device.show);
|
||
router.get('/api/web/devices/:id/channels', apiAuth, subjectAuth, subjectAdmin, controller.web.device.channels);
|
||
router.post('/api/web/devices/:id/unbind', apiAuth, subjectAuth, subjectAdmin, controller.web.device.unbind);
|
||
router.post('/api/web/devices/:id/logout', apiAuth, subjectAuth, subjectAdmin, controller.web.device.logout);
|
||
router.delete('/api/web/devices/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.device.destroy);
|
||
|
||
// 本主体扫码记录(范围限定在当前主体的设备;仅主体管理员)
|
||
router.get('/api/web/records', apiAuth, subjectAuth, subjectAdmin, controller.web.record.index);
|
||
|
||
// 运单回放查询:运单号 → 当时的工位快照(录像机/摄像头/布局)+ 要拉的回放区间
|
||
// 桌面端拿到后按 streams 去各 NVR 拉那段录像(凭据走 /api/web/nvrs/:id/credential)
|
||
// ⚠️ 这个不挂 subjectAdmin:它是打包工位的日常查询入口,普通成员也要能用
|
||
router.get('/api/web/pack-query', apiAuth, subjectAuth, controller.web.pack.query);
|
||
|
||
// 边缘能力:查询机在局域网找不到「设备管理服务」时,来这里问云端
|
||
// (云端转给打包仓库那台扫码服务,由它真拉一段确认有没有录像)
|
||
router.post('/api/web/edge/check', apiAuth, subjectAuth, controller.web.edge.check);
|
||
// 跨网下载:创建任务 → 查进度 → 取成片(支持 Range)
|
||
router.post('/api/web/edge/download', apiAuth, subjectAuth, controller.web.edge.download);
|
||
router.get('/api/web/edge/download/:taskId', apiAuth, subjectAuth, controller.web.edge.downloadStatus);
|
||
router.get('/api/web/edge/download/:taskId/file', apiAuth, subjectAuth, controller.web.edge.downloadFile);
|
||
|
||
// ---------- 视频接入:NVR / 摄像头 / 工作台(只碰本主体的数据;仅主体管理员)----------
|
||
// 拉取通道 = 前端调本机软件(localhost:17300/api/hik/channels)→ 勾选 → POST /nvrs/:id/channels 落库
|
||
router.get('/api/web/nvrs', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.index);
|
||
router.post('/api/web/nvrs', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.create);
|
||
router.get('/api/web/nvrs/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.show);
|
||
router.put('/api/web/nvrs/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.update);
|
||
router.delete('/api/web/nvrs/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.destroy);
|
||
router.get('/api/web/nvrs/:id/channels', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.cameras);
|
||
router.post('/api/web/nvrs/:id/channels', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.syncChannels);
|
||
router.get('/api/web/nvrs/:id/credential', apiAuth, subjectAuth, subjectAdmin, controller.web.nvr.credential);
|
||
|
||
// 摄像头:/options、/batch-delete 必须在 /:id 之前注册,否则会被当成 id
|
||
router.get('/api/web/cameras/options', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.options);
|
||
router.post('/api/web/cameras/batch-delete', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.batchDestroy);
|
||
router.get('/api/web/cameras', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.index);
|
||
router.get('/api/web/cameras/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.show);
|
||
router.put('/api/web/cameras/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.update);
|
||
router.delete('/api/web/cameras/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.camera.destroy);
|
||
|
||
// 工作台:CRUD + 绑定摄像头 + 绑定扫码通道
|
||
router.get('/api/web/workstation-scan-channels', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.availableScanChannels);
|
||
router.get('/api/web/workstations', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.index);
|
||
router.post('/api/web/workstations', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.create);
|
||
router.get('/api/web/workstations/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.show);
|
||
router.put('/api/web/workstations/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.update);
|
||
router.delete('/api/web/workstations/:id', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.destroy);
|
||
router.post('/api/web/workstations/:id/cameras', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.bindCameras);
|
||
router.delete('/api/web/workstations/:id/cameras/:cameraId', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.unbindCamera);
|
||
// 合成画面布局(拖拽/缩放后保存)
|
||
router.put('/api/web/workstations/:id/cameras/:cameraId/layout', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.updateCameraLayout);
|
||
router.post('/api/web/workstations/:id/scan-channels', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.bindScanChannels);
|
||
router.delete('/api/web/workstations/:id/scan-channels/:linkId', apiAuth, subjectAuth, subjectAdmin, controller.web.workstation.unbindScanChannel);
|
||
|
||
// 前端「测试页」的模拟接口(模拟设备扫码登录 / 模拟中控上报),与真机走同一套 service
|
||
// 只在非生产环境注册:生产不暴露模拟链路
|
||
if (app.config.env !== 'prod') {
|
||
router.post('/api/web/test/device-login', apiAuth, subjectAuth, controller.web.test.deviceLogin);
|
||
router.post('/api/web/test/scan', apiAuth, subjectAuth, controller.web.test.scan);
|
||
}
|
||
|
||
// ---------- 运维/内部(脚本、后台系统;**需内部令牌**,见 middleware/internal_auth.js)----------
|
||
router.get('/api/users', internalAuth, controller.internal.user.index);
|
||
router.get('/api/users/:id', internalAuth, controller.internal.user.show);
|
||
router.post('/api/users', internalAuth, controller.internal.user.create);
|
||
router.put('/api/users/:id', internalAuth, controller.internal.user.update);
|
||
router.delete('/api/users/:id', internalAuth, controller.internal.user.destroy);
|
||
|
||
// 微信授权(绑定关系)
|
||
router.get('/api/users/:id/wechats', internalAuth, controller.internal.wechat.indexByUser);
|
||
router.get('/api/wechat/:appid/:openid', internalAuth, controller.internal.wechat.show);
|
||
router.post('/api/wechat/bind', internalAuth, controller.internal.wechat.bind);
|
||
router.put('/api/wechat/:id/tokens', internalAuth, controller.internal.wechat.updateTokens);
|
||
router.delete('/api/wechat/:id', internalAuth, controller.internal.wechat.unbind);
|
||
|
||
// 系统配置(读接口带 Redis 缓存,写接口自动失效)
|
||
router.get('/api/configs', internalAuth, controller.internal.config.index);
|
||
router.put('/api/configs', internalAuth, controller.internal.config.upsert);
|
||
router.get('/api/configs/:group', internalAuth, controller.internal.config.showGroup);
|
||
router.get('/api/configs/:group/:key', internalAuth, controller.internal.config.show);
|
||
router.delete('/api/configs/:group/:key', internalAuth, controller.internal.config.destroy);
|
||
|
||
// 设备管理(运维视角:可看/可管所有人的设备):绑定 / 解绑 / 列表 / 删除
|
||
router.post('/api/scanner/bind', internalAuth, controller.internal.device.bind);
|
||
router.post('/api/scanner/unbind', internalAuth, controller.internal.device.unbind);
|
||
router.get('/api/scanners', internalAuth, controller.internal.device.index);
|
||
router.get('/api/scanners/:id', internalAuth, controller.internal.device.show);
|
||
router.delete('/api/scanners/:id', internalAuth, controller.internal.device.destroy);
|
||
|
||
// ---------- 支付渠道通知(公开,签名见 config.pay)----------
|
||
// 渠道接入前用它可以模拟「已付款」:{ orderNo, transactionId, amount } → 续期
|
||
router.post('/api/pay/notify', controller.pay.notify.index);
|
||
|
||
// 运维模拟支付(内部令牌,不需要渠道签名)
|
||
router.post('/api/internal/subject-orders/:orderNo/pay', internalAuth, controller.internal.subjectOrder.pay);
|
||
|
||
// ---------- 公开的登录接口(auth)----------
|
||
// 登录码二维码(SVG,本地生成;前端登录页直接 img 引用)
|
||
router.get('/api/wechat/qrcode.svg', controller.auth.wechat.qrcode);
|
||
// 同一张二维码的 GIF 版(桌面端 WPF 不能渲染 SVG)
|
||
router.get('/api/wechat/qrcode.gif', controller.auth.wechat.qrcodeGif);
|
||
// 扫码登录(前端/客户端接口):不带参数发串码,带 ?code=&wait= 长轮询并拿用户 JWT
|
||
router.get('/api/wechat/login', controller.auth.wechat.login);
|
||
// 查登录码状态(无需登录)
|
||
router.get('/api/wechat/status', controller.auth.wechat.status);
|
||
// 微信公众号网页授权回调(微信把手机浏览器重定向到这里,处理完再转回前端 /wechat 页)
|
||
router.get('/api/wechat/callback', controller.auth.wechat.callback);
|
||
// 设备发码 + 长轮询:**这一步才注册/绑定**并直接拿到长期 JWT(发码不需要任何凭据)
|
||
router.get('/api/device/login', controller.device.auth.login);
|
||
// 刷新访问令牌:凭据是刷新令牌本身(访问令牌可能已过期,所以不能挂 scannerAuth)
|
||
router.post('/api/device/refresh', controller.device.auth.refresh);
|
||
|
||
// ---------- 用户态(client):小程序 / Win 客户端 / SPA ----------
|
||
// 用登录码触发登录(**不认 cookie**:header 带 Authorization: Bearer <user JWT> 就行)
|
||
router.post('/api/wechat/confirm', apiAuth, controller.client.wechat.confirm);
|
||
|
||
// ---------- 设备态(device):需长期 JWT ----------
|
||
router.get('/api/scanner/me', scannerAuth, controller.device.self.me);
|
||
router.post('/api/scanner/heartbeat', scannerAuth, controller.device.self.heartbeat);
|
||
// 边缘任务通道:设备主动出站领任务(跨公司取流用,云端从不反向连设备)
|
||
router.post('/api/scanner/tasks/poll', scannerAuth, controller.device.edge.poll);
|
||
router.post('/api/scanner/tasks/:id/result', scannerAuth, controller.device.edge.result);
|
||
// 成片分片上传(原始字节流,bodyParser 已在 config 里对该路由禁用)
|
||
router.post('/api/scanner/tasks/:id/upload', scannerAuth, controller.device.edge.upload);
|
||
// 上报(写)额外检查主体是否过期/停用:过期后返回 403 subject_expired,设备暂停推送并靠心跳探测续期
|
||
router.post('/api/scan/channels', scannerAuth, subjectActive, controller.device.scan.reportChannels);
|
||
router.get('/api/scan/channels', scannerAuth, controller.device.scan.channels);
|
||
router.post('/api/scan/records', scannerAuth, subjectActive, controller.device.scan.reportRecords);
|
||
router.get('/api/scan/records', scannerAuth, controller.device.scan.records);
|
||
};
|