外观
表定义
控制库 41 张 ORM 表的逐列定义,按子系统分七册。日常检索从这里进。
一个子系统的数据通常跨层:几张表在 PostgreSQL、几个键在 Valkey 或 Redis。按子系统分册意味着单册即可看到它的全部落点,无需跨文件拼接——层作为每张表的属性标注,不作为目录轴。层的含义见分层与存储角色。
七册
| 文档 | 覆盖的子系统 | 表数 |
|---|---|---|
| 节点与网络 | 节点身份、密钥、端口池、接入凭据、世代、Peering 聚合 | 10 |
| 共享 DNS | DNS 三级模型与组装规则 | 3 |
| 账号、门户与自动对等 | 两个信任域、审计、自动对等策略与请求 | 8 |
| 健康与自观测 | 对账健康、上报历史、agent 自观测存档 | 4 |
| 路由观测 | 路由全表、逐路由明细、差分基准、churn 时间线 | 4 |
| 流量 | 节点级与接口级流量:热窗口、5 min 存档、差分基准 | 4 |
| Flap 检测 | 两级打分热态、转移历史、告警事件、速率与活跃度存档 | 8 |
前三册以 L1 配置事实源为主(人写入、丢失不可重建、必须进备份,账号、门户与自动对等另有一张 L3 存档表与一条降级路径),后四册以观测与存档为主(agent 上报,多数可重建)。全库体量集中在路由观测,单子系统约 153 MB、占控制库 38%。
不在这里的东西
| 要找的 | 去处 |
|---|---|
| 按表名反查它属于哪一册 | 册总览的全表速查 |
| KV 与 Redis 中的键 | KV 与缓存键索引 |
| 某张表由谁在什么时机写入 | 写入路径 |
| 表为什么落在这一层 | 分层与存储角色 |