package com.aurora.controller;

import com.aurora.annotation.OptLog;
import com.aurora.model.dto.AboutDTO;
import com.aurora.model.dto.AuroraAdminInfoDTO;
import com.aurora.model.dto.AuroraHomeInfoDTO;
import com.aurora.model.dto.WebsiteConfigDTO;
import com.aurora.enums.FilePathEnum;
import com.aurora.model.vo.ResultVO;
import com.aurora.service.AuroraInfoService;
import com.aurora.strategy.context.UploadStrategyContext;
import com.aurora.model.vo.AboutVO;
import com.aurora.model.vo.WebsiteConfigVO;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import javax.validation.Valid;

import static com.aurora.constant.OptTypeConstant.UPDATE;
import static com.aurora.constant.OptTypeConstant.UPLOAD;

//AuroraInfoController控制器类，用于处理访客上报和首页信息获取的请求
@Api(tags = "aurora信息")// 使用Swagger注解标记本类为API的"aurora信息"分组，方便生成交互式API文档
@RestController// 标识本类为RESTful控制器，组合了@Controller和@ResponseBody，所有方法返回值直接写入HTTP响应体
public class AuroraInfoController {

    @Autowired // 使用依赖注入自动装配AuroraInfoService，用于处理访客上报和首页信息查询等业务逻辑
    private AuroraInfoService auroraInfoService;

    @Autowired  // 注入文件上传策略上下文，用于处理图片等文件的上传操作
    private UploadStrategyContext uploadStrategyContext;

    @ApiOperation(value = "上报访客信息")
    @PostMapping("/report")  // 处理HTTP POST请求，路径为/report
    // 返回ResultVO<?>表示统一响应格式，?通配符表示返回值类型不确定或无返回体
    public ResultVO<?> report() {
        // 调用Service层方法处理访客上报的业务（如增加访客计数）
        auroraInfoService.report();
        // 返回操作成功的统一响应
        return ResultVO.ok();
    }

    // 获取系统首页信息（前端展示用）
    @ApiOperation(value = "获取系统信息")
    @GetMapping("/")  // 处理HTTP GET请求，路径为/（通常是根路径或首页）
    // 返回结果封装了AuroraHomeInfoDTO对象，包含博客首页所需的各种信息（比如文章标题...)
    public ResultVO<AuroraHomeInfoDTO> getBlogHomeInfo() {
        return ResultVO.ok(auroraInfoService.getAuroraHomeInfo());
    }

    // 获取系统后台管理信息（后台管理界面用）
    @ApiOperation(value = "获取系统后台信息")
    @GetMapping("/admin") // 处理HTTP GET请求，路径为/admin
    public ResultVO<AuroraAdminInfoDTO> getBlogBackInfo() {
        // 调用Service获取后台管理信息，可能包含统计数据、系统状态等
        //AuroraAdminInfoDTO为后台信息的封装类
        return ResultVO.ok(auroraInfoService.getAuroraAdminInfo());
    }

    //网站配置的后台接口
    @OptLog(optType = UPDATE)// 自定义操作日志注解，记录更新操作（UPDATE为操作类型常量）
    @ApiOperation(value = "更新网站配置")
    @PutMapping("/admin/website/config")
    public ResultVO<?> updateWebsiteConfig(@Valid @RequestBody WebsiteConfigVO websiteConfigVO) {
        // @Valid触发参数校验，@RequestBody接收JSON格式的网站配置数据
        auroraInfoService.updateWebsiteConfig(websiteConfigVO);
        return ResultVO.ok();
    }

    @ApiOperation(value = "获取网站配置")//获取网站配置的后台接口
    @GetMapping("/admin/website/config")
    public ResultVO<WebsiteConfigDTO> getWebsiteConfig() {
        return ResultVO.ok(auroraInfoService.getWebsiteConfig());
    }

    // 查看关于我信息（前台展示接口）
    @ApiOperation(value = "查看关于我信息")
    @GetMapping("/about")//处理GET请求的普通接口。普通用户也可访问
    public ResultVO<AboutDTO> getAbout() {
        //AboutDTO是“关于我”信息的封装类（包含个人介绍，头像，联系方式等）
        return ResultVO.ok(auroraInfoService.getAbout());
    }

    //修改“关于我”信息的后台管理接口
    @OptLog(optType = UPDATE) // 记录更新操作日志
    @ApiOperation(value = "修改关于我信息")// 修改关于我信息（后台管理）
    @PutMapping("/admin/about")
    public ResultVO<?> updateAbout(@Valid @RequestBody AboutVO aboutVO) {
        // @Valid校验AboutVO参数的合法性
        auroraInfoService.updateAbout(aboutVO);
        return ResultVO.ok();
    }

    @OptLog(optType = UPLOAD)// 记录上传操作日志
    @ApiOperation(value = "上传博客配置图片")//后台接口
    @ApiImplicitParam(name = "file", value = "图片", required = true, dataType = "MultipartFile")
    // Swagger参数说明，name指定参数名，value是描述，required=true表示必填，dataType是数据类型
    @PostMapping("/admin/config/images")
    // 返回结果是图片访问路径的字符串
    public ResultVO<String> savePhotoAlbumCover(MultipartFile file) {
        //通过上传策略上下文执行文件上传，FilePathEnum.CONFIG.getPath()指定配置文件存储路径
        return ResultVO.ok(uploadStrategyContext.executeUploadStrategy(file, FilePathEnum.CONFIG.getPath()));
    }

}