本文档由 g2rain-agent-runtime 的 docs/development/database-conventions.md 自动同步生成。

# 数据库与数据模型

• 任务实例、图节点、边、节点载荷、检查点、恢复记录、会话、消息和工具调用记录必须具有清晰的生命周期与关联键。
• 业务读写经 Service 管理；DAO 仅负责持久化；PO 不泄露到外部 API。
• 状态迁移应使用条件更新或等价机制避免并发覆盖，并保留必要的审计时间和关联 ID。
• 任何工具副作用的重试或恢复必须基于持久化记录做幂等判断，不能仅依赖内存状态。
• 表结构、索引、迁移脚本和 Mapper 发生变化时，同步更新契约、测试与本页。