OpenIM 开发与接入
全流程进度中心

官方 OpenIM 核心保持稳定,产品层围绕账号、客户端、业务能力和生产运维完成接入。 本页只记录可复核的进度,不把“容器运行”当作“客户端可用”。

开发总览

12 个关键工作项中,10 项开发自动验收已完成;直连厂商推送的设备登记、加密存储与华为、荣耀、米系、vivo、鸿蒙接入骨架正在本地开发。组织成员能力和客户端举报提交均已接入真实后台开关;Windows PC 端也可按用户停止新登录。特殊/官方账号标识与邀请码签发已完成本地权限、审计和回归,邀请码尚未接入注册兑换。所有新增能力均未迁移或部署。

整体完成度10 / 12
已完成10底座、边缘、账号、API、WSS、SDK、韧性与媒体自动验收
进行中1直连厂商离线推送基础
未开始1生产多节点能力
阻塞0当前无已确认阻塞项

核心不乱改,产品层必须开发

以顺钉通现有功能作为产品需求参考,先通过官方 API、SDK、回调和扩展服务实现;不迁移旧账号、数据或服务。

官方 OpenIM 核心保持稳定

  • 连接、会话与消息同步
  • 单聊、群聊与关系管理
  • 已读、撤回与离线消息
  • 官方 SDK 心跳与重连
  • MongoDB、Redis、Kafka、Etcd、MinIO 基础依赖

产品接入层需要开发

  • 企业编码、账号体系与 OpenIM Token 映射
  • Android、iOS、Windows、HarmonyOS 客户端接入
  • 审批、考勤、公告、任务等企业业务
  • 推送、媒体策略、风控、审计与运营后台
  • 公网边缘、监控、备份、扩容、灰度发布与回滚

开发清单

模块状态当前结论下一步验收证据
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、iOS 模拟器、Safari Web/WASM 与 Electron 兼容性环境均已完成 SDK 登录和 WSS 连接转入发布人工审核;iOS APNs、真机网络矩阵和真实 Windows 桌面在接入矩阵中独立跟踪Android/iPhone 17 Pro 模拟器、Safari 与 Electron SDK 受控登录证据(2026-08-30)
断线重连与离线消息已完成模拟器全断网后 SDK 产生重试失败;恢复网络自动重连,前后台返回后仍可发送转入发布人工审核的真机换网与离线消息恢复矩阵网络路由检查、SDK 连接回调和前后台恢复后发送(2026-08-30)
媒体上传与消息已完成图片和文件经官方 SDK 本地路径消息发送;类型和大小受限,签名对象路径仅在独立客户端域名开放转入真机媒体选择、上传进度和回读人工审核iPhone 模拟器受控图片发送与 MinIO 对象计数(2026-08-31)
直连厂商离线推送进行中本地已实现用户同意后的加密设备登记;direct_push_registration 关闭后 Flutter/HarmonyOS 停止展示登记入口,认证服务拒绝绕过客户端的新登记;华为、荣耀、小米、vivo 与鸿蒙接入骨架均不依赖聚合推送执行受控迁移与边缘发布,登记各应用独立凭据,部署发送与反馈服务;OPPO 先确认不含 APK 密钥的官方注册方案本地 Go/Flutter 回归;待迁移、部署及各厂商真机锁屏送达、点击、令牌刷新与失败回执
生产多节点未开始当前仅为单节点测试基线拆分有状态依赖并执行压测容量、故障切换、备份恢复

状态依据:运行事实、真实请求和客户端行为;不根据计划日期自动变更。

后台功能开发台账

顺钉通后台仅用于功能类别参考;所有实现使用独立 OpenIM 数据模型、权限和审计,不迁移旧代码、数据、账号或凭据。

