namespace Admin.NET.Plugin.HwPortal;

[Route("portal/analytics")]
public class HwAnalyticsController : HwPortalControllerBase
{
    private readonly HwAnalyticsService _service;

    public HwAnalyticsController(HwAnalyticsService service)
    {
        _service = service;
    }

    // 这里故意用 POST，而不是 GET。
    // 原因是埋点采集本质上是“写入事件”，语义上就应该是 POST。
    // Spring Boot 里这个思路也一样，只是写法会是 @PostMapping("/collect")。
    [HttpPost("collect")]
    [AllowAnonymous]
    // [Consumes] 是 ASP.NET Core 的请求体内容类型约束。
    // 它告诉框架：这个接口允许 application/json 和 text/plain 两种 Content-Type。
    // 之所以要写这个，是因为原 ruoyi-portal 明确支持前端把 JSON 字符串当 text/plain 发过来。
    [Consumes("application/json", "text/plain")]
    [HwPortalIpRateLimit("portal_analytics_collect", 60, 240)]
    public async Task<HwPortalAjaxResult> Collect()
    {
        // 这里没有直接写参数 [FromBody] AnalyticsCollectRequest request，
        // 是因为我们要同时兼容 “真正 JSON 请求体” 和 “text/plain 包着 JSON 字符串” 两种历史行为。
        // 如果强行交给默认模型绑定，text/plain 场景很容易直接绑定失败。
        string body = await ReadRequestBodyAsync();
        if (string.IsNullOrWhiteSpace(body))
        {
            return Error("请求体不能为空");
        }

        try
        {
            // JsonSerializer.Deserialize<T>() 是 C# 常见的 JSON 反序列化写法。
            // 你可以把它理解成 Jackson 的 objectMapper.readValue(body, AnalyticsCollectRequest.class)。
            AnalyticsCollectRequest request = JsonSerializer.Deserialize<AnalyticsCollectRequest>(body, new JsonSerializerOptions
            {
                // PropertyNameCaseInsensitive = true 表示“属性名大小写不敏感”。
                // 这样前端传 eventType / EventType / eventtype 都能尽量兼容，减少历史字段命名不统一导致的问题。
                PropertyNameCaseInsensitive = true
            });

            // HttpContext 是 ASP.NET Core 里贯穿整个请求的核心上下文对象。
            // 类似于你在 Spring MVC 里能拿到的 HttpServletRequest / SecurityContext / RequestAttributes 的组合入口。
            await _service.Collect(request, HwPortalContextHelper.CurrentRequestIp(HttpContext), Request.Headers["User-Agent"].ToString());
            return Success();
        }
        catch (Exception ex)
        {
            // 这里不把异常直接抛出去，而是转成兼容 AjaxResult。
            // 原因是这个接口在源模块里就是“失败返回 error(msg)”风格，迁移后要保持对外行为一致。
            return Error($"采集失败: {ex.Message}");
        }
    }

    [HttpGet("dashboard")]
    public async Task<HwPortalAjaxResult> Dashboard([FromQuery] DateTime? statDate, [FromQuery(Name = "top")] int? top)
    {
        // DateTime? 里的问号表示“可空类型”。
        // Java 里你常见 Date/LocalDate 可以为 null；C# 的值类型默认不能为 null，所以要写成 DateTime? 才能接收空值。
        return Success(await _service.GetDashboard(statDate, top));
    }

    [HttpPost("refreshDaily")]
    public async Task<HwPortalAjaxResult> RefreshDaily([FromQuery] DateTime? statDate)
    {
        await _service.RefreshDailyStat(statDate);
        return Success(null, "刷新成功");
    }

    private async Task<string> ReadRequestBodyAsync()
    {
        // Request.EnableBuffering() 的作用是“允许请求体被重复读取”。
        // 这一点和 Java Servlet 最大的差异之一在于：
        // Java 里 InputStream 一般读一次就没了，ASP.NET Core 这里也一样，所以如果你想自己读取后还让后续组件继续用，就必须先开启缓冲。
        Request.EnableBuffering();

        // Position = 0 表示把流指针移回开头。
        // 你可以把它理解成“从头重新读一遍文件/流”。
        Request.Body.Position = 0;

        // using StreamReader reader = new(...) 是 C# 的资源释放语法。
        // Java 里你可以类比 try-with-resources。
        // leaveOpen: true 的意思是“Reader 用完后，不要顺手把底层 Request.Body 也关掉”，否则后续框架再访问请求体就会出问题。
        using StreamReader reader = new(Request.Body, Encoding.UTF8, detectEncodingFromByteOrderMarks: false, leaveOpen: true);
        string body = await reader.ReadToEndAsync();

        // 读完后把流指针再拨回起点，这是为了保证后续如果别的组件还想读请求体，不会读到空内容。
        Request.Body.Position = 0;
        return body;
    }
}