findAll() {
    return this.tasksRepository.find();
  }

这是一种简单的方法，可以调用********* find（） *********，基本上是喜欢的SELECT * FROM TASKS;现在我们可以在koude8端点上调用获取方法。

这将返回我们任务的JSON数组：

[
    {
        "id": 1,
        "createdAt": "2023-08-15T10:18:14.437Z",
        "updatedAt": "2023-08-15T10:18:14.437Z",
        "title": "This is a task 1",
        "done": false
    },
    {
        "id": 2,
        "createdAt": "2023-08-15T16:45:51.630Z",
        "updatedAt": "2023-08-15T16:45:51.630Z",
        "title": "This is a task 2",
        "done": false
    }
]

接下来，我们将实施************* findOne（） ************** *为了获取特定任务数据的方法：

@Get(':id')
  findOne(@Param('id') id: string) {
    return this.tasksService.findOne({ id: +id });
  }

首先，我们将在控制器中更新我们的FindOne方法以通过{id: +id}，因为我们将使用************ entityCondition ******* ******通过字段。最后，我们的服务中的发现方法将看起来像这样：

findOne(fields: EntityCondition<Task>): Promise<NullableType<Task>> {
    return this.tasksRepository.findOne({ where: fields });
  }

******************************************************** 接下来我们将写我们服务中的更新方法： ******************************************** *

update(id: Task['id'], payload: DeepPartial<Task>): Promise<Task> {
    return this.tasksRepository.save(
      this.tasksRepository.create({
        id,
        ...payload,
      }),
    );
  }

您可以看到，我们正在接受任务ID和有效负载，这基本上是部分DTO，此方法返回我们更新的任务。

*************** 接下来，我们将实施删除服务 ***************************************************

这是非常简单的方法：

remove(id: number) {
    return this.articlesRepository.delete(id);
  }

请注意，这些服务有各种各样的实现，我提供了简单的服务，有多种更新和处理错误，响应等的方法。但是可以根据特定的用例来实现。

前端 - 添加新资源

一旦我们启动并运行了后端，我们就可以实现前端。

我们将使用************* 完善Cli *************新资源。使用Refine Create Command创建项目时，将安装完善的CLI，但在此样板中已经可用。

将终端定位到前端目录（例如my-app）并运行以下命令：

npm run refine create-resource

此向导会要求您定义您的资源名称（在我们的情况下为任务），并随身携带所有页面。这将生成******* 任务 *******目录，并带有所需的所有页面。另外，它将使用新的资源数据更新app.tsx。

请注意，此命令不会生成路由，并且仅在生成页面中使用推论器。

**************************************************************************************************************************************************** ************************** 首先，我们将为我们的任务添加路线 **** ****************************************************** ****************

<Route path="/tasks">
                  <Route index element={<TasksList />} />
                  <Route path="create" element={<TasksCreate />} />
                  <Route path="edit/:id" element={<TasksEdit />} />
                  <Route path="show/:id" element={<TasksShow />} />
                </Route>

这些路线与我们的页面直接相关，但是由于RBAC限制，它们将立即看到。

我们必须编辑********* casbin *********访问控制。打开src/casbin/accessControl.ts并将以下内容添加到适配器：

p, 1, tasks, (list)|(create)|(edit)|(show)|(delete)
p, 2, tasks, (list)|(create)|(edit)|(show)|(delete)

这将使用户和管理员都能进行所有CRUD操作。

现在，如果您在Localhost上刷新前端，然后单击任务，则应查看任务列表。

**************************************************************************************************************************************************** **** 如果未自动添加，请在app.tsx中的任务资源添加以下内容： ********************************************************************************* ******************************************

meta: {
           canDelete: true,
      },

所有页面都是使用推论器生成的，一个来自Refine.dev的零件：https://refine.dev/docs/packages/documentation/inferencer