功能模块状态当前实现下一步验收边界
后台账号、角色、菜单与审计已完成独立操作员、角色权限、菜单可见性、登录记录、IP 黑名单和不可变审计随新增业务模块补充最小权限控制 API 权限测试与审计记录
OpenIM 用户、关系、群组与消息运营已完成用户目录、关系、群组治理、受限消息检索和回执均经官方 API按上线授权复核数据面回调官方 API 受控请求与权限审计
内容、客户端配置与投诉审核已完成公告、发现页、宵禁、版本策略和人工投诉审核独立存储为每项配置接入正式客户端消费者控制台回归;客户端生效另行验收
企业组织、部门与成员目录进行中本地已实现组织编码、无环部门树、成员映射、RBAC、审计和管理界面;不改写 OpenIM 账号执行受控迁移并部署后,补充客户端消费与用户资格核验本地 Go/静态界面回归;尚未迁移、部署或进行真实管理请求
组织定向公告与员工策略进行中本地已实现企业、部门或成员范围的公告草稿、发布时在职成员快照、撤回、权限审计;独立测试客户端可按快照拉取并写幂等已读回执执行迁移与部署后,接入正式客户端、送达/推送、员工策略与真实验收本地 Go/Flutter 回归;尚未迁移、部署、真实边缘请求或真机验证
审批、考勤与任务进行中本地已实现审批、任务和人工考勤的数据模型、状态约束、RBAC、审计和管理界面;成员端开关关闭后隐藏入口、不签发用途令牌并拒绝读写绕过请求执行迁移与部署;补提醒、通知、排班、打卡、补卡、隐私与真实流程本地 Go/Flutter/静态界面回归;尚未迁移、部署、真实边缘请求或真实管理请求
厂商离线推送发送与反馈进行中仅有用户同意后的设备登记和厂商接入骨架,不含发送凭据或发送服务配置各应用独立凭据并实现发送、失败回执和重试策略各厂商真机锁屏送达、点击路由和令牌刷新
订单、社区与内容业务未开始未迁移旧系统功能;支付、钱包和红包已明确排除本轮范围,不使用占位表单伪装为已实现按非支付领域分别确定数据模型、合规、风控和审核边界独立数据模型、权限、审计和真实业务验收

本表以代码、迁移、部署和真实请求证据更新。仅本地实现不标记为“已完成部署”。

逐项功能对照清单

