信息对象与数据结构

本文档基于 docs/archon/docs/assets/reflekt-health.sql 数据库导出文件编写，交叉参考需求文档（raw_requirements_context.md、project_brief.md）、业务架构（business_architecture.md）、技术架构（technical_architecture.md）等，形成 Reflekt Health 真实数据模型。

Schema: reflekt-health（PostgreSQL）

第一部分：领域模型（代码层）

领域模型从业务视角描述核心业务对象及其关系，供后端 Agent 实现业务逻辑使用。表名与业务域的映射关系：需求中定义的 ref_* 表对应实现中的 iot_* 表（iot_family_* 家族表 + 独立 iot_* 表）。

1.1 核心业务域

业务域	英文	核心职责	数据库表归属
用户与认证	User & Auth	IoT 用户（家属账号）注册登录、AES-256 加密手机号	`iot_user`
家庭域	Family	家庭档案、成员管理、设备绑定、消息、通话	`iot_family_*` 系列表
设备域	Device	设备注册、状态管理、设备分享	`iot_device`、`iot_device_share`
健康数据域	Health	心率、血氧、步数、睡眠、体温	`iot_heart_rate`、`iot_spo`、`iot_pedo`、`iot_sleep_raw`、`iot_temperature`
AI 对话域	AI Brain	AI 会话记忆、消息记录、AI 操作日志	`iot_ai_session_memory`、`iot_ai_session_message`、`ai_operation_log`
雷达事件域	Radar	跌倒事件上报、MQTT 订阅管理	`mqtt_fall_event`、`mqtt_subscription`、`mqtt_inbound_message`
提醒域	Reminder	提醒计划创建、播报、执行日志	`iot_family_reminder`
告警域	Alert	告警触发、升级链路、通知下发	待建（需求定义 `ref_alert`、`ref_escalation`、`ref_notification` 表尚未创建）
运营管理域	Admin	系统配置、字典、OSS、审计日志	`sys_*` 系列表
定时任务域	Scheduling	分布式定时任务调度、重试机制	`sj_*` 系列表

1.2 核心领域对象

对象名称	中文名	需求对应	数据库表	主要属性	关联对象
IoTUser	IoT用户（家属）	CAREGIVER	`iot_user`	id, phone(AES), nickname, avatar, family_id	Family, Device
Family	家庭	FAMILY	`iot_family_archive`	id, family_name, elder_name, elder_age, health_profile(JSON)	IoTUser, Device, Elder
Elder	被照护者	ELDER	`iot_family_archive`（同表内嵌）	elder_name, elder_age, health_profile, baseline_hash	Family, Device, HealthData
Device	设备	DEVICE	`iot_device`	id, serial_number, device_type(luma/radar/watch), status, last_heartbeat	Family, DeviceEvent
DeviceEvent	设备事件	DEVICE_EVENT	`mqtt_fall_event`（跌倒）、`mqtt_inbound_message`（通用）	id, device_id, event_type, payload(JSON), event_time	Device
HealthData	健康数据	DEVICE_EVENT	`iot_heart_rate`、`iot_spo`、`iot_pedo`、`iot_sleep_raw`、`iot_temperature`	id, device_id, value, measured_at	Device, Elder
FamilyMessage	家庭消息	NOTIFICATION	`iot_family_message`	id, family_id, sender_id, content_type(voice/text), content	Family, IoTUser
Reminder	提醒计划	REMINDER	`iot_family_reminder`	id, family_id, elder_id, content_type, schedule, frequency, need_confirm	Family, Elder
AISessionMemory	AI记忆话题	MEMORY	`iot_ai_session_memory`	id, family_id, elder_id, topic, elder_response_url, status(pending/answered/listened)	Family, Elder
Alert	告警事件	ALERT	待建 `ref_alert`	id, elder_id, device_event_id, level(red/amber/normal), status, evidence_pack(JSON)	Elder, DeviceEvent
Escalation	升级链路	ESCALATION	待建 `ref_escalation`	id, alert_id, level, caregiver_id, channel(push/sms/voice), status	Alert, IoTUser
Notification	通知记录	NOTIFICATION	待建 `ref_notification`	id, alert_id, caregiver_id, channel, title, body, status	Alert, IoTUser

1.3 领域对象关系图

1.4 领域对象状态机

1.4.1 告警状态机（Alert — 待建）

1.4.2 设备状态机（Device）

1.4.3 六状态颜色语言（六态联动 Family App / Luma App 双端）

1.4.4 AI记忆话题状态机（AI Session Memory）

1.4.5 家庭通话状态机（Family Call）

1.4.6 家庭消息状态机（Family Message）

第二部分：数据字典（数据库层）

数据字典描述数据库表结构、字段定义、索引设计，供 DBA 和后端 Agent 创建数据库 Schema 使用。注：ref_alert、ref_escalation、ref_notification 三表已在需求文档中定义，但尚未在 SQL 导出文件中创建。以下 DDL 章节仅覆盖已导出的实际表。

2.1 ER 图

