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;
// 面单一直放在扫码器上时会持续「更新最近扫描时间」(每 1~2 秒一次)——
// 这种事件不能每条都写日志,否则一天几万行;同一个 通道+条码 5 分钟记一次。
private static readonly ConcurrentDictionary TouchedLogAt = 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 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} 台)");
// 拉起扫码记录上报循环(断网期间的积压会一次性补上去)
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();
}
///
/// 上报一条扫码记录(fire-and-forget 的**入队**版本)。
///
/// ⚠️ 只在真的"扫了一次码"时调用;**运单查询不要调** ——
/// 查询只是看看,记一条 `DESKTOP` 记录会污染扫码记录表(历史要求)。
/// 先落本地库,由后台上报循环推给服务器;失败会一直重试,不会丢。
///
public void ReportScan(string code) => ReportOnChannel(LocalChannelId, LocalChannelName, code);
///
/// 用指定通道记一条扫码记录。
///
/// 与 AndroidScanCenter 的 ScanStore + BarcodeReporter 一致:
/// ① 先落本地(连续扫描只刷新「最近一次扫描时间」)→ ② 唤醒后台上报循环 →
/// ③ 服务器 2xx 确认后才把记录标成已上传,否则按退避重试。
///
/// **延迟上报**:扫到后 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;
// 没开设备服务也照样记本地:开起来之后会把积压的自动补上去(断网/未开启期间不丢码)
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;
}
/// 查服务器上当前中控已登记的通道(用于确认同步)
public Task> ChannelsAsync(CancellationToken ct = default)
=> _api.ChannelsAsync(_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;
UploadStatus = string.Empty;
ScanRecordStore.Flush();
}
private void SignalUpload()
{
try
{
if (_uploadSignal.CurrentCount == 0) _uploadSignal.Release();
}
catch
{
// 忽略
}
}
///
/// 后台上报循环:有信号或每 30 秒检查一次,把**静默满 5 分钟**的待上传记录攒批推送。
///
/// 失败时**不标记**那批记录,等退避(1s→2s→5s→10s→30s 封顶)后重发;
/// 服务端按 设备+通道+条码+秒 去重、同一运单 24 小时内覆盖成最新时间,
/// 所以整批重发不会造成重复落库,也不会把时间改回过去。
///
private async Task UploadLoopAsync(CancellationToken ct)
{
while (!ct.IsCancellationRequested)
{
try
{
await _uploadSignal.WaitAsync(TimeSpan.FromSeconds(30), ct).ConfigureAwait(false);
}
catch (OperationCanceledException)
{
break;
}
while (!ct.IsCancellationRequested && Enabled)
{
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 (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);
}
}
}
}
}