canina/backend/src/settings/settings.controller.ts

import { Controller, Get, Patch, Put, Delete, Body, Param, UseGuards, HttpStatus } from '@nestjs/common';
import { SettingsService } from './settings.service';
import { JwtAuthGuard } from '../auth/jwt-auth.guard';
import { ApiTags, ApiOperation, ApiBearerAuth, ApiResponse, ApiOkResponse, ApiUnauthorizedResponse } from '@nestjs/swagger';

@ApiTags('Settings - تنظیمات متون پویا و واژه‌نامه علمی')
@Controller('settings')
export class SettingsController {
  constructor(private readonly settingsService: SettingsService) {}

  @Get('ui-texts')
  @ApiOperation({ summary: 'دریافت تمامی متون و پیکربندی‌های رابط کاربری' })
  @ApiOkResponse({
    description: 'یک آبجکت کلید-مقدار حاوی تمامی متون، شعارها و برچسب‌های دکمه‌ها',
    schema: {
      example: {
        hero_badge: "تخصص دارویی از آلمان",
        hero_title: "تخصص آلمانی در خدمت سلامت پت‌های خانگی",
        hero_desc: "بیش از ۴۰ سال تجربه نوآورانه..."
      }
    }
  })
  getUiTexts() {
    return this.settingsService.getUiTexts();
  }

  @UseGuards(JwtAuthGuard)
  @ApiBearerAuth()
  @Patch('ui-texts/:key')
  @ApiOperation({ summary: 'ویرایش متن یک کلید در رابط کاربری (نیازمند توکن)' })
  @ApiOkResponse({
    description: 'متن با موفقیت به‌روزرسانی شد',
    schema: {
      example: {
        key: 'hero_badge',
        value: 'تخصص دارویی ممتاز از آلمان'
      }
    }
  })
  @ApiUnauthorizedResponse({
    description: 'عدم دسترسی به دلیل عدم احراز هویت',
    schema: { example: { success: false, message: 'Unauthorized', code: 'UNAUTHORIZED' } }
  })
  updateUiText(@Param('key') key: string, @Body('value') value: string) {
    return this.settingsService.updateUiText(key, value);
  }

  @Get('scientific-terms')
  @ApiOperation({ summary: 'دریافت تمامی اصطلاحات واژه‌نامه علمی' })
  @ApiOkResponse({
    description: 'لیست کامل اصطلاحات علمی به همراه تعاریف و شناسه‌ها',
    schema: {
      example: [
        {
          key: 'green-mussel',
          term: 'صدف لب‌سبز (Perna Canaliculus)',
          definition: 'این صدف بومی سواحل بکر نیوزیلند است...',
          wikiId: 'general'
        }
      ]
    }
  })
  getScientificTerms() {
    return this.settingsService.getScientificTerms();
  }

  @UseGuards(JwtAuthGuard)
  @ApiBearerAuth()
  @Put('scientific-terms/:key')
  @ApiOperation({ summary: 'ثبت یا ویرایش یک اصطلاح علمی (نیازمند توکن)' })
  @ApiOkResponse({
    description: 'اصطلاح علمی ثبت یا ویرایش شد',
    schema: {
      example: {
        key: 'green-mussel',
        term: 'صدف لب‌سبز اصل نیوزیلند',
        definition: 'این صدف بومی سواحل بکر نیوزیلند است...',
        wikiId: 'general'
      }
    }
  })
  @ApiUnauthorizedResponse({
    description: 'عدم دسترسی',
    schema: { example: { success: false, message: 'Unauthorized', code: 'UNAUTHORIZED' } }
  })
  upsertScientificTerm(@Param('key') key: string, @Body() data: any) {
    return this.settingsService.upsertScientificTerm(key, data);
  }

  @UseGuards(JwtAuthGuard)
  @ApiBearerAuth()
  @Delete('scientific-terms/:key')
  @ApiOperation({ summary: 'حذف یک اصطلاح علمی (نیازمند توکن)' })
  @ApiOkResponse({
    description: 'اصطلاح علمی حذف شد',
    schema: {
      example: {
        success: true,
        message: 'Scientific term successfully deleted'
      }
    }
  })
  @ApiUnauthorizedResponse({
    description: 'عدم دسترسی',
    schema: { example: { success: false, message: 'Unauthorized', code: 'UNAUTHORIZED' } }
  })
  deleteScientificTerm(@Param('key') key: string) {
    return this.settingsService.deleteScientificTerm(key);
  }
}