using System.IO;
using System.Threading;
using System.Threading.Tasks;
using ClassNotify.Server.Services;
using ClassNotify.Shared.Models;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
namespace ClassNotify.Server.Controllers;
///
/// 设备端在线升级包下载与状态汇报接口 (P2.5 RC1-4 Phase 1)
/// 严格基于设备凭据鉴权 (X-Device-Id, X-Device-Token),防止未授权拉取
///
[ApiController]
public sealed class DeviceUpdatePackageController : ControllerBase
{
private readonly IDeviceUpdateService _updateService;
private readonly ISecurityService _securityService;
private readonly ILogger _logger;
public DeviceUpdatePackageController(
IDeviceUpdateService updateService,
ISecurityService securityService,
ILogger logger)
{
_updateService = updateService;
_securityService = securityService;
_logger = logger;
}
///
/// 终端鉴权安全下载指定 Release 安装包 (U1, U2)
///
[HttpGet("api/device/update-releases/{releaseId}/package")]
public async Task DownloadUpdatePackage(
[FromRoute] string releaseId,
CancellationToken ct)
{
// 1. 终端鉴权 (X-Device-Id, X-Device-Token)
var deviceId = Request.Headers["X-Device-Id"].ToString();
var deviceToken = Request.Headers["X-Device-Token"].ToString();
if (string.IsNullOrWhiteSpace(deviceId) || string.IsNullOrWhiteSpace(deviceToken))
{
return Unauthorized(new { errorCode = UpdateErrorCodes.Unauthorized, message = "Missing device authentication credentials." });
}
var device = await _securityService.ValidateDeviceAsync(deviceId, deviceToken);
if (device == null)
{
return Unauthorized(new { errorCode = UpdateErrorCodes.Unauthorized, message = "Invalid device credentials." });
}
// 2. 准备升级包文件
var result = await _updateService.PreparePackageDownloadAsync(releaseId, device.Id, ct);
if (result.StatusCode == 403)
{
return StatusCode(403, new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
if (result.StatusCode == 404)
{
return NotFound(new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
if (result.StatusCode == 400)
{
return BadRequest(new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
if (result.StatusCode == 500)
{
return StatusCode(500, new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
Response.Headers["Cache-Control"] = "private, no-store";
Response.Headers["Pragma"] = "no-cache";
Response.Headers["X-Content-Type-Options"] = "nosniff";
Response.Headers["X-Package-Sha256"] = result.Sha256!;
var stream = new FileStream(result.PhysicalPath!, FileMode.Open, FileAccess.Read, FileShare.Read, 81920, useAsync: true);
return File(stream, "application/zip", result.DownloadFileName, enableRangeProcessing: false);
}
///
/// 终端向服务端上报升级流转状态 (Downloading -> Verified -> Installing -> HealthChecking -> Succeeded/Failed)
///
[HttpPost("api/device/update-runs/{updateRunId}/status")]
public async Task ReportUpdateStatus(
[FromRoute] string updateRunId,
[FromBody] DeviceUpdateReportRequest request,
CancellationToken ct)
{
var deviceId = Request.Headers["X-Device-Id"].ToString();
var deviceToken = Request.Headers["X-Device-Token"].ToString();
if (string.IsNullOrWhiteSpace(deviceId) || string.IsNullOrWhiteSpace(deviceToken))
{
return Unauthorized(new { errorCode = UpdateErrorCodes.Unauthorized, message = "Missing device credentials." });
}
var device = await _securityService.ValidateDeviceAsync(deviceId, deviceToken);
if (device == null)
{
return Unauthorized(new { errorCode = UpdateErrorCodes.Unauthorized, message = "Invalid device credentials." });
}
var result = await _updateService.ReportDeviceUpdateStatusAsync(device.Id, updateRunId, request, ct);
if (result.StatusCode == 404)
{
return NotFound(new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
if (result.StatusCode == 409)
{
return Conflict(new { errorCode = result.ErrorCode, message = result.ErrorMessage });
}
return Ok(new { success = true });
}
}