GO云启 OA · 协同办公前端

面向政企/中小团队的协同办公前端，基于 Vue 3 + Vite + Element Plus 二次定制，覆盖工作台看板、审批工作流（加签 / 退回 / 会签）、流程/表单设计器、组织人事、系统权限、应用中心与插件开关、系统参数、租户运营、公告管理、知识库、审计日志与附件离线预览。

设计语言：飞书式交互 + 政企配色，双栏导航（一级图标栏 + 二级菜单面板）
多标签页、动态路由、按钮级权限、状态字典全量中文化
复杂审批：串行 / 会签 / 或签 / 条件分支（排他网关） / 抄送 / 前加签与后加签 / 退回发起人或指定节点 / 退回后重新提交
附件：不依赖外网 Office 的离线预览（PDF 本地渲染 + 文本层检索）、图片相册、其余格式给出明确降级；签名地址过期前会静默续签，页面开多久都不需要手动刷新
知识库：企业文档与个人文件分类归档，支持按附件正文检索并高亮片段
安全底座：策略外置（密码/锁定/验证码/会话）、登录与操作日志哈希链完整性校验、附件签名访问
面向 SaaS：应用中心按租户开通、租户用量与账号配额可视化，平台管理员可切换租户视角

说明：本仓库只包含前端。后端服务不随仓库提供，前端只依赖稳定的 HTTP 契约，见后端对接。截图数据来自本地演示环境。

界面预览

审批中心 · 收件箱	审批详情 · 会签进度

流程设计器（vue-flow）	表单设计器

角色与权限	登录日志

个人中心	登录页

知识库 · 文档库（封面缩略图）	知识库 · 图片全屏预览

应用中心（按租户开通）	插件管理（停用即拒绝接口）

系统参数 · 安全策略	审计日志 · 哈希链校验

菜单管理 · 图标选择器	知识库 · 附件正文检索

审批详情 · 加签 / 退回	加签弹窗（前加签 / 后加签）

退回后 · 发起人重新提交（沿用原单号）

登录页 · 算术图形验证码（策略要求时自动出现）	登录页 · 连续失败锁定倒计时

流程设计器 · 条件分支清单与优先级	分支条件编辑器（字段来自关联表单）

设计器卡片 · n8n/Dify 风格与治理角标	动态审批人来源（主管链与表单字段）

节点级字段权限（可见/可改/必填）	一键插入连线与自动分层布局

功能特性

工作台

可视化看板：审批趋势（双序列折线）、状态分布环形图、部门人数、流程使用排行、最近审批动态、快捷发起
图表使用手写 SVG 组件，不依赖 ECharts

登录与账号

品牌主视觉登录页：左侧能力展示 + 右侧账号卡片，账号登录 / 申请账号双 Tab
记住密码、忘记密码说明、帮助中心/隐私政策/使用条款弹窗，移动端自适应
图形验证码：自绘 SVG 算术题，点图换一张；是否需要填写完全听后端策略（未要求时不占位）
锁定倒计时：账号被锁时在提交前就提示剩余分钟数，不让人反复试错

审批工作流

审批中心采用「收件箱」布局：左侧按时间分组卡片 + 右侧内联预览，支持不打开弹窗直接审批
六类视图：我发起的 / 我待办的 / 我已办的 / 抄送给我的 / 已通过 / 已取消
流程设计器（vue-flow）：拖拽连线、条件分支按连线判定（字段+操作符+值，支持 AND/OR 与默认分支）、分支顺序可调、连线标签自动汇总
审批详情抽屉：流程时间轴（节点类型、会签/或签/串行、审批人与状态、节点耗时）、评论与附件、打印、撤销、重新发起
审批动作：加签（前加签 / 后加签）、退回（发起人 / 上一步 / 指定节点）、退回后重新提交（沿用原单号）
任意一人审批（或签）节点不支持加签：按钮置灰并给出原因，后端同样拒绝
发起审批：表单填写 + 审批人/抄送人调整 + 本地草稿

流程与表单设计

