sequenceDiagram
    autonumber
    participant U as 用户
    participant App
    participant DB as LocalDB
    participant OS
    participant S as Server
    participant C as CloudDB

    U->>App: 填表 / 语音创建
    App->>App: 生成 UUID(sch_9f2a)

    rect rgb(255, 248, 240)
        Note over App,DB: 【磁盘】本地先落地 —— 一个事务写两张表
        App->>DB: INSERT schedules(18 列, version=1)
        App->>DB: INSERT sync_outbox(op_3c81, create)
        Note over DB: 「待同步」= outbox 里有它的 entity_id<br/>不另存 sync_status 列
    end
    App-->>U: 创建成功(不等服务端)

    alt 在线
        App->>S: POST /sync/push [op_3c81]
        S->>C: 【磁盘】INSERT sync_operations(op_3c81) 幂等
        S->>C: 【磁盘】INSERT schedules version=1
        S->>S: 算权威计划 T<br/>TimeWindowTrigger / evaluate_geofence
        S-->>App: applied + plan(T)
        App->>OS: 【原生】register(alarmId=sch_9f2a, T+N)
        Note over OS: SharedPreferences 存 (sch_9f2a, T+N)<br/>= 唯一的计划记录,SQLite 不再存一份
        App->>DB: 【磁盘】DELETE sync_outbox WHERE op_3c81
    else 离线
        rect rgb(255, 250, 235)
            Note over App,OS: 降级兜底 —— 服务端够不着时的临时方案
            App->>App: 时间:start_time - offset<br/>围栏:用日程字段,armed 默认 true
            App->>OS: 【原生】register(alarmId=sch_9f2a, 降级时刻)
        end
        Note over App,DB: 【磁盘】outbox 行保持不动,等联网(见 2.3)
    end

sequenceDiagram
    autonumber
    participant S as Server
    participant C as CloudDB
    participant OS as OS + 原生存储
    participant App
    participant Mem as App 内存
    participant DB as LocalDB
    participant U as 用户

    Note over S,OS: 服务端计划 T,本地兜底闹钟注册在 T+N

    alt 在线 —— 服务端通道生效
        Note over S: T 时刻
        S->>App: reminder.control + TTS 音频
        S->>S: 【内存】_pending[sch_9f2a] = 已发,等 ack
        App->>Mem: 【内存】claim(sch_9f2a)
        Note over Mem: Map 里没有 → 写入,返回 true
        App->>U: 展示提醒 + 播放服务端音频
        App->>S: ack (ok=true)
        S->>C: 【磁盘】UPDATE time_triggered_at = now<br/>WHERE time_triggered_at IS NULL
        S->>S: 【内存】_pending.delete(sch_9f2a)
        Note over App,DB: 在线路径**不写 outbox** —— ack 就是上报

        Note over OS,Mem: T+N 时刻 —— 必定同一进程(见要点)
        OS->>App: 本地兜底闹钟响
        App->>Mem: 【内存】claim(sch_9f2a)
        Note over Mem: 已存在 → 返回 false<br/>静默丢弃,用户无感知

    else 离线 / 推送未达 —— 本地兜底生效
        Note over S: T 时刻:推送发不出去<br/>或发出但客户端没收到
        Note over S: 【内存】_pending 里没有这条
        Note over OS: T+N 时刻
        OS->>App: 本地兜底闹钟响
        App->>Mem: 【内存】claim(sch_9f2a)
        Note over Mem: 没有 → 写入,返回 true
        App->>U: 展示提醒 + 本地 TTS
        rect rgb(255, 235, 235)
            App->>DB: 【磁盘】INSERT sync_outbox(delivered,<br/>{sch_9f2a, shown_at, 'local'})
            Note over DB: 必须落磁盘!只放内存的话<br/>App 被杀 → 联网后服务端补推 → 重复提醒
        end
        Note over App,S: 联网后按 outbox 顺序补报(见 2.3)
    end

    rect rgb(255, 235, 235)
        Note over App,Mem: 服务端 ack 超时重发时:claim 返回 false<br/>→ 丢弃展示,但仍必须回 ack
    end

