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