2026/10/16 2:33:20

DooTask 系统设置页面总览:管理员后台 6 大 Tab 配置全指南

DooTask 系统设置页面总览:管理员后台 6 大 Tab 配置全指南 后端前端协同办公即时通讯企业应用【免费下载链接】dootaskDooTask是一款开源在线项目任务管理工具提供各类文档协作工具、在线思维导图、在线流程图、项目管理、任务分发、即时IM文件管理等工具同时消息功能使用非对称加密技术让你的沟通更安全。项目地址https://gitcode.com/gh_mirrors/do/dootask点击查看免费下载导读DooTask 的系统设置是管理员集中维护全局配置的一级菜单从注册策略、密码强度到任务优先级、列模板再到消息加密、文件打包下载与 WebDAV所有影响全系统行为的开关都汇聚在此。本文以官方「系统设置页面总览」文档为骨架逐 tab 拆解字段含义、默认值与操作步骤并结合 SystemController.php 等后端源码说明每个配置项在服务端的校验与生效机制帮助你作为管理员快速定位配置入口、理解边界并安全落地。入口与权限谁能看到「系统设置」桌面端路径左上角头像 → 下拉菜单 →「系统设置」仅管理员可见→ 左侧子菜单选「系统设置」一级项打开后是「左侧子菜单 右侧表单」的二级页面。移动端通常不展示「系统设置」入口需使用桌面端或浏览器后台。权限要求需要admin身份才能打开整页其中 License 子项仅超级管理员可改。普通成员end-user在左侧栏看不到该入口。额外环境门槛部署环境变量SYSTEM_SETTINGdisabled时所有保存操作一律被拒绝返回「当前环境禁止修改」该开关在 config/dootask.php 中由env(SYSTEM_SETTING)读取演示环境常用此方式锁死配置。6 个 Tab 一句话目录「系统设置」一级页打开后顶部是 6 个并列的 Tab对应同一 URL 下按领域整理的设置表单默认进入「基础设置」。每个 Tab 底部只有一组「提交 / 重置」一个 Tab 涉及多类配置时提交会依次调用对应接口并统一反馈结果。Tabname内容配套指南基础设置general系统别名和仪表盘欢迎语通用设置帐号与安全account注册方式、临时帐号、登录验证码和密码策略注册策略、密码策略项目设置project项目创建与邀请权限、部门负责人视角、项目模板列模板任务设置task任务默认规则、提醒、AI 分析、任务优先级及流转设置任务优先级、任务流转、AI 任务分析、任务可见性消息设置message群聊、私聊、匿名消息、加密、撤回和待办权限端到端加密、撤回与编辑时长、待办设置权限文件与存储file上传与媒体处理、打包下载权限和 WebDAV文件设置、上传大小限制、视频转码与压缩、WebDAV注意这 6 个 Tab 只是「系统设置」一级菜单内的内容邮件、AI、签到等是同级别的其他左侧菜单项不在这个页面内详见下文「同级菜单」。基础设置 Tabgeneral系统别名与欢迎语对应后端POST api/system/setting参数typesave提交核心字段system_alias— 系统名称别名同时显示在 Web、桌面端和移动端登录页的Welcome标题中。system_welcome— 仪表盘欢迎语。login_logo— 登录页 Logo支持上传、预览和删除删除后恢复内置 DooTask Logo。存储细节当system_alias与部署默认应用名称config(app.name)相同时服务端会用空值存储以表示「沿用默认名称」但保存响应和后续读取仍返回实际默认名称SystemController.phpsystem_welcome等于默认文案欢迎您{username}时同样归一为空串。login_logo入库前会经Base::unFillUrl()剥离完整 URL读取时再补全。帐号与安全 Tabaccount注册与密码策略注册策略reg取值含义open允许任何人在登录页注册invite仍可注册但注册时必须填邀请码close禁止注册登录页不显示注册入口配套字段reg_invite— 邀请码。reginvite时显示留空保存后系统自动生成随机码Base::generatePassword()不会真的「无码可用」也不能完全关闭「凭码注册」模式。邀请码全局唯一且仅对admin可见普通用户读取时服务端会 unset 该字段SystemController.php。reg_identity— 新注册用户身份normal正常帐号权限与已有成员一致/temp临时帐号受 5 项限制禁止查看共享文件、禁止发起会话、禁止建群、禁止打电话、禁止打包下载文件。temp_account_alias— 临时帐号别名用于在用户列表展示区别。login_code— 登录验证码策略。限制只支持三档枚举不支持按邮箱域名白名单临时帐号创建后无法在线一键转为正常帐号不能区分电脑端 / 移动端的注册开关。密码策略password_policy档位长度复杂度要求simple默认≥ 6 位无complex≥ 6 位必须混合不能全是数字、不能全是字母、不能仅数字大写、不能仅数字小写通用约束密码长度上限固定 32 位。策略只在「设置密码」「修改密码」「注册」时校验改成complex后存量用户登录不受影响旧弱密码仍可用、下次主动改密必须满足新规则、管理员代设密码同样要遵守。没有「强制重置全员密码」按钮需管理员手动通知。不支持自定义正则、按账号 / 部门差异化。项目设置 Tabproject项目模板与部门负责人视角列模板columnTemplate创建项目预置列对应后端POST api/system/column/templatetypeget读取、typesave写入限 admin。模板就是「模板名 列名清单」例如内置「研发任务」模板列待办、进行中、待测试、已完成新建项目勾选后自动生成这 4 列。保存时上传list数组[ { name: 研发任务, columns: 待办,进行中,待测试,已完成 }, { name: 市场活动, columns: 策划,执行中,复盘 } ]name— 模板名必填columns— 逗号分隔的列名字符串服务端处理任何缺name或columns的条目会被跳过columns按,切分 → 去重 → 去空后落库为数组SystemController.php最终为空数组直接报「参数为空」。操作要点删除行先保留在当前表单点击「提交」后才会生效「重置」可撤销未提交的删除系统至少保留一个模板。模板只控制「初始列」不能预置任务卡、流程、负责人修改模板不影响已创建项目仅影响后续新建新建项目对话框的「选择模板」下拉即此列表选模板后按列名顺序生成空列。其他项目相关字段project_invite/project_add_permission/project_add_userids— 项目创建与邀请权限。department_owner_project_view— 部门负责人是否能看下属项目部门负责人视角开关。任务设置 Tabtask优先级、流转、AI 分析与可见性任务优先级priority全系统共享清单对应后端POST api/system/prioritytypeget读取普通用户也可读、typesave写入限 admin。每条优先级有名称、颜色、自动截止天数、排序权重任务创建时下拉里出现的就是这套清单。保存时上传list数组{ name: 紧急, color: #FF4D4F, days: 1, priority: 100 }字段说明name显示名必填colorHex 颜色码用于卡片左边色条 / 标签days自动建议截止天数创建任务时按「今天 days」预填截止priority排序权重数字越大越靠前源码支撑服务端调用Setting::normalizeTaskPriorityList()校验并归一化Setting.php——name/color 为空或priority 0的条目被剔除is_default标记保证有且仅有一个默认项未显式标记时第一项为默认空数组拒绝保存SystemController.php。默认数据首次访问返回「紧急 / 高 / 普通 / 低」四档修改保存后覆盖默认。删除默认优先级后剩余第一项自动成为默认项。限制不能按项目维度独立配置不支持按优先级自动指派负责人 / 自动通知 / 触发自动化规则删除某优先级后已使用它的旧任务仍保留旧名称不会自动迁移。任务流转与部门指派权限project_task_handoff*设置选项默认任务流转开启、关闭关闭部门视角指派权限关闭、仅部门负责人、部门负责人及部门管理员仅部门负责人可指派人员范围管理部门范围内的项目成员、项目内全部成员管理部门范围内的项目成员原负责人调整范围仅调整管理范围内负责人、允许调整全部负责人仅调整管理范围内负责人指派留言要求选填、必填选填设置键依次为project_task_handoff、project_task_handoff_role、project_task_handoff_candidates、project_task_handoff_adjust、project_task_handoff_note由系统设置接口统一读写每项取值在 ProjectTaskHandoffSettings.php 中定义为白名单首个值为默认非法值保存时被拒绝返回「流转设置选项无效」SystemController.php。总开关开启才显示其余配置及任务详情「流转」标签关闭不删除记录原有任务操作及变更留痕继续工作。候选人和原负责人调整范围仅约束部门视角新增授权不收紧原有项目角色权限留言要求仅约束流转窗口人工指派不阻断原负责人编辑、领取或自动工作流。不支持非项目成员指派、审批、接单或通过部门权限查看私密任务。AI 任务自动分析task_ai_auto_analyze开关枚举open/close默认open需应用市场已安装 ai 插件。触发链路在 AiTaskLoopTask.php 中有完整实现共三道闸检查ai插件是否安装Apps::isInstalled(ai)未装直接返回检查系统级开关task_ai_auto_analyze为close直接返回拉取待处理新任务仅主任务、1 天内、无 AI 事件记录每批 5 条对每个任务再检查项目级开关ai_auto_analyze为close则跳过全过才投递异步任务AiTaskAnalyzeTask进行分析。产出为「建议」形式如优先级、负责人、子任务拆分建议不会自动改任务字段不回溯历史任务不能选择分析所用模型用 AI 插件配置的默认模型。任务可见性选项task_visible枚举open/close默认close。注意该字段只控制任务详情 UI 上「可见性」控件是否常驻显示不是 ACL 配置。取值UI 文案含义open保持任务详情页始终显示「可见性」字段用户每次都能看到当前可见范围与切换入口close自动仅当任务可见性为非默认值或处于「合并项目」上下文时才显示默认情况下控件隐藏任务的真实可见范围由任务自身visibility_*字段决定新建时按所在项目继承默认值本开关不重写任何任务的可见性数据历史任务范围不变。消息设置 Tabmessage待办权限、撤回编辑与端到端加密待办设置权限todo_set_permission枚举open/close默认open。这是消息 → 待办聊天里把某条消息变成 todo的权限开关与项目任务无关。取值UI 文案含义open允许群里所有成员都能把某条消息设 / 取消为他人待办close禁止只有本人、系统管理员、群主或群管理员、项目负责人或项目管理员、任务负责人能给他人设 / 取消待办无论开关如何「给自己」设 / 取消 todo 永远允许。后端在两处校验WebSocketDialogMsg::toggleTodoMsgWebSocketDialogMsg.php与DialogController::msg__todo_indicate关闭时调用WebSocketDialog::checkTodoOwnerPermissionWebSocketDialog.php校验不通过则报「仅群主、项目/任务负责人或系统管理员可设置或取消他人待办」。全局生效不能按群 / 项目差异化。撤回与编辑时长上限msg_rev_limit/msg_edit_limit单位分钟整数默认留空 等价「不限制」。后端用intval()取值 0时不做限制留空、写0、写负数都按「不限制」处理写正整数N则消息发出 N 分钟后不可撤回 / 编辑。超时后服务端抛「已超过 X 分钟此消息不可撤回 / 修改」系统管理员同样受限没有「管理员强撤」旁路。不支持按会话类型分别设阈值、不能给特定角色开特权、最小粒度 1 分钟。端到端加密e2e_message开关枚举open/close默认close。开启后下列接口的请求体在客户端加密后再发往服务端users/login、users/editpass、users/operation、users/delete/accountusers/bot/*、system/licensedialog/msg/*— 所有消息收发私聊、群聊、文件消息等WebSocket 通道在握手后用 PGP 公钥协商一次会话密钥再传输调试环境window.systemInfo.debug yes下跳过协商。注意不区分私聊 / 群聊是否走 e2e 取决于接口而非会话类型不追溯历史消息关键词搜索不能搜到传输中的密文已落库明文仍可搜撤回 / 编辑时长由msg_rev_limit/msg_edit_limit决定与 e2e 无关。文件与存储 Tabfile打包下载、上传限制、视频处理与 WebDAV打包下载权限permission_pack_type/permission_pack_userids对应后端POST api/system/setting/fileSystemController.php服务端只接受这两个字段其他键自动剔除。字段取值 / 说明permission_pack_typeall所有用户可用默认/admin仅系统管理员 /user仅名单内用户 /close全员禁用permission_pack_userids数组typeuser时生效的白名单用户 ID 列表原因大文件夹打包会占大量磁盘和带宽需要按需限制。影响文件中心 / 项目附件 / 群聊文件等所有「文件夹批量下载」入口即使有打包权限被打包的文件仍需用户对单文件有可见权限无权部分自动跳过。不控制单文件下载单文件下载由文件本身可见性决定。单文件上传大小限制file_upload_limit整数单位MB默认留空前端 placeholder 显示「默认 1G」。生效逻辑见 Base.php调用方未显式传size时先取file_upload_limit为空则按1024 MB1G兜底超过则报错「文件大小超限最大限制N KB」。分片上传路径 ChunkUpload.php 同样读取该值。作用于聊天消息附件、任务附件、「文件」应用上传等所有走Base::upload的入口。与分片上传的关系前端 ≥ 10MB 自动走分片上传单分片 5MB提高file_upload_limit后可突破老的 1G 限制例如填5120可上传 5G 视频受磁盘 / 内存等部署能力约束。留空只是「应用层不限制」仍受 Nginx / PHP 等 web 服务器层上限约束不能按用户 / 部门差异化。视频转码与压缩convert_video/compress_video两个开关默认均为close字段作用触发条件convert_video把MOV、WEBM转成MP4提升跨端兼容性上传后缀为 mov 或 webmcompress_video对MP4做压缩减小体积上传 / 转码后产物为 MP4组合关系只开转码 → MOV/WEBM 转 MP4原始码率只开压缩 → MP4 直接压缩都开 → 先转再压都关 → 原样保存。开启代价服务端需要 ffmpeg容器化部署默认包含转码占用 CPU 与临时磁盘用户上传后有「视频处理中」等待时间。原文件被产物替代入库原始 MOV / WEBM 不保留。不能按大小阈值触发、不能自定义分辨率 / 码率 / 编码器、不回溯历史视频。WebDAVapi/file/dav/*管理员启用与配置项启用 WebDAV全局协议开关关闭后/dav/立即停止服务。允许范围「所有人」或「指定成员」被停用账号始终不能使用。每人应用密码上限1 至 20 个有效凭据。默认有效期 / 最长有效期最长上限 3650 天。保存用管理接口api/file/dav/adminsetting运行状态接口api/file/dav/adminstatus提供有效凭据数、活动锁数和路径冲突数冲突明细接口api/file/dav/conflicts分页返回冲突路径、拥有者、文件 ID 及管理员基于现有文件权限能否打开文件位置。启用流程要点外部地址须为 HTTPS生产环境 DAV 协议入口拒绝明文 HTTP存在有效文件路径冲突时服务端硬性拒绝开启需处理冲突重命名或删除同组文件并「刷新检测」确认清零后才可提交通知获准用户从「文件」页右上角「···」自行创建应用密码管理员不代替生成或查看密码。安全与运维用户应用密码以不可逆哈希保存仅创建时返回明文撤销凭据后其锁记录同步失效DAV 请求有独立操作审计请求 ID、用户、凭据、方法、路径、状态、流量、来源 IP、耗时用户访问被限制在files/与shared/两个虚拟根实际读写仍逐项执行现有文件权限单文件大小、锁超时和复制节点数还受服务端硬限制界面配置不能突破部署侧限制。同级菜单不在这 6 个 Tab 内左侧子菜单的其他独立项包括详见 系统设置入口通用— 注册策略、密码策略、消息撤回时长、自动归档等邮件— SMTP 服务器、注册验证邮件、未读消息提醒会议— 声网 Agora 参数会议设置AI 设置— AI 模型供应商AI 模型AI 机器人— 关联机器人与默认模型AI 机器人签到— 打卡规则、地理围栏、人脸签到APP 推送— UMENG iOS/Android 推送配置第三方接入— LDAP / OAuth第三方接入License— 终端授权仅超管可改这些配置同样全部全局生效不下放到项目级或部门级。后端接口与保存机制一次提交背后的调用链所有 Tab 的保存最终都落到几个系统接口理解它们有助于排查「为什么保存失败」api/system/settingtypesave承载基础设置、帐号与安全、任务设置、消息设置的大部分字段。服务端先校验SYSTEM_SETTING环境开关再要求admin身份User::auth(admin)随后按白名单裁剪字段——不在 白名单列表 内的键会被unset这也是文档中「不在白名单内的字段会被服务端自动剔除」的出处auto_archivedopen时archived_day限制在 1–100 天超出直接报错。api/system/prioritytypesave限 admin空 list 或非法 list 分别报「参数错误」「参数为空」经normalizeTaskPriorityList归一化后写入settings.priority。api/system/column/templatetypesave限 admin逐条校验 name / columns去重去空后写入settings.columnTemplate。api/system/setting/filetypesave限 admin只接受permission_pack_type与permission_pack_userids两个键写入settings.fileSetting。api/file/dav/*独立承载 WebDAV 的启用、状态与冲突检测。页面行为一个 Tab 底部只有一组「提交 / 重置」同一 Tab 涉及多个配置接口时前端依次调用并统一反馈结果。除SYSTEM_SETTINGdisabled场景外保存即时生效、无需重启服务。常见边界与不支持项速查入口限制移动端不展示普通成员无入口SYSTEM_SETTINGdisabled时所有修改被拒绝。全局生效所有系统设置均不下放到项目级 / 部门级多套邀请码、按邮箱域名白名单、按会话类型差异化阈值均不支持。只影响后续列模板不回溯已建项目AI 分析不回溯历史任务视频处理不回溯历史上传密码策略不强制存量用户改密。有硬上限自动归档天数 1–100 天、密码长度上限 32 位、WebDAV 每人凭据上限 20 个、最长有效期 3650 天。删除类操作优先级、列模板的删除需「提交」才生效「重置」可撤销系统至少保留一个优先级和一个项目模板。与直觉相反的点file_upload_limit留空是「不限制」按 1G 兜底而非「禁止上传」task_visible只影响 UI 显示而非任务 ACLtodo_set_permission只约束聊天消息待办与项目任务指派是两套体系。赞分享后端前端协同办公即时通讯企业应用【免费下载链接】dootaskDooTask是一款开源在线项目任务管理工具提供各类文档协作工具、在线思维导图、在线流程图、项目管理、任务分发、即时IM文件管理等工具同时消息功能使用非对称加密技术让你的沟通更安全。项目地址https://gitcode.com/gh_mirrors/do/dootask点击查看免费下载相关推荐ARM 设置页面完全指南从系统总览到配置管理的 Web 控制台深度解析ARM 设置页面完全指南从系统总览到配置管理的 Web 控制台深度解析 导读 本文围绕 Automatic Ripping MachineARM自动抓取机音视频后端DooTask 管理员后台进不去排查指南系统管理员与超级管理员两级权限体系全解析DooTask 管理员后台进不去排查指南系统管理员与超级管理员两级权限体系全解析 本文基于 DooTask 官方知识库 FAQ《进不了管理员区》围绕头像下后端前端协同办公即时通讯企业应用zag 状态管理核心 zag-js/store 深度解析Proxy 响应式实现、版本演进与实战用法zag 状态管理核心 zag js/store 深度解析Proxy 响应式实现、版本演进与实战用法 zag js/store 是 zag 设计系统框架中负前端UI组件上一篇3步精准调校AMD Ryzen处理器免费工具解锁隐藏性能的实战指南下一篇WarcraftHelper魔兽争霸3终极优化工具完整使用指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考