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 }); } }