CURRENT BASELINE
开发总览
11 个关键工作项中，5 项已完成；Android 模拟器已完成双账号 SDK 登录、消息同步与受控断网恢复，真机和前后台矩阵尚待验收。
整体完成度5 / 11
CORE BOUNDARY
核心不乱改，产品层必须开发
以顺钉通现有功能作为产品需求参考，先通过官方 API、SDK、回调和扩展服务实现；不迁移旧账号、数据或服务。
官方 OpenIM 核心保持稳定
- 连接、会话与消息同步
- 单聊、群聊与关系管理
- 已读、撤回与离线消息
- 官方 SDK 心跳与重连
- MongoDB、Redis、Kafka、Etcd、MinIO 基础依赖
产品接入层需要开发
- 企业编码、账号体系与 OpenIM Token 映射
- Android、iOS、Windows、HarmonyOS 客户端接入
- 审批、考勤、公告、任务等企业业务
- 推送、媒体策略、风控、审计与运营后台
- 公网边缘、监控、备份、扩容、灰度发布与回滚
DEVELOPMENT CHECKLIST
开发清单
| 模块 | 状态 | 当前结论 | 下一步 | 验收证据 |
|---|---|---|---|---|
| OpenIM 单节点底座 | 已完成 | 官方 Server、Chat 与依赖组件运行 | 保持版本化基线 | Compose / healthcheck |
| 原生管理入口 | 已完成 | 管理 UI 与所需 API 已通过 HTTPS | 维持最小暴露面 | 真实管理请求 |
| 节点监控心跳 | 已完成 | 30 秒上报已接受，节点健康与资源聚合持续写入 | 保持令牌受限管理并定期复测过期/恢复 | last_seen / node_stale 重开与恢复事件（2026-08-30） |
| 客户端边缘设计 | 已完成 | 独立客户端域名的 TLS、路由、限流、无查询日志与回滚已发布 | 按受限配置定期复核与续签 | Nginx 校验、HTTPS/WSS 协议探测（2026-08-30） |
| 公网 WSS 网关 | 进行中 | Android 模拟器官方 SDK 已完成登录、受控全断网重试与网络恢复后的 WSS 重连 | 验证真机长连接、前后台、换网和断线重连 | SDK onConnectFailed / onConnectSuccess 与恢复后发送（2026-08-30） |
| 公网客户端 HTTPS API | 进行中 | 独立登录 API 已成功签发测试 Token；管理路由保持不可访问 | 用官方 SDK 调用并记录脱敏成功请求 | API 合同、成功请求与脱敏请求日志 |
| 账号与 Token 映射 | 已完成 | 独立产品账号使用 bcrypt；原生后台账号经本机 Chat 校验后签发统一 SDK Token | 扩展禁用、注销和正式身份策略 | 产品账号与原生后台新建手机号账号均登录成功（2026-08-30） |
| 官方 SDK 客户端 | 进行中 | Android 模拟器双账号已完成登录、WSS 连接、A 到 B 发送、B 本地未读同步及断网恢复后的发送 | 在真机及 iOS 完成双向收发、前后台和重连 | 模拟器 SDK 日志与本地消息库（2026-08-30）；真机矩阵待补 |
| 断线重连与离线消息 | 进行中 | 模拟器关闭 Wi-Fi 与蜂窝数据后无路由，SDK 重试失败；恢复网络后自动重连成功 | 完成真机前后台、换网与离线消息恢复矩阵 | 网络路由检查、SDK 连接回调与恢复后消息发送（2026-08-30） |
| 推送与媒体 | 未开始 | 尚未形成 OpenIM 端到端契约 | 定义 APNs/厂商推送与媒体存储 | 锁屏推送与媒体回读 |
| 生产多节点 | 未开始 | 当前仅为单节点测试基线 | 拆分有状态依赖并执行压测 | 容量、故障切换、备份恢复 |
状态依据：运行事实、真实请求和客户端行为；不根据计划日期自动变更。
URL RELEASE REVIEW
网址发布与人工审核
网址生成后先做技术验证，再由人工打开核对页面、功能、权限和移动端显示；技术验证通过不等于审核完成。
审核规则
新网址默认标记“待人工审核”。只有审核人实际打开并确认后，才可改为“人工已通过”；发现问题则标记“退回修改”。
| 网址/入口 | 用途 | 登录账号 | 密码/凭据 | 发布状态 | 技术验证 | 人工审核 | 审核操作 |
|---|---|---|---|---|---|---|---|
| https://kf.tawfhhkkp.vip/ | OpenIM 开发进度与接入状态 | 无需登录 | 无需密码 | 已发布 | HTTPS 200 | 待人工审核 | 打开审核 |
| https://openimht.tawfhhkkp.vip/ | OpenIM 原生管理入口 | chatAdmin |
已登记•••••••• |
已发布 | HTTPS 可达 | 待人工复核 | 打开审核 |
| https://openim-client.tawfhhkkp.vip/ | OpenIM 客户端 HTTPS API 与 WSS /msg_gateway | 受限测试账号 | 受限凭据库 | 入口已发布 | 登录 Token 与 WSS 已验证 | 待 SDK 与人工复核 | 打开审核 |
| Android arm64-v8a APK v1.0.4+5 | OpenIM Android SDK 测试安装包（64 位设备） | 无需登录下载 | 无需密码 | 已发布 | APK v2 签名、模拟器 SDK 闭环与断网重连已验证 | 待两台真机复核 | 下载测试 |
| App Store Connect | iOS 商店新版本 | 受限开发者账号 | 已登记•••••••• |
处理中 | 上传成功 | 等待 Apple 处理 | 非公开审核入口 |
人工审核结果需记录审核人、时间、结论和问题。账号可显示；明文密码和验证码只从统一受限凭据库授权取用，不进入公开网页、源码或浏览器存储。
CLIENT MATRIX
客户端接入矩阵
这里记录的是新 OpenIM 的客户端开发接入状态；顺钉通功能仅作为需求参考，不迁移现有客户端或用户。
AAndroid
进行中Flutter + OpenIM 官方 SDK
arm64-v8a APK v1.0.4+5 已发布；模拟器双账号登录、消息同步、断网恢复与恢复后发送已通过，真机前后台矩阵待补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/client-auth.md产品账号映射、原生后台账号回退与私有 Token 签发契约
client-test/官方 Flutter SDK 的独立测试客户端
docs/control-api.md节点代理、指标、任务与审计契约
../memo.log按时间记录的开发证据，不存放凭据