wehub-cloud-tpl-static-site-function
yf
3db74f3c8c
- POST /api/cloud/uploads: presigned PUT URL + pending metadata row - POST /api/cloud/uploads/:id/confirm: mark ready, HEAD object to backfill size - GET /api/cloud/uploads: list metadata - GET /api/cloud/uploads/🆔 metadata + presigned GET download URL - DELETE /api/cloud/uploads/🆔 delete object + metadata - Auto-migrate app.uploads schema - S3 credentials exchange with expiry cache - Frontend: upload (direct PUT), list, download, delete UI - Drop 512MiB big.bin build (no longer needed)
44 行
1.7 KiB
Markdown
44 行
1.7 KiB
Markdown
# wehub-cloud-tpl-static-site-function
|
||
|
||
WeHub Cloud 模板：静态站 + `/api/cloud/*` 函数，带**上传 / 下载**功能，文件落对象存储，**元信息存 PostgreSQL**。
|
||
|
||
## 资源
|
||
|
||
| 资源 | 说明 |
|
||
| --- | --- |
|
||
| `public/` | 静态前端，占根路由 `/`（`type=static`，`outputDirectory=public`） |
|
||
| `functions/api/` | HTTP 函数，入口 `index.handler`，绑 `/api/cloud/*` |
|
||
| Postgres | 控制台绑定后注入 `DATABASE_URL`，存元信息 |
|
||
| 对象存储 | 控制台绑定后注入 `S3_*`，存文件本体 |
|
||
|
||
## 接口
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
| --- | --- | --- |
|
||
| GET | `/api/cloud/health` | 绑定状态 |
|
||
| POST | `/api/cloud/uploads` | 申请上传：返回 `id` + presigned PUT URL，DB 写一条 `pending` 元信息 |
|
||
| POST | `/api/cloud/uploads/:id/confirm` | 上传完成后回填 `size` / `status=ready` |
|
||
| GET | `/api/cloud/uploads` | 列出元信息 |
|
||
| GET | `/api/cloud/uploads/:id` | 取单条 + presigned GET 下载 URL |
|
||
| DELETE | `/api/cloud/uploads/:id` | 删对象 + 删元信息 |
|
||
|
||
## 流程
|
||
|
||
1. 前端选文件 → `POST /api/cloud/uploads` → 拿到 `upload_url` + `id`
|
||
2. 前端 `PUT upload_url` 直传对象存储（不经过函数）
|
||
3. 前端 `POST /api/cloud/uploads/:id/confirm` → 后端把元信息置为 `ready`
|
||
4. 下载：`GET /api/cloud/uploads/:id` → 拿 presigned GET URL → 浏览器跳转
|
||
|
||
## 部署
|
||
|
||
1. 仓库根有 `wehub.json`，`functions/api` 目录存在。
|
||
2. 控制台给 Preview 绑定 **Postgres** 与 **对象存储**，重新部署后函数才能拿到 `DATABASE_URL` / `S3_*`。
|
||
3. 部署后访问 Preview 根路径即可。
|
||
|
||
## 本地
|
||
|
||
```bash
|
||
cd functions/api && npm install
|
||
# 需要本地 PG / S3 兼容服务，并设置 DATABASE_URL / S3_* 环境变量后才能跑通上传下载
|
||
```
|