CURRENT BASELINE
开发总览
11 个关键工作项中，5 项已完成；官方 Flutter 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 网关 | 进行中 | 真实测试 Token 已获 WSS 101 升级；路径和查询日志保持脱敏 | 用官方 SDK 建立长连接并验证重连 | 真实 SDK 长连接、收发消息与断网恢复 |
| 公网客户端 HTTPS API | 进行中 | 独立登录 API 已成功签发测试 Token；管理路由保持不可访问 | 用官方 SDK 调用并记录脱敏成功请求 | API 合同、成功请求与脱敏请求日志 |
| 账号与 Token 映射 | 已完成 | 独立新账号映射 OpenIM 用户，密码仅存 bcrypt 哈希，令牌由私有管理员凭据签发 | 扩展禁用、注销和正式身份策略 | 两套独立测试账号登录成功；错误密码统一 HTTP 401（2026-08-30） |
| 官方 SDK 客户端 | 进行中 | 独立 Flutter 测试工程已接入官方 SDK、受控登录和文本消息操作 | 在两台 Android/iOS 测试设备完成登录与双向收发 | 真机登录、收发消息与连接状态证据 |
| 断线重连与离线消息 | 未开始 | 官方能力存在，尚未实测 | 完成前后台、断网、换网矩阵 | 客户端日志与消息序列 |
| 推送与媒体 | 未开始 | 尚未形成 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 / 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/client-auth.md新账号映射与私有 Token 签发契约
client-test/官方 Flutter SDK 的独立测试客户端
docs/control-api.md节点代理、指标、任务与审计契约
../memo.log按时间记录的开发证据，不存放凭据