# 云函数 Function Schema

线上运行时使用 Parse `Function` 类保存云函数代码与元数据。Angular 前端不保存也不接触 Parse `masterKey`，只把当前 Parse `sessionToken` 发送给 `/api/functions/*`。

```plantuml
@startuml
class Function {
  objectId: String
  name: String
  desc: String
  type: String
  path: String
  code: String
  params: Array
  paramList: Array
  respType: String
  respJson: Object
  enabled: Boolean
  version: String
  project: Pointer<Project>
  createdAt: Date
  updatedAt: Date
  ACL: ACL
}
@enduml
```

当前执行器版本 `2.0.0` 的全局通配路由按不带前导 `/` 的字符串精确匹配 `Function.path`。因此记录保存为 `xiaoshu/admin/gateway`，HTTP 调用仍使用 `/api/functions/xiaoshu/admin/gateway`。这是对线上执行器行为的兼容，部署脚本会校验这一约束。

执行器还会占用请求体顶层 `id`。所有业务参数必须放入 `params`，即 `{ token?, params: { action/operation, id, ... } }`；否则带 `id` 的详情接口会在进入 handler 前返回 `Object not found`。

已部署函数：

| Function.name | path | 用途 |
|---|---|---|
| `xiaoshu.admin.gateway` | `xiaoshu/admin/gateway` | 后台权限、帐套隔离、Schema、分页 CRUD、统计与软删除 |
| `cms.content-normalizer` | `xiaoshu/cms/content-normalizer` | 替代两个 SQL HTML 清理函数 |
| `cms.users.extended` | `xiaoshu/cms/users/extended` | 用户扩展资料安全投影 |
| `cms.users.platform` | `xiaoshu/cms/users/platform` | 用户平台资料投影 |
| `cms.users.wechat` | `xiaoshu/cms/users/wechat` | 用户微信资料投影并过滤密钥 |
| `cms.exams.classes` | `xiaoshu/cms/exams/classes` | 考试班级分页投影 |
| `cms.guest.bar` | `xiaoshu/cms/guest/bar` | 互动社区分页投影 |
| `cms.search` | `xiaoshu/cms/search` | 规范化内容搜索 |
| `xiaoshu.app.gateway` | `xiaoshu/app/gateway` | 旧 H5 `WXAPP` action 的云函数兼容网关与阻塞清单 |

部署使用 `XIAOSHU_MASTER_KEY` 进程环境变量；仓库和浏览器构建产物不得保存真实值。