using System.IO; using System.Security.Claims; using System.Threading; using System.Threading.Tasks; using ClassNotify.Server.Services; using ClassNotify.Shared.Models; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; namespace ClassNotify.Server.Controllers; /// /// 设备技术诊断包管控接口 (P2.5 RC1-3 Support Bundle Phase 1, Phase 2, Phase 3) /// 覆盖诊断包发起、状态查询、历史恢复与管理员安全下载 /// [ApiController] public class SupportBundlesController : ControllerBase { private readonly ISupportBundleService _bundleService; private readonly ILogger _logger; public SupportBundlesController( ISupportBundleService bundleService, ILogger logger) { _bundleService = bundleService; _logger = logger; } private string GetActorUsername() => User.FindFirst(ClaimTypes.Name)?.Value ?? User.FindFirst(ClaimTypes.NameIdentifier)?.Value ?? "Admin"; private string GetActorRole() => User.FindFirst(ClaimTypes.Role)?.Value ?? (User.IsInRole("SuperAdmin") ? "SuperAdmin" : "SchoolAdmin"); private string? GetActorTenantId() => User.FindFirst("tenant_id")?.Value ?? User.FindFirst("TenantId")?.Value; private string GetClientIp() => HttpContext.Connection.RemoteIpAddress?.ToString() ?? "127.0.0.1"; /// /// 请求生成设备技术诊断包 (SB1-SB3, P1-1 ~ P1-10) /// [HttpPost("api/admin/devices/{deviceId}/support-bundles")] [Authorize(Roles = "SuperAdmin,SchoolAdmin,TenantOwner")] public async Task CreateSupportBundle( [FromRoute] string deviceId, [FromBody] CreateSupportBundleRequest? request, CancellationToken ct) { var actorUser = GetActorUsername(); var actorRole = GetActorRole(); var actorTenant = GetActorTenantId(); var clientIp = GetClientIp(); // 支持非生产环境测试事务原子性测试桩 bool simulateAuditFailure = Request.Headers.TryGetValue("X-Simulate-Audit-Failure", out var headerVal) && string.Equals(headerVal, "true", StringComparison.OrdinalIgnoreCase); var result = await _bundleService.CreateSupportBundleAsync( deviceId, request ?? new CreateSupportBundleRequest(), actorUser, actorRole, actorTenant, clientIp, simulateAuditFailure, ct); if (result.StatusCode == 202) { var locationUrl = $"/api/admin/support-bundles/{result.Dto!.SupportBundleId}"; return Accepted(locationUrl, result.Dto); } if (result.StatusCode == 409) { return Conflict(new { errorCode = result.ErrorCode, supportBundleId = result.ExistingBundleId, message = result.ErrorMessage }); } 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 }); } return BadRequest(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } /// /// 获取技术诊断包状态与详情 (P3-1: 严格 RBAC,杜绝暴露服务器物理路径) /// [HttpGet("api/admin/support-bundles/{bundleId}")] [Authorize(Roles = "SuperAdmin,SchoolAdmin,TenantOwner")] public async Task GetSupportBundle( [FromRoute] string bundleId, CancellationToken ct) { var actorRole = GetActorRole(); var actorTenant = GetActorTenantId(); var result = await _bundleService.GetSupportBundleStatusAsync(bundleId, actorRole, actorTenant, ct); if (result.StatusCode == 403) { return StatusCode(403, new { errorCode = "Forbidden", message = result.ErrorMessage }); } if (result.StatusCode == 404) { return NotFound(new { errorCode = SupportBundleErrorCodes.SupportBundleNotFound, message = result.ErrorMessage }); } return Ok(result.Data); } /// /// 获取指定设备最近技术诊断包记录 (P3-11: 页面刷新恢复,最多 20 条) /// [HttpGet("api/admin/devices/{deviceId}/support-bundles")] [Authorize(Roles = "SuperAdmin,SchoolAdmin,TenantOwner")] public async Task GetDeviceSupportBundles( [FromRoute] string deviceId, [FromQuery] int take = 5, CancellationToken ct = default) { var actorRole = GetActorRole(); var actorTenant = GetActorTenantId(); var result = await _bundleService.GetDeviceSupportBundlesAsync(deviceId, take, actorRole, actorTenant, ct); if (result.StatusCode == 403) { return StatusCode(403, new { errorCode = "Forbidden", message = result.ErrorMessage }); } if (result.StatusCode == 404) { return NotFound(new { errorCode = "DeviceNotFound", message = result.ErrorMessage }); } return Ok(result.Data); } /// /// 管理员安全下载诊断包 (P3-2 ~ P3-5, P3-8, P3-9) /// 严格防目录越界、防过期、防非就绪下载,成功后生成标准下载文件名与 Audit 记录 /// [HttpGet("api/admin/support-bundles/{bundleId}/download")] [Authorize(Roles = "SuperAdmin,SchoolAdmin,TenantOwner")] public async Task DownloadSupportBundle( [FromRoute] string bundleId, CancellationToken ct) { var actorUser = GetActorUsername(); var actorRole = GetActorRole(); var actorTenant = GetActorTenantId(); var clientIp = GetClientIp(); var result = await _bundleService.PrepareDownloadAsync(bundleId, actorRole, actorTenant, actorUser, clientIp, 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 == 409) { return Conflict(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } if (result.StatusCode == 410) { return StatusCode(410, 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"; var fileStream = new FileStream(result.PhysicalPath!, FileMode.Open, FileAccess.Read, FileShare.Read, 81920, useAsync: true); return File(fileStream, "application/zip", result.DownloadFileName, enableRangeProcessing: false); } }