ChatVoice legacy schema 集成¶
ChatLogin 0.2.0 提供方能力
本页描述 ChatLogin provider 0.2.0 提供的 legacy schema 托管接入面。既有消费方若仍固定 <0.2 不会改变;采用该能力时需由消费方显式升级依赖并在自己的发布中接入。
该集成面向已经使用 ChatVoice/Speakr SQLite accounts 与 auth_sessions 的宿主。目标是保留原账号、密码材料、会话表关系、业务 owner_id、API token 归属、会议/对话/录音等数据,同时把同一账户目录暴露给 ChatLogin managed users 的 owner/admin/user 管理能力。
支持的 schema 采用方式¶
from chatlogin.backends import (
ChatVoiceManagedStore,
adopt_owner,
initialize_chatvoice_managed_schema,
)
from chatlogin.managed import ManagedUsers
store = ChatVoiceManagedStore(connect, lock, clock, max_users=10000, max_sessions=10000)
store.initialize()
users = ManagedUsers(store, session_namespace="chatvoice", ttl=86400, clock=clock)
owner = adopt_owner(store, "admin@example.invalid")
connect、lock 与 clock 由受信任同进程宿主提供,并指向同一个 ChatVoice 数据库和互斥边界。initialize_chatvoice_managed_schema(connection) 可在宿主的显式数据库 setup 中调用;迁移不是 import side effect,也不是公开 HTTP bootstrap。
数据保留¶
| 原始数据 | 集成后的处理 |
|---|---|
accounts.id |
继续作为稳定 user_id;不重建、不重新分配 |
account / display_name |
作为 managed username/display name 的来源 |
password_salt / password_hash |
原字节保留;不重新哈希旧密码 |
业务表 owner_id |
继续指向原稳定账号 ID;managed OWNER 不是业务记录通行证 |
auth_sessions |
继续由同一 cookie/session 关系解析;角色、状态或密码安全变化会使受影响旧会话失效 |
| API token | 禁用或删除账号后拒绝访问,不删除保留行 |
schema 初始化是显式、幂等、additive 的:为旧账号补充 role/status/revision 等管理列,默认旧账号为 enabled USER,并建立唯一有效 owner 约束。它不删除旧行、不复制账号到第二个用户库,也不改写业务归属。
账号匹配规则¶
启用 managed schema 后,ChatVoiceAuth 与 ManagedUsers 共用 metadata-aware 的 lower(account) 账号键:ASCII 账号大小写变体可登录同一既有身份,原 account 字符串、ID、盐和密码哈希不改写。规范化键冲突时拒绝认证,不能选择任意匹配行;schema 初始化也会拒绝冲突,并在原表建立规范化唯一性约束。尚未启用管理元数据的旧库继续采用原来的精确账号匹配。管理资料、角色、状态、密码与删除操作也保持原账号字符串;初始化会在调用方事务内替换曾改写账号的旧版 package-owned update trigger,不修改既有账号行,已修正 trigger 不重复替换。
Owner 采用¶
adopt_owner(store, exact_existing_account_or_id) -> UserRecord 只用于一次性采用精确既有账号或 ID:
- 已存在 owner 时失败。
- 目标必须已在原
accounts中存在。 - 采用会把该账号设为 enabled
OWNER,递增认证 revision,并返回不含凭据的UserRecord。 - 其他既有账号保持
USER/ enabled,除非后续由 owner/admin 通过管理 API 修改。
示例中的 admin@example.invalid 是合成占位账号。生产选择由宿主的受信任 Python setup 执行,不在公共文档、命令历史或日志中写入真实账号、用户 ID、哈希或 token。
权限与信任边界¶
| 边界 | 说明 |
|---|---|
| 公开注册 | 不提供。ChatVoice 原生账号仍由 invite-only/受信任工具创建 |
| 宿主连接 | connect/lock 是同进程受信任接口;不防御恶意 in-process 代码 |
| 管理角色 | owner/admin/user 管理账户目录;业务会议、音频、API token、模型调用仍需宿主 ACL |
| owner 含义 | OWNER 是账号目录 owner,不是所有业务数据的全读权限 |
| 会话失效 | 角色、状态、删除、改密和 owner 交接通过 revision 使受影响会话失效 |
| owner 交接 | 由 managed users 的 owner-only 原子交接处理 |
宿主仍需在业务路由中执行原来的记录归属检查,例如会议 owner_id、声音任务所属账号、只读 token scope 与禁用/删除账号拒绝策略。