2.2 核心业务表 DDL

2.2.1 表：`iot_user`（IoT 用户/家属账号）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive	所属家庭ID
phone	VARCHAR(50)	UNIQUE（加密存储）	手机号（MyBatis AES-256 加密）
nickname	VARCHAR(100)		昵称
avatar	VARCHAR(500)		头像URL
status	VARCHAR(20)	DEFAULT 'active'	状态：active / inactive
create_dept	BIGINT		创建部门（RuoYi框架）
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询成员
idx_phone	phone	UNIQUE	手机号登录查询

关联：iot_user ← iot_family_group_member（多对多家庭成员）← iot_family_archive

2.2.2 表：`iot_family_archive`（家庭档案 / 被照护者）

需求中对应 FAMILY + ELDER 两个实体，在实现中合并为一张表。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_name	VARCHAR(100)		家庭名称
elder_name	VARCHAR(100)		被照护者姓名
elder_age	INT		被照护者年龄
elder_gender	VARCHAR(10)		性别
health_profile	JSONB		健康档案JSON：疾病史/用药史/作息规律
baseline_hash	VARCHAR(100)		行为基线标识
privacy_consent	JSONB		隐私同意状态JSON
address	VARCHAR(500)		家庭地址
status	VARCHAR(20)	DEFAULT 'active'	状态：active / pilot / formal
create_dept	BIGINT		创建部门
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_status	status	NORMAL	状态筛选（试点/正式）

DDL：

CREATE TABLE iot_family_archive (
    id BIGSERIAL PRIMARY KEY,
    family_name VARCHAR(100),
    elder_name VARCHAR(100),
    elder_age INT,
    elder_gender VARCHAR(10),
    health_profile JSONB,
    baseline_hash VARCHAR(100),
    privacy_consent JSONB,
    address VARCHAR(500),
    status VARCHAR(20) DEFAULT 'active',
    create_dept BIGINT,
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6),
    INDEX idx_status (status)
);

2.2.3 表：`iot_family_group_member`（家庭组成员）

需求中对应 CAREGIVER 实体，实现为关联表支持多成员家庭。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive, NOT NULL	家庭ID
user_id	BIGINT	FK → iot_user, NOT NULL	用户ID
role	VARCHAR(20)	DEFAULT 'member'	角色：admin / member
priority	INT	DEFAULT 99	紧急联系优先级（1最高）
nickname	VARCHAR(100)		成员昵称
status	VARCHAR(20)	DEFAULT 'active'	状态
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询成员
idx_user_id	user_id	NORMAL	按用户查询家庭
uk_family_user	family_id + user_id	UNIQUE	唯一约束

DDL：

CREATE TABLE iot_family_group_member (
    id BIGSERIAL PRIMARY KEY,
    family_id BIGINT NOT NULL REFERENCES iot_family_archive(id),
    user_id BIGINT NOT NULL REFERENCES iot_user(id),
    role VARCHAR(20) DEFAULT 'member',
    priority INT DEFAULT 99,
    nickname VARCHAR(100),
    status VARCHAR(20) DEFAULT 'active',
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    UNIQUE (family_id, user_id),
    INDEX idx_family_id (family_id),
    INDEX idx_user_id (user_id)
);

2.2.4 表：`iot_device`（设备）

需求中对应 DEVICE 实体，统一管理三类设备。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
serial_number	VARCHAR(100)	UNIQUE, NOT NULL	设备序列号
device_type	VARCHAR(20)	NOT NULL	类型：luma / radar / watch
family_id	BIGINT	FK → iot_family_archive	绑定家庭ID
device_name	VARCHAR(100)		设备名称（可自定义）
device_model	VARCHAR(100)		设备型号
status	VARCHAR(20)	DEFAULT 'pending'	状态：online / offline / pending
config	JSONB		设备配置JSON
last_heartbeat	TIMESTAMP(6)		最后心跳时间
firmware_version	VARCHAR(50)		固件版本
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_serial_number	serial_number	UNIQUE	序列号精确查询
idx_family_id	family_id	NORMAL	按家庭查询设备
idx_device_type	device_type	NORMAL	设备类型筛选
idx_status	status	NORMAL	状态筛选
idx_last_heartbeat	last_heartbeat	NORMAL	心跳超时检测

DDL：

CREATE TABLE iot_device (
    id BIGSERIAL PRIMARY KEY,
    serial_number VARCHAR(100) NOT NULL UNIQUE,
    device_type VARCHAR(20) NOT NULL,
    family_id BIGINT REFERENCES iot_family_archive(id),
    device_name VARCHAR(100),
    device_model VARCHAR(100),
    status VARCHAR(20) DEFAULT 'pending',
    config JSONB,
    last_heartbeat TIMESTAMP(6),
    firmware_version VARCHAR(50),
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6),
    INDEX idx_family_id (family_id),
    INDEX idx_device_type (device_type),
    INDEX idx_status (status),
    INDEX idx_last_heartbeat (last_heartbeat)
);

