old backend core lib

apps/server-rust/README.md

@@ -5,27 +5,29 @@ crate 导出。
 
 ## 模块职责
 
-| 模块          | 职责                                                     |
-| ------------- | -------------------------------------------------------- |
-| `app`         | 依赖组装、迁移、事件队列、源启动与旧配置导入             |
-| `auth`        | 邀请码、TOTP、恢复码、会话、secret 加密和组件 token      |
-| `components`  | 组件定义、设置版本、订阅、projection 与 handler registry |
-| `config`      | TOML 解析、部署策略校验和旧单用户兼容字段                |
-| `credentials` | CookieCloud URL 边界与 Bilibili Cookie 提取              |
-| `db`          | PostgreSQL pool、迁移和 RLS tenant context               |
-| `domain`      | provider-independent event 与 WebSocket envelope         |
-| `http_api`    | REST/WS、会话、权限、same-origin、静态资源与安全响应头   |
-| `live`        | provider trait、Bilibili adapter 与 source supervisor    |
-| `overlay`     | 弹幕姬设置及礼物/表情目录                                |
-| `rate_limit`  | 匿名登录和 enrollment 滥用限制                           |
-| `realtime`    | source event routing 与 component-scoped fanout          |
-| `repository`  | PostgreSQL component facade 和热路径缓存同步             |
+| 模块           | 职责                                                     |
+| -------------- | -------------------------------------------------------- |
+| `app`          | 依赖组装、迁移、事件队列、源启动与旧配置导入             |
+| `auth`         | 邀请码、TOTP、恢复码、会话、secret 加密和组件 token      |
+| `components`   | 组件定义、设置版本、订阅、projection 与 handler registry |
+| `config`       | TOML 解析、部署策略校验和旧单用户兼容字段                |
+| `credentials`  | CookieCloud URL 边界与 Bilibili Cookie 提取              |
+| `db`           | PostgreSQL pool、迁移和 RLS tenant context               |
+| `domain`       | provider-independent event 与 WebSocket envelope         |
+| `http_api`     | REST/WS、会话、权限、same-origin、静态资源与安全响应头   |
+| `live`         | provider trait、Bilibili adapter 与 source supervisor    |
+| `overlay`      | 弹幕姬设置及礼物/表情目录                                |
+| `rate_limit`   | 匿名登录和 enrollment 滥用限制                           |
+| `realtime`     | source event routing 与 component-scoped fanout          |
+| `repository`   | PostgreSQL component facade 和热路径缓存同步             |
+| `song_request` | 点歌命令、事务队列、评分、快照和管理服务                 |
 
 ## 重要不变量
 
 - handler 不能信任请求体中的 owner；owner 必须来自 session 或 source context。
 - tenant table 查询必须在 `Db::set_tenant` 后的事务中执行。
 - provider 只能输出 canonical、bounded、sanitized `LiveEvent`。
+- Bilibili listener 必须保持 20 秒心跳；socket 内部重连失败后由 adapter 重建完整客户端。
 - projection 无副作用；可靠业务动作必须使用幂等 handler。
 - token、邀请码和恢复码只存摘要，TOTP/CookieCloud Secret 只存认证加密密文。
 - EventHub 的 channel key 是 component ID，不允许增加无权限的全局 receiver。