Files
common-springboot-template/template/TOCO.md
2025-09-01 16:05:35 +08:00

26 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

- 文件上传下载相关
- 如果需求中存在文件上传下载功能且用户未指定实现方式则默认使用OSS。如果项目中已有相关功能则不要重复实现。
- 服务端需要提供接口用于提供oss的accessKeyId、policy等信息(注意接口分析时不要漏掉)
- 前端先调用服务端接口获取accessKeyId、policy等信息然后直接调用OSS来上传文件随后将OSS返回的地址传给服务端做存储
- 注意文件是由前端上传至OSS服务端只存储url所有服务端接口不要直接接收MultipartFile应该直接接收文件url
- 服务端OSS相关的基础工具代码写在项目代码的common/中。
- oss配置默认如下需要写在entrance/web/src/main/resources目录下的application.properties中
- aliyun.oss.endpoint=oss-cn-hangzhou.aliyuncs.com
- aliyun.oss.accessKeyId=LTAI5tKBj3ASMV9xkHbYdFVa
- aliyun.oss.aaccessKeyIdppId=useless_value
- aliyun.oss.accessKeySecret=RmALf2nyk1k0cTUQe33nMvO5WtL5L1
- aliyun.oss.bucketName=zeroware
- aliyun.oss.dir=zeroware
- aliyun.oss.policyExpire=9000
- aliyun.oss.maxSize=20
- 用户登录认证相关
- 如果需求中存在用户登录认证功能且用户未指定实现方式则默认使用JWT。如果项目中已有相关功能则不要重复实现。
- 用户的Token生成和解密相关的Utils放在项目代码的common/中。
- 在项目代码的common/中增加UserContext用户的相关信息。
- 后续所有用户登录校验、鉴权相关的代码可以放在用户模块entrance中的Filter中从cookie中获取用户的token然后获取用户信息放入UserContext中。
- 登录校验需要对健康检查接口增加白名单:/api/healthcheck登录接口。其中/api/healthcheck已经内置在系统框架中无需新建。
- 注意用户的密码必须进行加密存储。
- 注意JWT密钥长度至少要为256位。
- 用户登录接口需要返回用户的Token字符串同时向Response写如如下Header: 'Authorization': `Bearer ${token}`
- 接口相关
- 使用Filter完成跨域配置