如果您单击“推论器”弹出，您将看到有关任务列表的生成代码，复制此代码并将其粘贴到tasks/list.tsx（替换当前代码）中。弹出将消失，您将具有自定义页面的灵活性。

如果您的控制台中存在错误或您的页面空白，则页面导出可能是错误的（任务清单而不是Taskslist），请检查此类问题。

I18N-翻译

导出后，我们可以为页面编辑翻译以显示真实值而不是对象字段。打开public/locales/en/common.json

将以下对象添加到与用户相同的级别：

"tasks": {
    "tasks": "Tasks",
    "fields": {
      "id": "ID",
      "title": "Title",
      "done": "Done",
      "createdAt": "Created at",
      "updatedAt": "Updated at"
    },
    "titles": {
      "create": "Create task",
      "edit": "Edit task",
      "list": "Tasks",
      "show": "Show task"
    }
  },

此外，在DocumentTitle下，与用户相同的级别添加以下级别：

"tasks": {
      "list": "Tasks | Poliath Manager",
      "show": "#{{id}} Show task | Poliath Manager",
      "edit": "#{{id}} Edit task | Poliath Manager",
      "create": "Create new task | Poliath Manager",
      "clone": "#{{id}} Clone task | Poliath Manager"
    },

上面用于页面标题。

为其他语言添加相同的字段。

当您刷新页面时，您应该看到字段现在的名称。

通过我们的前端创建新任务

这很简单，只需单击创建按钮并填写字段即可。 * 当然，您可以将推论器代码 *复制到您的create.tsx文件，例如在字段上删除并更新了，因为这些文件已在我们的后端。

单击“保存” - 您将获得错误422-无法处理的实体，这是因为我们没有传递受让人参数。但是如何获得呢？

我们可以使用************ Uselist ***********************是一个粗略的选择，因为它将所有用户加载到内存中，并且我们正在客户端进行解析。相反，我们应该使用USEMANY，它将调用我们的后端方法并仅检索我们实际需要的过滤用户。

const { data: data, isLoading } = useList<IUser>({
        resource: 'users'
    });

挥舞着

精炼提供了一些解决方案，例如数据提供商，但有时该代码不满足我们的需求。这就是为什么存在Swizzle的原因，它基本上会根据现有的预定义代码生成可以自定义的代码。

npm run refine swizzle

这就是我们可以编辑组件，验证页面，验证提供商等的方式

https://refine.dev/docs/tutorial/understanding-dataprovider/swizzle/#what-is-swizzle

发送电子邮件

此样板已实施了电子邮件服务，并且在src/mail/mail.service.ts中实现了用法，可以用作自定义的参考。

其他工具和信息

后端带有方便的开发工具，例如：

1. Swagger-完整的API文档（http://localhost:3000/docs）
2. Adminer-数据库的客户端（http://localhost:8080）
3. MailDev -SMTP服务器（http://localhost:1080）

请注意，这些服务应在生产中禁用！

在生产中运行

完成后端逻辑后，可以使用Docker在生产中运行它。您应该禁用上述开发工具。

请注意，如果您之前正在运行此样板，以获取代码，迁移等的最新更新。您首先必须重建Docker Image！

docker compose build --no-cache

默认情况下实现了记录，并且在./logs目录中可用日志。

结论

请注意，您可能需要在很多情况下编辑默认代码（例如，更改查询方法，更新当前DTO等），但这是任何项目的绝佳起点。

此外，此文档将根据需要进行更新或修复，并提供新功能，修复和改进。

问题和错误

请注意，此文档主要旨在加快您的入职过程。虽然它可能提供一些“快捷方式”解决方案，但这些解决方案纯粹是为了说明目的，以帮助阐明该样板的工作。如果您是否在前端或后端遇到任何问题，我们鼓励您在GitHub上提出一个问题：

• 精炼样板：https://github.com/poliath/poliath-refine-boilerplate
• Nestjs样板：https://github.com/poliath/nestjs-poliath-boilerplate