参考类别独立 OpenIM 功能状态当前范围下一步与验收
系统与权限后台操作员已完成独立操作员创建、更新、重置和受限登录随业务域新增最小权限
系统与权限角色与操作权限已完成服务端权限目录和受保护内置管理员角色新增业务接口必须补权限测试
系统与权限菜单与导航已完成数据库菜单排序和角色可见性,不绕过服务端权限新模块登记菜单和权限
系统与权限参数、字典与入口台账已完成受限系统参数、任务字典和非敏感入口记录配置变更按审计和消费者验证
系统与权限登录记录、IP 黑名单与操作审计已完成后台登录事件、IP 拦截和不可变审计导出按保留策略复核
IM 运营用户目录与资料管理已完成官方 OpenIM 用户查询、新建与受限公开资料更新上线前复核数据面授权
IM 运营登录、会话与活跃统计已完成注册、活跃、终端会话和强制下线的受限运营视图部署回调后取得真实事件证据
IM 运营好友、黑名单、申请与默认好友已完成官方关系接口、申请审核和受限默认好友规则补外部注册路径的触发契约
IM 运营私聊与群聊消息治理已完成有范围约束的消息检索和逻辑撤回,不提供物理删除按权限审计复核
IM 运营群组、成员与入群申请已完成建群、成员、群策略、转让、解散和申请审核均走官方 API补线上回调与真实运营验收
IM 运营系统通知账号与平台公告已完成官方系统通知账号和独立平台级公告正式客户端接入公告消费者
IM 运营IM 举报案件审核与处置已完成运营端可维护人工案件、状态、处理说明、权限和审计;客户端提交案件与申诉均在本地独立列表审核处置通知、消息证据核验和正式客户端消费者另列开发
IM 举报用户举报提交进行中本地用途令牌和独立 Flutter 测试表单可提交被举报用户标识、原因和有限说明;成员只能拉取本人案件,后台关闭后入口隐藏且服务端拒绝读写迁移、发布、正式客户端入口、限频反馈和案件展示
IM 举报群组与成员举报提交进行中本地测试表单可提交群组或成员标识与群组上下文快照;本人案件列表不验证成员资格历史迁移、发布、正式客户端入口、成员资格核验和案件展示
IM 举报私聊与群聊消息举报提交进行中本地测试表单可提交发送者、会话或群组与消息引用;本人案件列表不接收正文、附件或设备标识迁移、发布、正式客户端入口、消息证据核验和案件展示
IM 举报举报证据、处置通知与复审进行中本地原举报人可查看本人案件,并对已处理或已驳回案件提交一条申诉;管理端独立复审且不自动改写原案件迁移、发布、留存期限、消息证据访问控制和处置通知
用户账户与安全产品账号登录密码重置未开始不复用旧后台密码或重置接口;OpenIM Token 不是产品密码独立身份验证、短时重置令牌、审计和通知
用户账户与安全支付密码重置本轮排除没有钱包或支付密码体系;支付相关能力不在本轮开发范围仅在另行授权账本、强验证、合规和双人审核后重新评估
用户账户与安全邀请码启用与修改进行中本地可签发 192 位随机邀请码、设置失效时间、启停并审计;仅保存摘要且原文只在创建响应显示一次先完成独立注册、身份核验、账号原子创建和限频后,才接入兑换与正式客户端
用户账户与安全特殊账号与官方账号标识进行中本地可按 OpenIM 用户设置官方或特殊展示标识,登录仅返回本人标识;不改 OpenIM 资料且不宣称身份已核验迁移、部署、正式客户端展示范围与标识审批/撤销真实验收
用户账户与安全会议权限未开始没有会议服务、参会角色或用户级会议开关先确定独立会议产品和授权模型
用户账户与安全用户级建群开关未开始现有群组治理不含每个用户的建群资格控制定义资格、变更审计和客户端拦截契约
用户账户与安全用户级建群额度未开始没有个人建群数量配额或额度规则定义统计口径、额度调整和并发校验
用户账户与安全我创建的群组列表未开始现有用户群组视图不作为“创建群组”运营清单增加群主精确查询与权限边界
用户账户与安全PC 端用户级功能开关进行中本地可按 OpenIM 用户启停 Windows 平台 3 的新 SDK 登录;管理端权限与审计齐全,认证服务在签发任何令牌前强制拒绝禁用状态,Electron 显示明确拒绝原因迁移、部署并以真实边缘登录复核;已有 SDK 会话仍须通过强制下线处理
用户账户与安全昵称设置已完成官方 OpenIM 用户公开资料更新可受限修改昵称保持权限和审计复核
用户账户与安全新设备登录保护与设备管理未开始已有终端会话历史,不含审批新设备或设备信任清单定义设备指纹、确认、撤销和隐私边界
用户账户与安全指定用户登录 IP进行中本地可按 OpenIM 用户配置 IPv4/IPv6 主机或 CIDR;认证服务在签发任何客户端令牌前强制核对可信边缘源 IP迁移、部署并用真实边缘请求复核转发信任链、允许/拒绝、回退和审计
用户账户与安全好友列表已完成可经官方 OpenIM API 查询好友和黑名单保持受限查询和审计
用户账户与安全会话风险提示未开始没有用户级聊天时长、异常行为或风险提示策略先定义触发条件、隐私边界和通知方式
用户账户与安全聊天、在线时长与活跃统计已完成有界注册、消息活跃和终端会话统计,不伪装为完整登录历史部署回调后取得真实数据证据
用户账户与安全用户余额调整本轮排除没有资金账户、余额字段或管理员调账入口;支付相关能力不在本轮开发范围仅在另行授权账本、对账、审批和不可变流水后重新评估
前端功能与登录策略直连厂商推送登记开关进行中本地 direct_push_registration 已接入后台审计、Flutter 每 60 秒/前台恢复同步、HarmonyOS 页面加载同步和认证服务 403 强制校验执行迁移、边缘发布和新客户端构建;关闭后核验前端隐藏、既有登记撤销和绕过请求被拒绝
前端功能与登录策略客户端举报提交开关进行中本地 client_report_submission 已接入后台审计、Flutter 策略刷新、登录用途令牌以及本人列表/举报/申诉服务端 403 强制校验执行迁移、边缘发布和新客户端构建;关闭后核验入口隐藏、令牌缺失和列表/提交/申诉绕过请求被拒绝
前端功能与登录策略组织公告、任务、审批与考勤确认开关进行中本地 organization_announcement_inboxorganization_task_inboxorganization_approval_inboxorganization_attendance_acknowledgement 均已接入后台审计、Flutter 刷新同步、登录用途令牌和服务端 403 强制校验执行迁移、边缘发布和新客户端构建;关闭后核验前端隐藏、令牌缺失和读写绕过请求被拒绝
前端功能与登录策略其他客户端全局功能开关未开始红包、会议、企业日程、退群和建群等尚无客户端消费者或服务端强制校验每项分别接入后台策略、客户端同步、服务端校验、审计与回滚后才可启用
前端功能与登录策略全局宵禁与客户端提示已完成独立宵禁策略和有界客户端配置读取已具备正式客户端消费者和实际拦截行为另行验收
前端功能与登录策略Android 手机实名认证策略未开始没有独立手机号、短信、姓名或身份证核验服务,也没有 Android 专属策略先确定身份服务、最小数据留存、注册拦截、异常处理和审计
前端功能与登录策略实名资料审核与实名状态未开始用户目录不保存实名材料,也没有人工审核队列定义资料加密、访问权限、审核、拒绝、注销和留存期限
前端功能与登录策略Apple ID 登录与绑定开关未开始没有独立 iOS Apple 登录、账号绑定或服务端令牌校验建立 Apple 身份校验、账号绑定、撤销和客户端开关契约
前端功能与登录策略第三方/品牌账号授权与手机号绑定策略未开始没有复用旧品牌账号授权或跳过手机绑定规则逐一确定提供方、回调、绑定冲突、隐私告知和审计
前端功能与登录策略注册入口与认证方式开关未开始现有账号与 Token 映射不等于可运营的注册方式策略定义账号、手机、邮箱和第三方注册的开关、依赖关系和服务端强制校验
配置与运维发现页与版本策略已完成独立配置、审核和有界公开读取接口逐项接入正式客户端消费者
配置与运维节点、线路、告警、任务与路由发布已完成节点心跳、健康历史、受限诊断、路由快照和回滚生产拓扑和容量验收
推送厂商设备登记进行中同意后加密登记华为、荣耀、小米、vivo、鸿蒙等设备各应用独立凭据、真机送达和反馈回执
推送厂商发送、失败反馈与重试未开始不含厂商发送服务、凭据或重试队列按厂商分别实现并做锁屏真机验收
企业管理企业、部门与成员目录进行中本地组织编码、无环部门树、成员映射、RBAC 和审计迁移、部署、用户资格核验和客户端消费
企业管理组织定向公告与员工策略进行中本地公告可按全企业、部门或成员建草稿;发布时仅快照在职映射成员,成员端可拉取和写已读回执,后台关闭时入口隐藏且服务端拒绝读写迁移、部署、正式客户端展示、送达/推送、员工策略与真实验收
企业管理审批工作流进行中本地模板草稿/启停、在职成员顺序审批链、提交快照、RBAC、审计和后台代录界面;独立测试客户端只可提交审批链不含本人的申请、查看本人/当前步骤记录、撤回本人待处理申请并处理他人当前分配步骤迁移、部署、正式客户端、提醒、通知和真实流程验收
企业管理考勤进行中本地可按在职成员和工作日人工登记正常出勤、迟到、缺勤或请假;成员客户端只可拉取本人记录并确认已查看,后台更正后须重新确认,不伪装为员工打卡迁移、部署、班次与时区、端侧打卡、补卡审批、隐私留存和真实考勤验收
企业管理任务与待办进行中本地任务可分配给在职成员;独立测试客户端只拉取本人任务,且仅可待处理→进行中→完成。操作员与客户端事件分开记录,取消仍仅后台可执行迁移、部署、正式客户端、提醒、通知和真实流程验收
身份与授权企业身份与员工资格核验未开始组织成员映射不等于员工身份核验或企业资格校验先完成独立身份来源、隐私、合规和审核设计
增长与积分签到、积分与奖励任务未开始没有积分账户、规则或奖励发放实现先定义不可篡改积分流水和风控
钱包与红包钱包、充值、提现与红包本轮排除用户已明确不开发支付相关功能;没有资金账本、支付渠道或管理员调账入口仅在另行授权独立账本、对账、合规、风控和双人审核后重新评估
招聘与订单企业、职位、简历与招聘订单未开始未迁移顺钉通招聘业务或订单数据按领域建立独立数据模型和权限
招聘与订单发票、报销与案例管理未开始没有票据、报销、案例或附件审批流程先定义留存、审批和访问控制
内容社区圈子、城市、文章与内容审核未开始没有社区关系、发布、审核或地域运营模型独立内容、审核和风控契约
内容社区相册与图片审核未开始只有 OpenIM 媒体消息,不含相册业务独立媒体归属、访问、审核和删除策略
内容社区圈子、文章与相册内容举报未开始没有社区内容对象、举报提交、证据快照或审核队列在内容域建立举报、审核、处置、申诉和审计闭环
通知服务邮件通道、模板与投递记录未开始没有独立邮件发送、模板或投递反馈服务单独登记发送凭据、退信与审计策略
生产能力多节点、容量、备份与故障切换未开始当前仍是单节点测试基线有状态拆分、压测、恢复和回滚演练

