github/dootask
1
0
Fork 0
mirror of https://github.com/kuaifan/dootask.git synced 2026-08-01 19:05:55 +00:00
Code Issues Packages Projects Releases Wiki Activity
dootask/resources/ai-kb/zh/howto/application/menu-admin.md
kuaifan 9b14120055 fix(application): 自定义应用可见范围统一 app 顶层，修复全员可见失效与编辑回填重置 
前后端对 visible_to 存放层级约定不一致导致两个 bug：
- 新增应用设为全员可见，普通成员仍看不到（前端存在 menu 级，后端只认 app 级，落库恒回落为 admin）
- 再次编辑时可见范围被重置为"仅管理员"（响应无条件剥离 visible_to，回填丢失）

统一以 app 顶层为唯一权威来源：
- 前端保存时提到 app 顶层，回填时从 app 顶层读回（数组转下拉框字符串）
- 后端响应新增 keepVisible，管理员保存/读取场景保留 visible_to，普通成员仍剥离

同步 ai-kb application/menu-admin last_verified。
2026-07-13 23:54:23 +00:00

2.0 KiB
Raw Permalink Blame History

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified
id title type feature scope locale aliases related_tools related_pages prerequisites negative last_verified
application.menu-admin.howto 管理员自定义全员应用菜单 howto application admin zh
自定义应用菜单
给所有人加应用入口
加自定义微应用
全员可见的应用怎么配
microapp menu
application
当前用户为系统管理员（userIsAdmin）
仅管理员可见入口和保存接口
自定义菜单只是注册一个 URL/iframe 入口，DooTask 不托管业务页面
配置项里没有"权限继承项目角色"的开关
v1.8.64

管理员自定义全员应用菜单

是什么

管理员可以在应用中心追加自定义菜单项（iframe / 外链等），对应一个或多个全员/管理员可见的入口。底层调用 api/system/microapp_menu，保存到系统设置的 microapp_menu 项。

入口

  • 桌面端 / 移动端：应用中心右上角「⋯」→「自定义应用菜单」（普通成员看不到此项）

操作步骤

  1. 应用中心右上角「⋯」→「自定义应用菜单」
  2. 点「新增菜单」生成一张空白配置卡
  3. 填写必填字段：
    • 应用 ID（如 custom-okr）
    • 菜单标题
    • 菜单 URL（支持 {user_token} 等占位符）
  4. 调整可选项：菜单位置 / 可见范围 / 图标 / 类型（iframe / iframe_blank / inline / inline_blank / external）/ 背景色 / 保活 / 暗黑等
  5. 点「保存」提交，应用中心立即出现新菜单

关键字段

字段 取值 说明
菜单位置 application / application/admin / main/menu 决定卡片放在常用区、管理员区或顶部主导航
可见范围 admin / all 仅管理员或全员可见
类型 iframe / iframe_blank / inline / inline_blank / external 决定打开方式

不支持

  • 普通成员无入口，必须以管理员身份进
  • 不能精细到「按部门可见」，可见范围仅 admin / all 两档
  • 配置不会影响微应用插件本身，只是追加一层菜单