using System.Security.Claims; using ClassNotify.Server.Data; using ClassNotify.Server.Domain.Entities; using ClassNotify.Server.Services; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Identity; using Microsoft.AspNetCore.Mvc; using Microsoft.EntityFrameworkCore; namespace ClassNotify.Server.Controllers; public record TeacherProfileDto( string TeacherId, string? Username, string? FullName, string? SpaceName, string? Mobile, string SubscriptionState, DateTimeOffset? TrialEndsAt, DateTimeOffset? VipExpiresAt, int ActiveScreenCount, int ScreenLimit, DateTimeOffset CreatedAt ); public record UpdateTeacherProfileRequest( string? FullName, string? SpaceName ); public record TeacherChangePasswordRequest( string CurrentPassword, string NewPassword, string ConfirmPassword ); public record RotateRecoveryKeyRequest( string CurrentPassword ); public record ScreenDto( Guid DeviceId, string ClassAlias, bool IsOnline, DateTimeOffset BoundAt, string? ClientVersion = "v2.2.0", string? HardwareDeviceId = null ); public record ClaimScreenRequest( string PairingCode, string? ClassAlias ); [ApiController] [Route("api/teacher")] [Authorize] public class TeacherConsoleController : ControllerBase { private readonly ClassNotifyDbContext _db; private readonly IPairingService _pairingService; private readonly IConfiguration _config; private readonly IDeviceNotificationService _deviceNotificationService; private readonly ISecurityService _securityService; private readonly IPasswordHasher _passwordHasher; private readonly IInstallerTicketService _ticketService; private readonly ILogger _logger; public TeacherConsoleController( ClassNotifyDbContext db, IPairingService pairingService, IConfiguration config, IDeviceNotificationService deviceNotificationService, ISecurityService securityService, IPasswordHasher passwordHasher, IInstallerTicketService ticketService, ILogger logger) { _db = db; _pairingService = pairingService; _config = config; _deviceNotificationService = deviceNotificationService; _securityService = securityService; _passwordHasher = passwordHasher; _ticketService = ticketService; _logger = logger; } private string GetTeacherId() { return User.FindFirst(ClaimTypes.NameIdentifier)?.Value ?? User.FindFirst("sub")?.Value ?? string.Empty; } [HttpGet("me")] [HttpGet("profile")] public async Task> GetProfileAsync() { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在或未授权" }); var teacher = await _db.Users.Include(u => u.Tenant).FirstOrDefaultAsync(u => u.Id == teacherId); if (teacher == null) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在" }); var activeScreenCount = await _db.TeacherDeviceBindings .CountAsync(b => b.TeacherId == teacherId && b.IsActive); var screenLimit = _config.GetValue("Product:PersonalScreenLimit", 4); var now = DateTimeOffset.UtcNow; // 关键自愈逻辑:若教师尚未绑定任何大屏,且非正式 VIP,试用期尚未开启,TrialEndsAt 自动修正为 null,绝不提前扣除天数 if (activeScreenCount == 0 && teacher.VipExpiresAt == null && teacher.TrialEndsAt != null) { teacher.TrialEndsAt = null; await _db.SaveChangesAsync(); } var isVip = teacher.IsVipActive(now); string subState; if (isVip) { subState = "VIP"; } else if (teacher.TrialEndsAt == null || teacher.TrialEndsAt.Value > now) { subState = "Trial"; } else { subState = "Expired"; } return Ok(new TeacherProfileDto( TeacherId: teacher.Id, Username: teacher.Username, FullName: teacher.FullName, SpaceName: teacher.Tenant?.Name ?? "教师工作台", Mobile: teacher.Mobile, SubscriptionState: subState, TrialEndsAt: teacher.TrialEndsAt, VipExpiresAt: teacher.VipExpiresAt, ActiveScreenCount: activeScreenCount, ScreenLimit: screenLimit, CreatedAt: teacher.CreatedAt )); } [HttpPatch("profile")] public async Task UpdateProfileAsync([FromBody] UpdateTeacherProfileRequest req) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在或未授权" }); var teacher = await _db.Users.Include(u => u.Tenant).FirstOrDefaultAsync(u => u.Id == teacherId); if (teacher == null) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在" }); if (!string.IsNullOrWhiteSpace(req.FullName)) { var name = req.FullName.Trim(); if (name.Length > 50) return BadRequest(new { code = "INVALID_NAME", message = "教师称谓长度不能超过 50 个字符" }); teacher.FullName = name; } if (!string.IsNullOrWhiteSpace(req.SpaceName)) { var space = req.SpaceName.Trim(); if (space.Length > 100) return BadRequest(new { code = "INVALID_SPACE_NAME", message = "教学空间名称长度不能超过 100 个字符" }); if (teacher.Tenant != null && (teacher.Role == "TenantOwner" || teacher.Tenant.TenantType == "Personal")) { teacher.Tenant.Name = space; } } await _db.SaveChangesAsync(); _logger.LogInformation("Teacher {TeacherId} profile updated: FullName={FullName}, SpaceName={SpaceName}", teacher.Id, teacher.FullName, teacher.Tenant?.Name); var profileRes = await GetProfileAsync(); return profileRes.Result ?? Ok(profileRes.Value); } [HttpPost("account/change-password")] public async Task ChangePasswordAsync([FromBody] TeacherChangePasswordRequest req) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在或未授权" }); var teacher = await _db.Users.Include(u => u.Tenant).FirstOrDefaultAsync(u => u.Id == teacherId); if (teacher == null) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在" }); if (string.IsNullOrEmpty(req.CurrentPassword)) return BadRequest(new { code = "PASSWORD_REQUIRED", message = "请输入当前登录密码" }); if (string.IsNullOrEmpty(req.NewPassword) || req.NewPassword.Length < 8) return BadRequest(new { code = "PASSWORD_TOO_SHORT", message = "为了账户安全,新密码长度不能少于 8 位" }); if (req.NewPassword != req.ConfirmPassword) return BadRequest(new { code = "PASSWORD_MISMATCH", message = "两次输入的新密码不一致,请核对" }); var verifyResult = _passwordHasher.VerifyHashedPassword(teacher, teacher.PasswordHash, req.CurrentPassword); if (verifyResult == PasswordVerificationResult.Failed) { return BadRequest(new { code = "INVALID_CURRENT_PASSWORD", message = "当前密码不正确,请核对后重试" }); } teacher.PasswordHash = _passwordHasher.HashPassword(teacher, req.NewPassword); teacher.TokenVersion++; var remoteIp = HttpContext.Connection.RemoteIpAddress?.ToString(); _db.AdminAuditEvents.Add(new AdminAuditEvent { Id = $"aud_{Guid.NewGuid():N}"[..16], OccurredAt = DateTimeOffset.UtcNow, ActorUsername = teacher.Username, ActorRole = teacher.Role, Action = "TEACHER_CHANGE_PASSWORD", TargetType = "User", TargetId = teacher.Id, Details = "教师在控制台自主修改登录密码,旧凭据立即失效", IpAddress = remoteIp }); await _db.SaveChangesAsync(); var freshToken = _securityService.GenerateJwtToken(teacher, teacher.Tenant, isPasswordChangeOnly: false); _logger.LogInformation("Teacher {TeacherId} ({Username}) successfully changed password.", teacher.Id, teacher.Username); return Ok(new { success = true, message = "密码修改成功!新密码已生效", token = freshToken }); } [HttpPost("account/rotate-recovery-key")] public async Task RotateRecoveryKeyAsync([FromBody] RotateRecoveryKeyRequest req) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "TEACHER_NOT_FOUND", message = "教师账户不存在或未授权" }); if (string.IsNullOrEmpty(req.CurrentPassword)) return BadRequest(new { code = "PASSWORD_REQUIRED", message = "请输入当前密码以验证身份" }); var remoteIp = HttpContext.Connection.RemoteIpAddress?.ToString(); var (ok, msg, newKey) = await _securityService.RotateRecoveryKeyAsync(teacherId, req.CurrentPassword, remoteIp); if (!ok) { return BadRequest(new { code = "ROTATE_FAILED", message = msg }); } return Ok(new { success = true, message = msg, recoveryKey = newKey }); } [HttpGet("screens")] public async Task>> GetScreensAsync() { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "UNAUTHORIZED", message = "未登录" }); var bindings = await _db.TeacherDeviceBindings .Where(b => b.TeacherId == teacherId && b.IsActive) .ToListAsync(); var allDevices = await _db.Devices.ToListAsync(); var deviceDict = allDevices.ToDictionary(d => PairingService.ToDeviceGuid(d.Id), d => d); var dtos = bindings.Select(b => { deviceDict.TryGetValue(b.DeviceId, out var dev); var ver = dev?.ClientVersion; if (!string.IsNullOrEmpty(ver) && !ver.StartsWith('v')) ver = $"v{ver}"; return new ScreenDto( b.DeviceId, b.ClassAlias ?? "未命名教室", dev != null && dev.LastHeartbeatAt.HasValue && (DateTimeOffset.UtcNow - dev.LastHeartbeatAt.Value).TotalSeconds <= 120, b.BoundAt, ver ?? "v2.2.0", dev?.Id ); }).ToList(); return Ok(dtos); } [HttpPost("screens/claim")] public async Task ClaimScreenAsync([FromBody] ClaimScreenRequest req) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "UNAUTHORIZED", message = "未登录" }); if (string.IsNullOrWhiteSpace(req.PairingCode)) return BadRequest(new { code = "INVALID_PAIRING_CODE", message = "请输入有效的8位班级配对码" }); var (isValid, canonicalClassName, classError) = PairingService.ValidateAndCanonicalizeClassName(req.ClassAlias); if (!isValid) { return BadRequest(new { code = "INVALID_CLASS_NAME", message = classError }); } var normalizedCode = req.PairingCode.Replace(" ", "").Replace("-", "").Trim(); var result = await _pairingService.ClaimDeviceAsync(teacherId, normalizedCode, canonicalClassName); if (!result.Success) { return BadRequest(new { code = result.ErrorCode, message = result.ErrorMessage }); } if (result.DeviceId.HasValue) { try { var activeTeacherCount = await _db.TeacherDeviceBindings .CountAsync(b => b.DeviceId == result.DeviceId.Value && b.IsActive); await _deviceNotificationService.NotifyScreenClaimedAsync(result.DeviceId.Value, canonicalClassName ?? "教学班级", activeTeacherCount); } catch (Exception ex) { _logger.LogWarning(ex, "Failed to send real-time binding notification to screen {DeviceId}", result.DeviceId.Value); } } return Ok(new { deviceId = result.DeviceId, classAlias = canonicalClassName }); } [HttpDelete("screens/{deviceId}")] public async Task UnbindScreenAsync(string deviceId) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "UNAUTHORIZED", message = "未登录" }); var bindings = await _db.TeacherDeviceBindings .Where(b => b.TeacherId == teacherId && b.IsActive) .ToListAsync(); TeacherDeviceBinding? targetBinding = null; if (Guid.TryParse(deviceId, out var parsedGuid)) { targetBinding = bindings.FirstOrDefault(b => b.DeviceId == parsedGuid); } if (targetBinding == null) { var hashedGuid = PairingService.ToDeviceGuid(deviceId); targetBinding = bindings.FirstOrDefault(b => b.DeviceId == hashedGuid); } if (targetBinding == null) { var dev = await _db.Devices.FirstOrDefaultAsync(d => d.Id == deviceId || d.Hostname == deviceId || d.ClassroomId == deviceId); if (dev != null) { var devGuid = PairingService.ToDeviceGuid(dev.Id); targetBinding = bindings.FirstOrDefault(b => b.DeviceId == devGuid); } } if (targetBinding == null) { targetBinding = bindings.FirstOrDefault(b => b.ClassAlias == deviceId); } if (targetBinding != null) { targetBinding.IsActive = false; targetBinding.ReleasedAt = DateTimeOffset.UtcNow; await _db.SaveChangesAsync(); _logger.LogInformation("Teacher {TeacherId} unbound screen {DeviceId}", teacherId, targetBinding.DeviceId); } // Check if there are any remaining active screens for this teacher var remainingScreens = await _db.TeacherDeviceBindings .CountAsync(b => b.TeacherId == teacherId && b.IsActive); if (remainingScreens == 0) { var teacher = await _db.Users.FirstOrDefaultAsync(u => u.Id == teacherId); if (teacher != null && teacher.VipExpiresAt == null && teacher.TrialEndsAt != null) { teacher.TrialEndsAt = null; await _db.SaveChangesAsync(); _logger.LogInformation("Teacher {TeacherId} has 0 screens after unbind, reset TrialEndsAt to null", teacherId); } } return NoContent(); } /// /// 已绑定教师临时开启大屏配对模式(10分钟窗口) /// [HttpPost("screens/{deviceId:guid}/pairing-mode")] public async Task EnterPairingModeAsync(Guid deviceId) { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "UNAUTHORIZED", message = "未登录" }); var binding = await _db.TeacherDeviceBindings .FirstOrDefaultAsync(b => b.TeacherId == teacherId && b.DeviceId == deviceId && b.IsActive); if (binding == null) { return StatusCode(403, new { code = "DEVICE_BINDING_REQUIRED", message = "您没有管理此大屏配对状态的权限。" }); } var pairingCode = await _pairingService.ActivateTemporaryPairingAsync(deviceId, TimeSpan.FromMinutes(10)); await _deviceNotificationService.NotifyScreenEnterPairingModeAsync(deviceId, pairingCode, 600); return Ok(new { pairingCode, ttlSeconds = 600 }); } /// /// 已登录教师申请 Windows 客户端安装包临时下载凭据(10分钟窗口) /// 支持所有服务状态(Trial, Active, Expired),不因订阅到期卡住客户端获取 /// [HttpPost("download/windows-ticket")] public ActionResult GetWindowsInstallerTicket() { var teacherId = GetTeacherId(); if (string.IsNullOrEmpty(teacherId)) return Unauthorized(new { code = "UNAUTHORIZED", message = "未登录" }); var ticket = _ticketService.IssueTicket(teacherId, TimeSpan.FromMinutes(10)); return Ok(new { version = "2.2.0", downloadUrl = $"/download/windows?ticket={Uri.EscapeDataString(ticket)}", expiresInSeconds = 600 }); } }