R524809
63 lines
2.0 KiB
TypeScript
63 lines
2.0 KiB
TypeScript
import { Controller, Get, Param, Query } from '@nestjs/common';
|
||
import {
|
||
ApiNotFoundResponse,
|
||
ApiOkResponse,
|
||
ApiOperation,
|
||
ApiParam,
|
||
ApiTags,
|
||
} from '@nestjs/swagger';
|
||
import type {
|
||
ApiSuccess,
|
||
PublicWorksheet,
|
||
WorksheetPage,
|
||
} from '@doodle/contracts';
|
||
import { Public } from '../auth/auth.decorators';
|
||
import { WorksheetQueryDto } from './worksheet-query.dto';
|
||
import { WorksheetService } from './worksheet.service';
|
||
|
||
@Controller('worksheets')
|
||
@ApiTags('worksheets')
|
||
@Public()
|
||
/** 小程序与未来 Web 共用的公开只读接口，不提供管理状态或原始统计的查询开关。 */
|
||
export class WorksheetController {
|
||
constructor(private readonly worksheets: WorksheetService) {}
|
||
|
||
@Get()
|
||
@ApiOperation({
|
||
summary: '分页查询全部/分类/年级/年龄段/Tag，支持最新和热门排序',
|
||
security: [],
|
||
description:
|
||
'条件可组合，题型及全部上级分类必须 active；sort=hot 按下载展示值降序；isHot 为运营标记筛选。预览未就绪返回 null。',
|
||
})
|
||
@ApiOkResponse({
|
||
description:
|
||
'{code:0,message:"ok",data:{items,total,page,pageSize,hasNext}}；downloads/likes 为含 seed 的十进制字符串。',
|
||
})
|
||
async list(
|
||
@Query() query: WorksheetQueryDto,
|
||
): Promise<ApiSuccess<WorksheetPage>> {
|
||
return {
|
||
code: 0,
|
||
message: 'ok',
|
||
data: await this.worksheets.list(query),
|
||
};
|
||
}
|
||
|
||
@Get(':id')
|
||
@ApiOperation({
|
||
summary: '公开题型详情；不存在或未发布返回 404',
|
||
security: [],
|
||
})
|
||
@ApiParam({
|
||
name: 'id',
|
||
example: 'number-find',
|
||
description: '使用题型列表 data.items 中的 id，例如 number-find',
|
||
})
|
||
@ApiNotFoundResponse({
|
||
description: '题型不存在，或题型及所属分类链尚未全部上线',
|
||
})
|
||
async get(@Param('id') id: string): Promise<ApiSuccess<PublicWorksheet>> {
|
||
return { code: 0, message: 'ok', data: await this.worksheets.get(id) };
|
||
}
|
||
}
|