“已完成”仅表示独立控制面已有实现和相应自动验证;业务域仍需各自的数据模型、消费者、部署和真实验收,不能从顺钉通复制或迁移。

网址发布与人工审核

网址生成后先做技术验证,再由人工打开核对页面、功能、权限和移动端显示;技术验证通过不等于审核完成。

审核规则 新网址默认标记“待人工审核”。只有审核人实际打开并确认后,才可改为“人工已通过”;发现问题则标记“退回修改”。
网址/入口用途登录账号密码/凭据发布状态技术验证人工审核审核操作
https://kf.tawfhhkkp.vip/ OpenIM 开发进度与接入状态 无需密码 已发布 HTTPS 200 待人工审核 打开审核
https://openimht.tawfhhkkp.vip/ OpenIM 原生管理入口 已登记•••••••• 已发布 HTTPS 可达 待人工复核 打开审核
https://openim-client.tawfhhkkp.vip/ OpenIM 客户端 HTTPS API 与 WSS /msg_gateway 受限凭据库 入口已发布 SDK 登录、HTTPS API 与 WSS 已验证 待 SDK 与人工复核 打开审核
OpenIM Web/WASM SDK 测试 官方 WASM SDK 浏览器测试客户端 受限凭据库 已发布 Safari SDK 登录、HTTPS 同步与 WSS 已验证 待浏览器人工复核 打开审核
Android arm64-v8a APK v1.0.7+8 OpenIM Android SDK 测试安装包(64 位设备) 无需密码 已发布 APK v2 签名、SDK 媒体路径、历史加载、断网和前后台恢复已验证 待两台真机复核 下载测试
App Store Connect iOS 商店新版本 已登记•••••••• 处理中 上传成功 等待 Apple 处理 非公开审核入口

