…
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/身份服务讨论为架构建议,不代表把当前文档站接到新的外部服务。