'use strict'; const { Controller } = require('egg'); /** * 设备态:边缘任务通道(**需长期设备 JWT**) * * 打包仓库的扫码服务没有公网 IP,只能自己出站来领任务: * - `POST /api/scanner/tasks/poll?wait=25`:没有任务就挂住,有任务立刻返回; * - `POST /api/scanner/tasks/:id/result`:回执行结果。 * * 云端从不主动连设备 —— 这也正是跨公司场景能成立的原因。 */ class DeviceEdgeController extends Controller { /** * 领任务(长轮询) * * 返回 204 表示这段时间没有任务,客户端立刻再发起下一次即可。 */ async poll() { const { ctx } = this; const scanner = ctx.state.scanner; // 上限 25 秒:比心跳间隔短,也能避开大多数反代的读超时(默认 60s) const wait = Math.min(Math.max(Number(ctx.query.wait) || 25, 1), 25); const task = await ctx.service.edgeTask.poll(scanner.id, wait * 1000); if (!task) { ctx.status = 204; return; } ctx.logger.info('[edge] 设备 %s 领取任务 %s(%s)', scanner.sn, task.id, task.type); ctx.body = { ok: true, data: task }; } /** * 回任务结果 * * body: `{ ok: true, ... }` 或 `{ ok: false, error: '...' }` */ async result() { const { ctx } = this; const id = String(ctx.params.id || '').trim(); if (!id) ctx.throw(400, '缺少任务 id'); const body = ctx.request.body || {}; await ctx.service.edgeTask.submitResult(id, body); // 跨网下载失败时,设备把 uploadTaskId 带回来 —— 立刻落 failed, // 查询机不用干等到超时。 if (body.ok === false && body.uploadTaskId) { await ctx.service.edgeTask.markFailed(String(body.uploadTaskId), body.error || '设备下载失败'); } ctx.logger.info('[edge] 设备 %s 回任务 %s:ok=%s', ctx.state.scanner.sn, id, body.ok); ctx.body = { ok: true }; } /** * 上传成片分片(跨网下载用) * * `POST /api/scanner/tasks/:id/upload?last=0|1`,body 是**原始字节**。 * 用原始流而不是 JSON/base64:几 MB 的分片做 base64 会膨胀 33%,没有意义。 * 该路由已在 config.bodyParser.ignore 里排除,所以这里直接读 `ctx.req`。 * * ⚠️ 分片必须按顺序追加(设备侧是顺序读文件的),不校验 seq 是为了少一次往返。 */ async upload() { const { ctx } = this; const id = String(ctx.params.id || '').trim(); if (!id) ctx.throw(400, '缺少任务 id'); const last = String(ctx.query.last || '0') === '1'; try { const meta = await ctx.service.edgeTask.appendChunk(id, ctx.req, { last }); ctx.body = { ok: true, data: { size: meta.size, state: meta.state } }; } catch (err) { ctx.logger.warn('[edge] 上传分片失败 %s:%s', id, err.message); // 上传失败要落状态,否则查询机要白等两分钟 await ctx.service.edgeTask.markFailed(id, err.message); ctx.throw(500, `上传失败:${err.message}`); } } } module.exports = DeviceEdgeController;