diff --git a/AGENTS.md b/AGENTS.md index c8df551..ac90614 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,7 +14,7 @@ ## 项目速览(速记) -- **`design`(本分支)= 设计文档中心 + 实现主线**:实现代码与文档同分支演进(代码落点已定案),monorepo 结构(`apps/server` · `apps/web` · `packages/core` · `packages/db`)见 `docs/design/技术选型.md` §4 +- **`v1`(本分支)= 设计文档中心 + 实现主线**:实现代码与文档同分支演进(代码落点已定案),monorepo 结构(`apps/server` · `apps/web` · `packages/core` · `packages/db`)见 `docs/design/技术选型.md` §4 - 数据模型:四张基线表(`api_keys` · `usage_logs` · `payments` · `qpu_history`)+ 三张访问主体表(`members` · `users` · `sessions`)设计见本目录,**七篇已定稿(2026-10-01,经作者逐篇审阅)**;同步架构(轮询 + `request_id` 去重 + 攒库)的动因由上游物理约束决定,架构结论不变 - 需求总集与待裁决项(平台身份体系、费用分摊与账单、充值折算、多订阅、数据资产保护)见 `docs/design/需求清单.md`;交付形态已裁决(双形态并行,完整形态先行) - 上游约束速记:只有 sk-key、无时间过滤接口 → 轮询攒库是唯一路径(README「架构的根本动因」) diff --git a/README.md b/README.md index 4171ddc..1d1264b 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ | 项目 | 内容 | |------|------| -| 当前状态 | **实现推进中**(`design` 分支 = 文档中心 + 实现主线)——设计文档全部定稿(含同步引擎);后端全量落地(core / db / server / engine + Scalar 在线文档),同步引擎已人工验收;**前端仅有 antdv-next 能力 spike,真实页面待开工** | +| 当前状态 | **实现推进中**(`v1` 分支 = 文档中心 + 实现主线)——设计文档全部定稿;后端 + 同步引擎已落地;前端总览与 Key 管理已实现,其余页面进行中 | | 技术栈 | 全栈 TypeScript(选型定稿见 [`docs/design/技术选型.md`](docs/design/技术选型.md)):母体 Bun + Hono + Drizzle + PostgreSQL · 前端 Vue 3 + antdv-next | ## 项目沿革 diff --git a/docs/design/技术选型.md b/docs/design/技术选型.md index 10b2dfc..d98a8d9 100644 --- a/docs/design/技术选型.md +++ b/docs/design/技术选型.md @@ -47,7 +47,7 @@ ## 4. 分层落地:monorepo(Bun workspaces) ```text -(仓库根 · design 分支) +(仓库根 · v1 分支) ├─ apps/ │ ├─ server/ # 母体后端:Hono serve 装配 · Drizzle/pg · 进程内调度 · 环境变量与密钥注入 │ └─ web/ # 前端:Vue 3 + antdv-next + Vite @@ -58,7 +58,7 @@ **依赖规则(单向)**:`apps/*` → `packages/db` → `packages/core`;core 导出的 DTO 类型可被 web 以纯类型依赖引用(前后端共用一份契约类型)。 -**代码落点**:实现代码与设计文档同在 design 分支演进。 +**代码落点**:实现代码与设计文档同在 v1 分支演进。 ## 5. R14 预留:现阶段零成本,只为后续抽取不挖坑