server/README.md

53 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

## 介绍
一个NestJS起始模板正在优化中。
## 功能
- Swagger接口文档
- 邮件发送功能(SMTP)
- 统一参数校验
- 统一异常拦截
- 统一响应结构
- 统一参数序列化
- 数据库功能(支持多配置)
- 数据库分页/条件/全部查询
- 静态页面
- 文件上传
- 文件下载
- Redis或内存缓存
- 日志输出到控制台/文件
- 统一配置/环境变量服务(类型安全且带默认值)
- 模块/控制器/服务基类
- 模板快速生成(业务型模板非NestJS脚手架的模板)
## 模块
- 用户模块
- 登陆模块
- 角色模块
- 权限模块
- 上传模块
- 文章模块
## 部署
目前基于 Gitea 和 Gitea Actions 实现,大致流程是这样的:提交代码到 Gitea 仓库后,触发流水线任务进行构建并打包成 Docker 镜像,推送到 Gitea 自带的软件包仓库,然后登陆生产服务器执行更新命令。
使用 Github Actions 也是可以的,两者使用上是兼容的。本仓库有关部署的内容涉及三个地方,不需要的话可自行删除,如下:
- Dockerfile 构建镜像的配置文件
- .dockerignore 配置哪些文件应该被忽略掉
- .gitea/workflows/depoy.yaml 流水线任务的配置文件,语法上与 Github Actions 一致
## 计划
- 双token无感刷新
- session/cookiejwtsso单点登陆
- 大文件上传,断点续传
## 笔记
- createUserDto与User分开
- 涉及关系时,先用 service 查出有效关系避免存储不存在的关联ID
## 最后
如果你在使用过程中遇到问题,欢迎在 Issue 中提问。