扫码上报静默窗口从 5 分钟改成 5 秒
有积压时上报循环每秒检查一次(空闲仍 30 秒保活),保证「最后一次扫描 + 5 秒」就能上报;时间被刷新则重新计时并再次上报。 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
ed063db9f4
commit
b135ef09d4
@ -723,8 +723,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
|
||||
| 假死看门狗 | `ScanService.WatchdogLoopAsync` | 每 30s:连接看着在线但 **60s 没字节** → 回查设备侧 `SOCK.ClientIP`(CID 10001 才有)→ 本机 IP 不在里面就强制重连(设备断电重启时 TCP 不发 FIN,`ReadAsync` 会永久挂住) |
|
||||
| IP 变化 | `ScanService.ApplyDiscoveredIps` | 每次发现结果回来就刷新各通道 `LastIp`,变了立即用新地址重连(DHCP 续租后不会卡在旧 IP) || 通道配置 | `Services/Scan/ChannelStore.cs` | `%LOCALAPPDATA%\YuncangTrace\channels.json`(服务模式:`%ProgramData%\YuncangTrace\channels.json`),通道号取最小空号、删除后不复用;**不再有团购/散单字段**(团散在「工作台」区分) |
|
||||
| 编排 | `Services/Scan/ScanService.cs` | 启动→连接**全部**通道(没有启用/停用开关,加了就连);**通道一旦变动(增/删/改名)自动同步到服务器**:`POST /api/scan/channels`(增删带 `replace: true`,全量对账;改名只是更新名称)→ `GET /api/scan/channels` 回查确认 → 缺了就退避重试(1s→30s)直到服务器真的有;**删除通道会让服务器软删该通道并解绑工作台**(`removed` / `unbound`),删到 0 个也会推空列表 |
|
||||
| 扫码记录 | `Services/Scan/ScanRecordStore.cs` | `%LOCALAPPDATA%\YuncangTrace\scan-records.json`(服务模式:`%ProgramData%\YuncangTrace\scan-records.json`),每个通道最多 5000 条;**先落本地、服务器确认后才标「已上传」**,没确认的一直重试,断网不丢;连续扫描只刷新「最近一次扫到的时间」;**扫到后 5 分钟没再扫到同一个码才上报**,上报的就是最后一次扫描时间;同一运单 24 小时内再次扫到会**重新激活同一条本地记录**(不新增行),下一轮上报覆盖服务器记录 |
|
||||
| 上报队列 | `Services/DeviceService.cs` | 条码静默满 5 分钟后后台攒批(50 条/批)推 `POST /api/scan/records`,失败不标记、指数退避重发(服务端按 设备+通道+条码+秒 精确去重;**同一运单 24 小时内只保留一条,后上报的新时间会覆盖旧记录的时间与工作台快照**)。**主体过期/停用或令牌失效 → 暂停推送**(保留本地积压、不做无意义重试),暂停期间每 60 秒只发一次心跳;心跳返回 `subject.expired=false`(续费)后自动恢复并补传 |
|
||||
| 扫码记录 | `Services/Scan/ScanRecordStore.cs` | `%LOCALAPPDATA%\YuncangTrace\scan-records.json`(服务模式:`%ProgramData%\YuncangTrace\scan-records.json`),每个通道最多 5000 条;**先落本地、服务器确认后才标「已上传」**,没确认的一直重试,断网不丢;连续扫描只刷新「最近一次扫到的时间」;**扫到后 5 秒没再扫到同一个码才上报**,上报的就是最后一次扫描时间;同一运单 24 小时内再次扫到会**重新激活同一条本地记录**(不新增行),下一轮上报覆盖服务器记录 |
|
||||
| 上报队列 | `Services/DeviceService.cs` | 条码静默满 5 秒后后台攒批(50 条/批)推 `POST /api/scan/records`(有积压时上报循环每秒醒一次,空闲 30 秒),失败不标记、指数退避重发(服务端按 设备+通道+条码+秒 精确去重;**同一运单 24 小时内只保留一条,后上报的新时间会覆盖旧记录的时间与工作台快照**)。**主体过期/停用或令牌失效 → 暂停推送**(保留本地积压、不做无意义重试),暂停期间每 60 秒只发一次心跳;心跳返回 `subject.expired=false`(续费)后自动恢复并补传 |
|
||||
|
||||
### 添加通道(设备名 + 通道号)
|
||||
|
||||
@ -781,8 +781,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
|
||||
[scan] 扫码服务已启动,通道 1 个
|
||||
[scan] 通道已同步到服务器并确认:1 个
|
||||
[scan] 通道 1(模拟扫码枪)已连接 127.0.0.1:8087
|
||||
[scan] 通道 1 扫码:TESTCH-BARCODE-9001(5 分钟未再扫到后上报)
|
||||
(5 分钟后)
|
||||
[scan] 通道 1 扫码:TESTCH-BARCODE-9001(5 秒未再扫到后上报)
|
||||
(5 秒后)
|
||||
[scan] 已上报扫码 1 条
|
||||
```
|
||||
数据库 `scan_records` 里 `channel_id=1`、`device_sn=MINGREN`;工作台可绑定通道 `1/模拟扫码枪`。
|
||||
|
||||
@ -40,6 +40,11 @@ public sealed class DeviceService
|
||||
private const int PauseUnauthorized = 2;
|
||||
private static readonly TimeSpan PauseProbeInterval = TimeSpan.FromSeconds(60);
|
||||
|
||||
// 静默窗口只有 5 秒,所以有积压时上报循环每秒醒一次(本地列表扫描,开销可忽略);
|
||||
// 没积压时 30 秒保活一次,别空转。
|
||||
private static readonly TimeSpan UploadBusyInterval = TimeSpan.FromSeconds(1);
|
||||
private static readonly TimeSpan UploadIdleInterval = TimeSpan.FromSeconds(30);
|
||||
|
||||
private readonly object _pauseGate = new();
|
||||
private int _pauseState = PauseNone;
|
||||
private string _pauseMessage = string.Empty;
|
||||
@ -250,7 +255,7 @@ public sealed class DeviceService
|
||||
/// ① 先落本地(连续扫描只刷新「最近一次扫描时间」)→ ② 唤醒后台上报循环 →
|
||||
/// ③ 服务器 2xx 确认后才把记录标成已上传,否则按退避重试。
|
||||
///
|
||||
/// **延迟上报**:扫到后 5 分钟没再扫到同一个码才真正上报(见
|
||||
/// **延迟上报**:扫到后 5 秒没再扫到同一个码才真正上报(见
|
||||
/// <see cref="ScanRecordStore.SettleDelay"/>),上报的是最后一次扫描时间。
|
||||
/// </summary>
|
||||
/// <returns>true = 一次新的扫码事件(连续扫描的重复帧返回 false,界面不用重查)</returns>
|
||||
@ -270,12 +275,12 @@ public sealed class DeviceService
|
||||
{
|
||||
if (ShouldLogTouched(channel, barcode))
|
||||
{
|
||||
AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 分钟内不再重复记录)");
|
||||
AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 秒内不再重复记录)");
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 分钟未再扫到后上报)");
|
||||
AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 秒未再扫到后上报)");
|
||||
}
|
||||
|
||||
if (!Enabled) return true;
|
||||
@ -340,7 +345,8 @@ public sealed class DeviceService
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 后台上报循环:有信号或每 30 秒检查一次,把**静默满 5 分钟**的待上传记录攒批推送。
|
||||
/// 后台上报循环:有信号、有积压时每秒检查一次(空闲时 30 秒),
|
||||
/// 把**静默满 5 秒**的待上传记录攒批推送。
|
||||
///
|
||||
/// 失败时**不标记**那批记录,等退避(1s→2s→5s→10s→30s 封顶)后重发;
|
||||
/// 服务端按 设备+通道+条码+秒 去重、同一运单 24 小时内覆盖成最新时间,
|
||||
@ -355,7 +361,10 @@ public sealed class DeviceService
|
||||
{
|
||||
try
|
||||
{
|
||||
await _uploadSignal.WaitAsync(TimeSpan.FromSeconds(30), ct).ConfigureAwait(false);
|
||||
// 静默期只有 5 秒:有待上传记录时每秒回来看一次,
|
||||
// 否则「最后一次扫描 + 5 秒」会被拖到下一次 30 秒保活才上报。
|
||||
var wait = ScanRecordStore.PendingCount() > 0 ? UploadBusyInterval : UploadIdleInterval;
|
||||
await _uploadSignal.WaitAsync(wait, ct).ConfigureAwait(false);
|
||||
}
|
||||
catch (OperationCanceledException)
|
||||
{
|
||||
|
||||
@ -99,11 +99,11 @@ public readonly record struct ScanAddResult(ScanAddKind Kind, ScanRecordItem? It
|
||||
/// - **通道回放**:现场要能翻「这台设备刚才扫了什么」,不能只留一条「最近条码」;
|
||||
/// - **连续扫描去重**:同一个码每 ~80ms 报一次,只刷新「最近一次扫到的时间」,
|
||||
/// 不新增记录(所以「A A A B A」记成 A、B 两条,A 的时间是最后一次扫到的时刻);
|
||||
/// - **延迟上报**:扫到后 <see cref="SettleDelay"/>(5 分钟)内没再扫到才进上报队列,
|
||||
/// - **延迟上报**:扫到后 <see cref="SettleDelay"/>(5 秒)内没再扫到才进上报队列,
|
||||
/// 上报的是**最后一次**扫描时间。面单一直放在扫码器上时,时间会一直往后刷,
|
||||
/// 直到面单被贴走/拿开,这才是包裹真正离开工作台的时刻;
|
||||
/// - 同一个码在 24 小时内再次扫到时会**复用/重新激活同一条本地记录**(不新增行),
|
||||
/// 5 分钟静默后重新上报,**服务器侧覆盖**原来那条记录的时间和工作台快照
|
||||
/// 5 秒静默后重新上报,**服务器侧覆盖**原来那条记录的时间和工作台快照
|
||||
/// (不再像旧版本那样「24 小时内重复的不上报」)。
|
||||
///
|
||||
/// 全部操作加锁:调用方既有收条码的连接线程,也有界面线程和上报重试线程。
|
||||
@ -116,8 +116,11 @@ public static class ScanRecordStore
|
||||
/// <summary>
|
||||
/// 延迟上报的静默窗口:扫到后这么久没再扫到同一个码,才允许上报。
|
||||
/// 连续扫描时每次扫到都会把时间往后推,所以上报的是「最后一次扫描」。
|
||||
///
|
||||
/// ⚠️ 这个值要和 <c>DeviceService</c> 上报循环的轮询间隔一起看:
|
||||
/// 静默期只有 5 秒,循环必须更频繁地检查,否则上报会被拖到下一次唤醒。
|
||||
/// </summary>
|
||||
public static readonly TimeSpan SettleDelay = TimeSpan.FromMinutes(5);
|
||||
public static readonly TimeSpan SettleDelay = TimeSpan.FromSeconds(5);
|
||||
|
||||
/// <summary>
|
||||
/// 同一运单在本地复用同一条记录的窗口(与后端的合并窗口一致:24 小时)。
|
||||
@ -227,7 +230,7 @@ public static class ScanRecordStore
|
||||
/// 返回 <see cref="ScanAddKind.Repeated"/>(界面不用重查,避免刷屏);
|
||||
/// - 同一个码还有一条没上报的记录(例如 A B A)→ 刷新那条的时间,返回 <see cref="ScanAddKind.Touched"/>;
|
||||
/// - 同一个码 24 小时内**已经上报过**、现在又被扫到(扫码枪范围大 / 两个面单轮流被扫)→
|
||||
/// **重新激活原来那条**(不新增行),静默 5 分钟后再上报覆盖服务器记录;
|
||||
/// **重新激活原来那条**(不新增行),静默 5 秒后再上报覆盖服务器记录;
|
||||
/// - 其它情况新建一条记录。
|
||||
/// </summary>
|
||||
public static ScanAddResult Add(string channelId, string channelName, string code, DateTime scannedAt)
|
||||
@ -282,7 +285,7 @@ public static class ScanRecordStore
|
||||
else
|
||||
{
|
||||
// 已经上报过的同一条码(24 小时内)→ 重新激活原来那条,
|
||||
// 静默 5 分钟后再上报,后端会覆盖成最新扫描时间 + 工作台快照。
|
||||
// 静默 5 秒后再上报,后端会覆盖成最新扫描时间 + 工作台快照。
|
||||
var uploaded = _items
|
||||
.Where(item => item.ChannelId.Equals(key, StringComparison.OrdinalIgnoreCase)
|
||||
&& item.Code.Equals(text, StringComparison.Ordinal)
|
||||
@ -349,7 +352,7 @@ public static class ScanRecordStore
|
||||
///
|
||||
/// 扫码枪范围太大时,两个面单会轮流被扫:A 刚上报完、过一会儿又被扫到。
|
||||
/// 这时不新增本地行,而是把原来那条改回「待上传」并刷新时间,
|
||||
/// 静默 5 分钟后再上报 —— 后端会把同一条记录覆盖成最新扫描时间。
|
||||
/// 静默 5 秒后再上报 —— 后端会把同一条记录覆盖成最新扫描时间。
|
||||
/// </summary>
|
||||
private static void Reopen(ScanRecordItem item, DateTime scannedAt, string channelName)
|
||||
{
|
||||
@ -364,7 +367,7 @@ public static class ScanRecordStore
|
||||
/// <summary>
|
||||
/// 可以上报的一批(按写入顺序,头进头出)。
|
||||
///
|
||||
/// **默认只返回静默满 <see cref="SettleDelay"/>(5 分钟)的记录**:扫到后 5 分钟内又扫到同一个码,
|
||||
/// **默认只返回静默满 <see cref="SettleDelay"/>(5 秒)的记录**:扫到后 5 秒内又扫到同一个码,
|
||||
/// <see cref="ScanRecordItem.ScannedAt"/> 会被刷新,这条就继续等,不会提前上报。
|
||||
/// </summary>
|
||||
public static List<ScanRecordItem> Pending(int limit) => Pending(limit, SettleDelay);
|
||||
@ -394,7 +397,7 @@ public static class ScanRecordStore
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>已经静默满 5 分钟、可以真正上报的条数</summary>
|
||||
/// <summary>已经静默满 5 秒、可以真正上报的条数</summary>
|
||||
public static int ReadyCount()
|
||||
{
|
||||
var cutoff = DateTime.Now - SettleDelay;
|
||||
@ -464,7 +467,7 @@ public static class ScanRecordStore
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>总条数 / 待上传条数(界面统计用;含还在 5 分钟静默期的记录)</summary>
|
||||
/// <summary>总条数 / 待上传条数(界面统计用;含还在 5 秒静默期的记录)</summary>
|
||||
public static (int Total, int Pending) Stats()
|
||||
{
|
||||
lock (Gate)
|
||||
|
||||
@ -701,7 +701,7 @@ public sealed class ScanService
|
||||
/// - 记录库只把「最近扫描时间」刷到最新,不新增记录;
|
||||
/// - 这里只在**新扫码事件**(换了条码 / 已上报过的码又扫到)时通知界面,
|
||||
/// 否则订阅者会被连续扫描刷屏。订阅者**只能做展示**,不能据此发起运单查询。
|
||||
/// 真正的上报在扫到后 5 分钟没再扫到同一个码时才做(时间取最后一次扫描)。
|
||||
/// 真正的上报在扫到后 5 秒没再扫到同一个码时才做(时间取最后一次扫描)。
|
||||
/// </summary>
|
||||
private void OnBarcode(ScanChannel channel, string code)
|
||||
{
|
||||
|
||||
@ -154,7 +154,7 @@ public partial class ScanRecordsView : UserControl
|
||||
var (allTotal, pending) = ScanRecordStore.Stats();
|
||||
var ready = ScanRecordStore.ReadyCount();
|
||||
var status = $"{scope}:共 {total} 条 · 全部 {allTotal} 条 · 待上传 {pending} 条";
|
||||
if (pending > ready) status += $"({pending - ready} 条静默中,满 5 分钟自动上报)";
|
||||
if (pending > ready) status += $"({pending - ready} 条静默中,满 5 秒自动上报)";
|
||||
|
||||
if (IsAgentMode)
|
||||
{
|
||||
@ -244,7 +244,7 @@ public partial class ScanRecordsView : UserControl
|
||||
|
||||
if (ScanRecordStore.ReadyCount() == 0)
|
||||
{
|
||||
StatusText.Text = "记录还在 5 分钟静默期(等最后一次扫描后再上报),稍后会自动上传";
|
||||
StatusText.Text = "记录还在 5 秒静默期(等最后一次扫描后再上报),稍后会自动上传";
|
||||
return;
|
||||
}
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user