实体参考

所有实体使用 Lombok 注解（@Data、@Getter、@Setter），通过 @MappedEntity 映射到 H2 表。

Note

带有 @Id 且通过 CrudRepository.update() 操作的实体必须使用显式 getter/setter，而非 Lombok @Getter/@Setter。Lombok 会隐藏 @Id 注解，导致 Micronaut Data 注解处理器报错"No identity is present"。目前 EventRelations 和 Room 遵循此模式。

User

表： users

字段	类型	说明
`id`	String (PK)	用户 ID（`@alice:localhost`）
`passwordHash`	String	密码哈希
`displayName`	String	显示名称
`avatarUrl`	String	头像 MXC URI
`createdAt`	Long	创建时间戳

UserAccessToken

表： user_access_tokens

字段	类型	说明
`id`	String (PK)	令牌 ID
`userId`	String	所有者用户 ID
`deviceId`	String	设备标识符
`token`	String	不透明令牌字符串（`syt_...`）
`createdAt`	Long	创建时间戳

Room

表： rooms

字段	类型	说明
`id`	String (PK)	房间 ID（`!room:localhost`）
`name`	String	房间名称
`topic`	String	房间话题
`creatorId`	String	创建者用户 ID
`roomType`	String	房间类型（`m.space` 为空间）
`createdAt`	Long	创建时间戳

Event

表： event

字段	类型	说明
`id`	String (PK)	事件 ID
`roomId`	String	房间 ID
`type`	String	事件类型
`sender`	String	发送者用户 ID
`stateKey`	String	状态键（非状态事件为 null）
`content`	String	JSON 内容
`streamOrdering`	Long	流位置
`originServerTs`	Long	源服务器时间戳
`depth`	Long	DAG 深度

RoomMember

表： room_user

字段	类型	说明
`id`	String (PK)	组合 ID
`roomId`	String	房间 ID
`userId`	String	用户 ID
`membership`	String	join/invite/leave/ban
`eventMembership`	String	成员事件 ID

EventRelations

表： event_relations

字段	类型	说明
`id`	Long (PK)	自增 ID
`eventId`	String	源事件 ID
`relatesToId`	String	关联事件 ID
`relationType`	String	m.thread、m.annotation、m.replace、m.reference
`eventType`	String	关联事件类型
`roomId`	String	房间 ID

MediaMetadata

表： media_metadata

字段	类型	说明
`id`	String (PK)	媒体 ID
`contentType`	String	MIME 类型
`contentLength`	Long	文件大小（字节）
`fileName`	String	原始文件名
`uploadName`	String	上传名称

ServerSigningKey

表： server_signing_key

字段	类型	说明
`id`	String (PK)	密钥记录 ID
`serverName`	String	服务器名称
`keyId`	String	密钥标识符
`publicKey`	String	Base64 公钥
`privateKey`	String	Base64 私钥
`algorithm`	String	签名算法
`createdAt`	Long	创建时间戳
`expiresAt`	Long	过期时间戳

UserPushRule

表： user_push_rules

字段	类型	说明
`id`	String (PK)	规则 ID
`userId`	String	所有者用户 ID
`ruleId`	String	规则标识符
`kind`	String	override/room/sender/content/underride
`enabled`	Boolean	规则启用状态
`actions`	String	JSON 操作数组
`conditions`	String	JSON 条件数组

DeviceInbox

表： device_inbox

字段	类型	说明
`id`	String (PK)	消息 ID
`userId`	String	目标用户 ID
`deviceId`	String	目标设备 ID
`content`	String	JSON 消息内容
`createdAt`	Long	创建时间戳

#实体参考

#User

#UserAccessToken

#Room

#Event

#RoomMember

#EventRelations

#MediaMetadata

#ServerSigningKey

#UserPushRule

#DeviceInbox