Organize living documentation and directory guides

2026-10-18 20:58:42 +08:00
parent 6fa95b64b0
commit 8bbe78e01e
30 changed files with 674 additions and 396 deletions
@@ -0,0 +1,14 @@
+# Server 入口
+
+[main.rs](main.rs) 包含当前所有宿主启动代码：
+
+| 部分 | 职责 |
+| --- | --- |
+| AppState | 共享只读 Arc<Vm> 与可克隆的 Storage 连接池 |
+| main／run | 创建 VM、连接数据库、写 host.version、绑定地址、组装路由、服务结束后关闭存储 |
+| health | ping 数据库，返回 200／503 及后端标签 |
+| bootstrap | 返回对象模型、type_system=false 和堆对象数量，不分配对象 |
+| shutdown_signal | Ctrl-C；Unix 上同时接受 SIGTERM，触发 Axum 优雅退出 |
+| tests | 关闭数据库池后健康状态变为 unavailable |
+
+改变端点时同步 [运行指南](../../../docs/operations/README.md) 与 [smoke.py](../../../scripts/README.md)；改变启动变量时同步 [配置](../../../docs/operations/configuration.md)。网络、信号和数据库逻辑不进入 Core。返回 [server](../README.md)。