CURRENT BASELINE
迁移总览
12 个关键工作项中，2 项已完成；真实客户端数据链路尚未开放。
整体完成度2 / 12
CORE BOUNDARY
核心不乱改，产品层必须开发
先通过官方 API、SDK、回调和扩展服务解决需求；只有明确缺口才评估核心补丁。
官方 OpenIM 核心保持稳定
- 连接、会话与消息同步
- 单聊、群聊与关系管理
- 已读、撤回与离线消息
- 官方 SDK 心跳与重连
- MongoDB、Redis、Kafka、Etcd、MinIO 基础依赖
产品接入层需要开发
- 企业编码、账号体系与 OpenIM Token 映射
- Android、iOS、Windows、HarmonyOS 客户端接入
- 审批、考勤、公告、任务等企业业务
- 推送、媒体策略、风控、审计与运营后台
- 公网边缘、监控、备份、扩容、灰度迁移与回滚
MIGRATION CHECKLIST
迁移清单
| 模块 | 状态 | 当前结论 | 下一步 | 验收证据 |
|---|---|---|---|---|
| OpenIM 单节点底座 | 已完成 | 官方 Server、Chat 与依赖组件运行 | 保持版本化基线 | Compose / healthcheck |
| 原生管理入口 | 已完成 | 管理 UI 与所需 API 已通过 HTTPS | 维持最小暴露面 | 真实管理请求 |
| 节点监控心跳 | 阻塞 | 代理运行，上报被控制面 HTTP 401 拒绝 | 修复认证并验证过期/恢复 | last_seen / 告警记录 |
| 客户端边缘设计 | 进行中 | 管理链路与客户端链路已分界 | 确定 TLS、路由、限流、回滚 | 边缘配置评审 |
| 公网 WSS 网关 | 阻塞 | 消息网关仍为本机映射 | 开放受控 WSS /msg_gateway | 真实 SDK 长连接 |
| 公网客户端 HTTPS API | 未开始 | 当前公网只服务管理链路 | 发布客户端最小 API 路由 | API 合同与请求日志 |
| 账号与 Token 映射 | 未开始 | 产品账号尚未映射 OpenIM 用户 | 定义身份、Token、禁用与注销契约 | 独立测试账号登录 |
| 官方 SDK 客户端 | 未开始 | 尚无真实 OpenIM 客户端会话 | 先接入一个 Flutter 测试客户端 | 登录、收发、会话截图 |
| 断线重连与离线消息 | 未开始 | 官方能力存在，尚未实测 | 完成前后台、断网、换网矩阵 | 客户端日志与消息序列 |
| 推送与媒体 | 未开始 | 尚未形成 OpenIM 端到端契约 | 定义 APNs/厂商推送与媒体存储 | 锁屏推送与媒体回读 |
| 生产多节点 | 未开始 | 当前仅为单节点测试基线 | 拆分有状态依赖并执行压测 | 容量、故障切换、备份恢复 |
| 老用户迁移 | 未开始 | 禁止直接原地切换现有 Java IM 用户 | 设计新用户批次、灰度与回滚 | 迁移演练与回滚报告 |
状态依据：运行事实、真实请求和客户端行为；不根据计划日期自动变更。
URL RELEASE REVIEW
网址发布与人工审核
网址生成后先做技术验证，再由人工打开核对页面、功能、权限和移动端显示；技术验证通过不等于审核完成。
审核规则
新网址默认标记“待人工审核”。只有审核人实际打开并确认后，才可改为“人工已通过”；发现问题则标记“退回修改”。
| 网址/入口 | 用途 | 登录账号 | 密码/凭据 | 发布状态 | 技术验证 | 人工审核 | 审核操作 |
|---|---|---|---|---|---|---|---|
| https://kf.tawfhhkkp.vip/ | OpenIM 迁移进度与开发状态 | 无需登录 | 无需密码 | 已发布 | HTTPS 200 | 待人工审核 | 打开审核 |
| https://openimht.tawfhhkkp.vip/ | OpenIM 原生管理入口 | chatAdmin |
已登记•••••••• |
已发布 | HTTPS 可达 | 待人工复核 | 打开审核 |
| 尚未生成 | 公网客户端 HTTPS API | 待定义 | 尚未登记 | 未发布 | 未验证 | 未进入审核 | 等待发布 |
| 尚未生成 | 公网 WSS /msg_gateway | 客户端 SDK | Token 契约未完成 | 阻塞 | 未验证 | 未进入审核 | 等待开放 |
| 尚未生成 | Android / Windows 测试安装包 | 无需登录下载 | 无需密码 | 未发布 | 未验证 | 未进入审核 | 等待打包 |
| App Store Connect | iOS 商店新版本 | 受限开发者账号 | 已登记•••••••• |
处理中 | 上传成功 | 等待 Apple 处理 | 非公开审核入口 |
人工审核结果需记录审核人、时间、结论和问题。账号可显示；明文密码和验证码只从统一受限凭据库授权取用，不进入公开网页、源码或浏览器存储。
CLIENT MATRIX
客户端接入矩阵
这里记录的是“接入新 OpenIM 核心”的状态，不等同于现有旧核心客户端版本。
AAndroid
未开始Flutter + OpenIM 官方 SDK
先完成测试账号登录与消息闭环iiOS
未开始Flutter + OpenIM 官方 SDK
同步验证 APNs 与生命周期重连WWindows
未开始Flutter Desktop + OpenIM SDK
验证窗口失焦、托盘与多账号状态HHarmonyOS
未开始独立工程，能力适配待定
先确认官方支持边界和桥接方案5H5 / Web
未开始OpenIM Web/WASM SDK
在公网边缘验收后接入ACCEPTANCE EVIDENCE
完成必须留下证据
每一项“已完成”都要能被另一名开发或测试人员独立复核。
- 01配置证据
变更文件、前后 SHA256、语法校验和回滚位置。
- 02连接证据
真实 HTTPS/WSS 请求、SDK 登录和消息会话。
- 03韧性证据
前后台、断网、换网、重连、离线消息恢复。
- 04生产证据
容量、监控、告警、备份恢复、故障切换与回滚演练。
SOURCE OF TRUTH
唯一可信依据
页面是摘要，版本库文档和运行证据才是完整记录。
README.md测试底座范围与公开入口
docs/architecture.md数据面、控制面、边缘与迁移边界
docs/development-guide.md当前状态、交付顺序和验收规则
docs/control-api.md节点代理、指标、任务与审计契约
../memo.log按时间记录的开发证据，不存放凭据