From 8a5a4affc044d0fb8d6224757526ce7ddc55c689 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=BB=E7=AE=A1?= Date: Wed, 23 Sep 2026 23:12:13 +0800 Subject: [PATCH] docs: hand over Jinxunda status and next steps Co-authored-by: multica-agent --- deploy/public/README.md | 2 ++ docs/README.md | 12 +++++----- docs/任务清单.md | 38 +++++++++--------------------- docs/最新进度.md | 46 +++++-------------------------------- docs/项目交接-2026-09-23.md | 30 ++++++++++++++++++++++++ docs/项目需求.md | 9 ++++---- 6 files changed, 60 insertions(+), 77 deletions(-) create mode 100644 docs/项目交接-2026-09-23.md diff --git a/deploy/public/README.md b/deploy/public/README.md index b57e6c9..f8cae21 100644 --- a/deploy/public/README.md +++ b/deploy/public/README.md @@ -1,5 +1,7 @@ # 公网测试部署说明(jxd.jinniu.ink) +> **已过时,仅留档备查(2026-09-23)。** 当前 `154.37.220.158` 已由系统 Nginx 统一承接 80/443,`jxd-edge` 已移除。本页下方 edge 启停、证书和回滚步骤不能直接用于现网;先读 [最新交接](../../docs/项目交接-2026-09-23.md),核对现网配置与未合入 `main` 的部署变更,再制订新操作方案。 + 施工员本卡**不执行**本节命令、不 SSH 改测试机。由总工审核通过后再部署。 目标机:已解析到 `jxd.jinniu.ink` 的香港测试服务器。数据目录仍是仓库下的 `components/` 与 `data/`,回滚不删数据。 diff --git a/docs/README.md b/docs/README.md index f44957c..d070872 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,10 +1,10 @@ -# 畅联项目手册 +# 金讯达项目手册 这是项目的交接首页。新接手的人先按下面顺序阅读,不要只凭旧文档或聊天记录判断项目状态。 -1. 先读 [项目需求](项目需求.md):弄清楚项目要做什么、不能碰什么。 -2. 再读 [最新进度](最新进度.md):确认代码已经做到哪里、哪些结论已经被验证。 -3. 最后读 [任务清单](任务清单.md):从“正在做”和“还没安排”里选择下一件事。 +1. 先读 [2026-09-23 项目交接](项目交接-2026-09-23.md):最新部署状态、风险和接下来的计划。 +2. 再读 [项目需求](项目需求.md):弄清楚项目要做什么、不能碰什么。 +3. [最新进度](最新进度.md)和[任务清单](任务清单.md)是精简索引;旧验收记录仅供追溯。 ## 仓库里有什么 @@ -12,7 +12,7 @@ - `pc-client/`:电脑端,使用 Electron,Windows 是当前优先支持的平台。 - `account-service/`:公司账号服务,负责工号密码登录、管理员导入和管理名单。 - `docker-compose.yaml`、`config/`、`scripts/`:OpenIM、语音服务和内网环境的配置及维护脚本。 -- `deploy/public/`:香港测试机 `jxd.jinniu.ink` 的公网反代、证书和回滚说明(由总工部署)。 +- `deploy/public/`:早期公网部署资料。旧 edge 操作不适用于当前系统 Nginx 统一入口,不要直接执行。 - `docs/`:本手册和以前留下的验收、回归、使用说明。 ## 更新规矩 @@ -24,4 +24,4 @@ - 任务状态变化时,更新 `任务清单.md` 的三栏,并写明依据。 - 旧文档不能删除;如果它和当前事实不一致,在旧文档开头加“已过时,仅留档备查”提示,再在本目录写新版。 -手册只记录已经确认的事实。拿不准的内容要写成“待确认”,不要当成已完成。 \ No newline at end of file +手册只记录已经确认的事实。拿不准的内容要写成“待确认”,不要当成已完成。 diff --git a/docs/任务清单.md b/docs/任务清单.md index b31426f..8dfa548 100644 --- a/docs/任务清单.md +++ b/docs/任务清单.md @@ -1,33 +1,17 @@ # 任务清单 -更新时间:2026-08-31。任务状态以当前仓库和项目约束为准;没有证据的事项不写成“已完成”。 +更新时间:2026-09-23。旧协调卡 HEL-4 及相关子卡收口后,以 [项目交接](项目交接-2026-09-23.md)为新任务依据。旧卡关闭不等于整个项目已验收。 -## 正在做 +## 已交付 -无。安卓自适应图标已按 66dp 安全区重做,版本 `1.0.9+10`,等待审核。 -HEL-294 员工管理页接口路径与英文报错热修:代码和本地自测已完成,等待部署到香港测试环境后由管理员在公网 `/account/` 页面验收。 +- Flutter 安卓端、Electron Windows 端、账号服务、OpenIM/LiveKit 集成与历史跨端回归记录。 +- 安卓名称/图标/包名调整,极光和华为构建配置接入,测试包生成。 +- 香港测试机系统 Nginx 统一入口;金讯达网页并入统一门户。网页单人登录、退出及入口可访问性已有记录。 -## 已做完 +## 下一步新开独立任务 -- 建立手机端 Flutter 工程和 Windows 优先的 Electron 电脑端工程。 -- 接入公司工号加密码登录,以及管理员导入、管理员工账号的账号服务。 -- 完成聊天、通讯录、同事申请、语音消息、文件/图片消息和一对一语音通话的相关代码接入。 -- 完成一轮手机与电脑的跨端回归记录;其中已通过的项目见旧档 `phase4-regression-2026-08-16.md`。 -- 将 LiveKit 的信令/媒体端口统一为 `17880`、`17881`、`17882`,并提供可重复执行的修复脚本。 -- 建立本目录四份交接手册,并为三份过时旧说明加上明确的留档提示。 -- 手机端应用标识统一为 `cn.solsum.jinxunda`。 -- 安卓极光 SDK 初始化、通知权限、alias 回传、点击处理,以及 OpenIM 离线推送所需的服务端配置入口(Master Secret 从服务器文件注入)。 -- 公网反向代理 / HTTPS / WSS / 防火墙与回滚说明(配置进仓库;香港测试环境已由总工部署)。 -- 公网 overlay 用 `!override` 覆盖内部端口绑定;部署脚本校验 `SERVER_IP` 非空。 -- 构建机本地放入华为 `agconnect-services.json`(不入库);AGConnect 插件映射/版本已按 AGP 9 补齐,Gradle 能识别包名 `cn.solsum.jinxunda`。 -- 升级 `livekit_client` 至 `2.10.0`,在 Flutter 3.47 / Dart 3.13 下打出整包安卓 release APK。 -- 安卓桌面名称改为「金讯达」,按正式参考图生成各密度与自适应图标;随后按真机裁切问题把前景缩进 66dp 安全区,版本提升到 `1.0.9+10` 并重新出包。 -- HEL-294:管理页按部署前缀请求账号接口,并给 401/404/500/空响应/非 JSON 提供中文兜底(代码已合入分支,公网部署前现网仍会报英文错)。 - -## 还没安排 - -- 用真机验证华为厂商通道到达,以及一对一语音通话。 -- 组织真实手机和 Windows 电脑的回归:重点确认文件传输、一对一语音通话和杀进程后的离线通知。 -- 明确手机正式签名的负责人和安全保管方式;不能把签名密钥提交进仓库。 -- 获得负责人同意后,再导入真实员工名单并验证账号管理流程。 -- 不接入小米、OPPO、vivo、荣耀、魅族、FCM 或苹果推送(本阶段明确不做)。 +1. 审核并同步现网 Nginx 配置与仓库代码,补齐金讯达证书自动续期及回滚演练(原 HEL-554;到期风险优先)。 +2. 两名真实员工跨安卓、Windows、网页验收消息、附件与一对一语音通话;华为真机验收离线推送。 +3. 确定账号导入和原生端门户登录策略,准备安卓正式签名及安全保管。 +4. 根据资质进展另行接其他安卓厂商推送与 iOS。 +5. 如仍需 `solsum.cn` 根域名 HTTPS,另行处理证书域名不匹配(原 HEL-553;不属于金讯达当前域名接入阻塞)。 diff --git a/docs/最新进度.md b/docs/最新进度.md index 3d06365..4a2f09f 100644 --- a/docs/最新进度.md +++ b/docs/最新进度.md @@ -1,43 +1,9 @@ # 最新进度 -更新时间:2026-08-31。以下内容依据当前仓库代码整理。 +更新时间:2026-09-23。详细事实、证据边界和下一步见 [项目交接](项目交接-2026-09-23.md)。 -## 现在做到哪里 - -项目已经具备可继续测试的手机端、Windows 电脑端、账号服务,香港测试环境已由总工部署。本轮在 `1.0.8+9` 图标交付基线上,修正了安卓自适应图标安全区并重新出包: - -- 手机端在 `mobile/`,使用 OpenIM Flutter SDK `3.8.3+hotfix.12`,版本 `1.0.9+10`。 -- 安卓/苹果应用标识为 `cn.solsum.jinxunda`。 -- 安卓桌面、最近任务和系统应用信息的显示名称为「金讯达」(`values` / `values-zh` / `values-zh-rCN` / `values-en` 均为此名)。登录页与聊天页文案未改。 -- 安卓自适应图标不再把带圆角的整张 PNG 顶格作为前景:红色背景铺满 108dp,前景把完整标识放进中心 66dp 安全区;legacy 方/圆图标仍是完整标识。真机 1.0.8 安装器裁切已按此修正。 -- 手机端已接入极光官方 Flutter 插件(AppKey 在客户端配置),登录后把 OpenIM userID 设为极光 alias。 -- 华为 AGConnect 插件在放入本地 `agconnect-services.json` 后启用(agcp `1.9.5.301`,适配 AGP 9);该文件含密钥,仓库继续忽略,不入库。 -- 手机默认服务地址为 `jxd.jinniu.ink` 的 HTTPS/WSS;内网可用 `--dart-define=SERVER_HOST=... --dart-define=USE_TLS=false` 覆盖。 -- 公网部署 overlay、Nginx、证书步骤、Master Secret 注入脚本和回滚脚本在 `deploy/public/` 与 `scripts/deploy-public.sh`;由总工部署,施工员不改测试机。 -- overlay 的内部端口用 Compose `!override` 覆盖基础 `0.0.0.0` 绑定,只留 `127.0.0.1`;LiveKit `17881/tcp`、`17882/udp` 仍对公网开放。部署脚本会拒绝空 `SERVER_IP`。 -- 电脑端在 `pc-client/`,使用 Electron,显示版本 `v1.0.2`。 -- 员工用工号和密码通过 `account-service/` 登录;管理员导入和管理账号的页面、接口已在仓库中。 -- HEL-294:管理页接口改为适配 `/account/` 部署前缀;非 JSON/空响应改为中文提示,不再把浏览器英文异常直接展示。热修代码已提交,尚未部署到公网。 -- 手机和电脑端已接入聊天、通讯录、同事申请、语音消息、文件/图片消息和一对一语音通话相关代码。 -- 语音服务 LiveKit 的信令和媒体端口已统一为 `17880`、`17881`、`17882`;仓库提供 `scripts/fix-livekit-ports.sh` 用于服务器已部署环境的端口修复。 - -## 已有验证记录 - -- `docs/phase4-regression-2026-08-16.md` 记录过手机与电脑之间的文字、同事申请、图片、语音消息等跨端回归结果。 -- 该记录中的文件传输和一对一语音通话,曾因模拟器环境无法闭环,仍需要用真实设备再次确认。 -- 旧记录使用的是更早的提交、安装包版本和端口状态;因此已保留为档案并在开头标明过时,不能当作当前验收结论。 -- 放入与 `cn.solsum.jinxunda` 匹配的真实华为配置后,Gradle `:app:processDebugAGCPlugin` 与 `:app:processReleaseAGCPlugin` 通过;debug/release/profile 均识别该配置文件。未因配置缺失或包名不一致失败。 -- `flutter pub get` 已写入 `jpush_flutter 3.5.6` / `jpush_flutter_android 1.0.2` 到 `mobile/pubspec.lock`。 -- `flutter analyze` 仅有 2 条既有 OpenIM `group` 弃用 info;`flutter test`(`config_test` 与登录页 widget_test)通过。 -- 语音组件已升级到 `livekit_client 2.10.0`(配套直接依赖 `uuid 4.5.3`),Flutter 3.47 / Dart 3.13 下可编译。 -- 整包 `flutter build apk` 已打出 release 安装包 `app-release.apk`,包名 `cn.solsum.jinxunda`,版本 `1.0.9+10`。 - -## 当前停在哪 - -华为配置可被 Gradle 识别,整包安卓安装包已能在当前工具链打出。真机华为通道到达率、真机一对一语音通话仍待真机验证。本轮未改测试机、未回退公网端口与部署安全修复。 - -## 已知风险和待验证事实 - -- 真机上的文件传输、一对一语音通话、杀进程后的离线推送(尤其华为通道)仍需实际设备验证。 -- 当前 release 包仍用调试签名;正式签名需后续单独准备,密钥不得入库。 -- 电脑端使用较旧的 Electron;公网接入后仍需评估 HTTPS、登录限流和跨域策略。 +- 最新测试服务器:`154.37.220.158`;系统 Nginx 统一承接 80/443,金讯达网页 `https://jxd.jinniu.ink` 已由负责人整合到统一门户 `https://bg.jinniu.ink`。 +- 当日只读检查表明网页与账号健康检查可访问,安卓测试包可下载,OpenIM、账号服务、LiveKit 等服务运行;尚不能据此判定双人通讯和推送验收通过。 +- 安卓代码版本 `1.0.9+10`,包名 `cn.solsum.jinxunda`,名称与图标已经调整;Windows 文档版本 `v1.0.2`。安卓极光和华为配置已有接入,真机到达率仍待验证。 +- 门户网页已验证单人登录与退出;两个真实员工之间的消息、附件、语音通话仍待验收。Android/Windows 原生端还未适配门户登录;iOS、其他安卓厂商推送、正式签名尚未完成。 +- 现网统一入口的变更尚未同步进仓库 `main`;旧 `jxd-edge` 部署指令不适用于现网。证书自动续期仍待补齐。 diff --git a/docs/项目交接-2026-09-23.md b/docs/项目交接-2026-09-23.md new file mode 100644 index 0000000..4cbaa9f --- /dev/null +++ b/docs/项目交接-2026-09-23.md @@ -0,0 +1,30 @@ +# 金讯达项目交接(2026-09-23) + +本页是旧协调卡 HEL-4 归档后的项目入口。它记录截至本日能核实的状态与下一步,不代表整个项目已经验收完成。后续请以新的、范围明确的任务卡推进,并在完成时更新本页。不得把密钥、员工资料或私钥写入仓库。 + +## 当前部署和入口 + +- 当前香港**测试**服务器公网地址:`154.37.220.158`;`jxd.jinniu.ink` 指向这台服务器。正式上线前仍需独立验收。 +- 集团统一门户为 `https://bg.jinniu.ink`。负责人已自行把金讯达网页端整合进统一门户;网页地址为 `https://jxd.jinniu.ink`,网页身份入口以门户为准,详情见 [网页试运行说明](portal-web-trial.md)。 +- 2026-09-23 只读核对:系统 Nginx 占用 80/443,配置检查通过;金讯达网页、账号健康检查均返回 HTTP 200,现有安卓测试包下载支持 HTTP 206 分段下载。OpenIM、账号服务、LiveKit、MinIO 及其依赖容器当时在运行。**这只证明服务和入口当时可用,不等于聊天、通话或推送已完成用户验收。** +- 现网由系统 Nginx 统一承接 80/443;原 `jxd-edge` 容器已移除。`deploy/public/README.md` 的 edge 启停步骤是旧方案,禁止直接照其操作现网。 + +## 代码与已经交付的能力 + +- 代码包含 Flutter 手机端、Electron/网页端、公司账号服务,以及 OpenIM、LiveKit 等部署配置。安卓包名 `cn.solsum.jinxunda`,版本 `1.0.9+10`;安卓名称为“金讯达”,已按系统自适应图标安全区调整图标。Windows 客户端当前文档版本为 `v1.0.2`。 +- 手机和电脑端已有工号密码登录、通讯录、聊天、图片/文件/语音消息及一对一语音通话相关代码;历史跨端测试记录见 [回归记录](phase4-regression-2026-08-16.md),不能拿历史记录代替当前版本的真机验收。 +- 安卓已接入极光 SDK 与华为 AGConnect 构建配置;华为配置文件及极光 Master Secret 均为私有材料,不入库。其他安卓厂商通道与苹果推送尚未完成。 +- 网页端已接入统一门户单点登录。现有网页试运行记录覆盖登录、会话兑换与退出;当时仅有一个正式管理员,尚无两个真实员工之间的消息、音视频、附件完整验收。原生 Android/Windows 客户端仍使用旧登录机制,尚未统一为门户登录。 +- 本仓库 `main` 已含网页门户整合代码;服务器 Nginx 统一入口相关改动曾交付于另一个分支,**截至本日尚未合入 `main`**。后续部署前要先审查并同步该分支及现网配置,不能直接用 `main` 的旧 edge 脚本覆盖现网。 + +## 尚未完成、按优先级推进 + +1. **P0:统一部署基线与证书。** 审查并合入系统 Nginx 统一入口相关代码,核对现网配置、备份和回滚路径;补齐 `jxd.jinniu.ink` 证书自动续期。现有证书到期日记录为 2026-11-28,应在 2026-11-14 前完成自动续期及演练。原 HEL-554 尚未执行,不得因旧卡归档误认为已完成。 +2. **P1:真实员工验收。** 准备两个获授权的测试员工账号,在安卓、Windows、网页之间验证登录、双向消息、附件、语音消息与一对一语音通话;华为真机验证前台、后台和被系统结束后的通知到达与点击。记录设备、版本、时间和失败现象;不得以健康检查代替这些测试。 +3. **P1:账号及发布安全。** 负责人确认员工名单导入与权限边界;安卓正式发布前改用受保护的正式签名,不能把签名密钥入库。评估网页门户身份与原生客户端旧登录并存的期限,以及原生端是否改用门户登录。 +4. **P2:其余平台。** 其他安卓厂商通道待各厂商资质完成后再接;iOS 的 Apple 开发者账号、推送凭据、构建和真机验收另立任务,不视为本阶段已完成。 +5. **P2:`solsum.cn` 证书问题。** 原 HEL-553 记录其根域名证书只覆盖 `www`,与金讯达当前 `jxd.jinniu.ink` 接入不是同一个阻塞;如仍需根域名 HTTPS,由该域名负责人另开独立任务处理。 + +## 旧任务卡收口说明 + +HEL-4 是跨阶段协调卡,不是“项目全部完工”的证明。归档时,已交付的子卡记为完成;未执行的 HEL-553、HEL-554 仅关闭旧卡、把风险迁入上方计划。以后请从此文档开新卡,不继续在旧长线程里追加施工。实际状态以当时运行环境和最新代码为准。 diff --git a/docs/项目需求.md b/docs/项目需求.md index f21d67e..836f06e 100644 --- a/docs/项目需求.md +++ b/docs/项目需求.md @@ -2,7 +2,7 @@ ## 项目是什么 -“畅联”是集团内部使用的通讯 App,也就是给员工聊天、找同事和语音通话的工具。项目以开源 OpenIM 为基础改造,保留 OpenIM 原有标识,不换品牌、不另起一套产品标识。 +“金讯达”是集团内部使用的通讯 App,也就是给员工聊天、找同事和语音通话的工具。项目以开源 OpenIM 为基础改造;员工使用的安卓应用已采用经负责人确认的“金讯达”名称和图标。OpenIM 的第三方标识、许可和署名仍须按其许可保留。 ## 要解决什么 @@ -20,12 +20,13 @@ - 手机端:Android 和 iPhone 工程都在仓库中;当前手机端版本号为 `1.0.9+10`。应用标识 `cn.solsum.jinxunda`。安卓桌面/最近任务/系统应用信息显示名称为「金讯达」。 - 电脑端:Windows 优先;当前电脑端显示版本为 `v1.0.2`。 -- 服务端:以 Docker Compose(把一组服务一起启动的工具)编排 OpenIM、账号服务和语音服务。公网测试域名为 `jxd.jinniu.ink`(HTTPS/WSS),部署配置在 `deploy/public/`,实际部署由总工执行。 +- 网页端:已由负责人整合进统一门户,入口 `https://bg.jinniu.ink`,业务页面 `https://jxd.jinniu.ink`;网页身份以门户为准。原生 Android/Windows 尚未同步门户登录。 +- 服务端:以 Docker Compose(把一组服务一起启动的工具)编排 OpenIM、账号服务和语音服务。当前香港测试机为 `154.37.220.158`,域名 `jxd.jinniu.ink`(HTTPS/WSS);系统 Nginx 承接 80/443。仓库旧 edge 部署资料不得直接用于现网。 ## 当前边界 - 只做集团内部通讯,不改造成公开社交产品。 -- 保留 OpenIM 的现有标识,禁止替换品牌。 +- 尊重 OpenIM 第三方许可与署名;用户可见应用品牌为“金讯达”,不据此改写 OpenIM 上游代码中的许可信息。 - 公网第一阶段:安卓极光 + 华为厂商通道(`agconnect-services.json` 只放构建机、不入库,见 `mobile/android/app/README-agconnect.md`);不接小米/OPPO/vivo/荣耀/魅族/FCM/苹果推送。 - 不把员工名单、密码、管理员口令、极光 Master Secret、华为 Secret、私钥或服务器私密配置写入仓库和文档。 -- 本仓库的日常任务如无明确授权,不做发布、部署或改动生产环境。 \ No newline at end of file +- 本仓库的日常任务如无明确授权,不做发布、部署或改动生产环境。