2.2.5 表：`iot_family_device`（家庭设备绑定关系）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive, NOT NULL	家庭ID
device_id	BIGINT	FK → iot_device, NOT NULL	设备ID
binding_status	VARCHAR(20)	DEFAULT 'active'	绑定状态
bind_time	TIMESTAMP(6)		绑定时间
unbind_time	TIMESTAMP(6)		解绑时间
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询设备
idx_device_id	device_id	NORMAL	按设备查询家庭
uk_family_device	family_id + device_id	UNIQUE	唯一约束

2.2.6 表：`iot_device_share`（设备分享）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device, NOT NULL	设备ID
owner_family_id	BIGINT	FK → iot_family_archive	所有者家庭ID
shared_family_id	BIGINT	FK → iot_family_archive	被分享家庭ID
share_type	VARCHAR(20)	DEFAULT 'view'	分享类型：view / control
status	VARCHAR(20)	DEFAULT 'active'	状态
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

2.2.7 表：`iot_family_message`（家庭消息）

需求中对应 NOTIFICATION 实体（消息通知）。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive, NOT NULL	家庭ID
sender_id	BIGINT	FK → iot_user	发送者用户ID
sender_type	VARCHAR(20)		发送者类型：user / elder
elder_id	BIGINT		老人ID（消息对象）
content_type	VARCHAR(20)	NOT NULL	内容类型：voice / text
content	TEXT		文字内容
voice_url	VARCHAR(500)		语音文件URL（S3）
duration	INT		语音时长（秒）
status	VARCHAR(20)	DEFAULT 'pending'	状态：pending / sent / delivered / played / failed
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询消息
idx_sender_id	sender_id	NORMAL	按发送者查询
idx_create_time	create_time	NORMAL	时间倒序查询
idx_status	status	NORMAL	状态筛选

DDL：

CREATE TABLE iot_family_message (
    id BIGSERIAL PRIMARY KEY,
    family_id BIGINT NOT NULL REFERENCES iot_family_archive(id),
    sender_id BIGINT REFERENCES iot_user(id),
    sender_type VARCHAR(20),
    elder_id BIGINT,
    content_type VARCHAR(20) NOT NULL,
    content TEXT,
    voice_url VARCHAR(500),
    duration INT,
    status VARCHAR(20) DEFAULT 'pending',
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6),
    INDEX idx_family_id (family_id),
    INDEX idx_create_time (create_time DESC),
    INDEX idx_status (status)
);
-- 触发器：update_time 自动更新
CREATE TRIGGER update_family_message_modtime
    BEFORE UPDATE ON iot_family_message
    FOR EACH ROW EXECUTE FUNCTION update_family_message_modtime();

2.2.8 表：`iot_family_reminder`（提醒计划）

需求中对应 REMINDER 实体。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive, NOT NULL	家庭ID
elder_id	BIGINT		被提醒老人ID
creator_id	BIGINT	FK → iot_user	创建人ID
content_type	VARCHAR(20)	DEFAULT 'text'	内容类型：text / voice
content	TEXT		提醒文字内容
voice_url	VARCHAR(500)		语音文件URL
schedule	VARCHAR(100)		Cron 表达式
frequency	VARCHAR(20)		频率：daily / weekly / custom
need_confirm	BOOLEAN	DEFAULT false	是否需老人确认
shared	BOOLEAN	DEFAULT true	是否分享给家属
status	VARCHAR(20)	DEFAULT 'active'	状态：active / paused / deleted
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询提醒
idx_elder_id	elder_id	NORMAL	按老人查询提醒
idx_status	status	NORMAL	状态筛选
idx_schedule	schedule	NORMAL	Cron 调度查询

2.2.9 表：`iot_family_call`（家庭通话记录）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive	家庭ID
initiator_id	BIGINT	FK → iot_user	发起人用户ID
call_type	VARCHAR(20)	DEFAULT 'audio'	通话类型：audio / video
status	VARCHAR(20)	DEFAULT 'pending'	状态：pending / connected / cancelled / no_answer / ended
duration	INT	DEFAULT 0	通话时长（秒）
start_time	TIMESTAMP(6)		开始时间
end_time	TIMESTAMP(6)		结束时间
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

DDL：

CREATE TABLE iot_family_call (
    id BIGSERIAL PRIMARY KEY,
    family_id BIGINT REFERENCES iot_family_archive(id),
    initiator_id BIGINT REFERENCES iot_user(id),
    call_type VARCHAR(20) DEFAULT 'audio',
    status VARCHAR(20) DEFAULT 'pending',
    duration INT DEFAULT 0,
    start_time TIMESTAMP(6),
    end_time TIMESTAMP(6),
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6)
);
-- 触发器：update_time 自动更新
CREATE TRIGGER update_family_call_modtime
    BEFORE UPDATE ON iot_family_call
    FOR EACH ROW EXECUTE FUNCTION update_family_call_modtime();

2.2.10 表：`iot_ai_session_memory`（AI 记忆话题）

