todo

一个简易的 todo 项目，包含后端和前端

线上示例：https://env-caafniqh-1253337886.ap-shanghai.app.tcloudbase.com/todo

一键部署：

解决 CloudBase Framework Node.JS 版本过低问题

截至目前， CloudBase Framework 最高仅支持 Node.JS 12.16，很多依赖已经无法正常使用了

这将导致部署的云函数启动失败

为了解决这个问题，你需要或先创建同名云函数再部署，创建云函数时选择 nodejs 版本为 16.13 （目前最高的支持）

或一键部署后删除 todo 云函数，然后再重建一个同名函数，然后再次部署。

介绍

使用了数据库两个文档：todo-user, todo-todo。

测试账号：

• email: test@hal.wang
• password: 123456

前端：vue3 + pinia + ant-design

后端：halsp

全部使用 ts 开发

权限认证

使用 JWT 进行了基本的权限认证

前端使用 localStorage 进行 Token 管理和验证

后端写了以下几种权限

• 管理员: 用 @Admin 装饰的 Action
• 开放: 用 @Open 装饰的 Action
• 普通用户：默认，需要登录状态

二次开发

如果现有功能不能满足，你可以进行二次开发

API

在 todo-api 下创建文件 .env.local，内容如下

SCF_NAMESPACE=cloudbase环境id
SECRET_KEY=腾讯云 secret key
SECRET_ID=腾讯云 secret id
JWT_SECRET=JWT 密钥

运行 API

先安装依赖，在 todo-api 下执行

yarn install

再使用 vscode 打开 todo-api，直接 F5 开始调试

或在 todo-api 目录下执行

yarn dev

Web

先安装依赖，在 todo-web 下执行

yarn install

再执行下面命令运行

yarn dev

或使用已发布的接口，需要修改 todo-web/.env.stage 文件中的 VUE_APP_BASE_API

然后运行

yarn dev:stage

发布

可以本地使用 @cloudbase/cli 发布，也可以使用 GitHub Actions 持续集成

cli 发布

在项目根目录下创建 .env.local （注意是项目根目录，不是 API 或 Web 下）

内容如下

ENV_ID=cloudbase环境id
JWT_SECRET=JWT 密钥

在项目根目录下运行以下命令发布

yarn deploy

GitHub Actions

仓库增加 Secrets，在 Settings -> Secrets -> Actions，点击 New repository secret 按钮

• TENCENT_SECRET_ID: 腾讯云 secret id
• TENCENT_SECRET_KEY: 腾讯云 secret key
• ENV: 与 cli 发布 的 .env.local 文件内容相同

配置完成后，每次 main 分支提交代码就会自动发布到 CloudBase

发布进度可在仓库 Actions 中看到