pocket-base/spec/openapi-manage/openapi.yaml

openapi: 3.1.0
info:
  title: BAI PocketBase Manage Hooks API
  version: 1.0.0-manage-folder
  description: |
    面向管理端与自定义 hooks 的接口文档。
    本目录仅收敛自定义 hooks API，不包含 PocketBase 原生 records API。

    本文件为目录索引，支持单文件独立导入，不依赖其他 YAML。

    文档约定：
    - 不单独配置鉴权组件；如接口需要登录，请直接在说明中关注 `Authorization: Bearer <token>`
    - 示例字段值统一使用 `<字段说明>|<类型>` 风格
    - 当前 `tbl_auth_users.openid` 为全平台统一身份锚点
servers:
  - url: https://bai-api.blv-oa.com
    description: 生产环境
  - url: http://localhost:8090
    description: PocketBase 本地环境
tags:
  - name: 系统
    description: hooks 系统基础接口
  - name: 微信认证
    description: hooks 微信认证与资料接口
  - name: 平台认证
    description: hooks 平台用户认证接口
  - name: 字典管理
    description: hooks 字典管理接口
  - name: 附件管理
    description: hooks 附件管理接口
  - name: 文档管理
    description: hooks 文档管理接口
  - name: 文档历史
    description: hooks 文档历史接口
  - name: 购物车
    description: hooks 购物车接口
  - name: 订单
    description: hooks 订单接口
paths: {}
x-index:
  files:
    - cart.yaml
    - order.yaml
-												feat: 添加 PocketBase 管理端与自定义 hooks 的 API 文档

- 新增 openapi.yaml 文件，定义管理端与自定义 hooks 的接口文档，包括系统、微信认证、平台认证、字典管理、附件管理、文档管理、购物车和订单等接口。
- 新增 order.yaml 文件，定义订单相关的接口，包括查询订单列表、查询订单详情、新增订单记录、修改订单记录和删除订单记录的请求和响应结构。
- 新增 openapi-wx/openapi.yaml 文件，定义 PocketBase 原生 API 文档，包含企业信息、附件信息、产品信息、文档信息、购物车和订单的接口。
- 新增 pocketbase.scheme.js 文件，包含 PocketBase 集合的创建和更新逻辑，定义了多个集合的字段、索引和权限规则。

											
										
										
											2026-04-08 20:14:22 +08:00
+								openapi: 3.1.0
 								info:
 								  title: BAI PocketBase Manage Hooks API
 								  version: 1.0.0-manage-folder
 								  description: |
 								    面向管理端与自定义 hooks 的接口文档。
 								    本目录仅收敛自定义 hooks API，不包含 PocketBase 原生 records API。
-												feat: 添加购物车相关迁移和索引功能

- 在 package.json 中添加迁移脚本 `migrate:cart-active-unique-index`。
- 修改 `pocketbase.cart-order.js` 文件，更新 `cart_id` 和 `cart_product_id` 字段的必填属性，并添加唯一索引 `idx_tbl_cart_owner_product_active_unique`。
- 在 `pocketbase.ensure-cart-order-autogen-id.js` 中，调整 `cart_id` 字段的必填属性为可选，并确保 `order_id` 字段为必填。
- 在 `pocketbase.product-list.js` 中，新增 `prod_list_barcode` 字段。
- 新增 `make-openapi-standalone.cjs` 脚本，用于处理 OpenAPI 文档。
- 新增 `pocketbase.cart-active-unique-index.js` 脚本，处理购物车的唯一索引和去重逻辑。

											
										
										
											2026-04-09 14:49:12 +08:00
+								    本文件为目录索引，支持单文件独立导入，不依赖其他 YAML。
-												feat: 添加 PocketBase 管理端与自定义 hooks 的 API 文档

- 新增 openapi.yaml 文件，定义管理端与自定义 hooks 的接口文档，包括系统、微信认证、平台认证、字典管理、附件管理、文档管理、购物车和订单等接口。
- 新增 order.yaml 文件，定义订单相关的接口，包括查询订单列表、查询订单详情、新增订单记录、修改订单记录和删除订单记录的请求和响应结构。
- 新增 openapi-wx/openapi.yaml 文件，定义 PocketBase 原生 API 文档，包含企业信息、附件信息、产品信息、文档信息、购物车和订单的接口。
- 新增 pocketbase.scheme.js 文件，包含 PocketBase 集合的创建和更新逻辑，定义了多个集合的字段、索引和权限规则。

											
										
										
											2026-04-08 20:14:22 +08:00
+								    文档约定：
 								    - 不单独配置鉴权组件；如接口需要登录，请直接在说明中关注 `Authorization: Bearer <token>`
 								    - 示例字段值统一使用 `<字段说明>|<类型>` 风格
 								    - 当前 `tbl_auth_users.openid` 为全平台统一身份锚点
 								servers:
 								  - url: https://bai-api.blv-oa.com
 								    description: 生产环境
 								  - url: http://localhost:8090
 								    description: PocketBase 本地环境
 								tags:
 								  - name: 系统
 								    description: hooks 系统基础接口
 								  - name: 微信认证
 								    description: hooks 微信认证与资料接口
 								  - name: 平台认证
 								    description: hooks 平台用户认证接口
 								  - name: 字典管理
 								    description: hooks 字典管理接口
 								  - name: 附件管理
 								    description: hooks 附件管理接口
 								  - name: 文档管理
 								    description: hooks 文档管理接口
 								  - name: 文档历史
 								    description: hooks 文档历史接口
 								  - name: 购物车
 								    description: hooks 购物车接口
 								  - name: 订单
 								    description: hooks 订单接口
-												feat: 添加购物车相关迁移和索引功能

- 在 package.json 中添加迁移脚本 `migrate:cart-active-unique-index`。
- 修改 `pocketbase.cart-order.js` 文件，更新 `cart_id` 和 `cart_product_id` 字段的必填属性，并添加唯一索引 `idx_tbl_cart_owner_product_active_unique`。
- 在 `pocketbase.ensure-cart-order-autogen-id.js` 中，调整 `cart_id` 字段的必填属性为可选，并确保 `order_id` 字段为必填。
- 在 `pocketbase.product-list.js` 中，新增 `prod_list_barcode` 字段。
- 新增 `make-openapi-standalone.cjs` 脚本，用于处理 OpenAPI 文档。
- 新增 `pocketbase.cart-active-unique-index.js` 脚本，处理购物车的唯一索引和去重逻辑。

											
										
										
											2026-04-09 14:49:12 +08:00
+								paths: {}
 								x-index:
 								  files:
 								    - cart.yaml
 								    - order.yaml