需求中对应 MEMORY 实体。家属提问 → Luma 收音 → 家属播放 → 完成闭环。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive, NOT NULL	家庭ID
elder_id	BIGINT		被提问老人ID
caregiver_id	BIGINT	FK → iot_user	提问人用户ID
topic	VARCHAR(500)		话题内容
elder_response_text	TEXT		老人回答文字
elder_response_url	VARCHAR(500)		老人回答语音URL（S3）
status	VARCHAR(20)	DEFAULT 'pending'	状态：pending / answered / listened / expired
asked_at	TIMESTAMP(6)		提问时间
answered_at	TIMESTAMP(6)		回答时间
listened_at	TIMESTAMP(6)		聆听时间
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询记忆
idx_status	status	NORMAL	状态筛选
idx_create_time	create_time	NORMAL	时间查询

DDL：

CREATE TABLE iot_ai_session_memory (
    id BIGSERIAL PRIMARY KEY,
    family_id BIGINT NOT NULL REFERENCES iot_family_archive(id),
    elder_id BIGINT,
    caregiver_id BIGINT REFERENCES iot_user(id),
    topic VARCHAR(500),
    elder_response_text TEXT,
    elder_response_url VARCHAR(500),
    status VARCHAR(20) DEFAULT 'pending',
    asked_at TIMESTAMP(6),
    answered_at TIMESTAMP(6),
    listened_at TIMESTAMP(6),
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6),
    INDEX idx_family_id (family_id),
    INDEX idx_status (status)
);
CREATE TRIGGER update_ai_memory_modtime
    BEFORE UPDATE ON iot_ai_session_memory
    FOR EACH ROW EXECUTE FUNCTION update_ai_memory_modtime();

2.2.11 表：`iot_ai_session_message`（AI 会话消息）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
session_id	BIGINT	FK → iot_ai_session_memory	会话/记忆ID
role	VARCHAR(20)	NOT NULL	角色：user / assistant
content	TEXT		消息内容
voice_url	VARCHAR(500)		语音URL
model	VARCHAR(50)		使用的AI模型
tokens_used	INT		消耗token数
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_by	BIGINT		更新者
update_time	TIMESTAMP(6)		更新时间

DDL：

CREATE TABLE iot_ai_session_message (
    id BIGSERIAL PRIMARY KEY,
    session_id BIGINT REFERENCES iot_ai_session_memory(id),
    role VARCHAR(20) NOT NULL,
    content TEXT,
    voice_url VARCHAR(500),
    model VARCHAR(50),
    tokens_used INT,
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    update_by BIGINT,
    update_time TIMESTAMP(6),
    INDEX idx_session_id (session_id)
);
CREATE TRIGGER update_ai_session_msg_modtime
    BEFORE UPDATE ON iot_ai_session_message
    FOR EACH ROW EXECUTE FUNCTION update_ai_session_msg_modtime();

2.2.12 表：`ai_operation_log`（AI 操作日志）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
operation_type	VARCHAR(50)	NOT NULL	操作类型：tts / asr / transcribe / session / gpt
family_id	BIGINT		关联家庭ID
device_id	BIGINT		关联设备ID
session_id	BIGINT		关联会话ID
request_payload	JSONB		请求参数JSON
response_payload	JSONB		响应结果JSON
status	VARCHAR(20)	DEFAULT 'success'	状态：success / failed
error_message	TEXT		错误信息
duration_ms	BIGINT		耗时（毫秒）
model	VARCHAR(50)		AI模型
tokens_used	INT		token消耗
create_time	TIMESTAMP(6)	DEFAULT NOW()	操作时间

索引设计：

索引名	字段	类型	说明
idx_family_id	family_id	NORMAL	按家庭查询AI使用记录
idx_device_id	device_id	NORMAL	按设备查询
idx_session_id	session_id	NORMAL	按会话查询
idx_operation_type	operation_type	NORMAL	操作类型筛选
idx_create_time	create_time	NORMAL	时间范围查询

2.2.13 表：`mqtt_fall_event`（雷达跌倒事件）

需求中对应 DEVICE_EVENT（event_type = fall）。

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
serial_number	VARCHAR(100)	NOT NULL	设备序列号
device_id	BIGINT	FK → iot_device	设备ID
family_id	BIGINT	FK → iot_family_archive	家庭ID
elder_id	BIGINT		老人ID
fall_confidence	DECIMAL(5,4)		跌倒置信度（0.0000-1.0000）
heart_rate	INT		当时心率
fall_type	VARCHAR(50)		跌倒类型
presence_data	JSONB		存在感数据
radar_params	JSONB		雷达参数JSON
ai_verdict	VARCHAR(20)		AI判断结果：escalate / dismiss
luma_response	VARCHAR(50)		Luma询问结果：ok / timeout / help
process_status	VARCHAR(20)	DEFAULT 'pending'	处理状态：pending / processed / escalated / dismissed
event_time	TIMESTAMP(6)	NOT NULL	事件发生时间
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_serial_number	serial_number	NORMAL	序列号查询
idx_family_id	family_id	NORMAL	按家庭查询
idx_event_time	event_time	NORMAL	时间范围查询
idx_process_status	process_status	NORMAL	处理状态筛选
idx_device_event	device_id + event_time	NORMAL	设备事件时序查询

DDL：

CREATE TABLE mqtt_fall_event (
    id BIGSERIAL PRIMARY KEY,
    serial_number VARCHAR(100) NOT NULL,
    device_id BIGINT REFERENCES iot_device(id),
    family_id BIGINT REFERENCES iot_family_archive(id),
    elder_id BIGINT,
    fall_confidence DECIMAL(5,4),
    heart_rate INT,
    fall_type VARCHAR(50),
    presence_data JSONB,
    radar_params JSONB,
    ai_verdict VARCHAR(20),
    luma_response VARCHAR(50),
    process_status VARCHAR(20) DEFAULT 'pending',
    event_time TIMESTAMP(6) NOT NULL,
    create_by BIGINT,
    create_time TIMESTAMP(6) DEFAULT NOW(),
    INDEX idx_serial_number (serial_number),
    INDEX idx_family_id (family_id),
    INDEX idx_event_time (event_time DESC),
    INDEX idx_process_status (process_status)
);

2.2.14 表：`mqtt_subscription`（MQTT 订阅管理）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
client_id	VARCHAR(100)	NOT NULL	MQTT客户端ID
topic	VARCHAR(255)	NOT NULL	订阅主题
qos	INT	DEFAULT 0	QoS级别：0/1/2
status	VARCHAR(20)	DEFAULT 'active'	状态：active / disconnected
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_client_id	client_id	NORMAL	客户端查询
idx_topic	topic	NORMAL	主题查询

2.2.15 表：`mqtt_inbound_message`（MQTT 入站消息）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
client_id	VARCHAR(100)	NOT NULL	来源客户端ID
topic	VARCHAR(255)	NOT NULL	消息主题
payload	TEXT		消息内容
qos	INT		QoS级别
message_type	VARCHAR(50)		消息类型
headers	JSONB		消息头JSON
device_id	BIGINT	FK → iot_device	设备ID
received_at	TIMESTAMP(6)	NOT NULL	接收时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_client_id	client_id	NORMAL	客户端查询
idx_topic	topic	NORMAL	主题查询
idx_received_at	received_at	NORMAL	时间范围查询

2.2.16 表：健康数据系列

`iot_heart_rate`（心率）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device	设备ID
elder_id	BIGINT		老人ID
heart_rate	INT	NOT NULL	心率值（bpm）
quality	VARCHAR(20)		数据质量：good / poor
measured_at	TIMESTAMP(6)	NOT NULL	测量时间
create_by	BIGINT		创建者
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

索引设计：

索引名	字段	类型	说明
idx_device_measured	device_id + measured_at	NORMAL	设备时序查询
idx_elder_measured	elder_id + measured_at	NORMAL	老人时序查询

`iot_spo`（血氧）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device	设备ID
elder_id	BIGINT		老人ID
spo2	INT	NOT NULL	血氧值（%）
pi	INT		灌注指数
quality	VARCHAR(20)		数据质量
measured_at	TIMESTAMP(6)	NOT NULL	测量时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

`iot_pedo`（步数）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device	设备ID
elder_id	BIGINT		老人ID
step_count	INT		步数
calorie	INT		卡路里
distance	INT		距离（米）
active_minutes	JSONB		活跃分钟数JSON
measured_date	DATE	NOT NULL	测量日期
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

`iot_sleep_raw`（睡眠原始数据）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device	设备ID
elder_id	BIGINT		老人ID
sleep_start	TIMESTAMP(6)		入睡时间
sleep_end	TIMESTAMP(6)		醒来时间
sleep_duration	INT		睡眠时长（分钟）
sleep_stages	JSONB		睡眠分期JSON
sleep_score	INT		睡眠评分
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

`iot_temperature`（体温）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
device_id	BIGINT	FK → iot_device	设备ID
elder_id	BIGINT		老人ID
temperature	DECIMAL(4,1)	NOT NULL	体温值（℃）
measurement_type	VARCHAR(20)		测量类型：skin / ambient
measured_at	TIMESTAMP(6)	NOT NULL	测量时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

2.3 待建告警相关表（需求定义，未在 SQL 导出中实现）

以下三表已在 business_architecture.md 需求文档中定义，但当前 SQL 导出中尚未创建。列出预期结构供参考实现。

2.3.1 表：`ref_alert`（告警事件 — 待建）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
family_id	BIGINT	FK → iot_family_archive	家庭ID
elder_id	BIGINT		被照护者ID
device_event_id	BIGINT	FK → mqtt_fall_event	触发事件ID
level	VARCHAR(20)	NOT NULL	级别：red / amber / normal
status	VARCHAR(20)	DEFAULT 'firing'	状态：firing / escalating / acknowledged / resolved / false_alarm
evidence_pack	JSONB		证据包（雷达数据+Luma询问结果）
false_alarm_reason	VARCHAR(500)		误报原因
fired_at	TIMESTAMP(6)	NOT NULL	触发时间
acknowledged_at	TIMESTAMP(6)		确认时间
acknowledged_by	BIGINT		确认人用户ID
resolved_at	TIMESTAMP(6)		解决时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间
update_time	TIMESTAMP(6)		更新时间

2.3.2 表：`ref_escalation`（升级链路 — 待建）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
alert_id	BIGINT	FK → ref_alert	告警ID
escalation_level	INT	NOT NULL	升级阶梯（1-4）
caregiver_id	BIGINT	FK → iot_user	通知对象
channel	VARCHAR(20)	NOT NULL	通道：push / sms / voice
status	VARCHAR(20)	DEFAULT 'pending'	状态：pending / sent / delivered / acknowledged / timeout
scheduled_at	TIMESTAMP(6)	NOT NULL	计划通知时间
sent_at	TIMESTAMP(6)		实际发送时间
acked_at	TIMESTAMP(6)		确认时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

2.3.3 表：`ref_notification`（通知记录 — 待建）

字段名	类型	约束	说明
id	BIGSERIAL	PK	主键
alert_id	BIGINT	FK → ref_alert	告警ID
escalation_id	BIGINT	FK → ref_escalation	升级记录ID
caregiver_id	BIGINT	FK → iot_user	接收人
channel	VARCHAR(20)	NOT NULL	通道：push / sms / voice
title	VARCHAR(200)		通知标题
body	TEXT		通知正文
status	VARCHAR(20)	DEFAULT 'sent'	状态：sent / delivered / failed
sent_at	TIMESTAMP(6)		发送时间
delivered_at	TIMESTAMP(6)		送达时间
create_time	TIMESTAMP(6)	DEFAULT NOW()	创建时间

2.4 框架表说明

表前缀	所属框架	说明
`sys_*`	RuoYi-Vue-Plus 系统管理	用户、角色、菜单、部门、字典、OSS、审计日志
`gen_*`	RuoYi 代码生成	代码生成配置表（表信息、字段信息）
`sj_*`	分布式任务调度（saturn）	定时任务、任务执行器、工作流、重试机制

框架表由 RuoYi-Vue-Plus 脚手架自动生成和维护，业务开发通常不直接操作。

第三部分：缓存结构设计（Redis）

基于 technical_architecture.md 5.4 章节定义。

3.1 缓存 Key 总览

Key 模式	类型	内容	TTL	服务	说明
`device:heartbeat:{deviceId}`	String	心跳时间戳	5 min	D1 设备接入	高频写入，Redis 提供毫秒级读写
`family:status:{familyId}`	Hash	家庭当前六状态	30s	D2/D4	六态联动 Family App / Luma App，实时刷新
`session:{token}`	Hash	用户会话信息	2h	通用	Sa-Token + JWT
`alert:escalation:{alertId}`	String	升级链路状态锁	90s	D5 通知告警	Redisson 分布式锁
`iot:device:online:{serialNumber}`	String	设备在线状态	5 min	D1 设备接入	与心跳 key 联动
`iot:family:elder:{familyId}`	Hash	老人实时状态	30s	D4 AI大脑	心率/活动状态
`ai:session:{sessionId}`	Hash	AI会话上下文	1h	D4 AI大脑	GPT-4o 对话上下文缓存
`tts:audio:{hash}`	String	TTS音频缓存	24h	D4 AI大脑	相同内容不重复合成

3.2 缓存策略

设备心跳（device:heartbeat:*）：高频写入 Redis，DB 异步批量落盘，避免频繁 IO
家庭状态（family:status:*）：30s 过期，每次状态变化时主动刷新，支持 Family App / Luma App 实时感知
告警升级锁（alert:escalation:*）：90s 锁，Redisson 分布式锁保证升级链路原子性
AI 会话（ai:session:*）：1h 过期，存储 GPT-4o 对话上下文，减少 token 消耗
会话（session:*）：2h TTL，Sa-Token JWT 会话，续期机制

3.3 分布式锁用途

锁名称	用途	TTL	实现
`lock:device:heartbeat:{id}`	设备心跳并发写入	10s	Redisson
`lock:family:alert:{id}`	告警升级链路原子性	90s	Redisson
`lock:device:command:{id}`	设备指令下发幂等	30s	Redisson
`lock:ai:tts:{content_hash}`	TTS 内容去重合成	1h	Redisson

第四部分：ORM 模型代码

以下为 MyBatis-Plus 实体类，对应 RuoYi-Vue-Plus 框架规范。包名 health.reflekt.domain。

4.1 用户与家庭

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotUser {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long familyId;
    /** 手机号（AES-256加密，MyBatis拦截器自动加解密） */
    private String phone;
    private String nickname;
    private String avatar;
    private String status; // active / inactive
    @TableField(fill = FieldFill.INSERT)
    private Long createDept;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;
import java.util.Map;

@Data
public class IotFamilyArchive {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String familyName;
    private String elderName;
    private Integer elderAge;
    private String elderGender;
    /** 健康档案JSON：疾病史/用药史/作息 */
    private Map<String, Object> healthProfile;
    /** 行为基线标识 */
    private String baselineHash;
    /** 隐私同意状态JSON */
    private Map<String, Object> privacyConsent;
    private String address;
    private String status; // active / pilot / formal
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotFamilyGroupMember {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long familyId;
    private Long userId;
    /** 角色：admin / member */
    private String role;
    /** 紧急联系优先级（1最高） */
    private Integer priority;
    private String nickname;
    private String status;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

4.2 设备

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;
import java.util.Map;

@Data
public class IotDevice {
    @TableId(type = IdType.AUTO)
    private Long id;
    /** 设备序列号 */
    private String serialNumber;
    /** 设备类型：luma / radar / watch */
    private String deviceType;
    private Long familyId;
    private String deviceName;
    private String deviceModel;
    /** 状态：online / offline / pending */
    private String status;
    /** 设备配置JSON */
    private Map<String, Object> config;
    private LocalDateTime lastHeartbeat;
    private String firmwareVersion;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

4.3 消息与提醒

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotFamilyMessage {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long familyId;
    private Long senderId;
    /** 发送者类型：user / elder */
    private String senderType;
    private Long elderId;
    /** 内容类型：voice / text */
    private String contentType;
    private String content;
    /** 语音文件URL（S3） */
    private String voiceUrl;
    /** 语音时长（秒） */
    private Integer duration;
    /** 状态：pending / sent / delivered / played / failed */
    private String status;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    @TableField(update = "%NOW%")
    private LocalDateTime updateTime;
}

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotFamilyReminder {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long familyId;
    private Long elderId;
    private Long creatorId;
    /** 内容类型：text / voice */
    private String contentType;
    private String content;
    private String voiceUrl;
    /** Cron表达式 */
    private String schedule;
    /** 频率：daily / weekly / custom */
    private String frequency;
    private Boolean needConfirm;
    private Boolean shared;
    /** 状态：active / paused / deleted */
    private String status;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

4.4 AI 对话与记忆

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotAiSessionMemory {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long familyId;
    private Long elderId;
    private Long caregiverId;
    private String topic;
    private String elderResponseText;
    /** 老人回答语音URL（S3） */
    private String elderResponseUrl;
    /** 状态：pending / answered / listened / expired */
    private String status;
    private LocalDateTime askedAt;
    private LocalDateTime answeredAt;
    private LocalDateTime listenedAt;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    @TableField(update = "%NOW%")
    private LocalDateTime updateTime;
}

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotAiSessionMessage {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long sessionId;
    /** 角色：user / assistant */
    private String role;
    private String content;
    private String voiceUrl;
    private String model;
    private Integer tokensUsed;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    @TableField(update = "%NOW%")
    private LocalDateTime updateTime;
}

4.5 雷达事件

package health.reflekt.domain.mqtt;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.Map;

@Data
public class MqttFallEvent {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String serialNumber;
    private Long deviceId;
    private Long familyId;
    private Long elderId;
    /** 跌倒置信度（0.0000-1.0000） */
    private BigDecimal fallConfidence;
    private Integer heartRate;
    private String fallType;
    /** 存在感数据JSON */
    private Map<String, Object> presenceData;
    /** 雷达参数JSON */
    private Map<String, Object> radarParams;
    /** AI判断：escalate / dismiss */
    private String aiVerdict;
    /** Luma询问结果：ok / timeout / help */
    private String lumaResponse;
    /** 处理状态：pending / processed / escalated / dismissed */
    private String processStatus;
    private LocalDateTime eventTime;
    @TableField(fill = FieldFill.INSERT)
    private Long createBy;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

4.6 健康数据

package health.reflekt.domain.iot;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
public class IotHeartRate {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long deviceId;
    private Long elderId;
    /** 心率值（bpm） */
    private Integer heartRate;
    private String quality; // good / poor
    private LocalDateTime measuredAt;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

@Data
public class IotSpo {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long deviceId;
    private Long elderId;
    /** 血氧值（%） */
    private Integer spo2;
    private Integer pi;
    private String quality;
    private LocalDateTime measuredAt;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

@Data
public class IotPedo {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long deviceId;
    private Long elderId;
    private Integer stepCount;
    private Integer calorie;
    private Integer distance;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

@Data
public class IotSleepRaw {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long deviceId;
    private Long elderId;
    private LocalDateTime sleepStart;
    private LocalDateTime sleepEnd;
    private Integer sleepDuration;
    /** 睡眠分期JSON */
    private String sleepStages;
    private Integer sleepScore;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

@Data
public class IotTemperature {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Long deviceId;
    private Long elderId;
    /** 体温值（℃） */
    private java.math.BigDecimal temperature;
    /** 测量类型：skin / ambient */
    private String measurementType;
    private LocalDateTime measuredAt;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
}

本文档由 Reflekt Health 技术团队维护，最后更新于 2026-04-22。

第一部分：领域模型（代码层）​

1.1 核心业务域​

1.2 核心领域对象​

1.3 领域对象关系图​

1.4 领域对象状态机​

1.4.1 告警状态机（Alert — 待建）​

1.4.2 设备状态机（Device）​

1.4.3 六状态颜色语言（六态联动 Family App / Luma App 双端）​

1.4.4 AI记忆话题状态机（AI Session Memory）​

1.4.5 家庭通话状态机（Family Call）​

1.4.6 家庭消息状态机（Family Message）​

第二部分：数据字典（数据库层）​

2.1 ER 图​

2.2 核心业务表 DDL​

2.2.1 表：iot_user（IoT 用户/家属账号）​

2.2.2 表：iot_family_archive（家庭档案 / 被照护者）​

2.2.3 表：iot_family_group_member（家庭组成员）​

2.2.4 表：iot_device（设备）​

2.2.5 表：iot_family_device（家庭设备绑定关系）​

2.2.6 表：iot_device_share（设备分享）​

2.2.7 表：iot_family_message（家庭消息）​

2.2.8 表：iot_family_reminder（提醒计划）​

2.2.9 表：iot_family_call（家庭通话记录）​

2.2.10 表：iot_ai_session_memory（AI 记忆话题）​

2.2.11 表：iot_ai_session_message（AI 会话消息）​

2.2.12 表：ai_operation_log（AI 操作日志）​

2.2.13 表：mqtt_fall_event（雷达跌倒事件）​

2.2.14 表：mqtt_subscription（MQTT 订阅管理）​

2.2.15 表：mqtt_inbound_message（MQTT 入站消息）​

2.2.16 表：健康数据系列​

iot_heart_rate（心率）​

iot_spo（血氧）​

iot_pedo（步数）​

iot_sleep_raw（睡眠原始数据）​

iot_temperature（体温）​

2.3 待建告警相关表（需求定义，未在 SQL 导出中实现）​

2.3.1 表：ref_alert（告警事件 — 待建）​

2.3.2 表：ref_escalation（升级链路 — 待建）​

2.3.3 表：ref_notification（通知记录 — 待建）​

2.4 框架表说明​

第三部分：缓存结构设计（Redis）​

3.1 缓存 Key 总览​

3.2 缓存策略​

3.3 分布式锁用途​

第四部分：ORM 模型代码​

4.1 用户与家庭​

4.2 设备​

4.3 消息与提醒​

4.4 AI 对话与记忆​

4.5 雷达事件​

4.6 健康数据​

第一部分：领域模型（代码层）

1.1 核心业务域

1.2 核心领域对象

1.3 领域对象关系图

1.4 领域对象状态机

1.4.1 告警状态机（Alert — 待建）

1.4.2 设备状态机（Device）

1.4.3 六状态颜色语言（六态联动 Family App / Luma App 双端）

1.4.4 AI记忆话题状态机（AI Session Memory）

1.4.5 家庭通话状态机（Family Call）

1.4.6 家庭消息状态机（Family Message）

第二部分：数据字典（数据库层）

2.1 ER 图

2.2 核心业务表 DDL

2.2.1 表：`iot_user`（IoT 用户/家属账号）

2.2.2 表：`iot_family_archive`（家庭档案 / 被照护者）

2.2.3 表：`iot_family_group_member`（家庭组成员）

2.2.4 表：`iot_device`（设备）

2.2.5 表：`iot_family_device`（家庭设备绑定关系）

2.2.6 表：`iot_device_share`（设备分享）

2.2.7 表：`iot_family_message`（家庭消息）

2.2.8 表：`iot_family_reminder`（提醒计划）

2.2.9 表：`iot_family_call`（家庭通话记录）

2.2.10 表：`iot_ai_session_memory`（AI 记忆话题）

2.2.11 表：`iot_ai_session_message`（AI 会话消息）

2.2.12 表：`ai_operation_log`（AI 操作日志）

2.2.13 表：`mqtt_fall_event`（雷达跌倒事件）

2.2.14 表：`mqtt_subscription`（MQTT 订阅管理）

2.2.15 表：`mqtt_inbound_message`（MQTT 入站消息）

2.2.16 表：健康数据系列

`iot_heart_rate`（心率）

`iot_spo`（血氧）

`iot_pedo`（步数）

`iot_sleep_raw`（睡眠原始数据）

`iot_temperature`（体温）

2.3 待建告警相关表（需求定义，未在 SQL 导出中实现）

2.3.1 表：`ref_alert`（告警事件 — 待建）

2.3.2 表：`ref_escalation`（升级链路 — 待建）

2.3.3 表：`ref_notification`（通知记录 — 待建）

2.4 框架表说明

第三部分：缓存结构设计（Redis）

3.1 缓存 Key 总览

3.2 缓存策略

3.3 分布式锁用途

第四部分：ORM 模型代码

4.1 用户与家庭

4.2 设备

4.3 消息与提醒

4.4 AI 对话与记忆

4.5 雷达事件

4.6 健康数据