[总览] wire.treeden.app 单域名对接 #6

Open
opened 2026-11-08 23:06:07 +00:00 by keith · 1 comment
Owner

部署背景

单域名 https://wire.treeden.app:根路径由前端提供;/api/* 与 /ws/* 由 Caddy 反代到 wire-rs 并剥离前缀。

约定

  • API 版本固定为 v8:后端 /api-version 宣称与前端一致的 supported 范围(上限 8);/v{N}/ 路径按 v8 语义实现。
  • 后端保持最小:前端启动链路之外的接口返回空值或默认值。

部署说明

  • zuid cookie 的 Path 由 Caddy 把 Path=/access 改写为 Path=/api/access。
  • 设置 REMOVAL_PRIVATE_KEY(/mls/public-keys 需要)、DOMAIN=wire.treeden.app。

待办(按实现顺序)

  1. [R1] 接受 /v{N}/ 版本前缀 — #1
  2. [R2] 前端启动所需接口的最小实现 — #3
  3. [R3] 支持 PUT /clients/{cid} — #7
  4. [R4] self 会话与 1:1 会话 — #4
  5. [R5] /assets 上传与下载 — #5
## 部署背景 单域名 https://wire.treeden.app:根路径由前端提供;`/api/*` 与 `/ws/*` 由 Caddy 反代到 wire-rs 并剥离前缀。 ## 约定 - API 版本固定为 v8:后端 `/api-version` 宣称与前端一致的 supported 范围(上限 8);`/v{N}/` 路径按 v8 语义实现。 - 后端保持最小:前端启动链路之外的接口返回空值或默认值。 ## 部署说明 - `zuid` cookie 的 Path 由 Caddy 把 `Path=/access` 改写为 `Path=/api/access`。 - 设置 `REMOVAL_PRIVATE_KEY`(`/mls/public-keys` 需要)、`DOMAIN=wire.treeden.app`。 ## 待办(按实现顺序) 1. [ ] [R1] 接受 `/v{N}/` 版本前缀 — https://gitforge.treeden.app/keith/wire-rs/issues/1 2. [ ] [R2] 前端启动所需接口的最小实现 — https://gitforge.treeden.app/keith/wire-rs/issues/3 3. [ ] [R3] 支持 `PUT /clients/{cid}` — https://gitforge.treeden.app/keith/wire-rs/issues/7 4. [ ] [R4] self 会话与 1:1 会话 — https://gitforge.treeden.app/keith/wire-rs/issues/4 5. [ ] [R5] `/assets` 上传与下载 — https://gitforge.treeden.app/keith/wire-rs/issues/5
keith changed title from [总览] wire.treeden.app 单域名对接缺口 to [总览] wire.treeden.app 单域名对接 2026-11-08 23:37:04 +00:00
Author
Owner

子项已完成,保留 open 待真实前端联调

  • R1 /v{N}/ 版本前缀 → #1
  • R2 启动链接口 → #3
  • R3 PUT /clients/{cid} → #7
  • R4 self 与 1:1 会话 → #4
  • R5 /assets → #5

部署约定已按本 issue 实现:/api-version 固定 v8、zuid cookie Path=/access(由 Caddy 改写为 /api/access)、REMOVAL_PRIVATE_KEY 与 DOMAIN 经环境注入。

未闭环原因:本环境无 wire-webapp 前端,未做真实浏览器登录联调;接口形状按 issue 正文与 wire-server 参考逐项对齐。待真实前端跑通后再关闭本 issue。

M11 accepted · commit 56437e7 · doc docs/milestones/M11.md · gates: default 886 / test:db 177 (14 suites) / interop 971 / live 14 (×3, no flake) · integration agent 221 real-process assertions.

## 子项已完成,保留 open 待真实前端联调 - [x] R1 `/v{N}/` 版本前缀 → #1 - [x] R2 启动链接口 → #3 - [x] R3 `PUT /clients/{cid}` → #7 - [x] R4 self 与 1:1 会话 → #4 - [x] R5 `/assets` → #5 部署约定已按本 issue 实现:`/api-version` 固定 v8、`zuid` cookie `Path=/access`(由 Caddy 改写为 `/api/access`)、`REMOVAL_PRIVATE_KEY` 与 `DOMAIN` 经环境注入。 **未闭环原因**:本环境无 wire-webapp 前端,未做真实浏览器登录联调;接口形状按 issue 正文与 wire-server 参考逐项对齐。待真实前端跑通后再关闭本 issue。 M11 accepted · commit `56437e7` · doc `docs/milestones/M11.md` · gates: default **886** / test:db **177 (14 suites)** / interop **971** / live **14** (×3, no flake) · integration agent 221 real-process assertions.
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
keith/wire-rs#6
No description provided.