流程设计器（vue-flow）：
- 现代卡片：n8n / Dify 风格，无生硬 border-left 色条，四边等宽，图标芯片与类型标识清晰区分，卡片内置治理角标（超时/去重/兜底）；
- 交互减负：卡片内一键「+ 插入下一步」并自动连线，画布顶部配置引导条集中提示未配置项并支持一键定位，一键「自动布局」拓扑分层对齐；
- 动态审批人：支持 5 种运行时解析规则（发起人直属上级、发起人部门主管向上递归、连续多级上级、表单人员字段、指定部门主管）；
- 节点级治理：节点超时处理（仅提醒/自动通过/自动驳回/转交）、空审批人策略（报错/跳过/转交管理员/转交指定人）、审批人去重（不去重/签过自动通过/跳过待办/转回发起人）；
- 字段级权限：节点级配置表单字段可见、只读、必填，审批端按节点精确控制表单修改与校验；
- 条件分支：基于连线的排他分支判定（支持多字段组合 AND/OR、操作符与默认兜底分支）。
表单设计器：三栏布局（字段库 / 画布 / 属性），支持 12+ 字段类型，含子表格与附件上传

系统与组织

系统管理：用户、角色（菜单授权 / 权限授权）、菜单（树形）、权限、日志（登录 / 操作）
人事：部门组织树、职位、邀请码、员工档案、通讯录
账号安全：登录会话控制、个人资料、头像上传、修改密码

知识库 / 资料库

左侧分类树 + 右侧文档列表，企业文档全员可见、个人文件仅本人可见
文档封面取首个图片附件，列表以方形缩略图展示；详情附件区图片为缩略图网格，点击调用 el-image 全屏预览（支持左右切换、缩放）
文档附件统一存 fileId，展示时换取签名地址；预览方式由后端判定：图片走相册、PDF 本地渲染、其余格式弹窗说明并给出下载
PDF 预览内置文本层：可选中复制、按关键词高亮、上一处/下一处跳转；pdf.js 与 worker 全部本地打包（无 CDN）
知识库支持搜正文：关键词命中附件内容时返回片段并高亮，适合扫描件以外的合同/通知类文档
分类管理：树形上级选择、按归属范围（企业 / 个人）划分，删除前校验无子分类与无文档
菜单 / 分类等图标字段统一使用 AppIconPicker（从已注册图标中搜索挑选，避免手输字符串导致图标不渲染）

平台能力

应用中心：按租户展示已开通 / 可开通应用，核心应用不可停用；停用后菜单不再下发、接口直接拒绝
插件管理：平台应用目录与各租户开通状态（来源为代码注册表，新增应用自动出现在这里）
数据字典：左列表右字典项，内置枚举只读、业务字典可视化维护；useDict(code) 供页面按编码取用
系统参数：按分组维护站点信息、安全策略、附件限制与审批规则，支持整组批量保存
租户运营：租户列表 / 开通 / 编辑 / 切换租户视角，用量抽屉展示账号配额与存储占用
公告管理：部门树多选发布、送达与已读统计、撤回（联动清理已下发通知）、详情抽屉
数据导出：审批实例、登录日志、操作日志、员工花名册，按当前筛选条件导出 Excel

安全与审计

策略外置：验证码开关与失败阈值、密码规则与有效期、登录锁定、并发会话数、审计链算法均在后端参数里，前端只按接口返回行事
登录安全：算术验证码（可开关）、连续失败锁定、首次登录 / 密码过期引导改密
审计完整性：登录日志与操作日志支持哈希链校验，页面直接展示校验结果与断链位置
附件访问：签名地址带时效（默认 15 分钟），/files 静态直读已关闭；业务数据只存 fileId

交互与工程

动态路由（后端菜单驱动）、多标签页（右键菜单）、面包屑、全局搜索（Ctrl K）、消息中心
按钮级权限指令 v-auth 与 usePermission
统一字典层：状态/枚举全部映射中文，未收录值回退「未知状态」，不会把英文码暴露给用户

技术栈

