CURRENT BASELINE
开发总览
11 个关键工作项中,9 项开发自动验收已完成;Android 模拟器已完成双账号 SDK 登录、API 同步、本地历史、断网恢复与前后台恢复,真机验收独立记录。
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 | 已完成 | 官方 SDK 已通过独立登录 API 获取 Token,并完成用户、关系、群组与会话 HTTPS 同步;管理路由保持不可访问 | 定期复测认证边界和限流 | SDK 登录、HTTPS 同步与脱敏边缘日志(2026-08-30) |
| 账号与 Token 映射 | 已完成 | 独立产品账号使用 bcrypt;原生后台账号经本机 Chat 校验后签发统一 SDK Token | 扩展禁用、注销和正式身份策略 | 产品账号与原生后台新建手机号账号均登录成功(2026-08-30) |
| 官方 SDK 客户端 | 已完成 | Android 模拟器双账号已完成登录、WSS 连接、A 到 B 发送、本地历史加载、断网恢复与前后台恢复后发送 | 转入发布人工审核;iOS 客户端在接入矩阵中独立跟踪 | 模拟器 SDK 日志、本地历史视图与前后台恢复后发送(2026-08-30) |
| 断线重连与离线消息 | 已完成 | 模拟器全断网后 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 | 受限测试账号 | 受限凭据库 | 入口已发布 | SDK 登录、HTTPS API 与 WSS 已验证 | 待 SDK 与人工复核 | 打开审核 |
| Android arm64-v8a APK v1.0.6+7 | OpenIM Android SDK 测试安装包(64 位设备) | 无需登录下载 | 无需密码 | 已发布 | APK v2 签名、SDK 历史加载、断网和前后台恢复已验证 | 待两台真机复核 | 下载测试 |
| App Store Connect | iOS 商店新版本 | 受限开发者账号 | 已登记•••••••• |
处理中 | 上传成功 | 等待 Apple 处理 | 非公开审核入口 |
人工审核结果需记录审核人、时间、结论和问题。账号可显示;明文密码和验证码只从统一受限凭据库授权取用,不进入公开网页、源码或浏览器存储。
CLIENT MATRIX
客户端接入矩阵
这里记录的是新 OpenIM 的客户端开发接入状态;顺钉通功能仅作为需求参考,不迁移现有客户端或用户。
Flutter + OpenIM 官方 SDK
arm64-v8a APK v1.0.6+7 已发布;自动验收已通过,等待真机安装、换网和前后台人工验收Flutter + OpenIM 官方 SDK
同步验证 APNs 与生命周期重连Flutter Desktop + OpenIM SDK
验证窗口失焦、托盘与多账号状态独立工程,能力适配待定
先确认官方支持边界和桥接方案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按时间记录的开发证据,不存放凭据