import { Controller, Get } from '@nestjs/common';
import { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';
import { AppService } from './app.service';
import { AppStatusResponseDto } from './dto/app.dto';
import { ErrorResponseDto } from './dto/error_response.dto';

/**
 * 应用根控制器
 * 
 * 功能描述：
 * - 提供应用基础信息和健康检查接口
 * - 用于监控服务运行状态
 * 
 * @author moyin
 * @version 1.0.0
 * @since 2025-12-17
 */
@ApiTags('App')
@Controller()
export class AppController {
  constructor(private readonly appService: AppService) {}

  /**
   * 获取应用状态
   * 
   * 功能描述：
   * 返回应用的基本运行状态信息，用于健康检查和监控
   * 
   * @returns 应用状态信息
   */
  @Get()
  @ApiOperation({ 
    summary: '获取应用状态',
    description: '返回应用的基本运行状态信息，包括服务名称、版本、运行时间等。用于健康检查和服务监控。'
  })
  @ApiResponse({ 
    status: 200, 
    description: '成功获取应用状态',
    type: AppStatusResponseDto
  })
  @ApiResponse({ 
    status: 500, 
    description: '服务器内部错误',
    type: ErrorResponseDto
  })
  getStatus(): AppStatusResponseDto {
    return this.appService.getStatus();
  }
}