DTO、工具与通用服务

1. `PaginationDto`

分页 DTO 基类：

export class PaginationDto {
    page?: number = 1;
    pageSize?: number = 15;
}

用于忽略 undefined 条件，简化列表查询：

const where = buildWhere<Article>({
    status,
    categoryId,
    title: title ? Like(`%${title}%`) : undefined,
});

适合存放平台配置、运营配置、页面配置。

读取：

const config = await this.dictService.get("home_config", {}, "website");

带文件 URL 恢复：

const config = await this.dictService.get("hero", {}, "website", {
    restoreFileUrlFields: ["cover", "items.*.icon"],
});

写入：

await this.dictService.set("home_config", payload, {
    group: "website",
    normalizeFileUrlFields: ["cover", "items.*.icon"],
});

负责物理落盘：

保存 Multer 文件

保存 Buffer

保存远程文件

按类型/日期生成目录

负责相对路径与完整 URL 互转：

set(url)：完整 URL 入库前转相对路径

get(path)：读取时补完整域名

用于管理结构化密钥配置，适合：

AI Provider 密钥

支付密钥

第三方 API Key / Secret

如果是敏感密钥配置，优先考虑 SecretService，不要直接扔进普通字典。