chore: align sqlite control plane architecture
- replace default Convex control-plane wording with Rust SQLite control-plane across architecture, AGENTS, Reasonix, and design docs - retire root Convex functions source and deploy script into recycle while keeping explicit cloud/compat/sync-replica boundaries - add control-plane migration guard/docs and keep CodeGraph refreshed after the SQLite control-plane cutover
This commit is contained in:
@@ -2,13 +2,13 @@
|
||||
|
||||
本目录用于在本机通过 Docker Compose 启动 Convex backend + dashboard,并使用 backend 自身的持久化卷存储(包含数据库与文件存储)。
|
||||
|
||||
在 local-first 方案下,这套 Convex 自托管环境定位为控制面、cloud source、compat 和可选 sync replica 运行底座;页面正文、默认附件和本地 AI 会话全文不再以它作为早期产品默认数据真相。
|
||||
在 local-first 方案下,这套 Convex 自托管环境只定位为历史数据导出、显式 cloud source / compat 和可选 sync replica 运行底座;默认 auth、授权、分享、同步状态、AI policy、ACP/Hermes runtime session 等控制面已由 Rust SQLite control-plane 承接。页面正文、默认附件和本地 AI 会话全文不再以它作为早期产品默认数据真相。
|
||||
|
||||
## 当前 functions 边界
|
||||
|
||||
- 仓库根 `convex/` 是当前 active Convex functions 部署源;目前只保留 `schema.ts` 与 `aiSessions.ts`,用于 ACP / Hermes runtime session store。
|
||||
- `recycle/wolai-frontend/convex/` 是退役前端随带的历史实现,不允许作为当前部署 fallback。仍需要的 `documents` / `mediaAssets` / `users` / `workspaces` 等旧 functions,必须明确迁回 active 区或移动到外部辅助区;不再使用的应正式退役。
|
||||
- `scripts/run-convex-deploy.js` 只从仓库根部署 `convex/`,缺少 active functions 时应失败,不应从 `recycle/` 回退。
|
||||
- 仓库根 `convex/` 已退役并软删除到 `recycle/20260522-convex-runtime-retirement/convex/`;它只作为审计、迁移对照或历史恢复素材,不再是 active deploy source。
|
||||
- `recycle/wolai-frontend/convex/` 是退役前端随带的历史实现,不允许作为当前部署 fallback。
|
||||
- `scripts/run-convex-deploy.js` 已随根 functions 源码软删除到 `recycle/20260522-convex-runtime-retirement/scripts/run-convex-deploy.js`。如需重新部署 Convex functions,必须先明确新的 cloud/compat 部署边界,不应直接恢复旧根 `convex/` 作为默认控制面。
|
||||
|
||||
## 启动
|
||||
|
||||
@@ -36,12 +36,13 @@ docker compose exec backend ./generate_admin_key.sh
|
||||
|
||||
## 快速验证(可选)
|
||||
|
||||
### 1) 验证 Convex functions 可用
|
||||
### 1) 验证默认启动不依赖 Convex functions 源码
|
||||
|
||||
当前根 `convex/` 只保留 ACP / Hermes runtime session store,部署前可先确认 active functions 文件存在:
|
||||
当前默认 hot 启动链路不应要求仓库根存在 `convex/`:
|
||||
|
||||
```bash
|
||||
test -f convex/schema.ts && test -f convex/aiSessions.ts
|
||||
test ! -d convex
|
||||
npm run desktop:hot
|
||||
```
|
||||
|
||||
### 2) 验证固定开发用户(阶段 3)
|
||||
|
||||
Reference in New Issue
Block a user