32 lines
3.0 KiB
Markdown
32 lines
3.0 KiB
Markdown
# Endor 概念页验收 · 2026-10-27
|
|
|
|
新增页面 `/docs/00-endor-concepts-draft`。按用户给出的五张参考图组织为清晰的矢量图标、节点、实线/点线和二分全连接；未使用 Mermaid 自动矩形流程图，也未引入外部图标、字体或 CDN。
|
|
|
|
## 内容与图形核对
|
|
|
|
- 全球 `endorphin API` 入口分流到北美、亚洲各自的区域负载均衡入口。
|
|
- 每区两个 Traefik（冗余可选，第二个标 HA）与三个 Nexus Runtime 构成 K₂,₃；总共12条网关到 Runtime 边，六个 Nexus 各配一个 Aster VM。
|
|
- 四个区域分片分别有 PostgreSQL、Aerarium、S3 图标；Aerarium 指向另外两种存储。各层均有点线连接的区域内小型副本图标。
|
|
- 四个源分片各有独立的金色跨区线路和同编号异地备份集，备份位置明确为对侧区域。
|
|
- CDN 作为可选缓存路径，命中直接返回，点线回源到示例 S3；动态 API 和登录不默认进入共享缓存。
|
|
- 身份服务以独立控制服务建议呈现，客户端登录与签发、公钥分发和 Nexus 校验分别说明；没有宣称已实现的部署关系。
|
|
- 正文区分异步备份、在线副本、恢复点、RPO/RTO，说明“最后一笔写入绝不丢失”需要额外写入确认与耐久协议。
|
|
|
|
## 验证
|
|
|
|
- `pnpm lint`、`pnpm typecheck`：通过。
|
|
- `pnpm --filter @endor/docs run build --webpack`：通过，新增文档静态路由成功生成。本机采用前次验收已确定的 webpack 构建方式，仓库原有构建配置不变。
|
|
- `pnpm figures`：通过；独立 SVG，无外部图像资源。
|
|
- `uv run --locked --project tools/figures python -m unittest discover -s tools/figures/tests -v`：通过，覆盖重复生成字节一致、6个 VM、每区三个 Runtime/两个网关、12条全连接边、四个分片各有备份目标。该检查也接入容器校验脚本。
|
|
- 现有四个 CI/部署脚本单元测试通过。
|
|
- 实际生产预览 `127.0.0.1:3016`：检查桌面与390px手机。手机正文页面宽度390px，没有页面横向溢出；查看器放大至45%时内容宽808px，仅在宽372px的图面区域滚动，正文仍宽390px。
|
|
- 浏览器实际验证放大、适应宽度、关闭与 Escape；关闭后焦点恢复至“放大查看”按钮。桌面从适应状态放大到94%，按实际容器宽度计算比例。
|
|
- SVG 下载链接指向本地生成文件，并设置下载文件名。全部路由及 SVG/JS/CSS 的 HTTP 冒烟由现有 `scripts/smoke.py` 检查。
|
|
- 页面与查看器捕获的浏览器 error/warn 日志为空。
|
|
|
|
## 截图
|
|
|
|
`architecture.png` 为完整 SVG 的实际浏览器渲染；`page-desktop.png` / `page-mobile.png` 为正文页面；`viewer-desktop.png` / `viewer-zoom.png` 为桌面图形查看与缩放；`viewer-mobile.png` / `viewer-mobile-zoom.png` 为手机适应与缩放。
|
|
|
|
本次未改变共享 Runner、Docker 缓存、部署端口与回退策略。CDN/身份服务讨论为架构建议，不代表把当前文档站接到新的外部服务。
|