sequenceDiagram
    autonumber
    participant App
    participant Mem as App 内存
    participant DB as LocalDB
    participant OS as OS + 原生存储
    participant S as Server
    participant C as CloudDB

    rect rgb(240, 255, 240)
        Note over App,C: 第一步 —— 按 outbox 顺序推,create 天然排在 delivered 前面
        App->>DB: 【磁盘】SELECT * FROM sync_outbox ORDER BY created_at
        App->>S: ① POST /sync/push [create / update / delete]
        Note over App,S: 同一 entity_id 的操作严格保序
        S->>C: 【磁盘】INSERT sync_operations(幂等)
        S->>C: 【磁盘】落库 schedules
        S->>S: 算权威计划
        S-->>App: 逐条结果 + plan(支持部分成功)
        App->>DB: 【磁盘】DELETE 已成功的 outbox 行

        App->>OS: 【原生】cancel(sch_9f2a)
        App->>OS: 【原生】register(sch_9f2a, 权威 T+N)
        Note over OS: 无条件覆盖,不判断原来是不是降级计划<br/>→ 所以不需要 plan_source
    end

    rect rgb(235, 250, 255)
        Note over App,C: 第二步 —— 同一队列里的 delivered 行(顺序自动满足)
        App->>S: ② POST /sync/push [delivered]
        S->>C: 【磁盘】UPDATE time_triggered_at = shown_at<br/>WHERE time_triggered_at IS NULL
        App->>DB: 【磁盘】DELETE 该 outbox 行
    end

    rect rgb(255, 240, 245)
        Note over S,App: 第三步 —— 对账补发
        S->>C: 【磁盘】查:应触发但 *_triggered_at 仍为 NULL 的日程
        alt 有遗漏且在时效内(5~10 分钟)
            S->>App: 补推 reminder.control
            App->>Mem: 【内存】claim(schedule_id)
            Note over Mem: 若这次会话里已展示过 → false → 只回 ack
            App->>S: ack
            S->>C: 【磁盘】写 time_triggered_at
        else 已送达 或 已超时
            Note over S: 不补推<br/>超时的标记 expired 并记日志
        end
    end

    App->>S: GET /sync/pull
    S-->>App: 全量日程 + 最新计划
    App->>DB: 【磁盘】覆盖本地 schedules
    App->>OS: 【原生】按最新计划重新注册

sequenceDiagram
    autonumber
    participant U as 用户
    participant App
    participant Mem as App 内存
    participant DB as LocalDB
    participant OS as OS + 原生存储
    participant S as Server
    participant C as CloudDB

    alt 修改
        U->>App: 把会议 15:00 改到 16:00
        App->>DB: 【磁盘】事务:UPDATE schedules(version+1)<br/>+ INSERT sync_outbox(update, baseVersion=1)
        App-->>U: 修改成功
        App->>S: POST /sync/push

        alt 版本匹配
            S->>C: 【磁盘】UPDATE schedules version=2
            rect rgb(255, 235, 235)
                S->>C: 【磁盘】触发条件变了?<br/>→ 重置 time_triggered_at / geo_triggered_at = NULL
                Note over S,C: 判定依据:start_time / offset /<br/>经纬度 / 半径 任一改变<br/>只改标题备注则不重置
            end
            S->>S: 重算权威计划
            S-->>App: applied v2 + 新计划
            App->>DB: 【磁盘】DELETE 该 outbox 行
            App->>OS: 【原生】cancel(sch_9f2a)
            App->>OS: 【原生】register(sch_9f2a, 新 T+N)
            rect rgb(255, 235, 235)
                App->>Mem: 【内存】shown.delete(sch_9f2a)
                Note over Mem: 漏了这步:改期后新提醒会被<br/>旧的展示记录挡掉,静默不响
            end
        else 版本冲突
            S-->>App: conflict + 服务端数据
            App->>DB: 【磁盘】以服务端为准覆盖 + DELETE outbox 行
            App->>OS: 【原生】按服务端计划重新注册
            App->>Mem: 【内存】shown.delete(sch_9f2a)
        end
    else 删除
        U->>App: 删除日程
        App->>DB: 【磁盘】事务:status='deleted'<br/>+ INSERT sync_outbox(delete)
        App->>OS: 【原生】cancel(sch_9f2a) + 注销围栏
        App->>Mem: 【内存】shown.delete(sch_9f2a)
        App->>S: POST /sync/push
        S->>C: 【磁盘】status='deleted'(软删除墓碑,不物理删)
        S->>S: 清理 TTS 音频文件
    end