using System; using System.Collections.Concurrent; using System.Collections.Generic; using System.Linq; using System.Threading; using System.Threading.Tasks; using YuncangTrace.LocalService.Services.Scan; namespace YuncangTrace.LocalService.Services; /// /// 桌面端「设备服务」:把本机当成一台扫码中控(scanner),向服务器上报扫码记录。 /// /// - **默认关闭**:只有主体管理员在菜单「服务 → 开启设备服务」里手动开启; /// - 开启时调 `POST /api/web/devices/activate`,服务端保证「一个主体只有一台设备在线」, /// 同主体其他设备会被踢下线(旧令牌立即 401); /// - 开启后拿到**长期设备 JWT**,上报走 `POST /api/scan/{channels,records}`; /// - 关闭时调 `POST /api/web/devices/:id/logout` 让令牌立即作废。 /// public sealed class DeviceService { /// 本机上报用的通道 id / 名称(一台电脑就是一个通道) public const string LocalChannelId = "DESKTOP"; public const string LocalChannelName = "本机中控"; private readonly ApiClient _api; private readonly AppSettings _settings; private readonly Session _session; // 扫码记录上报队列:条码先进本地库,后台循环批量推送,**服务器确认后才标记已上传** private readonly SemaphoreSlim _uploadSignal = new(0, 1); private CancellationTokenSource? _uploadCts; private Task? _uploadTask; private int _uploadRetryMs = 1000; // 主体不可用(过期 / 停用)或设备令牌失效时暂停上报: // 暂停期间只发心跳探测(心跳不受期限拦截),续费后自动恢复并补传积压。 private const int PauseNone = 0; private const int PauseSubject = 1; 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; private int _probeFailures; private DateTime _lastProbeAt = DateTime.MinValue; /// 暂停上报期间探测「是否已续期」时触发(ScanService 用来补一次通道对账) public event Action? SubjectResumed; // 面单一直放在扫码器上时会持续「更新最近扫描时间」(每 1~2 秒一次)—— // 这种事件不能每条都写日志,否则一天几万行;同一个 通道+条码 5 分钟记一次。 private static readonly ConcurrentDictionary TouchedLogAt = new(); /// 散单通道「同一张面单还在扫」的判定窗口:这之内再扫到同一个码只算一次 private static readonly TimeSpan FirstSeenGap = TimeSpan.FromSeconds(5); // 散单通道的在场记录:key = 通道|条码 → (首次扫到, 最近扫到) private readonly Dictionary _firstSeen = new(StringComparer.OrdinalIgnoreCase); private readonly object _firstSeenGate = new(); private static bool ShouldLogTouched(string channel, string code) { var key = $"{channel}|{code}"; var now = DateTime.Now; if (TouchedLogAt.TryGetValue(key, out var last) && now - last < TimeSpan.FromMinutes(5)) return false; TouchedLogAt[key] = now; return true; } public DeviceService(ApiClient api, AppSettings settings, Session session) { _api = api; _settings = settings; _session = session; } /// 上报状态(给界面看的一句话;空串 = 一切正常) public string UploadStatus { get; private set; } = string.Empty; /// 是否已暂停上报(主体过期/停用,或设备令牌失效) public bool UploadPaused { get { lock (_pauseGate) return _pauseState != PauseNone; } } /// /// 心跳/上报拿到的视图:同步主体状态。 /// - 过期 / 停用 → 暂停上报(不消费队列、不标记已上传); /// - 恢复可用 → 立刻补传积压(服务端幂等,整批重发安全)。 /// public void ApplySubjectState(DeviceSubjectState? subject) { if (subject is null) return; if (subject.Disabled) { Pause(PauseSubject, $"主体「{subject.Name}」已停用"); return; } if (subject.Expired) { var deadline = subject.ExpireAt is null ? string.Empty : $"({subject.ExpireAt:yyyy-MM-dd HH:mm})"; Pause(PauseSubject, $"主体「{subject.Name}」使用期限已到{deadline}"); return; } Resume("主体已续期/恢复,开始补传积压的扫码记录"); } /// 是否已开启(本地标记 + 有令牌) public bool Enabled => _settings.DeviceServiceEnabled && !string.IsNullOrWhiteSpace(_settings.DeviceToken); /// 本机 SN(默认机器名,最多 64 字符) public string Sn { get { if (!string.IsNullOrWhiteSpace(_settings.DeviceSn)) return _settings.DeviceSn; var name = Environment.MachineName; return string.IsNullOrWhiteSpace(name) ? "PC-DESKTOP" : name.ToUpperInvariant(); } set { var text = (value ?? string.Empty).Trim(); _settings.DeviceSn = text.Length > 64 ? text[..64] : text; } } /// 当前主体 id(没有主体时 0) public int SubjectId => _settings.SubjectId; /// 当前主体下**除本机以外**的已绑定设备(开启前提示"会被踢掉") public async Task> OtherDevicesAsync(CancellationToken ct = default) { if (SubjectId <= 0) return Array.Empty(); var devices = await _api.DevicesAsync(_session.Token, SubjectId, ct).ConfigureAwait(false); return devices.Where(item => !string.Equals(item.Sn, Sn, StringComparison.OrdinalIgnoreCase)).ToList(); } /// /// 开启设备服务:注册本机 → 保存令牌 → 上报通道。 /// (踢掉其他设备的确认由界面负责,这里只管干活) /// /// 不是管理员 / 网络失败 / 主体到期等,message 可直接显示 public async Task EnableAsync(CancellationToken ct = default) { if (SubjectId <= 0) throw new ApiException("还没有选择主体,请先在「服务 → 切换主体」里选一个"); var result = await _api.ActivateDeviceAsync(_session.Token, SubjectId, Sn, $"{Environment.MachineName}(本机)", ct) .ConfigureAwait(false); _settings.DeviceServiceEnabled = true; _settings.DeviceId = result.Id; _settings.DeviceSn = result.Sn; _settings.DeviceToken = result.Token; _settings.DeviceRefreshToken = result.RefreshToken; _settings.DeviceTokenExpiresAt = result.ExpiresIn ?? string.Empty; _settings.Save(); AppLog.Write($"[device] 设备服务已开启:{result.Sn}(id={result.Id},踢下线 {result.Kicked.Count} 台)"); // 重新开启 = 重新鉴权:清掉暂停状态并马上补传积压 Resume("设备服务已重新开启,恢复上报"); // 拉起扫码记录上报循环(断网期间的积压会一次性补上去) EnsureUploadLoop(); TriggerUpload(); // 通道不在这里上报:真实通道由 `ScanService` 同步(加了几个扫码通道就报几个)。 // 以前这里会补一个 `DESKTOP`「本机中控」占位通道,结果工作台绑定页能看到一个 // 永远没数据的假通道;查询也不是扫码,不需要这个通道来"记账"。 AppLog.Write("[device] 通道由扫码服务同步(不再上报本机占位通道)"); return result; } /// 上报一批通道(扫码服务的每条通道都同步给服务器,供工作台绑定) public async Task ReportChannelsAsync(IEnumerable<(string ChannelId, string ChannelName)> channels, bool replace = false, CancellationToken ct = default) { if (!Enabled) return; var list = channels .Where(item => !string.IsNullOrWhiteSpace(item.ChannelId)) .Select(item => (item.ChannelId, string.IsNullOrWhiteSpace(item.ChannelName) ? item.ChannelId : item.ChannelName)) .ToList(); // 全量对账时允许空列表(表示通道已全部删除) if (list.Count == 0 && !replace) return; await _api.ReportChannelsAsync(_settings.DeviceToken, list, replace, ct).ConfigureAwait(false); } /// 关闭设备服务:让令牌立即作废并清掉本地状态 public async Task DisableAsync(CancellationToken ct = default) { StopUploadLoop(); var deviceId = _settings.DeviceId; var token = _settings.DeviceToken; _settings.DeviceServiceEnabled = false; _settings.DeviceToken = string.Empty; _settings.DeviceRefreshToken = string.Empty; _settings.DeviceTokenExpiresAt = string.Empty; _settings.Save(); if (deviceId > 0 && token.Length > 0 && SubjectId > 0) { try { await _api.DeactivateDeviceAsync(_session.Token, SubjectId, deviceId, ct).ConfigureAwait(false); AppLog.Write($"[device] 设备服务已关闭(id={deviceId},令牌已作废)"); } catch (Exception ex) { // 关服务不该因为网络问题卡住用户 AppLog.Write($"[device] 通知服务器关闭失败(本地已关闭):{ex.Message}"); } } else { AppLog.Write("[device] 设备服务已关闭(本地)"); } } /// 换了主体/退出登录:本地状态清掉(不动服务器上的旧设备) public void ResetLocalState() { StopUploadLoop(); _settings.DeviceServiceEnabled = false; _settings.DeviceId = 0; _settings.DeviceToken = string.Empty; _settings.DeviceRefreshToken = string.Empty; _settings.DeviceTokenExpiresAt = string.Empty; _settings.Save(); } /// /// 通道 → 工作台类型(1 散单 / 2 团购 / 0 未知),由 注入。 /// /// 散单的扫码枪也按「时间取**第一次** + 立即上报」记(和散单面单摄像头一致); /// 团购(或未知)仍按「静默 5 秒、时间取最后一次」。 /// public Func? ChannelModeOf { get; set; } /// /// 上报一条扫码记录(fire-and-forget 的**入队**版本)。 /// /// ⚠️ 只在真的"扫了一次码"时调用;**运单查询不要调** —— /// 查询只是看看,记一条 `DESKTOP` 记录会污染扫码记录表(历史要求)。 /// 先落本地库,由后台上报循环推给服务器;失败会一直重试,不会丢。 /// public void ReportScan(string code) => ReportOnChannel(LocalChannelId, LocalChannelName, code); /// /// 用指定通道记一条扫码记录。 /// /// 与 AndroidScanCenter 的 ScanStore + BarcodeReporter 一致: /// ① 先落本地(连续扫描只刷新「最近一次扫描时间」)→ ② 唤醒后台上报循环 → /// ③ 服务器 2xx 确认后才把记录标成已上传,否则按退避重试。 /// /// **延迟上报**:扫到后 5 秒没再扫到同一个码才真正上报(见 /// ),上报的是最后一次扫描时间。 /// /// **散单通道例外**( 返回 1):时间取**第一次**、**立即上报**, /// 和散单面单摄像头的规则一致;5 秒内重复扫同一个码只算一次(连续扫描帧)。 /// /// true = 一次新的扫码事件(连续扫描的重复帧返回 false,界面不用重查) public bool ReportOnChannel(string channelId, string channelName, string code) { var barcode = (code ?? string.Empty).Trim(); if (barcode.Length == 0) return false; var channel = string.IsNullOrWhiteSpace(channelId) ? LocalChannelId : channelId; var name = string.IsNullOrWhiteSpace(channelName) ? channel : channelName; if ((ChannelModeOf?.Invoke(channel) ?? 0) == 1) return ReportFirstSeen(channel, name, barcode); // 没开设备服务也照样记本地:开起来之后会把积压的自动补上去(断网/未开启期间不丢码) var result = ScanRecordStore.Add(channel, name, barcode, DateTime.Now); if (result.Item is null || result.Kind == ScanAddKind.Repeated) return false; if (result.Kind == ScanAddKind.Touched) { if (ShouldLogTouched(channel, barcode)) { AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(更新最近扫描时间;5 秒内不再重复记录)"); } } else { AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(5 秒未再扫到后上报)"); } if (!Enabled) return true; EnsureUploadLoop(); SignalUpload(); return true; } /// /// **散单通道**的扫码枪记录:时间取第一次、立即上报(和散单面单摄像头一致)。 /// /// 扫码枪连续模式下同一个码每 ~80ms 报一次,所以这里做「在场」去重: /// 内又扫到同一个码只算一次,不会把记录反复挂回队列。 /// private bool ReportFirstSeen(string channel, string name, string barcode) { var now = DateTime.Now; var key = $"{channel}|{barcode}"; var repeated = false; lock (_firstSeenGate) { PruneFirstSeen(now); if (_firstSeen.TryGetValue(key, out var seen) && now - seen.LastHitAt <= FirstSeenGap) { _firstSeen[key] = (seen.FirstSeenAt, now); repeated = true; } else { _firstSeen[key] = (now, now); } } if (repeated) return false; var result = ScanRecordStore.AddCamera(channel, name, barcode, now); if (result.Item is null || !result.IsScanEvent) return false; AppLog.Write($"[scan] 通道 {channel} 扫码:{barcode}(散单:取第一次识别时间,立即上报)"); if (!Enabled) return true; EnsureUploadLoop(); SignalUpload(); return true; } /// 清掉 24 小时没再命中的在场记录(防字典无限增长) private void PruneFirstSeen(DateTime now) { if (_firstSeen.Count == 0) return; var stale = _firstSeen .Where(pair => now - pair.Value.LastHitAt > TimeSpan.FromHours(24)) .Select(pair => pair.Key) .ToList(); foreach (var key in stale) _firstSeen.Remove(key); } /// 查服务器上当前中控已登记的通道(用于确认同步) public Task> ChannelsAsync(CancellationToken ct = default) => _api.ChannelsAsync(_settings.DeviceToken, ct); /// 拉取本机的面单摄像头识别配置(`GET /api/scanner/label-cameras`) public Task FetchLabelCamerasAsync(CancellationToken ct = default) => _api.GetLabelCamerasAsync(_settings.DeviceToken, ct); /// 拉取本机负责的工作台 + 全部绑定摄像头(`GET /api/scanner/workstations`,OSD 用) public Task FetchWorkstationsAsync(CancellationToken ct = default) => _api.GetWorkstationsAsync(_settings.DeviceToken, ct); /// 立即触发一次上报(界面的「立即上传」) public void TriggerUpload() { if (!Enabled) return; EnsureUploadLoop(); SignalUpload(); } /// 开设备服务时把上报循环拉起来(重复调用无影响) public void EnsureUploadLoop() { if (_uploadTask is { IsCompleted: false }) return; _uploadCts = new CancellationTokenSource(); _uploadTask = Task.Run(() => UploadLoopAsync(_uploadCts.Token)); } /// 停上报循环(关服务 / 退出登录) public void StopUploadLoop() { try { _uploadCts?.Cancel(); } catch { // 忽略 } _uploadCts = null; _uploadTask = null; lock (_pauseGate) { _pauseState = PauseNone; _pauseMessage = string.Empty; } UploadStatus = string.Empty; ScanRecordStore.Flush(); } private void SignalUpload() { try { if (_uploadSignal.CurrentCount == 0) _uploadSignal.Release(); } catch { // 忽略 } } /// /// 后台上报循环:有信号、有积压时每秒检查一次(空闲时 30 秒), /// 把**静默满 5 秒**的待上传记录攒批推送。 /// /// 失败时**不标记**那批记录,等退避(1s→2s→5s→10s→30s 封顶)后重发; /// 服务端按 设备+通道+条码+秒 去重、同一运单 24 小时内覆盖成最新时间, /// 所以整批重发不会造成重复落库,也不会把时间改回过去。 /// /// **主体过期/停用或令牌失效时不推送**:队列原样保留,每 60 秒只发一次心跳探测, /// 续期(或重新开启设备服务)后自动恢复并把积压补传上去。 /// private async Task UploadLoopAsync(CancellationToken ct) { while (!ct.IsCancellationRequested) { try { // 静默期只有 5 秒:有待上传记录时每秒回来看一次, // 否则「最后一次扫描 + 5 秒」会被拖到下一次 30 秒保活才上报。 var wait = ScanRecordStore.PendingCount() > 0 ? UploadBusyInterval : UploadIdleInterval; await _uploadSignal.WaitAsync(wait, ct).ConfigureAwait(false); } catch (OperationCanceledException) { break; } while (!ct.IsCancellationRequested && Enabled) { if (UploadPaused) { await WaitAndProbeAsync(ct).ConfigureAwait(false); continue; } var batch = ScanRecordStore.Pending(50); if (batch.Count == 0) { UploadStatus = string.Empty; break; } try { var rows = batch.Select(item => (item.ChannelId, item.Code, item.ScannedAt)).ToList(); await _api.ReportRecordsAsync(_settings.DeviceToken, rows, ct).ConfigureAwait(false); // 服务器已确认:只有这里才把记录标成已上传 // (传入上报时的扫描时间:上报期间又扫到的话保持待上传,下一轮带最新时间重发) ScanRecordStore.MarkUploaded(batch.Select(item => (item.Id, item.ScannedAt))); _uploadRetryMs = 1000; UploadStatus = string.Empty; AppLog.Write($"[scan] 已上报扫码 {batch.Count} 条"); } catch (OperationCanceledException) { break; } catch (ApiException ex) when (ex.IsSubjectUnavailable) { // 主体不可用:不重试、不丢队列,改为等心跳探测到续期 Pause(PauseSubject, ex.Message); } catch (ApiException ex) when (ex.StatusCode == 401) { // 令牌失效(被踢下线/重新扫码过):重新开启设备服务之前无法恢复 Pause(PauseUnauthorized, "设备令牌已失效(可能已在其他设备开启),请重新开启设备服务"); } catch (Exception ex) { UploadStatus = $"上报失败(待上传 {ScanRecordStore.PendingCount()} 条),{_uploadRetryMs / 1000} 秒后重试"; AppLog.Write($"[scan] 上报扫码失败({batch.Count} 条,{_uploadRetryMs}ms 后重试):{ex.Message}"); try { await Task.Delay(_uploadRetryMs, ct).ConfigureAwait(false); } catch (OperationCanceledException) { break; } _uploadRetryMs = Math.Min(_uploadRetryMs * 2, 30000); } } } } /// 暂停期间:等一会儿 → 只发心跳探测主体是否已恢复;令牌失效时不再探测 private async Task WaitAndProbeAsync(CancellationToken ct) { bool unauthorized; lock (_pauseGate) unauthorized = _pauseState == PauseUnauthorized; // 有积压就 60 秒探一次(续费后 1 分钟内自动补传);没积压就 5 分钟探一次,别浪费请求。 // 用 _uploadSignal 等待:重新开启设备服务 / 手动「立即上传」会立刻唤醒,不用干等。 var interval = ScanRecordStore.PendingCount() > 0 ? PauseProbeInterval : TimeSpan.FromMinutes(5); try { await _uploadSignal.WaitAsync(interval, ct).ConfigureAwait(false); } catch (OperationCanceledException) { throw; } RefreshPausedStatus(); // 已被 Resume(重新鉴权/续期事件)唤醒:直接回到上报循环,不重复探测 if (!UploadPaused) return; if (!Enabled || unauthorized) return; // 同一分钟内不重复探测(扫码会频繁唤醒,不需要每次都发心跳) if (DateTime.UtcNow - _lastProbeAt < PauseProbeInterval) return; _lastProbeAt = DateTime.UtcNow; try { var beat = await _api.HeartbeatAsync(_settings.DeviceToken, ct).ConfigureAwait(false); _probeFailures = 0; ApplySubjectState(beat?.Subject); } catch (OperationCanceledException) { throw; } catch (ApiException ex) when (ex.StatusCode == 401) { Pause(PauseUnauthorized, "设备令牌已失效(可能已在其他设备开启),请重新开启设备服务"); } catch (Exception ex) { // 网络问题:保持暂停,下个周期再探测;只偶尔记一行,别刷屏 if (++_probeFailures % 10 == 1) { AppLog.Write($"[scan] 暂停期间心跳探测失败(继续等待,本地记录不受影响):{ex.Message}"); } } } private void Pause(int state, string message) { var pending = ScanRecordStore.PendingCount(); var changed = false; lock (_pauseGate) { changed = _pauseState != state || _pauseMessage != message; _pauseState = state; _pauseMessage = message; UploadStatus = $"{message}(待上传 {pending} 条,恢复后自动补传)"; } if (changed) { _lastProbeAt = DateTime.MinValue; AppLog.Write($"[scan] {message},已暂停上报(本地记录保留,待上传 {pending} 条)"); } } private void Resume(string message) { var changed = false; lock (_pauseGate) { changed = _pauseState != PauseNone; _pauseState = PauseNone; _pauseMessage = string.Empty; UploadStatus = string.Empty; } if (!changed) return; _uploadRetryMs = 1000; _probeFailures = 0; _lastProbeAt = DateTime.MinValue; AppLog.Write($"[scan] {message}"); SubjectResumed?.Invoke(); SignalUpload(); } /// 刷新暂停提示里的「待上传 N 条」(暂停期间会继续扫码/积压) private void RefreshPausedStatus() { var pending = ScanRecordStore.PendingCount(); lock (_pauseGate) { if (_pauseState == PauseNone) return; UploadStatus = $"{_pauseMessage}(待上传 {pending} 条,恢复后自动补传)"; } } }