CURRENT BASELINE
开发总览
12 个关键工作项中，10 项开发自动验收已完成；直连厂商推送的设备登记、加密存储与华为、荣耀、米系、vivo、鸿蒙接入骨架正在本地开发。后台功能已按顺钉通参考类别展开为逐项清单；企业组织目录完成本地实现，尚未迁移或部署。
整体完成度10 / 12
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、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） |
| 直连厂商离线推送 | 进行中 | 本地已实现用户同意后的加密设备登记；华为、荣耀、小米、vivo 与鸿蒙接入骨架均不依赖聚合推送 | 登记各应用独立凭据，部署发送与反馈服务；OPPO 先确认不含 APK 密钥的官方注册方案 | 本地 Go/Flutter 回归；待各厂商真机锁屏送达、点击、令牌刷新与失败回执 |
| 生产多节点 | 未开始 | 当前仅为单节点测试基线 | 拆分有状态依赖并执行压测 | 容量、故障切换、备份恢复 |
状态依据：运行事实、真实请求和客户端行为；不根据计划日期自动变更。
BACKEND FUNCTION REGISTER
后台功能开发台账
顺钉通后台仅用于功能类别参考；所有实现使用独立 OpenIM 数据模型、权限和审计，不迁移旧代码、数据、账号或凭据。
| 功能模块 | 状态 | 当前实现 | 下一步 | 验收边界 |
|---|---|---|---|---|
| 后台账号、角色、菜单与审计 | 已完成 | 独立操作员、角色权限、菜单可见性、登录记录、IP 黑名单和不可变审计 | 随新增业务模块补充最小权限 | 控制 API 权限测试与审计记录 |
| OpenIM 用户、关系、群组与消息运营 | 已完成 | 用户目录、关系、群组治理、受限消息检索和回执均经官方 API | 按上线授权复核数据面回调 | 官方 API 受控请求与权限审计 |
| 内容、客户端配置与投诉审核 | 已完成 | 公告、发现页、宵禁、版本策略和人工投诉审核独立存储 | 为每项配置接入正式客户端消费者 | 控制台回归；客户端生效另行验收 |
| 企业组织、部门与成员目录 | 进行中 | 本地已实现组织编码、无环部门树、成员映射、RBAC、审计和管理界面；不改写 OpenIM 账号 | 执行受控迁移并部署后，补充客户端消费与用户资格核验 | 本地 Go/静态界面回归；尚未迁移、部署或进行真实管理请求 |
| 组织定向公告与员工策略 | 未开始 | 现有公告为平台级配置，不按企业、部门或成员定向 | 定义受众快照、撤回、阅读回执和审计模型 | 权限隔离、目标计算与客户端回执 |
| 审批、考勤与任务 | 未开始 | 尚无业务数据模型或工作流实现 | 先确定独立业务边界、状态机、权限和审计 | 流程状态、并发、撤回和可追溯性 |
| 厂商离线推送发送与反馈 | 进行中 | 仅有用户同意后的设备登记和厂商接入骨架，不含发送凭据或发送服务 | 配置各应用独立凭据并实现发送、失败回执和重试策略 | 各厂商真机锁屏送达、点击路由和令牌刷新 |
| 钱包、订单、社区与内容业务 | 未开始 | 未迁移旧系统功能；不使用占位表单伪装为已实现 | 按领域单独设计账本、合规、风控和审核边界 | 独立数据模型、对账、权限、审计和真实业务验收 |
本表以代码、迁移、部署和真实请求证据更新。仅本地实现不标记为“已完成部署”。
逐项功能对照清单
| 参考类别 | 独立 OpenIM 功能 | 状态 | 当前范围 | 下一步与验收 |
|---|---|---|---|---|
| 系统与权限 | 后台操作员 | 已完成 | 独立操作员创建、更新、重置和受限登录 | 随业务域新增最小权限 |
| 系统与权限 | 角色与操作权限 | 已完成 | 服务端权限目录和受保护内置管理员角色 | 新增业务接口必须补权限测试 |
| 系统与权限 | 菜单与导航 | 已完成 | 数据库菜单排序和角色可见性，不绕过服务端权限 | 新模块登记菜单和权限 |
| 系统与权限 | 参数、字典与入口台账 | 已完成 | 受限系统参数、任务字典和非敏感入口记录 | 配置变更按审计和消费者验证 |
| 系统与权限 | 登录记录、IP 黑名单与操作审计 | 已完成 | 后台登录事件、IP 拦截和不可变审计导出 | 按保留策略复核 |
| IM 运营 | 用户目录与资料管理 | 已完成 | 官方 OpenIM 用户查询、新建与受限公开资料更新 | 上线前复核数据面授权 |
| IM 运营 | 登录、会话与活跃统计 | 已完成 | 注册、活跃、终端会话和强制下线的受限运营视图 | 部署回调后取得真实事件证据 |
| IM 运营 | 好友、黑名单、申请与默认好友 | 已完成 | 官方关系接口、申请审核和受限默认好友规则 | 补外部注册路径的触发契约 |
| IM 运营 | 私聊与群聊消息治理 | 已完成 | 有范围约束的消息检索和逻辑撤回，不提供物理删除 | 按权限审计复核 |
| IM 运营 | 群组、成员与入群申请 | 已完成 | 建群、成员、群策略、转让、解散和申请审核均走官方 API | 补线上回调与真实运营验收 |
| IM 运营 | 系统通知账号与平台公告 | 已完成 | 官方系统通知账号和独立平台级公告 | 正式客户端接入公告消费者 |
| IM 运营 | IM 举报案件审核与处置 | 已完成 | 运营端可维护人工案件、状态、处理说明、权限和审计 | 客户端举报提交、证据和复审另列开发 |
| IM 举报 | 用户举报提交 | 未开始 | 没有独立客户端用户举报入口或目标快照 | 定义被举报用户、原因、证据、限频、通知和案件关联 |
| IM 举报 | 群组与成员举报提交 | 未开始 | 没有独立客户端群组或群成员举报入口 | 定义群组/成员目标、成员资格快照、理由、证据和案件关联 |
| IM 举报 | 私聊与群聊消息举报提交 | 未开始 | 没有独立客户端消息举报入口或受限消息证据固化 | 定义消息定位、最小证据快照、权限、限频和案件关联 |
| IM 举报 | 举报证据、处置通知与复审 | 未开始 | 案件审核不等于证据留存、处理告知或申诉复审闭环 | 定义留存期限、访问控制、处置通知、复审状态和审计 |
| 用户账户与安全 | 产品账号登录密码重置 | 未开始 | 不复用旧后台密码或重置接口；OpenIM Token 不是产品密码 | 独立身份验证、短时重置令牌、审计和通知 |
| 用户账户与安全 | 支付密码重置 | 未开始 | 没有钱包或支付密码体系 | 先建立账本、强验证和双人审核边界 |
| 用户账户与安全 | 邀请码启用与修改 | 未开始 | 没有邀请关系、邀请码或奖励规则 | 定义不可重复编码、归属和反作弊审计 |
| 用户账户与安全 | 特殊账号与官方账号标识 | 未开始 | 没有继承旧系统的特殊或官方账号开关 | 定义身份来源、展示范围、审批和撤销 |
| 用户账户与安全 | 会议权限 | 未开始 | 没有会议服务、参会角色或用户级会议开关 | 先确定独立会议产品和授权模型 |
| 用户账户与安全 | 用户级建群开关 | 未开始 | 现有群组治理不含每个用户的建群资格控制 | 定义资格、变更审计和客户端拦截契约 |
| 用户账户与安全 | 用户级建群额度 | 未开始 | 没有个人建群数量配额或额度规则 | 定义统计口径、额度调整和并发校验 |
| 用户账户与安全 | 我创建的群组列表 | 未开始 | 现有用户群组视图不作为“创建群组”运营清单 | 增加群主精确查询与权限边界 |
| 用户账户与安全 | PC 端用户级功能开关 | 未开始 | 已有桌面兼容测试，不含按用户启停 PC 能力 | 确定策略名称、客户端消费者和审计 |
| 用户账户与安全 | 昵称设置 | 已完成 | 官方 OpenIM 用户公开资料更新可受限修改昵称 | 保持权限和审计复核 |
| 用户账户与安全 | 新设备登录保护与设备管理 | 未开始 | 已有终端会话历史，不含审批新设备或设备信任清单 | 定义设备指纹、确认、撤销和隐私边界 |
| 用户账户与安全 | 指定用户登录 IP | 未开始 | 已有后台 IP 黑名单，不含每个用户的允许 IP 策略 | 定义 CIDR、代理信任链、回退和审计 |
| 用户账户与安全 | 好友列表 | 已完成 | 可经官方 OpenIM API 查询好友和黑名单 | 保持受限查询和审计 |
| 用户账户与安全 | 会话风险提示 | 未开始 | 没有用户级聊天时长、异常行为或风险提示策略 | 先定义触发条件、隐私边界和通知方式 |
| 用户账户与安全 | 聊天、在线时长与活跃统计 | 已完成 | 有界注册、消息活跃和终端会话统计，不伪装为完整登录历史 | 部署回调后取得真实数据证据 |
| 用户账户与安全 | 用户余额调整 | 未开始 | 没有资金账户、余额字段或管理员调账入口 | 完成账本、对账、审批和不可变流水后再设计 |
| 前端功能与登录策略 | 客户端全局功能开关 | 已完成 | 独立配置、审核和有界公开读取接口；可登记红包、会议、企业任务/日程/审批、退群和建群等能力 | 每项开关须接入正式客户端和服务端校验后才可称为生效 |
| 前端功能与登录策略 | 全局宵禁与客户端提示 | 已完成 | 独立宵禁策略和有界客户端配置读取已具备 | 正式客户端消费者和实际拦截行为另行验收 |
| 前端功能与登录策略 | Android 手机实名认证策略 | 未开始 | 没有独立手机号、短信、姓名或身份证核验服务，也没有 Android 专属策略 | 先确定身份服务、最小数据留存、注册拦截、异常处理和审计 |
| 前端功能与登录策略 | 实名资料审核与实名状态 | 未开始 | 用户目录不保存实名材料，也没有人工审核队列 | 定义资料加密、访问权限、审核、拒绝、注销和留存期限 |
| 前端功能与登录策略 | Apple ID 登录与绑定开关 | 未开始 | 没有独立 iOS Apple 登录、账号绑定或服务端令牌校验 | 建立 Apple 身份校验、账号绑定、撤销和客户端开关契约 |
| 前端功能与登录策略 | 第三方/品牌账号授权与手机号绑定策略 | 未开始 | 没有复用旧品牌账号授权或跳过手机绑定规则 | 逐一确定提供方、回调、绑定冲突、隐私告知和审计 |
| 前端功能与登录策略 | 注册入口与认证方式开关 | 未开始 | 现有账号与 Token 映射不等于可运营的注册方式策略 | 定义账号、手机、邮箱和第三方注册的开关、依赖关系和服务端强制校验 |
| 配置与运维 | 发现页与版本策略 | 已完成 | 独立配置、审核和有界公开读取接口 | 逐项接入正式客户端消费者 |
| 配置与运维 | 节点、线路、告警、任务与路由发布 | 已完成 | 节点心跳、健康历史、受限诊断、路由快照和回滚 | 生产拓扑和容量验收 |
| 推送 | 厂商设备登记 | 进行中 | 同意后加密登记华为、荣耀、小米、vivo、鸿蒙等设备 | 各应用独立凭据、真机送达和反馈回执 |
| 推送 | 厂商发送、失败反馈与重试 | 未开始 | 不含厂商发送服务、凭据或重试队列 | 按厂商分别实现并做锁屏真机验收 |
| 企业管理 | 企业、部门与成员目录 | 进行中 | 本地组织编码、无环部门树、成员映射、RBAC 和审计 | 迁移、部署、用户资格核验和客户端消费 |
| 企业管理 | 组织定向公告与员工策略 | 未开始 | 现有公告只支持平台级，不支持企业和部门受众 | 受众快照、撤回、阅读回执与审计 |
| 企业管理 | 审批工作流 | 未开始 | 没有表单、状态机、审批人规则或流程记录 | 独立模型、并发控制、撤回和可追溯性 |
| 企业管理 | 考勤 | 未开始 | 没有班次、地点、打卡或异常处理模型 | 定义隐私、时区、补卡和审核边界 |
| 企业管理 | 任务与待办 | 未开始 | 没有任务分派、状态、提醒或协作模型 | 定义负责人、权限、状态机和通知契约 |
| 身份与授权 | 企业身份与员工资格核验 | 未开始 | 组织成员映射不等于员工身份核验或企业资格校验 | 先完成独立身份来源、隐私、合规和审核设计 |
| 增长与积分 | 签到、积分与奖励任务 | 未开始 | 没有积分账户、规则或奖励发放实现 | 先定义不可篡改积分流水和风控 |
| 钱包与红包 | 钱包、充值、提现与红包 | 未开始 | 没有资金账本、支付渠道或管理员调账入口 | 独立账本、对账、合规、风控和双人审核 |
| 招聘与订单 | 企业、职位、简历与招聘订单 | 未开始 | 未迁移顺钉通招聘业务或订单数据 | 按领域建立独立数据模型和权限 |
| 招聘与订单 | 发票、报销与案例管理 | 未开始 | 没有票据、报销、案例或附件审批流程 | 先定义留存、审批和访问控制 |
| 内容社区 | 圈子、城市、文章与内容审核 | 未开始 | 没有社区关系、发布、审核或地域运营模型 | 独立内容、审核和风控契约 |
| 内容社区 | 相册与图片审核 | 未开始 | 只有 OpenIM 媒体消息，不含相册业务 | 独立媒体归属、访问、审核和删除策略 |
| 内容社区 | 圈子、文章与相册内容举报 | 未开始 | 没有社区内容对象、举报提交、证据快照或审核队列 | 在内容域建立举报、审核、处置、申诉和审计闭环 |
| 通知服务 | 邮件通道、模板与投递记录 | 未开始 | 没有独立邮件发送、模板或投递反馈服务 | 单独登记发送凭据、退信与审计策略 |
| 生产能力 | 多节点、容量、备份与故障切换 | 未开始 | 当前仍是单节点测试基线 | 有状态拆分、压测、恢复和回滚演练 |
“已完成”仅表示独立控制面已有实现和相应自动验证；业务域仍需各自的数据模型、消费者、部署和真实验收，不能从顺钉通复制或迁移。
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 与人工复核 | 打开审核 |
| 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 处理 | 非公开审核入口 |
人工审核结果需记录审核人、时间、结论和问题。账号可显示；明文密码和验证码只从统一受限凭据库授权取用，不进入公开网页、源码或浏览器存储。
CLIENT MATRIX
客户端接入矩阵
这里记录的是新 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；待浏览器人工复核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 签发契约
docs/push-media.md媒体对象路径、文件策略与独立离线推送边界
docs/reference-parity.md顺钉通后台功能参考与独立实现差距
control-api/internal/store/organizations.go企业组织、部门与成员目录的数据契约
client-test/官方 Flutter SDK 的独立测试客户端
harmony-push-test/HarmonyOS Push Kit 的独立设备登记样例
docs/control-api.md节点代理、指标、任务与审计契约
../memo.log按时间记录的开发证据，不存放凭据