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-4 Phase 3) /// 严格限权 SuperAdmin,支持 1~5 台同一租户灰度升级、Canary 门禁放行与紧急停止 /// [ApiController] [Authorize] public sealed class AdminUpdateBatchesController : ControllerBase { private readonly IDeviceUpdateBatchService _batchService; private readonly ILogger _logger; public AdminUpdateBatchesController( IDeviceUpdateBatchService batchService, ILogger logger) { _batchService = batchService; _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"; /// /// SuperAdmin 创建小规模灰度升级批次 (U21, U22, U23) /// [HttpPost("api/admin/update-batches")] public async Task CreateBatch( [FromBody] CreateUpdateBatchRequest? request, CancellationToken ct) { var actorUser = GetActorUsername(); var actorRole = GetActorRole(); var actorTenant = GetActorTenantId(); var clientIp = GetClientIp(); var result = await _batchService.CreateBatchAsync( request ?? new CreateUpdateBatchRequest(), actorUser, actorRole, actorTenant, clientIp, ct); if (result.StatusCode == 202) { var locationUrl = $"/api/admin/update-batches/{result.Dto!.BatchId}"; return Accepted(locationUrl, result.Dto); } if (result.StatusCode == 403) { return StatusCode(403, new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } if (result.StatusCode == 409) { return Conflict(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } return BadRequest(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } /// /// SuperAdmin 查询灰度批次全量实时聚合视图 (U28) /// [HttpGet("api/admin/update-batches/{batchId}")] public async Task GetBatch( [FromRoute] string batchId, CancellationToken ct) { var actorRole = GetActorRole(); var result = await _batchService.GetBatchAsync(batchId, actorRole, ct); if (result.StatusCode == 200) { return Ok(result.Data); } if (result.StatusCode == 403) { return StatusCode(403, new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } return NotFound(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } /// /// SuperAdmin 人工放行后续批次设备 (U26: 仅限 Canary 成功后生效) /// [HttpPost("api/admin/update-batches/{batchId}/continue")] public async Task ContinueBatch( [FromRoute] string batchId, CancellationToken ct) { var actorUser = GetActorUsername(); var actorRole = GetActorRole(); var clientIp = GetClientIp(); var result = await _batchService.ContinueBatchAsync(batchId, actorUser, actorRole, clientIp, ct); if (result.StatusCode == 200) { return Ok(result.Dto); } 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 }); } /// /// SuperAdmin 人工停止批次升级 (U27: 保持 Held 阻断,运行中安全终态化) /// [HttpPost("api/admin/update-batches/{batchId}/stop")] public async Task StopBatch( [FromRoute] string batchId, CancellationToken ct) { var actorUser = GetActorUsername(); var actorRole = GetActorRole(); var clientIp = GetClientIp(); var result = await _batchService.StopBatchAsync(batchId, actorUser, actorRole, clientIp, ct); if (result.StatusCode == 200) { return Ok(result.Dto); } 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 }); } /// /// 获取可用于升级的 Release 清单 /// [HttpGet("api/admin/update-releases")] public async Task GetReleases(CancellationToken ct) { var actorRole = GetActorRole(); var result = await _batchService.GetReleasesAsync(actorRole, ct); if (result.StatusCode == 200) { return Ok(result.Data); } if (result.StatusCode == 403) { return StatusCode(403, new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } return BadRequest(new { errorCode = result.ErrorCode, message = result.ErrorMessage }); } }