Fullstack/iboard
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
836035f4cd0215e94c3ee1fbacee9c63c3dc1adc
iboard/docs/021任务.md
T

8.1 KiB
Raw Blame History

0.2.1 发布任务 — 目标与现状

最后更新：2026-10-27 07:05 分支：dev-0.2（已推送，与 origin/dev-0.2 同步于 b29be62） 状态：代码与打包全部就绪；生产切换尚未执行（停在"镜像已构建，待起栈+迁移+切域名"）

一、任务目标（用户原始要求）

  1. 域名 iboard.honor3.com 已指向 3000 端口、HTTPS 证书已配好 → 客户端全面切到该域名。
  2. Windows 外壳 + 离线编辑功能正式合并到 dev-0.2，完整版本号 0.2.1。
  3. 确保 Android 功能正常（通过 CI 编译验证，不在本地装 Android 工具链）。
  4. 确保 CI/CD 正常。
  5. Windows 本地打包正常即可。
  6. dev-0.2 更新完成后 通过 master 分支发布。
  7. 追加要求：不要再有 13002 这类独立端口，所有版本合并成一套。

二、已完成

2.1 分支合并

内容 结果
dev-0.2.1（离线编辑 + 项目编号 + PG/PowerSync）→ dev-0.2 已合并 e689e44
dev-windows-0.1（Windows 外壳：托盘/悬浮球/吸附/自启动）→ dev-0.2 已按路径迁入 eef2969
dev-0.2 → android-1.0（触发 APK 构建） 已合并 4958359
冲突处理 projects.js/tasks.js/api/task.js 手工合并，两边功能都保留（autoArchive 归档 + code 编号）
归档功能补齐到本地库 src/api/task.js 新增 archive/unarchive/archivedList；schema.js 加 archived/archivedAt/archiveSource/autoArchive；sync-config.yaml 与 upload 处理器同步
Prisma 客户端补齐 dev-0.2 原来缺任务模块 6 个模型，已重新 generate fc23919

2.2 版本与域名

  • 版本统一 0.2.1：package.json / src-tauri/tauri.conf.json / Cargo.toml / Cargo.lock（scripts/ci/check-version.mjs 通过）
  • 域名切 https://iboard.honor3.com：
    • src/api/client.js 注释、.env.shell、scripts/wsl/build-apk.sh、.gitea/workflows/android-build.yml、.gitea/workflows/docker-build.yml、Dockerfile（OTA_PUBLIC_BASE）、tauri.conf.json（OTA endpoint + CSP）
  • 旧域名 bh.vps.honor3.com:3001 仅保留在 CSP 白名单里做滚动兼容

2.3 单端口架构（去掉 13002）

改动 位置
Express 增加 /sync、/socket 同域反代到内网 powersync server/powersync-proxy.js + server/index.js（挂在 express.json() 之前，支持长连接）
生产编排：app(3001 对外) + pg(内网) + powersync(内网) deploy/prod/docker-compose.yml
生产部署脚本（幂等：迁移 → publication → 起栈 → 健康检查） scripts/deploy/prod.sh
PG 初始化（powersync_storage 用户） deploy/prod/initdb/01-powersync-storage.sh
逻辑复制 publication（建表后执行） deploy/prod/sql/publication.sql
部署文档 deploy/prod/README.md、.env.example
CI 部署段改为调用宿主脚本，未配 PG secrets 时自动跳过 .gitea/workflows/docker-build.yml

2.4 Windows 本地打包 — 通过 ✅

npm run build:win 全流程成功（本机需 Node 20.19+；已用便携 Node 20.18.1 之外的 Node 24 验证过 vite 构建）：

产物 路径 大小
安装包 artifacts/windows/iBoard_0.2.1_x64-setup.exe 6.9 MB
便携版 zip artifacts/windows/iBoard_0.2.1_x64-portable.zip 7.9 MB

外壳能力（继承 dev-windows-0.1）：托盘、悬浮球吸附、自动隐藏、单实例、自启动、窗口尺寸单值配置 （%APPDATA%\com.iboard.app\shell-config.json 的 window_width，高度按 405:720 锁定推导）。

离线能力（继承 0.2.1）：GET 响应本地缓存、同步凭证持久化（离线不清库）、左上角「离线」徽标。

2.5 Android CI — 通过 ✅

  • 触发：android-1.0 分支 push（4ded8e3）
  • 结果：16 个步骤全部 success，Build release APK + Publish APK to Gitea packages 成功
  • 产物：app-universal-release.apk（20 MB），versionName = 0.2.1 已发布到 http://git.honor3.com/api/packages/Fullstack/generic/iboard/1.0-4ded8e30/
  • 首次失败原因：runner 宿主机（baihu）磁盘 95% → No space left on device； 清理悬空镜像 + 构建缓存后释放 11.5 GB，重跑通过。磁盘现已 60%（39 GB 可用）

2.6 CI/CD 现状

Workflow 触发 状态
docker-build.yml master push 改造完成，未在 master 上验证（部署段会因缺 secrets 跳过）
android-build.yml android-* push 已验证通过
ota-build.yml / sync-registry.yml 参照原逻辑 未改动

三、当前卡点（生产切换未执行）

生产镜像 已构建成功：iboard:latest = db6b27b851b8（924 MB，2026-10-26 22:53）

baihu 上当前跑着两套：

容器 用途 端口
iboard（旧） 现网生产，MySQL（宿主 3306） 3001
iboard-021-app-1 等 4 个 0.2.1 验证栈 13001 / 13002 / 13443
（未启动）iboard-prod 新生产栈（PG + PowerSync + app） 3001（计划）

/app/iboard-prod 已上传源码、deploy/prod/.env 已生成（6 个密钥，600 权限）。

剩余步骤（约 4 步）：

  1. 起新栈（先用 HOST_PORT=13011 灰度，不动现网）
  2. 数据迁移：现网 MySQL → 新 PG（scripts/etl-mariadb-to-pg.mjs，只读源库）
  3. 验证：健康检查、登录、任务列表、离线编辑（断网后仍可读）、同步回流
  4. 切换：停 iboard 旧容器 → 新栈改绑 3001 → 域名 iboard.honor3.com 生效 → 下线验证栈（13001/13002/13443）

然后 dev-0.2 → master 合并推送，触发 CI 发布。

四、需要确认的信息（阻塞项）

  1. Gitea Actions Secrets 是否要配 PG 密钥？ 需配：PG_PASSWORD、PS_STORAGE_PASSWORD、JWT_SECRET、POWERSYNC_JWT_SECRET、POWERSYNC_JWT_KEY_B64。 不配的话：master 的 CI 只构建镜像不部署，生产靠手工执行 scripts/deploy/prod.sh（当前默认路径）。

  2. 生产数据迁移的时间窗口：迁移需短暂停写（现网 MySQL 只读快照）。是否可以挑一个低峰时间、期间 (~10 分钟) 站点只读？

  3. 现网 MySQL 里的米家凭证/缓存：/app/iboard/cache（auth.txt 等）是否要一并搬到新栈的 deploy/prod/data/cache？

  4. 用户密码：迁移只搬数据，JWT_SECRET 若换新，所有人需重新登录；是否沿用现网 JWT_SECRET（iboard）以保持登录态？建议换新（当前值过弱）。

  5. 域名端口说明：iboard.honor3.com 实际反代到 baihu 3001（NPM 配置：114.134.187.170:3001，SSL 强制）。 你提到"已转向 3000 端口"——请确认指的是 honor3.com 根域（→ homepage）而非 iboard 子域， 否则需要调整 NPM 的 forward_port。

五、关键路径与命令速查

# 仓库
C:\Users\Rabbit\Documents\workbetch\iboard          # dev-0.2 主工作区
C:\Users\Rabbit\Documents\workbetch\iboard-dev-0.2.1 # 研究分支 worktree
C:\Users\Rabbit\Documents\workbetch\iboard-dev-windows # Windows 外壳 worktree

# 服务器
ssh root@baihu            # 生产 + CI runner（baihu 上跑 act_runner，注册名 baishe）
ssh root@baishe           # 反代（NPM）、Gitea、homepage

# 生产目录
/app/iboard-prod/deploy/prod/{docker-compose.yml,.env,data/,powersync/,sql/,initdb/}

# 常用
docker compose -f /app/iboard-prod/deploy/prod/docker-compose.yml --env-file /app/iboard-prod/deploy/prod/.env ps
bash /app/iboard-prod/scripts/deploy/prod.sh
curl -s https://iboard.honor3.com/api/health

六、已知遗留

  • dev-0.2.1 / dev-windows-0.1 两个 worktree 分支内容已全部并入 dev-0.2，可择机删除。
  • tmp-offline-edit 分支 = 1cd5b85，历史遗留，可删。
  • 临时测试脚本 scripts/_browser-test.mjs、scripts/_shell-offline-test.mjs 含真实口令，不要入库。
  • 0.2.1 验证库里可能残留测试任务（浏览器验证任务 / IBOARD-8），迁移后建议清理。
  • node_modules 曾在多种 Node 版本间切换，如遇 esbuild 权限报错，清 node_modules 重装即可。
Reference in New Issue View Git Blame Copy Permalink