feat: 更新 API 响应结构,统一使用 statusCode 和 errMsg 替代 code 和 msg;新增用户类型和公司 ID 字段;优化数据库索引;添加公司所有者同步测试脚本
This commit is contained in:
@@ -171,7 +171,7 @@ hooks 查询时统一联查 `tbl_attachments`,并补充:
|
||||
|
||||
处理方式:
|
||||
|
||||
- 登录路由本地 try/catch 显式返回 `{ code, msg, data }`
|
||||
- 登录路由本地 try/catch 显式返回 `{ statusCode, errMsg, data }`
|
||||
- 全局错误包装提前注册
|
||||
- 保存 auth 用户时透传原始错误信息
|
||||
|
||||
@@ -409,3 +409,5 @@ hooks 查询时统一联查 `tbl_attachments`,并补充:
|
||||
1. `refresh-token` 当前仅依赖 `users_wx_openid`,未校验旧 token
|
||||
2. 微信手机号能力依赖微信官方 `access_token` 与 `users_phone_code`
|
||||
3. 当前后端为 JavaScript + Express 架构,未引入 TypeScript 编译链
|
||||
|
||||
|
||||
|
||||
32
docs/api.md
32
docs/api.md
@@ -8,7 +8,7 @@
|
||||
- 基础路径(生产):`https://bai-api.blv-oa.com/pb/api`
|
||||
- 基础路径(本地):`http://localhost:8090/pb/api`
|
||||
- 响应格式:JSON
|
||||
- 业务响应结构统一为:`code`、`msg`、`data`
|
||||
- 业务响应结构统一为:`statusCode`、`errMsg`、`data`
|
||||
- 当前公开接口统一使用 **POST** 方法
|
||||
- 微信写接口统一要求 `Content-Type: application/json`
|
||||
|
||||
@@ -20,8 +20,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"statusCode": 200,
|
||||
"errMsg": "操作成功",
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
@@ -30,8 +30,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 400,
|
||||
"msg": "错误信息",
|
||||
"statusCode": 400,
|
||||
"errMsg": "错误信息",
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
@@ -51,8 +51,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "请求成功",
|
||||
"statusCode": 200,
|
||||
"errMsg": "请求成功",
|
||||
"data": {
|
||||
"message": "Hello, World!",
|
||||
"timestamp": "2026-03-20T00:00:00.000Z",
|
||||
@@ -72,8 +72,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "服务运行正常",
|
||||
"statusCode": 200,
|
||||
"errMsg": "服务运行正常",
|
||||
"data": {
|
||||
"status": "healthy",
|
||||
"timestamp": "2026-03-20T00:00:00.000Z"
|
||||
@@ -122,8 +122,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "登录成功",
|
||||
"statusCode": 200,
|
||||
"errMsg": "登录成功",
|
||||
"data": {
|
||||
"status": "login_success",
|
||||
"is_info_complete": true,
|
||||
@@ -203,8 +203,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "信息更新成功",
|
||||
"statusCode": 200,
|
||||
"errMsg": "信息更新成功",
|
||||
"data": {
|
||||
"status": "update_success",
|
||||
"user": {
|
||||
@@ -258,8 +258,8 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "刷新成功",
|
||||
"statusCode": 200,
|
||||
"errMsg": "刷新成功",
|
||||
"data": {
|
||||
"token": "new-jwt-token"
|
||||
}
|
||||
@@ -305,3 +305,5 @@ Authorization: Bearer <token>
|
||||
```
|
||||
|
||||
不需要旧 `Authorization`。
|
||||
|
||||
|
||||
|
||||
@@ -108,7 +108,7 @@ npm run test
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"statusCode": 200,
|
||||
"message": "success",
|
||||
"data": {}
|
||||
}
|
||||
@@ -118,7 +118,7 @@ npm run test
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 400,
|
||||
"statusCode": 400,
|
||||
"message": "错误信息",
|
||||
"data": null
|
||||
}
|
||||
@@ -150,4 +150,5 @@ npm run test
|
||||
|
||||
## 部署说明
|
||||
|
||||
详见 [部署文档](deployment.md)。
|
||||
详见 [部署文档](deployment.md)。
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> 来源:线上 PocketBase collection 回读、`script/pocketbase.newpb.js`
|
||||
> 类型:`auth`
|
||||
> 读写规则:仅管理员 / 管理角色允许
|
||||
> 读写规则:公开允许新增与修改;列表 / 详情 / 删除仍仅管理员 / 管理角色允许
|
||||
|
||||
## 表用途
|
||||
|
||||
|
||||
@@ -39,7 +39,7 @@
|
||||
| :--- | :--- | :--- |
|
||||
| `idx_company_id` | `UNIQUE INDEX` | 保证 `company_id` 唯一 |
|
||||
| `idx_company_usci` | `INDEX` | 加速按统一社会信用代码查询 |
|
||||
| `idx_company_owner_openid` | `INDEX` | 加速按公司所有者查询 |
|
||||
| `idx_company_owner_openid` | `UNIQUE INDEX` | 限制同一公司所有者仅能绑定一个公司 |
|
||||
|
||||
## 补充约定
|
||||
|
||||
|
||||
Reference in New Issue
Block a user