Skip to content

v0.11.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 06:29
· 468 commits to main since this release

这一版的主要内容

公告二期(#190 / #191)。

  • 发布范围:按部门(含下级)/ 角色 / 指定人发;后来进部门的人自动在范围内。铃铛、详情、附件下载三处看的是同一份范围
  • 定时发布 / 到期自动撤回
  • 登录后弹窗,可以设成「必须确认」—— 只能点「我已阅读」关掉,「全部已读」不能替人确认
  • 顶部横幅:置顶 + 紧急 + 还没读的公告;关掉就算已读
  • 登录页公告:勾了「公开」的公告在登录页显示纯文本摘要(匿名接口,每个 IP 每分钟 30 次);有发布范围的公告不能公开
  • 阅读统计:在管理列表里看谁读了、谁没读
  • 新建的账号不再一登录就几十个红点(建号之前的广播算已读,还在发的「必须确认」公告除外)
  • 有发布范围的公告不推群机器人(群里是所有人)
  • 移动端:登录屏公告、登录后弹窗、首页横幅、详情页「我已阅读」;退出登录会清缓存,换账号不会看到上一个人的定向公告

升级

  • 有数据库迁移 ag000000noticephase2:pnpm db:upgrade,镜像部署时 migrate 服务会自动跑
  • 新增调度任务 notice.sync_inbox(每 60 秒)。定时发布和到期撤回都靠它,beat 和 worker 都要在跑
  • 要回滚的话,降级会先把「有发布范围的」和「还没到发布时间的」公告改成隐藏 —— 旧版本不认识这两样,不这么做就会当成全员公告立刻放出去

桌面客户端

fastapi-react-admin 的桌面客户端 —— 把 web 后台装进 Electron 外壳,
提供浏览器给不了的四件事:静默打印、本地硬件、凭据托管、自动更新。
后台本身(页面、权限、多页签)和浏览器版是同一份代码。

下哪个

平台 文件 说明
Windows 10/11 x64 admin-desktop-<版本>-setup.exe NSIS 安装向导,装到当前用户(%LOCALAPPDATA%\Programs),不需要管理员
macOS Apple Silicon ...-arm64.dmg M1 及以后
macOS Intel ...-x64.dmg(文件名不带 arm64)
Linux x64 ...-x86_64.AppImage chmod +x 后直接运行,不用装

.blockmap 与 latest*.yml 是自动更新用的,人不需要下载。

装完第一件事:填后端地址

首次启动会让你填服务器地址(如 https://admin.example.com)。它是运行期配置,
存在用户目录里 —— 所以同一个安装包可以连不同环境,不用为每个环境各打一版。

已知限制(都是刻意的取舍,不是漏做)

  • 🔴 所有平台的包都没有代码签名。
    • Windows:SmartScreen 会拦一次 →「更多信息」→「仍要运行」
    • macOS:Gatekeeper 会说**「已损坏,应移到废纸篓」**。这不是包坏了,是没有公证:
      右键 →「打开」,或者 xattr -dr com.apple.quarantine /Applications/Admin\ Desktop.app
    • Linux:AppImage 不需要签名
    • 想去掉这些提示:Windows 侧有面向开源项目的免费证书方案(SignPath Foundation),
      macOS 侧没有免费路,需要 Apple Developer Program($99/年)
  • 🔴 macOS 上的自动更新不工作(未签名)。electron-updater 要校验运行中应用的代码签名,
    拿不到就拒绝安装更新。Windows 与 Linux(AppImage) 的自动更新正常
  • 读卡器等本地硬件是桩模式:厂商的原生助手不在仓库里(那是现场的东西),
    所以这个包里没有。界面上相关功能会走模拟数据
  • 打印:Windows 上是真的静默打印;macOS/Linux 上打印链路能跑,但没有在真机标签机上验过

更新从哪来

默认读这个仓库的 Release。内网部署(客户出不去公网)可以在客户机的 config.json 里
填 updateUrl,指向自己的静态目录 —— 不用为内网单独打一版。


What's Changed

  • feat(notice): 公告二期 —— 发布范围 · 定时发布 · 登录后弹窗 / 必须确认 · 顶部横幅 · 登录页公告 · 阅读统计(#190) by @yilecoding in #191

Full Changelog: v0.10.0...v0.11.0