人工审核结果需记录审核人、时间、结论和问题。账号可显示;明文密码和验证码只从统一受限凭据库授权取用,不进入公开网页、源码或浏览器存储。

客户端接入矩阵

这里记录的是新 OpenIM 的客户端开发接入状态;顺钉通功能仅作为需求参考,不迁移现有客户端或用户。

AAndroid
待人工验收

Flutter + OpenIM 官方 SDK

arm64-v8a APK v1.0.7+8 已发布;媒体、历史、断网和前后台自动验证已通过,等待真机安装、换网和媒体回读审核
iiOS
待人工验收

Flutter + OpenIM 官方 SDK

iPhone 17 Pro 模拟器已完成构建、SDK 登录和受控媒体发送基线;待真机 APNs、生命周期、网络切换和媒体选择复核
WWindows
待人工验收

Electron + OpenIM 官方 SDK

Windows x64 NSIS 包已构建;实际安装包在隔离 Wine 中完成 SDK 登录和 WSS,待真实 Windows 桌面复核
HHarmonyOS
进行中

独立 Stage + Push Kit

本地登记样例已建立;待独立包名、签名、Push Kit 凭据与真机构建验证
5H5 / Web
待人工验收

OpenIM Web/WASM 官方 SDK

Safari 已完成受控登录、WASM 初始化、HTTPS 同步与 WSS;待浏览器人工复核