分类	选型
框架	Vue 3.5（`<script setup>`）、TypeScript
构建	Vite 6
UI	Element Plus 2.9（全量引入 + SCSS 覆盖层）
状态	Pinia
路由	Vue Router 4（动态路由 + 多标签）
请求	Axios 封装（业务码处理、无感刷新 token）
流程图	@vue-flow/core + background + controls + minimap
样式	SCSS + CSS 变量设计令牌 + Tailwind 3（少量工具类）
图标	@iconify/vue 离线注册表（ep / ri / fa-solid）
附件预览	pdfjs-dist 6（legacy 构建，主包与 worker 均本地打包，兼容旧内核）
工具	dayjs、lodash-es、qs、js-cookie、nprogress、@vueuse/core

快速开始

要求：Node.js ≥ 18、pnpm ≥ 8。

pnpm install
pnpm dev        # http://localhost:8849
pnpm typecheck  # vue-tsc 类型检查
pnpm build      # 产物输出 dist/
pnpm preview    # 预览构建产物

环境变量

复制并按需修改 .env.development：

变量	说明	本地示例
`VITE_PORT`	开发端口	`8849`
`VITE_PROXY_TARGET`	业务接口代理目标（含附件与导出）	`http://127.0.0.1:8000`
`VITE_FILE_PROXY_TARGET`	附件代理目标（仅老后端仍用 `/files` 时保留）	`http://127.0.0.1:8000`
`VITE_WS_PROXY_TARGET`	WebSocket 代理目标	`ws://127.0.0.1:8000`
`VITE_FILE_BASE_URL`	附件额外域名前缀，新后端建议留空（附件与接口同源）	空
`VITE_ROUTER_HISTORY`	路由模式（`h5` / `hash`）	`h5`
`VITE_PUBLIC_PATH`	部署公共路径	`/`

没有后端时页面可以打开，但登录与数据依赖后端接口；仓库不内置 mock 服务。

目录结构

new-web
├─ docs/screenshots/          # README 截图
├─ public/                    # 静态资源（favicon、logo）
├─ src
│  ├─ api/                    # 接口层（按业务域拆分，路径与后端一一对应）
│  ├─ assets/icons/           # iconify 离线图标注册表
│  ├─ components
│  │  ├─ app/                 # App* 基础组件（页面容器/表格/表单弹窗/状态标签/图标选择器…）
│  │  ├─ charts/              # SVG 图表（趋势/环形/条形）
│  │  ├─ file/                # FilePreview：统一附件离线预览（pdf.js）
│  │  └─ workflow/            # 审批领域组件（详情/时间轴/表单渲染/附件…）
│  ├─ composables/            # useTable（列表分页）/ useFilePreview（预览宿主）/ usePermission
│  ├─ directives/             # v-auth / v-perms / v-copy
│  ├─ layout/                 # 布局：双栏导航、导航栏、多标签、主区域
│  ├─ router/                 # 静态路由 + 后端菜单转动态路由
│  ├─ store/                  # app / user / permission / multiTags / settings
│  ├─ styles/                 # 设计令牌、Element Plus 覆盖、布局与工具类
│  ├─ utils/                  # http、dicts/dictStore、export、workflow、storage…
│  └─ views/                  # 页面（路径与后端菜单 component 一一对应）
│     ├─ system/              # user / role / menu / permission / dict / config / tenant / announcement / plugin
│     ├─ engine/              # workflow / instance / designer / form
│     ├─ hr/                  # dept / position / employee / invite / contacts
│     ├─ kb/                  # 文档库 / 分类管理
│     ├─ appcenter/           # 应用中心（按租户开通）
│     └─ log/                 # login / operation（含哈希链校验）
├─ nginx.conf                 # 生产部署参考
├─ doc.md                     # 开发记录与验收说明
└─ vite.config.ts

后端对接

仓库不包含后端，前端只依赖稳定的 HTTP 契约。默认前缀 /api/v1，除登录外均需 Authorization: Bearer <accessToken>。

鉴权与用户

方法	路径	说明
POST	`/auth/login`	入参 `{ username, password, platform }`，返回 `data.{ accessToken, refreshToken, expireAt, user }`
POST	`/auth/logout`	注销当前会话
POST	`/auth/refresh-token`	刷新 token
GET	`/sys/menu/user`	当前用户菜单树（`data.tree`）
GET	`/sys/user/permissions`	当前用户按钮权限

