docs: 清除版本叙事并按开源文档体系整理
去掉初版/新版与分支指称,重写 README/AGENTS,删子包 README,对齐文档交叉引用与已废止测试脚本。
This commit is contained in:
+3
-3
@@ -41,13 +41,13 @@
|
||||
| 前端框架 | **Vue 3** | 作者近年常用栈;实现期自由度(共性 §3.5「作者即前端」) | — |
|
||||
| 组件库 | **antdv-next**(作者指定尝试项) | Vue 3 企业组件库、对齐 ant-design(React 上游)设计体系;**已核验通过**(§7.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)+ **bun test**(core/db/server) | Bun 自带 test runner;Vite 为 Vue 生态默认 | 前端组件测试可加 vitest(实现期定) |
|
||||
| 构建 / 测试 | **Vite**(web);质量门 = `typecheck` + `build` + 人工验收 | 前端构建走 Vite 生态默认;自动化测试不在当前范围 | 需要时再引入测试框架 |
|
||||
| API 文档与校验 | **zod** + **@hono/zod-openapi** + **Scalar**(作者确认) | 一源三用:TS 类型 / 请求校验(`422` 与 `fields` 的机器来源)/ OpenAPI 生成;Scalar 为 Hono 官方搭档,规范与渲染器解耦 | Swagger UI(规范不动、换皮即可) |
|
||||
|
||||
## 4. 分层落地:monorepo(Bun workspaces)
|
||||
|
||||
```text
|
||||
(仓库根 · 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 以纯类型依赖引用(前后端共用一份契约类型)。
|
||||
|
||||
**代码落点**:实现代码与设计文档同在 v1 分支演进。
|
||||
**代码落点**:实现代码与设计文档同仓演进。
|
||||
|
||||
## 5. R14 预留:现阶段零成本,只为后续抽取不挖坑
|
||||
|
||||
|
||||
Reference in New Issue
Block a user