yovision/deploy/postgres/README.md

YoVision PostgreSQL 初始化

本目录实现 T-009/T-010 的 PostgreSQL 17.10 schema。SQL 必须按文件名前缀顺序执行：001～004 创建 NOLOGIN 权限角色、Bell/Sense 初始对象和配额权限；005～007 增量增加 Area 策略投影、设备操作审计 Outbox 和对应最小权限。全部 SQL 可重放。应用登录角色及其密码由部署环境或密钥系统创建，并分别加入 bell_app、sense_app；仓库不保存登录凭据。

生产/共享实例必须由管理员先备份并在 YoVision 专用数据库中执行。Sense 进程不会用高权限自动建库或建角色。示例只使用私有环境变量，不把实际 DSN 写入脚本或日志：

$env:YOVISION_PG_ADMIN_DSN = '由管理员私下设置'
Get-ChildItem deploy/postgres/[0-9][0-9][0-9]_*.sql |
  Sort-Object Name |
  ForEach-Object { & 'D:\pgsql17\bin\psql.exe' -X -v ON_ERROR_STOP=1 -d $env:YOVISION_PG_ADMIN_DSN -f $_.FullName }

不要把该示例替换成真实连接串后提交。自动验收使用 scripts/test_postgres.ps1 启动隔离临时集群，不读取或修改 D:\pgsql17\data。

权限边界

• bell_app 拥有 bell.sites/bell.areas、版本 trigger、bell.site_quota_v1 和 bell.area_policy_v1。
• sense_app 拥有 sense schema，只获得 bell schema 的 USAGE 和两个投影视图的 SELECT。
• sense_app 对 Bell 源表、Bell migration 表和 trigger function 没有权限；启动检查发现权限过宽时拒绝运行。
• sense.device_operation_outbox 是本地持久化审计事实，不是 Bell 全局审计真相；relay 的传输、签名、确认和留存尚未实现。
• PUBLIC 对两个业务 schema 的表和函数没有权限。

恢复

T-009/T-010 不迁移或删除现有 SQLite 数据，默认运行配置也仍为 SQLite。SQLite 不具备生产 Area/Outbox 一致性，不能作为后续公共控制 API 的生产后端。若 PostgreSQL 切换验证失败，停止 PostgreSQL 模式的 Sense 进程并恢复原实验室 SQLite DSN；不要把此回退误报为生产语义等价。schema 不提供自动 down migration；需要移除时由管理员先备份，再只删除明确确认的 YoVision 专用数据库，禁止对共享实例做模糊或递归清理。