user 至少包含：id、username、nickname、employeeId、avatar、departments、is_super。

菜单节点字段：path、component、name、meta.{ title, icon, showLink, keepAlive, rank, frameSrc }、children。前端按 component 路径匹配 /src/views/** 文件，并依赖 name 与组件 defineOptions({ name }) 一致实现 keep-alive。

工作流

方法	路径	说明
GET	`/workflow/definition/list`	流程定义列表
GET	`/workflow/form-design/list` / `/{id}`	表单列表 / 详情
POST	`/workflow/instance/initiate`	发起审批
GET	`/workflow/instance/my-initiated`	我发起的
GET	`/workflow/task/my-pending` / `my-completed`	待办 / 已办
GET	`/workflow/cc/my-list`	抄送给我的
GET	`/workflow/instance/{id}`	实例详情（含 `processTimeline`）
GET	`/workflow/instance/{id}/permission`	当前用户对该单的权限（`canApprove / canAddSign / canReturn / canResubmit`、`pendingTaskId`、`pendingApproveType`）
POST	`/workflow/task/{taskId}/approve` / `reject`	同意 / 拒绝
POST	`/workflow/task/{taskId}/add-sign`	加签：`{ signType: before\|after, addSignerIds, comment }`
POST	`/workflow/task/{taskId}/return`	退回：`{ returnType: initiator\|previous\|specified, returnTo?, comment }`
POST	`/workflow/instance/{instanceId}/resubmit`	退回后重新提交（仅发起人）：`{ formData }`
POST	`/workflow/instance/cancel`	撤销

审批节点约定：

approveType：ORDER_SIGN（串行）/ ALL_SIGN（会签）/ ANY_SIGN（或签）
实例状态：running / approved / rejected / cancelled / returned（returned = 已退回发起人，等待修改后重新提交）
节点级"部分完成"由任务状态表达，不要新增实例状态；退回时旧任务行置 returned 保留审计痕迹
加签仅对会签/串行节点开放；或签节点一人通过即完成，加签没有语义，后端会拒绝

平台能力

方法	路径	说明
GET	`/sys/dict/list`	字典列表（`data.{ list, total }`）
GET	`/sys/dict/items?dictCode=`	按编码取字典项（`data.{ dictCode, dictName, items }`）
GET	`/sys/dict/options?codes=a,b`	批量取多项（`data.dicts[code] = items`）
POST / PUT / DELETE	`/sys/dict`、`/sys/dict/{id}`	字典增删改（内置字典不可删）
POST / PUT / DELETE	`/sys/dict/item`、`/sys/dict/item/{id}`	字典项增删改
GET	`/sys/config/groups`	参数分组（`data.groups[].{ code, name, count }`）
GET	`/sys/config/list?group=`	分组下的参数列表
POST	`/sys/config/batch`	批量保存：`{ group, items: [{ configKey, configValue }] }`
GET	`/sys/config/public`	无需管理权限的公开参数（站点名称、客服电话等）
GET	`/announcement/list`	公告列表（含 `deptNames`、`targetCount`、`readCount`）
POST	`/announcement`	发布公告：`{ title, content, deptIds }`，后端递归下发子部门
POST	`/announcement/{id}/withdraw`	撤回并清理已下发通知
DELETE	`/announcement/{id}`	删除（仅已撤回）
GET	`/sys/tenant/current`	当前租户
GET	`/sys/tenant/list`	租户列表（平台管理员）
POST	`/sys/tenant`	开通租户：租户 + 根部门 + 管理员账号
PUT	`/sys/tenant/{id}`	编辑租户（停用会作废该租户会话）
POST	`/sys/tenant/{id}/switch`	切换租户视角（返回新 token，前端需重新登录态）
GET	`/sys/tenant/usage`	用量与配额（不传 `tenantId` 即当前租户）
GET	`/sys/plugin/list`	平台应用目录 + 各租户开通状态（平台管理员）
GET	`/sys/plugin/mine`	当前租户可用应用（应用中心）
PUT	`/sys/plugin/{code}/status`	按租户开通 / 停用应用
POST	`/sys/log/verify`	审计哈希链校验：`{ type: login\|operation, ... }`，返回是否断链与断链位置

知识库

企业文档全员可见、个人文件仅本人可见；附件复用签名地址机制，业务侧只存 fileId。

方法	路径	说明
GET	`/kb/category/list`	分类列表（平铺，前端按 `parentId` 组树）
POST / PUT / DELETE	`/kb/category`、`/kb/category/{id}`	分类增删改（仅管理员）
GET	`/kb/doc/list`	文档列表（`page/pageSize/keyword/categoryId/scope/mine`，返回 `cover` 封面签名地址）
GET	`/kb/doc/{id}`	文档详情（含 `attachments` 签名地址）
POST / PUT / DELETE	`/kb/doc`、`/kb/doc/{id}`	文档增删改（`fileIds` 绑定已上传附件）
POST	`/kb/doc/{id}/publish`	发布到企业库（需 `kb:doc:publish`）
POST	`/kb/doc/{id}/archive`	归档 / 取消归档
POST	`/kb/doc/{id}/view` / `download`	浏览 / 下载计数（download 返回签名地址）

数据导出

导出接口直接返回 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet 文件流， 经过统一 http 封装会被当成 JSON 解包，因此 utils/export.ts 使用独立 axios 实例请求，并从 Content-Disposition 解析文件名（优先 filename*=UTF-8''）。

路径	说明
`GET /export/workflow-instances`	审批实例（支持 `status / keyword / mine / startAt / endAt`）
`GET /export/operation-logs`	操作日志
`GET /export/login-logs`	登录日志
`GET /export/hr-employees`	员工花名册

附件

上传 POST /common/file/upload 返回 data.file.{ id, fileName, fileUrl, fileSize, fileType }。

预览与检索（新增）：

方法	路径	说明
GET	`/common/file/{id}/preview`	预览元信息：`kind`（image/pdf/none）、`previewable`、`previewUrl`、`downloadUrl`、`message`、`textStatus`
POST	`/common/file/text-search`	附件正文检索：`{ keyword, fileIds }`，需管理员类权限（普通用户走知识库入口）
GET	`/kb/doc/search`	知识库正文检索：内部按可见范围收敛候选 fileId，返回命中片段

前端约定：能不能预览、用什么方式预览完全以 /preview 返回为准，不在前端按扩展名猜； PDF 已在本地渲染（FilePreview.vue，pdf.js legacy 构建），其余格式显示后端给的降级文案并提供下载。

访问约定（重要）：

fileUrl 是带时效的签名地址，形如 /api/v1/common/file/{fileId}/raw?expire=1700000000&sign=...，有效期由后端配置（默认 15 分钟）。可以直接用于 <img src> 或新窗口打开，无需额外携带 token。
不要把 fileUrl 写进业务数据（头像、表单字段、评论附件等）。需要长期引用时保存 fileId，展示前调用 GET /common/file/{id} 换取新的签名地址；审批详情与各列表接口已由后端自动完成重写，前端通常拿到的就是可用的签名地址。
旧版 /files/日期/文件名 静态路径已关闭，未签名访问会被拒绝（401/403）。
签名地址可被验证但不可伪造：缺参数、篡改 sign、超出 expire 均会返回业务错误。

设计系统

src/styles/tokens.scss 是唯一设计令牌来源：主色 #1F5AE0、页面底 #F5F6F8、圆角 4/6/8/12、动效 160/200ms
src/styles/element/vars.scss 用 SCSS color.mix 生成 Element Plus 五档色阶，只需改主色即可整体换肤
布局：app-nav-rail（72px 一级图标栏）+ app-nav-panel（208px 二级面板），折叠时仅保留图标栏且图标常显
领域组件统一 App* 前缀：AppPage / AppDataTable / AppFormDialog / AppStatusTag / AppEmpty / AppUserAvatar …

工程约定

views/ 路径与后端菜单 component 保持 1:1，避免动态路由失效。
路由 name 与页面组件 name 必须一致，否则多标签缓存（keep-alive）失效。
接口统一走 src/api/*，不要在页面里裸写 axios 路径（导出例外，见 utils/export.ts）。
状态/枚举统一在 src/utils/dicts.ts 维护，禁止把后端英文码直接渲染；业务枚举用 useDict(code)。
新增页面优先复用 AppPage、AppSearchBar、AppDataTable、AppFormDialog、AppFormDrawer；图标字段用 AppIconPicker，不要手输图标字符串。
树形选择必须设置 node-key：el-tree-select 开启 show-checkbox 后，勾选值的收集依赖 node-key，缺失时 v-model 会拿到 [null]（表现为标签空白、提交后提示未选择）。同理 el-tree 取值也要设。
文件类字段不落库访问地址：头像、附件一律存 fileId，展示时用接口返回的签名地址，否则签名过期后图片/附件必然失效。
权限码必须与后端权限目录一致：hasAuth('xxx') 里的码写错不会报错，只会让按钮永远不显示，新增/改名时请同步核对（超管因 *:*:* 不受影响，容易漏测）。
前端隐藏按钮不等于授权：高风险操作（改系统参数、删日志、批量导出、发公告）后端同样会校验权限码，前端只需保证体验一致，不要把权限当成安全边界。
状态字典要收录后端新增值：例如退回引入的 returned，漏收录会让时间轴与列表显示“未知状态”；新增状态时必须同步 utils/dicts.ts（Web）与 utils/dict.js（移动端）。
通用能力只保留一个宿主：附件预览挂在布局根组件，其他页面调 previewAttachment，不要每页各挂一份弹窗；能力上线前用全局检索盘点全部旧调用点（window.open、外链域名、<a href>）。

权限码对照

按钮权限码由后端权限目录下发，前端仅做展示控制；写错不会报错，只会让按钮永久隐藏。非超管账号的可见性完全取决于角色是否勾选了对应权限。

模块	编码
账号	`sys:user:add` / `edit` / `delete` / `resetPwd` / `assignRole` / `status` / `superSwitch`
角色	`sys:role:add` / `edit` / `delete` / `assignMenu` / `assignPermission`
菜单 / 权限	`sys:menu:add` / `edit` / `delete`、`sys:permission:add` / `edit` / `delete`
字典	`sys:dict:add` / `edit` / `delete`
系统参数	`sys:config:add` / `edit` / `delete`
租户	`sys:tenant:add` / `edit` / `switch`
公告	`sys:announcement:publish` / `withdraw` / `delete`
流程 / 表单	`engine:workflow:add` / `edit` / `delete`、`engine:form:add` / `edit` / `delete`
知识库	`kb:category:add` / `edit` / `delete`、`kb:doc:add` / `edit` / `delete` / `publish`
部门	`hr:dept:add` / `edit` / `delete`
职位	`hr:post:add` / `edit` / `delete`
员工	`hr:employee:add` / `edit` / `delete` / `account`（分配账号）
邀请码	`hr:invite:add` / `edit` / `delete`
日志	`system:login:delete`、`system:operation:delete`、`sys:log:verify`（完整性校验）
应用/插件	`sys:plugin:list` / `status` / `config`
附件检索	`sys:file:search`（正文检索通用入口，仅管理员类角色）
导出	`engine:instance:export`、`system:login:export`、`system:operation:export`、`hr:employee:export`

超管拥有 *:*:* 时前端 hasAuth 直接放行，因此用超管账号测不出权限码写错，排查非超管账号看不到按钮时，首先比对这里的编码与后端权限目录是否一致。

部署

pnpm build
# 将 dist/ 上传到服务器目录，参考 nginx.conf

nginx.conf 已包含：SPA 回退、index.html 不缓存、/static 强缓存、/api/v1、/swagger、/api.json 与 WebSocket 代理、gzip。

要点：附件与导出均走 /api/v1，不再依赖 /files 静态目录；若对接的是旧版后端，才需要额外保留 /files 代理。静态资源缓存建议使用 Cache-Control: private，避免共享缓存保留他人附件。

常见问题

附件预览提示「地址无效或已过期，请刷新页面重试」？ 正常情况下不该再看到：附件地址是短时效签名（后端 file.signTTLSeconds，默认 900 秒），而 src/composables/useSignedFile.ts 会在渲染前预检、不足时效就静默换一张，加载失败还会强制重试一次。如果你仍看到这个提示，先查两个参数：file.signTTLSeconds 必须显著大于前端 120 秒的提前量；以及该附件是否已被软删（is_deleted）——那种情况属于真不可用，提示会保留。

登录页为什么看不到图形验证码？ 默认不展示：是否需要验证码由后端参数决定（security.captcha.enabled 始终要求、security.captcha.failThreshold 连续失败 N 次后要求），前端只按 GET /auth/captcha 返回的 required 决定是否插入输入框。在「系统管理 → 系统参数 → 安全策略」里打开开关后，刷新登录页即可看到算术验证码（见界面预览）。想立刻验证效果，也可以把一个账号连错密码几次。

条件分支不生效，或者两边的人都收到了待办？ 条件只认连线上的结构化条件（选中连线后在右侧面板配），条件节点上那栏“分支说明”只是给人看的备注。判定是排他的：按连线顺序取第一条命中的分支，全部不命中时走默认分支；若一个条件节点的多条分支都配了条件却没设默认，发起时会被后端拦住（避免“无分支可走”默默结束）。

登录后菜单是空的？ 检查 /sys/menu/user 是否返回菜单树，以及菜单 component 是否能在 src/views 中找到对应文件；控制台会输出 [router] 未找到视图组件 的告警。

多标签页切换后页面状态丢失？ 确认路由 name 与组件 name 一致；不一致时 keep-alive 无法命中。

附件打不开？

确认使用的是接口下发的 fileUrl（签名地址 /api/v1/common/file/{id}/raw?...），而不是历史的 /files/... 路径；旧静态路径已关闭，未签名访问会被拒绝。
签名默认 15 分钟过期，长时间停留在页面上再次点击附件可能失效，刷新页面即可重新获取。
二次开发时不要把 fileUrl 存入数据库（包括头像、表单字段），应存 fileId，否则过期后必然破图。

非超管账号看不到某个按钮？ 先比对权限码对照里的编码与后端权限目录是否一致，再看角色是否勾选了该权限。编码写错时接口与页面都不会报错，只是永远不显示。

审批详情没有“加签 / 退回”按钮？ 按下面顺序排查：

当前用户在该单上是否有活动待办（permission.pendingTaskId 非空）且实例为 running；
或签节点不支持加签，后端会返回 canAddSign=false，前端按钮置灰；
退回目标已限定为“当前节点之前且已完成”的审批节点，没有可选节点时只能退回发起人。

PDF 预览在部分电脑上打不开 / 只有空白页？ pdf.js 6.x 主构建使用了较新的 Map.prototype.getOrInsertComputed，旧内核（如 Chrome 120 以下）不支持，表现为“PDF 加载失败”。本项目已改用 legacy 构建（自带 polyfill），升级 pdfjs 时不要换回主构建；损坏或不加密的 PDF 会在弹窗内明确提示并提供下载入口。

接口返回 401 后整页退出？ http 层对 401 统一清理会话；检查 token 是否过期、后端会话是否被其他设备顶替（并发会话限制）。

License

MIT

截图与演示数据仅用于展示界面能力，不含真实业务信息。

Name		Name	Last commit message	Last commit date
docs/screenshots		docs/screenshots
public		public
src		src
types		types
.env		.env
.env.development		.env.development
.env.production		.env.production
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
doc.md		doc.md
index.html		index.html
nginx.conf		nginx.conf
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Navigation Menu

Repository navigation

About

Repository files navigation

GO云启 OA · 协同办公前端

目录

界面预览

功能特性

技术栈

快速开始

环境变量

目录结构

后端对接

鉴权与用户

工作流

平台能力

知识库

数据导出

附件

设计系统

工程约定

权限码对照

部署

常见问题

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

GO云启 OA · 协同办公前端

目录

界面预览

功能特性

技术栈

快速开始

环境变量

目录结构

后端对接

鉴权与用户

工作流

平台能力

知识库

数据导出

附件

设计系统

工程约定

权限码对照

部署

常见问题

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages