feat: 更新 API 响应结构,统一使用 statusCode 和 errMsg 替代 code 和 msg;新增用户类型和公司 ID 字段;优化数据库索引;添加公司所有者同步测试脚本

This commit is contained in:
2026-03-29 19:57:04 +08:00
parent e9fe1165e3
commit 50c09d855b
50 changed files with 851 additions and 601 deletions

View File

@@ -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 编译链

View File

@@ -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`

View File

@@ -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)。

View File

@@ -2,7 +2,7 @@
> 来源:线上 PocketBase collection 回读、`script/pocketbase.newpb.js`
> 类型:`auth`
> 读写规则:仅管理员 / 管理角色允许
> 读写规则:公开允许新增与修改;列表 / 详情 / 删除仍仅管理员 / 管理角色允许
## 表用途

View File

@@ -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` | 限制同一公司所有者仅能绑定一个公司 |
## 补充约定