完成必须留下证据

每一项“已完成”都要能被另一名开发或测试人员独立复核。

  1. 01
    配置证据

    变更文件、前后 SHA256、语法校验和回滚位置。

  2. 02
    连接证据

    真实 HTTPS/WSS 请求、SDK 登录和消息会话。

  3. 03
    韧性证据

    前后台、断网、换网、重连、离线消息恢复。

  4. 04
    生产证据

    容量、监控、告警、备份恢复、故障切换与回滚演练。

唯一可信依据

页面是摘要,版本库文档和运行证据才是完整记录。

README.md

测试底座范围与公开入口

docs/architecture.md

数据面、控制面、边缘与开发边界

docs/development-guide.md

当前状态、交付顺序和验收规则

docs/client-auth.md

产品账号映射、原生后台账号回退与私有 Token 签发契约

docs/push-media.md

媒体对象路径、文件策略与独立离线推送边界

docs/reference-parity.md

顺钉通后台功能参考与独立实现差距

control-api/internal/store/organizations.go

企业组织、部门与成员目录的数据契约

control-api/internal/store/organization_announcements.go

组织定向公告、发布接收人快照与撤回契约

control-api/internal/store/client_organization_announcements.go

接收人快照拉取、撤回隐藏与幂等已读回执契约

control-api/internal/store/organization_approvals.go

审批模板、顺序步骤快照、操作员/客户端处理主体与撤回契约

client-test/lib/organization_approval_api.dart

成员模板、审批收件箱、本人提交和当前步骤处理客户端契约

control-api/internal/store/organization_tasks.go

企业任务、操作员/客户端状态事件、成员分配与终态约束

client-test/lib/organization_task_api.dart

本人任务拉取和受限自助状态推进客户端契约

control-api/internal/store/organization_attendance.go

人工考勤登记、时间约束、成员引用与审计契约

client-test/lib/organization_attendance_api.dart

本人考勤拉取和确认已查看人工登记客户端契约

control-api/internal/store/client_moderation_reports.go

客户端举报目标快照、案件状态、审核与审计契约

control-api/internal/store/client_moderation_report_appeals.go

原举报人申诉、独立复审状态与原案件隔离契约

client-test/lib/client_moderation_report_api.dart

用途令牌、本人案件列表、标识型举报与受限申诉客户端契约

control-api/internal/store/client_login_ip_policies.go

用户登录 IP 策略、CIDR 校验与令牌签发前强制契约

control-api/internal/store/client_desktop_access_policies.go

用户 Windows PC 登录策略、审计与令牌签发前强制契约

control-api/internal/store/client_account_labels.go

特殊/官方账号展示标识、权限审计与本人登录返回契约

control-api/internal/store/client_registration_invites.go

一次性邀请码摘要存储、失效/停用与明文仅显示一次契约

client-test/

官方 Flutter SDK 的独立测试客户端

harmony-push-test/

HarmonyOS Push Kit 的独立设备登记样例

docs/control-api.md

节点代理、指标、任务与审计契约

../memo.log

按时间记录的开发证据,不存放凭据