chore(deploy): 移除 Docker 配置与文档中的部署方案，待从代码重议
This commit is contained in:
@@ -27,7 +27,7 @@
|
||||
- **会话 cookie**：`HttpOnly + Secure + SameSite=Lax`，`Path=/api/admin`（「路径限管理面」裁决的落地）；随请求自动携带、登出即删行
|
||||
- **成员令牌**：`Authorization: Bearer <token>`；明文令牌只存在于登录壳输入与 sessionStorage（关标签即失效——《交互设计-登录与会话》§4）
|
||||
- 401 分流为前端职责：管理面任意 401 → 登录页「会话已过期」；成员视图任意 401 → 登录壳「令牌无效或已停用」——后端 401 响应不带面特化信息，前端按所在面分流（共性 §1）
|
||||
- **命名空间约定：`/api/*` 专属接口**——前端页面路由永不进入 `/api` 前缀；未知 `/api/*` 路径 = 接口 `404` 错误信封，非 `/api` 请求归前端托管（SPA history 回退「非 `/api` → index.html」，细则归骨架与部署设计）
|
||||
- **命名空间约定：`/api/*` 专属接口**——前端页面路由永不进入 `/api` 前缀；未知 `/api/*` 路径 = 接口 `404` 错误信封，非 `/api` 请求归前端托管（SPA history 回退「非 `/api` → index.html」，细则归骨架设计）
|
||||
|
||||
## 3. 错误信封
|
||||
|
||||
|
||||
@@ -55,7 +55,7 @@
|
||||
|
||||
- `key_hash`（HMAC-SHA256，不可逆）：只服务「命中判定」——没有它，每次查询都要把全部 key 送去上游验证
|
||||
- `key_ciphertext`（AES-256-GCM，可解密）：唯一用途是调上游
|
||||
- 密钥 `SK_KEY_ENCRYPTION_SECRET` 经 env 注入（HKDF 派生 hmac / aes 子密钥）；**密钥丢失 = 全部 key 需重新登记**（记入部署文档）
|
||||
- 密钥 `SK_KEY_ENCRYPTION_SECRET` 经 env 注入（HKDF 派生 hmac / aes 子密钥）；**密钥丢失 = 全部 key 需重新登记**
|
||||
|
||||
> **注解：为什么是两个字段（给非密码学背景的读者）**
|
||||
>
|
||||
|
||||
@@ -26,7 +26,7 @@ apps/engine ──► 定时 syncRound() ──► packages/db
|
||||
| 共享 | `packages/core`（上游客户端、dedupe、折算）· `packages/db`（仓储）——**业务能力仍一份** |
|
||||
| 不共享 | 进程内存、事件循环、调度器；HTTP 与引擎**互不调用** |
|
||||
| 不调自家 API | 引擎只打上游 NewAPI + 写库；不走 `/api/admin/*` |
|
||||
| 部署 | 开发：两个命令（`dev:server` / `dev:engine`）；生产 compose 两个 service（均连同一 PostgreSQL） |
|
||||
| 运行形态 | 开发：两个命令（`dev:server` / `dev:engine`）；生产两个进程（均连同一 PostgreSQL） |
|
||||
|
||||
**为何分进程（2026-10-05 复审）**：一轮可能解析上千条日志并做指纹/加密/批量写，若与 API 同进程会争事件循环，查询延迟与「引擎是否在跑」绑死；定时器漂移本身对本业务无害，**互扰才是拆分动因**。
|
||||
|
||||
@@ -174,7 +174,7 @@ apps/
|
||||
|
||||
## 9. 验收清单（实现后）
|
||||
|
||||
- [ ] 只启 `dev:engine`（或 compose 仅 engine+db）：日志入库、`log_synced_at` 前进
|
||||
- [ ] 只启 `dev:engine`（或只跑 engine + db）：日志入库、`log_synced_at` 前进
|
||||
- [ ] 只启 `dev:server`：HTTP 正常，无轮询日志
|
||||
- [ ] 同一数据重复轮次不产生重复行
|
||||
- [ ] 某 key 401：其余 key 正常；`engine_status.last_round.failed_api_key_ids` 含之
|
||||
|
||||
+6
-12
@@ -22,7 +22,6 @@
|
||||
| 调度 | **独立进程 `apps/engine`**：手写 `setTimeout` 循环（细则见《同步引擎设计》） |
|
||||
| 加密 | WebCrypto（Bun 原生） |
|
||||
| 前端 | **Vue 3 + antdv-next + Vite** |
|
||||
| 部署 | **Docker**（倾向，§6） |
|
||||
|
||||
## 2. 语言：TypeScript 全栈
|
||||
|
||||
@@ -39,7 +38,7 @@
|
||||
| 数据访问 | **Drizzle ORM** | TS 优先、查询保持 SQL 形态（不藏 SQL，利于学与审计）；schema 即代码，drizzle-kit 迁移配套齐全 | Kysely / 裸驱动 + 手写仓储 |
|
||||
| pg 驱动 | **postgres.js** | Drizzle 文档主推；查询构建器式 API；内置连接池；Bun 兼容好 | node-postgres |
|
||||
| 前端框架 | **Vue 3** | 作者近年常用栈；实现期自由度（共性 §3.5「作者即前端」） | — |
|
||||
| 组件库 | **antdv-next**（作者指定尝试项） | Vue 3 企业组件库、对齐 ant-design（React 上游）设计体系；**已核验通过**（§7.1）：活跃周更、§3.7 清单逐项有对应组件、Agent 文档齐备 | Element Plus / ant-design-vue（§3.7 全覆盖） |
|
||||
| 组件库 | **antdv-next**（作者指定尝试项） | Vue 3 企业组件库、对齐 ant-design（React 上游）设计体系；**已核验通过**（§6.1）：活跃周更、§3.7 清单逐项有对应组件、Agent 文档齐备 | Element Plus / ant-design-vue（§3.7 全覆盖） |
|
||||
| 加密 | **WebCrypto** | HKDF / AES-256-GCM / HMAC-SHA256 / PBKDF2 与裁决一致（密钥体系见各表设计）；Bun 原生 | HKDF 若 Bun 覆盖滞后：基于 HMAC 的纯 TS 垫片（同原语） |
|
||||
| 构建 / 测试 | **Vite**（web）；质量门 = `typecheck` + `build` + 人工验收 | 前端构建走 Vite 生态默认；自动化测试不在当前范围 | 需要时再引入测试框架 |
|
||||
| API 文档与校验 | **zod** + **@hono/zod-openapi** + **Scalar**（作者确认） | 一源三用：TS 类型 / 请求校验（`422` 与 `fields` 的机器来源）/ OpenAPI 生成；Scalar 为 Hono 官方搭档，规范与渲染器解耦 | Swagger UI（规范不动、换皮即可） |
|
||||
@@ -69,19 +68,15 @@ R13 的 CFW 抽取版仍是长期裁决，功能全集实现后启动，届时
|
||||
|
||||
Hono（双运行时可跑）与 WebCrypto 本身恰好与 CFW 兼容，属顺手之得，不构成现阶段约束。
|
||||
|
||||
## 6. 部署通道（倾向，细则归后续部署设计）
|
||||
|
||||
母体以 **Docker 镜像**交付（server 容器 + PostgreSQL，compose 编排）：满足仓库「一条命令链可部署」约定；运营方服务器零环境依赖（Bun 运行时随镜像内置），升级 = 换镜像重启；作者不接触服务器，镜像化把运行时选择与运营方环境解耦。
|
||||
|
||||
## 7. 风险与回退
|
||||
## 6. 风险与回退
|
||||
|
||||
| 风险 | 评估 | 对策 |
|
||||
|------|------|------|
|
||||
| antdv-next 项目年轻、维护者 3 人 | 桌面核验通过（§7.1）；未核验项：社区采用规模 | 实现期第一步做 **§3.7 能力 spike**（实测）；锁版本；实测不满足即触发回退（Element Plus / ant-design-vue） |
|
||||
| antdv-next 项目年轻、维护者 3 人 | 桌面核验通过（§6.1）；未核验项：社区采用规模 | 实现期第一步做 **§3.7 能力 spike**（实测）；锁版本；实测不满足即触发回退（Element Plus / ant-design-vue） |
|
||||
| Bun 生态资料少于 Node、边角兼容性 | 本项目规模小、依赖面窄（Hono / Drizzle / postgres.js 均成熟） | **Bun → Node 回退不伤业务代码**：换 `@hono/node-server` 装配即可，packages/* 原样 |
|
||||
| Bun 的 WebCrypto 原语覆盖（HKDF 等） | 未逐项实测 | 实现期首轮加密任务实测；缺失则 HMAC 纯 TS 垫片 |
|
||||
|
||||
### 7.1 antdv-next 核验记录（2026-10-02，一手源直查）
|
||||
### 6.1 antdv-next 核验记录（2026-10-02，一手源直查）
|
||||
|
||||
口径：npm registry / GitHub API / 官网 llms.txt 直查（当轮无浏览器检索通道——社区口碑与采用规模未核验）。
|
||||
|
||||
@@ -96,7 +91,6 @@ Hono（双运行时可跑）与 WebCrypto 本身恰好与 CFW 兼容，属顺手
|
||||
|
||||
结论：**通过核验，维持选定**；§3.7 spike 与回退预案照旧——桌面核验不替代实测。
|
||||
|
||||
## 8. 待裁决项
|
||||
## 7. 待裁决项
|
||||
|
||||
1. Docker 细则：基础镜像、compose 形态、密钥注入方式——部署设计时定；
|
||||
2. 前端测试设施是否引入 vitest。
|
||||
1. 前端测试设施是否引入 vitest。
|
||||
|
||||
Reference in New Issue
Block a user