Boonlive_RD_Web/Web_BAI_Manage_ApiServer
9
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cafd69ea2cd51d29b4a9f295eb0d793377676998
Web_BAI_Manage_ApiServer/pocket-base/spec/openapi.yaml

1892 lines
67 KiB
YAML
Raw Normal View History

feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
openapi: 3.1.0
info:
title: BAI PocketBase Hooks API
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: |
基于 PocketBase `bai_api_pb_hooks` 的对外接口文档，可直接导入 Postman。
当前 `tbl_auth_users.openid` 已被定义为全平台统一身份锚点：
- 微信用户：`openid = 微信 openid`
- 平台用户：`openid = 服务端生成的 GUID`
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
请在 Apifox 环境中统一设置全局 Header：`Authorization: Bearer {{token}}`。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
version: 1.0.0
servers:
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
- url: https://bai-api.blv-oa.com
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
description: 生产环境
- url: http://localhost:8090
description: PocketBase 本地环境
tags:
- name: 系统
description: 基础检查接口
- name: 微信认证
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 面向微信用户的认证接口；认证成功后仍统一使用全平台 `openid` 与 PocketBase 原生 token。
- name: 平台认证
description: 面向平台用户的认证接口；平台用户会生成 GUID 并写入统一 `openid` 字段。
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
- name: 字典管理
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 字典读接口公开；字典写接口面向 ManagePlatform 用户。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
- name: 附件管理
description: 面向 ManagePlatform 用户的附件上传、查询与删除接口。
- name: 文档管理
description: 面向 ManagePlatform 用户的文档新增、查询、修改、删除接口；查询时会自动返回关联附件的 PocketBase 文件流链接。
- name: 文档历史
description: 面向 ManagePlatform 用户的文档操作历史查询接口。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
components:
schemas:
ApiResponse:
type: object
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
required: [statusCode, errMsg, data]
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
properties:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
statusCode:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: integer
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务状态码"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
example: 200
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
errMsg:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务提示信息"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
example: 操作成功
data:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务响应数据"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: object
additionalProperties: true
HealthData:
type: object
properties:
status:
type: string
example: healthy
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
version:
type: string
description: 当前已部署 hooks 版本号，用于确认发布是否生效
example: 2026.03.26-health-probe.1
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
timestamp:
type: string
format: date-time
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
UsersCountData:
type: object
properties:
total_users:
type: integer
description: tbl_auth_users 表中的用户总数
example: 128
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
HelloWorldData:
type: object
properties:
message:
type: string
example: Hello, World!
timestamp:
type: string
format: date-time
status:
type: string
example: success
build_time:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
anyOf:
- type: string
format: date-time
- type: 'null'
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
CompanyInfo:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 用户所属公司信息；当用户尚未绑定公司时返回 `null`
anyOf:
- type: object
properties:
pb_id:
type: string
description: PocketBase 记录主键 id
company_id:
type: string
description: 公司业务 id，由数据库自动生成
company_name:
type: string
description: 公司名称
company_type:
type: string
description: 公司类型
company_entity:
type: string
description: 公司法人
company_usci:
type: string
description: 统一社会信用代码
company_nationality:
type: string
description: 国家名称
company_nationality_code:
type: string
description: 国家编码
company_province:
type: string
description: 省份名称
company_province_code:
type: string
description: 省份编码
company_city:
type: string
description: 城市名称
company_city_code:
type: string
description: 城市编码
company_district:
type: string
description: 区/县名称
company_district_code:
type: string
description: 区/县编码
company_postalcode:
type: string
description: 邮政编码
company_add:
type: string
description: 公司地址
company_status:
type: string
description: 公司状态
company_level:
type: string
description: 公司等级
company_owner_openid:
type: string
description: 公司所有者 openid
company_remark:
type: string
description: 备注
created:
type: string
description: 记录创建时间
updated:
type: string
description: 记录更新时间
- type: 'null'
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
UserInfo:
type: object
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: |
统一用户视图。
其中 `openid` 为全平台统一身份标识：微信用户使用微信 openid，平台用户使用服务端生成 GUID。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
properties:
pb_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 记录主键 id"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_convers_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "会话侧用户 ID"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
users_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户业务 ID"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_idtype:
description: 用户身份来源类型
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
anyOf:
- type: string
enum: [WeChat, ManagePlatform]
- type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_id_number:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "证件号"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
users_status:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户状态"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_rank_level:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户星级数值"
type: [number, string]
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_auth_type:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "账户类型"
type: [number, string]
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
users_type:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户类型"
anyOf:
- type: string
enum: [游客, 注册用户]
- type: string
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
users_name:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户姓名 / 昵称"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
users_phone:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "手机号"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
users_phone_masked:
type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_level:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 用户等级
feat: 添加 SDK 权限管理页面和产品功能字段迁移脚本 - 新增 SDK 权限管理页面，包含角色管理、用户授权和集合权限配置功能。 - 实现字段迁移脚本，向 tbl_product_list 集合添加 prod_list_function 字段，类型为 json。
2026-04-03 18:35:50 +08:00
users_level_name:
type: string
description: 用户等级名称，按 `users_level -> 数据-会员等级` 字典描述实时解析
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
users_tag:
type: string
description: 用户标签
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
users_picture:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: 用户头像附件的 `attachments_id`
users_picture_url:
type: string
description: 根据 `users_picture -> tbl_attachments` 自动解析出的头像文件流链接
users_id_pic_a:
type: string
description: 证件正面附件的 `attachments_id`
users_id_pic_a_url:
type: string
description: 根据 `users_id_pic_a -> tbl_attachments` 自动解析出的文件流链接
users_id_pic_b:
type: string
description: 证件反面附件的 `attachments_id`
users_id_pic_b_url:
type: string
description: 根据 `users_id_pic_b -> tbl_attachments` 自动解析出的文件流链接
users_title_picture:
type: string
description: 资质附件的 `attachments_id`
users_title_picture_url:
type: string
description: 根据 `users_title_picture -> tbl_attachments` 自动解析出的文件流链接
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
openid:
type: string
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 全平台统一身份标识；微信用户为微信 openid，平台用户为服务端生成的 GUID
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
company_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 公司业务 id，存储 `tbl_company.company_id`
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_parent_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 上级用户业务 id
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_promo_code:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 推广码
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
usergroups_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 用户组业务 id
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
company:
$ref: '#/components/schemas/CompanyInfo'
created:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 用户创建时间
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
updated:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 用户更新时间
example:
pb_id: PocketBase记录主键id | string
users_convers_id: 会话侧用户ID | string
users_id: 用户业务ID | string
users_idtype: 用户身份来源类型 | string
users_id_number: 证件号 | string
users_type: 用户类型 | string
users_name: 用户姓名或昵称 | string
users_status: 用户状态 | string
users_rank_level: 用户星级数值 | number
users_auth_type: 账户类型 | number
users_phone: 手机号 | string
users_phone_masked: 手机号脱敏值 | string
users_level: 用户等级 | string
feat: 添加 SDK 权限管理页面和产品功能字段迁移脚本 - 新增 SDK 权限管理页面，包含角色管理、用户授权和集合权限配置功能。 - 实现字段迁移脚本，向 tbl_product_list 集合添加 prod_list_function 字段，类型为 json。
2026-04-03 18:35:50 +08:00
users_level_name: 用户等级名称 | string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
users_tag: 用户标签 | string
users_picture: 用户头像附件ID | string
users_picture_url: 用户头像文件流链接 | string
users_id_pic_a: 证件正面附件ID | string
users_id_pic_a_url: 证件正面文件流链接 | string
users_id_pic_b: 证件反面附件ID | string
users_id_pic_b_url: 证件反面文件流链接 | string
users_title_picture: 资质附件ID | string
users_title_picture_url: 资质附件文件流链接 | string
openid: 全平台统一身份标识 | string
company_id: 公司业务id | string
users_parent_id: 上级用户业务id | string
users_promo_code: 推广码 | string
usergroups_id: 用户组业务id | string
company:
pb_id: PocketBase记录主键id | string
company_id: 公司业务id，由数据库自动生成 | string
company_name: 公司名称 | string
company_type: 公司类型 | string
company_entity: 公司法人 | string
company_usci: 统一社会信用代码 | string
company_nationality: 国家名称 | string
company_nationality_code: 国家编码 | string
company_province: 省份名称 | string
company_province_code: 省份编码 | string
company_city: 城市名称 | string
company_city_code: 城市编码 | string
company_district: 区县名称 | string
company_district_code: 区县编码 | string
company_postalcode: 邮政编码 | string
company_add: 公司地址 | string
company_status: 公司状态 | string
company_level: 公司等级 | string
company_owner_openid: 公司所有者openid | string
company_remark: 备注 | string
created: 记录创建时间 | string
updated: 记录更新时间 | string
created: 用户创建时间 | string
updated: 用户更新时间 | string
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
PocketBaseAuthResponse:
type: object
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: |
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
项目统一认证响应。
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
所有对外接口统一返回 `statusCode`、`errMsg`、`data`，认证成功时额外返回顶层 `token`。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
properties:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
statusCode:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: integer
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务状态码"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 200
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
errMsg:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务提示信息"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 登录成功
data:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "业务响应数据"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
type: object
properties:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
status:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
anyOf:
- type: string
enum: [register_success, login_success]
- type: string
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
is_info_complete:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
type: [boolean, string]
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
user:
$ref: '#/components/schemas/UserInfo'
token:
type: string
description: PocketBase 原生 auth token；仅认证类接口在成功时额外返回
example:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
statusCode: 200
errMsg: 登录成功
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
data:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
status: 登录或注册状态 | string
is_info_complete: 资料是否完整 | boolean
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
user:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
pb_id: PocketBase记录主键id | string
users_id: 用户业务ID | string
users_idtype: 用户身份来源类型 | string
users_name: 用户姓名或昵称 | string
users_phone: 手机号 | string
users_phone_masked: 手机号脱敏值 | string
users_status: 用户状态 | string
users_rank_level: 用户星级数值 | number
users_auth_type: 账户类型 | number
users_type: 用户类型 | string
users_picture: 用户头像附件ID | string
users_picture_url: 用户头像文件流链接 | string
users_id_pic_a: 证件正面附件ID | string
users_id_pic_a_url: 证件正面文件流链接 | string
users_id_pic_b: 证件反面附件ID | string
users_id_pic_b_url: 证件反面文件流链接 | string
users_title_picture: 资质附件ID | string
users_title_picture_url: 资质附件文件流链接 | string
openid: 全平台统一身份标识 | string
company_id: 公司业务id | string
users_parent_id: 上级用户业务id | string
users_promo_code: 推广码 | string
usergroups_id: 用户组业务id | string
company:
pb_id: PocketBase记录主键id | string
company_id: 公司业务id，由数据库自动生成 | string
company_name: 公司名称 | string
company_type: 公司类型 | string
company_entity: 公司法人 | string
company_usci: 统一社会信用代码 | string
company_nationality: 国家名称 | string
company_nationality_code: 国家编码 | string
company_province: 省份名称 | string
company_province_code: 省份编码 | string
company_city: 城市名称 | string
company_city_code: 城市编码 | string
company_district: 区县名称 | string
company_district_code: 区县编码 | string
company_postalcode: 邮政编码 | string
company_add: 公司地址 | string
company_status: 公司状态 | string
company_level: 公司等级 | string
company_owner_openid: 公司所有者openid | string
company_remark: 备注 | string
created: 记录创建时间 | string
updated: 记录更新时间 | string
created: 用户创建时间 | string
updated: 用户更新时间 | string
token: PocketBase原生认证token | string
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
WechatLoginRequest:
type: object
required: [users_wx_code]
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 微信小程序登录/注册请求体。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
properties:
users_wx_code:
type: string
description: 微信小程序登录临时凭证 code
example: 0a1b2c3d4e5f6g
WechatProfileRequest:
type: object
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 微信用户资料完善请求体。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
properties:
users_name:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户姓名 / 昵称"
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
example: 张三
users_phone_code:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 可选。若传入，服务端优先通过微信接口换取真实手机号并写入数据库
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
example: 2b7d9f2e3c4a5b6d7e8f
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
users_phone:
type: string
description: 可选。未传 `users_phone_code` 时，可直接写入手机号
example: '13800138000'
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
users_type:
type: string
description: 可选。用户类型；仅在传入非空值时更新
example: 服务商
company_id:
type: string
description: 可选。公司业务 id；仅在传入非空值时更新
example: WX-COMPANY-10001
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
users_tag:
type: string
description: 可选。用户标签；非空时才更新
example: 核心客户
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
users_picture:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 可选。用户头像附件的 `attachments_id`
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
example: ATT-1743123456789-abc123
users_id_pic_a:
type: string
description: 可选。证件正面附件的 `attachments_id`
users_id_pic_b:
type: string
description: 可选。证件反面附件的 `attachments_id`
users_title_picture:
type: string
description: 可选。资质附件的 `attachments_id`
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
WechatProfileResponseData:
type: object
properties:
status:
type: string
enum: [update_success]
user:
$ref: '#/components/schemas/UserInfo'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
PlatformRegisterRequest:
type: object
required: [users_name, users_phone, password, passwordConfirm, users_picture]
description: 平台用户注册请求体；注册成功后将生成 GUID 并写入统一 `openid` 字段。
properties:
users_name:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户姓名 / 昵称"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
example: 张三
users_phone:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "手机号"
example: '13800138000'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
password:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 认证密码"
example: '12345678'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
passwordConfirm:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example: '12345678'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_picture:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: 用户头像附件的 `attachments_id`
example: ATT-1743123456789-abc123
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_id_number:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "证件号"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
users_id_pic_a:
type: string
description: 可选。证件正面附件的 `attachments_id`
users_id_pic_b:
type: string
description: 可选。证件反面附件的 `attachments_id`
users_title_picture:
type: string
description: 可选。资质附件的 `attachments_id`
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
users_level:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户等级文本"
type: string
users_tag:
description: "用户标签"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
users_type:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户类型"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
company_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "所属公司业务 ID"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
users_parent_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "上级用户业务 ID"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
users_promo_code:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "推广码"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
usergroups_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "用户组 / 角色 ID"
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
PlatformLoginRequest:
type: object
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
required: [login_account, password]
description: 平台用户登录请求体；前端使用邮箱或手机号 + 密码提交，服务端内部转换为 PocketBase 原生 password auth。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
properties:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
login_account:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
description: 支持邮箱或手机号
example: admin@example.com
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
password:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 认证密码"
example: '12345678'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
SystemRefreshTokenRequest:
type: object
description: |
系统刷新 token 请求体。
`users_wx_code` 允许为空。
当 `Authorization` 对应 token 有效时，可不传或传空；
当 token 失效时，需提供 `users_wx_code` 走微信 code 重新签发流程。
properties:
users_wx_code:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
anyOf:
- type: string
- type: 'null'
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 微信小程序登录临时凭证 code
example: 0a1b2c3d4e5f6g
RefreshTokenData:
type: object
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
properties: {}
DictionaryItem:
type: object
required: [enum, description, sortOrder]
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
properties:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
enum:
type: string
example: enabled
description:
type: string
example: 启用
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
image:
type: string
description: 对应图片附件的 `attachments_id`，允许为空
example: ATT-1743037200000-abc123
imageUrl:
type: string
description: 根据 `image -> tbl_attachments` 自动解析出的图片文件流链接
imageAttachment:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
anyOf:
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
- $ref: '#/components/schemas/AttachmentRecord'
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
- type: 'null'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
sortOrder:
type: integer
example: 1
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
enum: enabled
description: 启用
image: ATT-1743037200000-abc123
imageUrl: https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/enabled.png
imageAttachment:
attachments_id: ATT-1743037200000-abc123
attachments_filename: enabled.png
sortOrder: 1
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
DictionaryRecord:
type: object
properties:
pb_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 记录主键 id"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
system_dict_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典业务 ID"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
dict_name:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典名称，当前按全局唯一维护"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
dict_word_is_enabled:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典是否启用"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: boolean
dict_word_parent_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "父级字典业务 ID"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
dict_word_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
items:
type: array
items:
$ref: '#/components/schemas/DictionaryItem'
created:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录创建时间"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
updated:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录更新时间"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
pb_id: y3qk5cuirz515d6
system_dict_id: DICT-1774599144591-hAEFQj
dict_name: 类型-发现页菜单
dict_word_is_enabled: true
dict_word_parent_id: ''
dict_word_remark: 首页菜单字典
items:
- enum: UT1
description: 每日资讯
image: ATT-1743037200000-abc123
imageUrl: https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/news.png
sortOrder: 1
created: '2026-03-28 07:20:00.000Z'
updated: '2026-03-29 08:00:00.000Z'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
DictionaryListRequest:
type: object
properties:
keyword:
type: string
description: 对 `dict_name` 的模糊搜索关键字
example: 状态
DictionaryDetailRequest:
type: object
required: [dict_name]
properties:
dict_name:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典名称，当前按全局唯一维护"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 用户状态
DictionaryMutationRequest:
type: object
required: [dict_name, items]
properties:
original_dict_name:
type: string
description: 更新时用于定位原始记录；新增时可不传
example: 用户状态
dict_name:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典名称，当前按全局唯一维护"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 用户状态
dict_word_is_enabled:
type: boolean
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典是否启用"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: true
dict_word_parent_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "父级字典业务 ID"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: ''
dict_word_remark:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 系统状态字典
items:
type: array
minItems: 1
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 每项会分别序列化写入 `dict_word_enum`、`dict_word_description`、`dict_word_image`、`dict_word_sort_order`
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
items:
$ref: '#/components/schemas/DictionaryItem'
DictionaryDeleteRequest:
type: object
required: [dict_name]
properties:
dict_name:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "字典名称，当前按全局唯一维护"
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example: 用户状态
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
AttachmentRecord:
type: object
properties:
pb_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 记录主键 id"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "附件业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_link:
type: string
description: PocketBase 实际存储的文件名
attachments_url:
type: string
description: 附件文件流访问链接
attachments_download_url:
type: string
description: 附件下载链接
attachments_filename:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "原始文件名"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_filetype:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文件类型 / MIME"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_size:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文件大小"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
attachments_owner:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "上传者业务标识"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_md5:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文件 MD5"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_ocr:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "OCR 识别结果"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_status:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "附件状态"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
created:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录创建时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
updated:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录更新时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
pb_id: a1b2c3d4e5f6g7h
attachments_id: ATT-1743037200000-abc123
attachments_link: enabled.png
attachments_url: https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/enabled.png
attachments_download_url: https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/enabled.png?download=1
attachments_filename: enabled.png
attachments_filetype: image/png
attachments_size: 24576
attachments_owner: app_momo
attachments_md5: 4b825dc642cb6eb9a060e54bf8d69288
attachments_ocr: ''
attachments_status: active
attachments_remark: 字典图标
created: '2026-03-28 07:20:00.000Z'
updated: '2026-03-29 08:00:00.000Z'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
AttachmentListRequest:
type: object
properties:
keyword:
type: string
description: 对 `attachments_id`、`attachments_filename` 的模糊搜索关键字
example: 手册
status:
type: string
description: 按附件状态过滤
example: active
AttachmentDetailRequest:
type: object
required: [attachments_id]
properties:
attachments_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "附件业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
example: ATT-1743037200000-abc123
AttachmentUploadRequest:
type: object
required: [attachments_link]
properties:
attachments_link:
type: string
format: binary
description: 要上传到 `tbl_attachments` 的单个文件
attachments_filename:
type: string
description: 原始文件名；不传时可由前端直接使用文件名
attachments_filetype:
type: string
description: 文件 MIME 类型
attachments_size:
type: number
description: 文件大小
attachments_md5:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文件 MD5"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_ocr:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "OCR 识别结果"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
attachments_status:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "附件状态"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
example: active
attachments_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
DocumentRecord:
type: object
properties:
pb_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 记录主键 id"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档业务 ID"
type: string
document_create:
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 文档创建时间，由数据库自动生成
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_effect_date:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档生效日期"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_expiry_date:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档到期日期"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_type:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 多选时按 `system_dict_id@dict_word_enum|...` 保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_title:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档标题"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_subtitle:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档副标题"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_summary:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档摘要"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_content:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "正文内容，保存 Markdown"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_image:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "关联多个 `attachments_id`，底层使用 `|` 分隔保存"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
document_image_ids:
type: array
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "`document_image` 解析后的附件 id 列表"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
items:
type: string
document_image_urls:
type: array
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "根据 `document_image -> tbl_attachments` 自动解析出的图片文件流链接列表"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
items:
type: string
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_image_url:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "兼容字段，返回第一张图片的文件流链接"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
document_image_attachments:
type: array
items:
$ref: '#/components/schemas/AttachmentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_image_attachment:
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
anyOf:
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
- $ref: '#/components/schemas/AttachmentRecord'
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
- type: 'null'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_video:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "关联多个 `attachments_id`，底层使用 `|` 分隔保存"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
document_video_ids:
type: array
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "`document_video` 解析后的附件 id 列表"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
items:
type: string
document_video_urls:
type: array
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "根据 `document_video -> tbl_attachments` 自动解析出的视频文件流链接列表"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
items:
type: string
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_video_url:
type: string
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
description: "兼容字段，返回第一个视频的文件流链接"
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
document_video_attachments:
type: array
items:
$ref: '#/components/schemas/AttachmentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_video_attachment:
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
anyOf:
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
- $ref: '#/components/schemas/AttachmentRecord'
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
- type: 'null'
document_file:
type: string
description: "关联多个 `attachments_id`，底层使用 `|` 分隔保存"
document_file_ids:
type: array
description: "`document_file` 解析后的附件 id 列表"
items:
type: string
document_file_urls:
type: array
description: "根据 `document_file -> tbl_attachments` 自动解析出的文件流链接列表"
items:
type: string
document_file_url:
type: string
description: "兼容字段，返回第一个文件的文件流链接"
document_file_attachments:
type: array
items:
$ref: '#/components/schemas/AttachmentRecord'
document_file_attachment:
anyOf:
- $ref: '#/components/schemas/AttachmentRecord'
- type: 'null'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_owner:
type: string
description: 上传者 openid
document_relation_model:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "关联机型 / 模型标识"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_keywords:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 固定字典多选字段，使用 `|` 分隔
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_share_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "分享次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_download_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "下载次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_favorite_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "收藏次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_status:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 文档状态，仅允许 `有效` 或 `过期`，由系统根据生效日期和到期日期自动计算；当两者都为空时默认 `有效`
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_embedding_status:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档嵌入状态"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_embedding_error:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档嵌入错误原因"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_embedding_lasttime:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "最后一次嵌入更新时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_vector_version:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "向量版本号 / 模型名称"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_product_categories:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 固定字典多选字段，使用 `|` 分隔
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_application_scenarios:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 固定字典多选字段，使用 `|` 分隔
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_hotel_type:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 固定字典多选字段，使用 `|` 分隔
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
created:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录创建时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
updated:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录更新时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
pb_id: docpb_001
document_id: DOC-1774677099775-WtHUaJ
document_create: '2026-03-28 07:20:00.000Z'
document_effect_date: '2026-03-28'
document_expiry_date: '2027-03-28'
document_type: DICT-1774599144591-hAEFQj@UT1
document_title: 智能化重构补记行业价值新链条
document_subtitle: 每日资讯
document_summary: 文档摘要示例
document_content: '# 正文内容'
document_image: ATT-1743037200000-abc123|ATT-1743037200001-def456
document_image_ids:
- ATT-1743037200000-abc123
document_image_urls:
- https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/news.png
document_image_url: https://bai-api.blv-oa.com/api/files/tbl_attachments/a1/news.png
document_video: ATT-1743037200002-ghi789
document_video_ids:
- ATT-1743037200002-ghi789
document_video_urls:
- https://bai-api.blv-oa.com/api/files/tbl_attachments/a2/demo.mp4
document_video_url: https://bai-api.blv-oa.com/api/files/tbl_attachments/a2/demo.mp4
document_file: ATT-1743037200003-jkl012
document_file_ids:
- ATT-1743037200003-jkl012
document_file_urls:
- https://bai-api.blv-oa.com/api/files/tbl_attachments/a3/manual.pdf
document_file_url: https://bai-api.blv-oa.com/api/files/tbl_attachments/a3/manual.pdf
document_owner: app_momo
document_relation_model: OR1
document_keywords: 酒店|智能化
document_share_count: 3
document_download_count: 12
document_favorite_count: 5
document_status: 有效
document_embedding_status: succeed
document_embedding_error: ''
document_embedding_lasttime: '2026-03-29'
document_vector_version: text-embedding-3-large
document_product_categories: OR1|AZ4
document_application_scenarios: 每日资讯
document_hotel_type: 高端酒店
document_remark: 文档备注
created: '2026-03-28 07:20:00.000Z'
updated: '2026-03-29 08:00:00.000Z'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
DocumentListRequest:
type: object
properties:
keyword:
type: string
description: 对 `document_id`、`document_title`、`document_subtitle`、`document_summary`、`document_keywords` 的模糊搜索关键字
example: 安装
status:
type: string
example: active
document_type:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 支持按存储值过滤；多选时格式为 `system_dict_id@dict_word_enum|...`
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
example: 说明书
DocumentDetailRequest:
type: object
required: [document_id]
properties:
document_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
example: DOC-1743037200000-abc123
DocumentMutationRequest:
type: object
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
required: [document_title, document_type]
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
properties:
document_id:
type: string
description: 创建时可不传，由服务端自动生成；更新时必填
example: DOC-1743037200000-abc123
document_effect_date:
type: string
description: 支持 `YYYY-MM-DD` 或 PocketBase 可识别日期时间字符串
example: 2026-03-27
document_expiry_date:
type: string
description: 支持 `YYYY-MM-DD` 或 PocketBase 可识别日期时间字符串
example: 2027-03-27
document_type:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 必填；前端显示为字典项描述，存库时按 `system_dict_id@dict_word_enum|...` 保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_title:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档标题"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_subtitle:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档副标题"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_summary:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档摘要"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_content:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "正文内容，保存 Markdown"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_image:
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
oneOf:
- type: string
description: 多个图片附件 id 使用 `|` 分隔
- type: array
items:
type: string
description: 图片附件 id 列表；支持数组或 `|` 分隔字符串
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_video:
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
oneOf:
- type: string
description: 多个视频附件 id 使用 `|` 分隔
- type: array
items:
type: string
description: 视频附件 id 列表；支持数组或 `|` 分隔字符串
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
document_file:
oneOf:
- type: string
description: 多个文件附件 id 使用 `|` 分隔
- type: array
items:
type: string
description: 文件附件 id 列表；支持数组或 `|` 分隔字符串
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_relation_model:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "关联机型 / 模型标识"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_keywords:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 从 `文档-关键词` 字典多选后使用 `|` 分隔保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_share_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "分享次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_download_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "下载次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_favorite_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "收藏次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
document_status:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 文档状态，仅允许 `有效` 或 `过期`，由系统根据生效日期和到期日期自动计算；当两者都为空时默认 `有效`
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_embedding_status:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档嵌入状态"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_embedding_error:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档嵌入错误原因"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_embedding_lasttime:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "最后一次嵌入更新时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_vector_version:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "向量版本号 / 模型名称"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
document_product_categories:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 从 `文档-产品关联文档` 字典多选后使用 `|` 分隔保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_application_scenarios:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 从 `文档-筛选依据` 字典多选后使用 `|` 分隔保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_hotel_type:
type: string
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
description: 从 `文档-适用场景` 字典多选后使用 `|` 分隔保存
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
document_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
DocumentDeleteRequest:
type: object
required: [document_id]
properties:
document_id:
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
example: DOC-1743037200000-abc123
DocumentHistoryRecord:
type: object
properties:
pb_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "PocketBase 记录主键 id"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
doh_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "文档操作历史业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
doh_document_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "关联文档业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
doh_operation_type:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "操作类型"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
doh_user_id:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "操作人业务 ID"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
doh_current_count:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "本次操作对应次数"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: number
doh_remark:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "备注"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
created:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录创建时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
updated:
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: "记录更新时间"
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
type: string
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
pb_id: histpb_001
doh_id: DOH-1774677099775-WtHUaJ
doh_document_id: DOC-1774677099775-WtHUaJ
doh_operation_type: update
doh_user_id: app_momo
doh_current_count: 1
doh_remark: 更新文档
created: '2026-03-29 08:00:00.000Z'
updated: '2026-03-29 08:00:00.000Z'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
DocumentHistoryListRequest:
type: object
properties:
document_id:
type: string
description: 可选；传入时仅查询指定文档的操作历史
example: DOC-1743037200000-abc123
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
paths:
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/system/test-helloworld:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
post:
tags: [系统]
summary: HelloWorld 测试接口
responses:
'200':
description: 成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/HelloWorldData'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/system/health:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
post:
tags: [系统]
summary: 健康检查
responses:
'200':
description: 成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/HealthData'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/system/users-count:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
post:
tags: [系统]
summary: 查询用户总数
description: 统计 `tbl_auth_users` 集合中的记录总数，并返回一个数值。
responses:
'200':
description: 成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/UsersCountData'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/system/refresh-token:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
post:
tags: [系统]
summary: 刷新系统认证 token
description: |
当前实现支持两种刷新路径：
1) 若 `Authorization` 对应 token 仍有效：直接按当前 auth record 续签（不调用微信接口）。
2) 若 token 已过期：仅在 body 提供 `users_wx_code` 时才走微信 code 重新签发。
返回体仅包含新的 `token`，不返回完整登录用户信息。
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/SystemRefreshTokenRequest'
responses:
'200':
description: 刷新成功（返回精简 token）
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
token:
type: string
description: 新签发的 PocketBase 原生 auth token
example:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
statusCode: 200
errMsg: 刷新成功
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
data: {}
token: eyJhbGciOi...
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
'400':
description: 参数错误或微信侧身份换取失败
'401':
description: token 无效/已过期，且未提供 users_wx_code
'404':
description: 用户不存在
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/wechat/login:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
post:
tags: [微信认证]
summary: 微信登录/注册合一
description: |
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
使用微信 code 换取微信侧 openid，并写入统一身份字段 `tbl_auth_users.openid`。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
若 `tbl_auth_users` 中不存在对应用户则自动创建 auth record，随后返回 PocketBase 原生 auth token。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
首次注册创建时会写入 `users_idtype = WeChat`。
feat: 添加 SDK 权限管理页面和产品功能字段迁移脚本 - 新增 SDK 权限管理页面，包含角色管理、用户授权和集合权限配置功能。 - 实现字段迁移脚本，向 tbl_product_list 集合添加 prod_list_function 字段，类型为 json。
2026-04-03 18:35:50 +08:00
首次注册创建时，`users_level` 默认保持为空，不自动写入会员等级。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
返回的 `token` 可直接用于 PocketBase SDK 与当前 hooks 接口调用。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WechatLoginRequest'
responses:
'200':
description: 登录或注册成功
content:
application/json:
schema:
$ref: '#/components/schemas/PocketBaseAuthResponse'
'400':
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: 参数错误或微信侧身份换取失败
'401':
description: PocketBase 原生认证失败
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
'500':
description: 保存 auth 用户失败或服务端内部错误
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/platform/register:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
post:
tags: [平台认证]
summary: 平台用户注册
description: |
创建平台用户 auth record。
服务端会自动生成 GUID 并写入统一身份字段 `openid`，同时写入 `users_idtype = ManagePlatform`。
前端以 `users_phone + password/passwordConfirm` 注册，但服务端仍会创建 PocketBase 原生 auth 用户。
feat: 添加 SDK 权限管理页面和产品功能字段迁移脚本 - 新增 SDK 权限管理页面，包含角色管理、用户授权和集合权限配置功能。 - 实现字段迁移脚本，向 tbl_product_list 集合添加 prod_list_function 字段，类型为 json。
2026-04-03 18:35:50 +08:00
首次注册创建时，`users_level` 默认保持为空，不自动写入会员等级。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
注册成功后直接返回 PocketBase 原生 auth token。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformRegisterRequest'
responses:
'200':
description: 注册成功
content:
application/json:
schema:
$ref: '#/components/schemas/PocketBaseAuthResponse'
'400':
description: 参数错误或手机号已存在
'500':
description: GUID 生成失败、auth identity 缺失或保存用户失败
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/platform/login:
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
post:
tags: [平台认证]
summary: 平台用户登录
description: |
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
前端使用平台注册时保存的 `邮箱或手机号 + password` 登录。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
仅允许 `users_idtype = ManagePlatform` 的用户通过该接口登录。
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
服务端会根据 `login_account` 自动判断邮箱或手机号，并定位平台用户，再使用该用户的 PocketBase 原生 identity（当前为 `email`）执行原生 password auth。
feat: 添加 SDK 权限管理页面和产品功能字段迁移脚本 - 新增 SDK 权限管理页面，包含角色管理、用户授权和集合权限配置功能。 - 实现字段迁移脚本，向 tbl_product_list 集合添加 prod_list_function 字段，类型为 json。
2026-04-03 18:35:50 +08:00
返回体中的 `user.users_level_name` 为服务端按“数据-会员等级”字典实时解析后的等级名称。
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
登录成功后直接返回 PocketBase 原生 auth token。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PlatformLoginRequest'
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
example:
login_account: '13509214696'
password: Momo123456
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
responses:
'200':
description: 登录成功
content:
application/json:
schema:
$ref: '#/components/schemas/PocketBaseAuthResponse'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
example:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
statusCode: 200
errMsg: 登录成功
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
data:
status: login_success
is_info_complete: false
user:
pb_id: vtukf6agem2xbcv
users_id: ''
users_idtype: ManagePlatform
users_name: momo
users_phone: '13509214696'
users_phone_masked: '135****4696'
users_status: ''
users_rank_level: 0
users_auth_type: 0
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
users_type: 注册用户
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
users_picture: ''
openid: app_momo
company_id: ''
users_parent_id: ''
users_promo_code: ''
usergroups_id: ''
company: null
created: ''
updated: ''
token: eyJhbGciOi...
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
'400':
description: 参数错误、密码错误或用户类型不匹配
'404':
description: 平台用户不存在
'500':
description: 平台用户缺少原生登录 identity 或服务端内部错误
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/wechat/profile:
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
post:
tags: [微信认证]
summary: 更新微信用户资料
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: |
基于当前 `Authorization` 对应 auth record 中的统一 `openid` 定位当前微信用户。
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
当前接口按“非空字段增量更新”处理资料完善。
若传入 `users_phone_code`，优先调用微信接口换取真实手机号；
若未传 `users_phone_code` 但传入 `users_phone`，则直接写入手机号；
未传或传空的字段不会清空数据库已有值。
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WechatProfileRequest'
responses:
'200':
description: 更新成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/WechatProfileResponseData'
feat: 完善微信认证功能，新增用户资料更新与token刷新接口 - 新增 userService.js，包含用户认证、资料更新、token 刷新等功能 - 新增 wechatService.js，处理微信API交互，获取openid和手机号 - 新增 appError.js，封装应用错误处理 - 新增 logger.js，提供日志记录功能 - 新增 response.js，统一成功响应格式 - 新增 sanitize.js，提供输入数据清洗功能 - 更新 OpenAPI 文档，描述新增接口及请求响应格式 - 更新 PocketBase 数据库结构，调整用户表字段及索引策略 - 增强错误处理机制，确保错误信息可观测性 - 更新变更记录文档，详细记录本次变更内容
2026-03-24 10:36:19 +08:00
'401':
feat: 增强 PocketBase hooks 认证功能 - 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
2026-03-25 20:03:46 +08:00
description: token 无效或当前 auth record 缺少统一身份字段 openid
'400':
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
description: 参数错误、手机号已被注册、微信手机号换取失败或资料更新失败
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/dictionary/list:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
post:
tags: [字典管理]
summary: 查询字典列表
description: |
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
公开读接口，无需 token。
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
支持按 `dict_name` 模糊搜索，返回字典全量信息，并将三个聚合字段组装为 `items`。
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/DictionaryListRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/DictionaryRecord'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
'415':
description: 请求体必须为 application/json
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/dictionary/detail:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
post:
tags: [字典管理]
summary: 查询指定字典
description: |
feat: 规范化PocketBase数据库文档与原生API访问 - 将数据库文档拆分为按collection命名的标准文件，统一格式 - 补充tbl_company、tbl_system_dict等表的原生访问规则 - 新增users_tag、document_create等字段 - 优化用户资料更新接口，支持非必填字段 - 添加公司原生API测试脚本 - 归档本次变更至OpenSpec
2026-03-29 16:21:34 +08:00
公开读接口，无需 token。
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
按唯一键 `dict_name` 查询单条字典，并返回组装后的 `items`。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DictionaryDetailRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DictionaryRecord'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
'400':
description: 参数错误
'404':
description: 未找到对应字典
'415':
description: 请求体必须为 application/json
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/dictionary/create:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
post:
tags: [字典管理]
summary: 新增字典
description: |
仅允许 `ManagePlatform` 用户访问。
`system_dict_id` 由服务端自动生成；`dict_name` 必须唯一；
feat: 添加微信端 API 文档和字典表初始化脚本 - 新增 openapi-wx.yaml 文件，定义微信端接口文档，包括用户统计、token 刷新、微信登录和用户资料更新等接口。 - 新增 pocketbase.dictionary.js 脚本，用于初始化和校验字典表结构，确保与预期一致。
2026-03-27 19:26:25 +08:00
`items` 会分别序列化写入 `dict_word_enum`、`dict_word_description`、`dict_word_image`、`dict_word_sort_order` 四个字段。
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DictionaryMutationRequest'
responses:
'200':
description: 新增成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DictionaryRecord'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
'400':
description: 参数错误或 dict_name 已存在
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/dictionary/update:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
post:
tags: [字典管理]
summary: 修改字典
description: |
仅允许 `ManagePlatform` 用户访问。
根据 `original_dict_name`（未传时回退为 `dict_name`）定位原记录并更新。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DictionaryMutationRequest'
responses:
'200':
description: 修改成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DictionaryRecord'
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
'400':
description: 参数错误或 dict_name 冲突
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到待修改字典
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/dictionary/delete:
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
post:
tags: [字典管理]
summary: 删除字典
description: |
仅允许 `ManagePlatform` 用户访问。
按 `dict_name` 真删除对应记录。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DictionaryDeleteRequest'
responses:
'200':
description: 删除成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
dict_name:
description: "字典名称，当前按全局唯一维护"
type: string
feat: 添加字典管理功能，包括字典的增删改查接口和管理页面 - 新增字典删除接口 `/api/dictionary/delete` - 新增字典详情接口 `/api/dictionary/detail` - 新增字典列表接口 `/api/dictionary/list` - 新增字典更新接口 `/api/dictionary/update` - 新增字典服务 `dictionaryService.js`，实现字典的创建、更新、删除和查询功能 - 新增字典管理页面 `dictionary-manage.js`，支持字典的增删改查操作 - 新增管理主页 `index.js`，提供字典管理入口 - 新增示例页面 `page-b.js`，用于验证页面跳转
2026-03-26 17:59:13 +08:00
'400':
description: 参数错误或删除失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到待删除字典
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
/pb/api/attachment/list:
post:
tags: [附件管理]
summary: 查询附件列表
description: |
仅允许 `ManagePlatform` 用户访问。
支持按 `attachments_id`、`attachments_filename` 模糊搜索，并可按 `attachments_status` 过滤。
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/AttachmentListRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/AttachmentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'415':
description: 请求体必须为 application/json
/pb/api/attachment/detail:
post:
tags: [附件管理]
summary: 查询附件详情
description: |
仅允许 `ManagePlatform` 用户访问。
按 `attachments_id` 查询单条附件，并返回 PocketBase 文件流链接与下载链接。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AttachmentDetailRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/AttachmentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到对应附件
'415':
description: 请求体必须为 application/json
/pb/api/attachment/upload:
post:
tags: [附件管理]
summary: 上传附件
description: |
仅允许 `ManagePlatform` 用户访问。
使用 `multipart/form-data` 上传单个文件到 `tbl_attachments`，服务端会自动生成 `attachments_id`，
并返回可直接访问的 PocketBase 文件流链接。
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/AttachmentUploadRequest'
responses:
'200':
description: 上传成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/AttachmentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误、缺少文件或附件保存失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
/pb/api/attachment/delete:
post:
tags: [附件管理]
summary: 删除附件
description: |
仅允许 `ManagePlatform` 用户访问。
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
按 `attachments_id` 真删除附件；若附件已被 `tbl_document.document_image`、`document_video` 或 `document_file` 引用，则拒绝删除。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AttachmentDetailRequest'
responses:
'200':
description: 删除成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
attachments_id:
description: "附件业务 ID"
type: string
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误、附件已被文档引用或删除失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到待删除附件
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
/pb/api/document/list:
post:
tags: [文档管理]
summary: 查询文档列表
description: |
仅允许 `ManagePlatform` 用户访问。
支持按标题、摘要、关键词等字段模糊搜索，并可按 `document_status`、`document_type` 过滤。
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
返回结果会自动根据 `document_image`、`document_video`、`document_file` 中的多个 `attachments_id` 关联 `tbl_attachments`，
额外补充 `document_image_urls`、`document_video_urls`、`document_file_urls` 以及对应附件对象数组。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentListRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/DocumentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'415':
description: 请求体必须为 application/json
/pb/api/document/detail:
post:
tags: [文档管理]
summary: 查询文档详情
description: |
仅允许 `ManagePlatform` 用户访问。
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
按 `document_id` 查询单条文档，并返回与附件表联动解析后的多文件流链接。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentDetailRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DocumentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到对应文档
'415':
description: 请求体必须为 application/json
/pb/api/document/create:
post:
tags: [文档管理]
summary: 新增文档
description: |
仅允许 `ManagePlatform` 用户访问。
`document_id` 可选；未传时服务端自动生成。
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
`document_title`、`document_type` 为必填；其余字段均允许为空。
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
`document_image`、`document_video`、`document_file` 支持传入多个已存在于 `tbl_attachments` 的 `attachments_id`。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
成功后会同步写入一条 `tbl_document_operation_history`，操作类型为 `create`。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentMutationRequest'
responses:
'200':
description: 新增成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DocumentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误、附件不存在或文档创建失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
/pb/api/document/update:
post:
tags: [文档管理]
summary: 修改文档
description: |
仅允许 `ManagePlatform` 用户访问。
feat: 更新 PocketBase API 路由，增强认证安全性 - 修改登录路由为 `/pb/api/wechat/login`，新增局部 try/catch 以保留业务状态码并返回统一结构 `{ code, msg, data }`。 - 更新所有相关 API 路由前缀为 `/pb`，包括系统、平台、字典、附件和文档接口。 - 新增文档接口支持多个附件 ID，更新 OpenAPI 文档以反映这些变化。 - 在数据库模式中添加对字典名称的唯一索引，确保全局唯一性。 - 更新文档字段，设置 `document_title` 和 `document_type` 为必填项，并在验证过程中检查字段的必填属性。
2026-03-27 13:55:06 +08:00
按 `document_id` 定位现有文档并更新。
`document_title`、`document_type` 为必填；其余字段均允许为空。
feat: 添加 PocketBase MiniApp 公司 API 文档和文件字段迁移脚本 - 新增 openapi-miniapp-company.yaml 文件，定义 tbl_company 的基础 CRUD 接口文档，包括查询、创建、更新和删除公司记录的详细描述和示例。 - 新增 pocketbase.file-fields-to-attachments.js 脚本，用于迁移 PocketBase 中的文件字段到文本字段，并处理 tbl_attachments 集合的公开规则。
2026-03-28 15:13:04 +08:00
若传入 `document_image`、`document_video`、`document_file`，则支持多个 `attachments_id`，并会逐一校验是否存在。
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
成功后会同步写入一条 `tbl_document_operation_history`，操作类型为 `update`。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentMutationRequest'
responses:
'200':
description: 修改成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
$ref: '#/components/schemas/DocumentRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误、附件不存在或修改失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到待修改文档
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
/pb/api/document/delete:
post:
tags: [文档管理]
summary: 删除文档
description: |
仅允许 `ManagePlatform` 用户访问。
按 `document_id` 真删除文档，并在删除前同步写入一条 `tbl_document_operation_history`，操作类型为 `delete`。
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentDeleteRequest'
responses:
'200':
description: 删除成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
document_id:
description: "文档业务 ID"
type: string
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'400':
description: 参数错误或删除失败
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'404':
description: 未找到待删除文档
'415':
description: 请求体必须为 application/json
'429':
description: 重复请求过于频繁
/pb/api/document-history/list:
post:
tags: [文档历史]
summary: 查询文档操作历史
description: |
仅允许 `ManagePlatform` 用户访问。
若 body 传入 `document_id`，则仅查询该文档的历史；否则返回全部文档操作历史，按创建时间倒序排列。
requestBody:
required: false
content:
application/json:
schema:
$ref: '#/components/schemas/DocumentHistoryListRequest'
responses:
'200':
description: 查询成功
content:
application/json:
schema:
feat: 更新 API 响应结构，统一使用 statusCode 和 errMsg 替代 code 和 msg；新增用户类型和公司 ID 字段；优化数据库索引；添加公司所有者同步测试脚本
2026-03-29 19:57:04 +08:00
description: "业务响应数据"
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/DocumentHistoryRecord'
feat: 添加文档管理和登录页面功能，包含文档上传、列表展示及用户登录逻辑；新增数据库表结构初始化脚本
2026-03-27 10:27:44 +08:00
'401':
description: token 无效或已过期
'403':
description: 非 ManagePlatform 用户无权访问
'415':
description: 请求体必须为 application/json
Reference in New Issue Copy Permalink