49 lines
2.0 KiB
TypeScript
49 lines
2.0 KiB
TypeScript
|
// services/api/src/photos/album-photos.controller.ts —— /albums/{albumId}/photos
|
|||
|
|
// 管理列表端点（P1b Task 4）。方法名与契约 operationId 一一对应
|
|||
|
|
// （listAlbumPhotos，tag [photos]——路由挂在相册子路径下，域仍属照片管理）。
|
|||
|
|
// 控制器级 SessionGuard：端点需认证。控制器只做认证用户透传 + 查询参数规整
|
|||
|
|
// （visibility 本域 dto / categoryId 空串归一 / cursor+limit 走 shared/pagination，
|
|||
|
|
// 同契约 bounds）；权限与 HTTP 映射由 PhotosService 抛 ApiException
|
|||
|
|
// （404 ALBUM_NOT_FOUND / 403 AUTH_FORBIDDEN / 400 VALIDATION_FAILED）。
|
|||
|
|
import {
|
|||
|
|
Controller,
|
|||
|
|
Get,
|
|||
|
|
Param,
|
|||
|
|
Query,
|
|||
|
|
Req,
|
|||
|
|
UseGuards,
|
|||
|
|
} from '@nestjs/common';
|
|||
|
|
import { userOf } from '../albums/albums.controller';
|
|||
|
|
import { AuthenticatedRequest, SessionGuard } from '../auth/session.guard';
|
|||
|
|
import { parseCursor, parseLimit } from '../shared/pagination';
|
|||
|
|
import { parseVisibilityFilter } from './dto';
|
|||
|
|
import { PhotosService, type AdminPhotoListResponse } from './photos.service';
|
|||
|
|
|
|||
|
|
@Controller('albums/:albumId/photos')
|
|||
|
|
@UseGuards(SessionGuard)
|
|||
|
|
export class AlbumPhotosController {
|
|||
|
|
constructor(private readonly photosService: PhotosService) {}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 管理照片列表：全部可见性状态可见（区别于公开列表仅 published），
|
|||
|
|
* (uploadedAt,id) 稳定倒序键集游标；条目内嵌 uploader 脱敏信息。
|
|||
|
|
*/
|
|||
|
|
@Get()
|
|||
|
|
listAlbumPhotos(
|
|||
|
|
@Param('albumId') albumId: string,
|
|||
|
|
@Query('visibility') visibility: string | undefined,
|
|||
|
|
@Query('categoryId') categoryId: string | undefined,
|
|||
|
|
@Query('cursor') cursor: string | undefined,
|
|||
|
|
@Query('limit') limit: string | undefined,
|
|||
|
|
@Req() req: AuthenticatedRequest,
|
|||
|
|
): Promise<AdminPhotoListResponse> {
|
|||
|
|
return this.photosService.listAlbumPhotos(userOf(req), albumId, {
|
|||
|
|
visibility: parseVisibilityFilter(visibility),
|
|||
|
|
// 空串视为缺省（同公开列表 category 规整惯例）。
|
|||
|
|
categoryId: categoryId === '' ? undefined : categoryId,
|
|||
|
|
cursor: parseCursor(cursor),
|
|||
|
|
limit: parseLimit(limit),
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
}
|