diff --git a/.env.dev b/.env.dev index 4023671..90fd7f8 100644 --- a/.env.dev +++ b/.env.dev @@ -9,5 +9,3 @@ VITE_SERVICE_HOST= VITE_ZIYUANKU_HOST=https://base.bestsch.com/BschZyk VITE_ZHUANXIANG_HOST=https://base.bestsch.com/BschZncpd VITE_IS_MOCK=false -# 流程中心基址（撤回/前往流程中心直调；flow-center CORS 已收 8087） -VITE_FLOW_HOST=http://localhost:8085 diff --git a/README.md b/README.md index d45c7db..325d02b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,11 @@ -# 办事大厅前端（svc-hall-front） +# 办事大厅后台管理端前端（svc-hall-front） -云海平台子应用：办事大厅（事项库 + 自定义表单 + 办件记录）。Vue 3 + Vite + view-ui-plus + alova。 +云海平台子应用「办事大厅」的**管理端**：事项库 + 服务字典 + 自定义表单（设计器）+ 办件记录。 +Vue 3 + Vite + view-ui-plus + alova。 + +> **用户面已迁出本前端**（2026-09-16，BP-R4-3）：在线办理 / 我的办件 / 办件详情在学生与教师 +> 办理入口的独立前端 **`svc-hall/app/public`（部署于 `/svc-hall/public/`）**，本前端只保留后台管理。 +> 两个前端互不引用；管理端的办件详情是「办件记录」里的只读抽屉，不做提交人动作（撤回/重提）。 > 说明：本文件此前误为本仓 Notice（通知公告）前端的副本（描述 `/notice/*` 路由、 > `src/assets/mock/noticeapi.ts`、`NoticeUpload.vue` 等本仓不存在的文件），2026-09-16 @@ -16,7 +21,8 @@ npm run dev # http://localhost:8087 `dev` 模式下 `serviceHost` 留空，接口走同源相对路径 `/api/...`，由 vite proxy 转发到本地后端 `http://localhost:8086`（后端 CAS 过滤器对 `/api/*` 不回 CORS 头，浏览器直连会被拦，必须同源代理）。 -本地完整链路还需：UserBase（base/sso 鉴权）、流程中心 `http://localhost:8085`（撤回、查看进度）。 +本地完整链路还需：UserBase（base/sso 鉴权）、流程中心后端 `http://localhost:8085` +（流程选择器与流程图；本前端**不直连** flow-center，一律经 svc-hall 后端中转）。 另有 `npm run dev:mock`（`.env.mock`）用于后端不可达时的纯前端联调。 ## 脚本 @@ -43,17 +49,19 @@ npm run dev # http://localhost:8087 | `/svc/dict` | 服务字典 | 24 | | `/svc/form` | 表单管理 | 25 | | `/svc/form/designer` | 表单设计器（拖拽三栏，`?id=` 回填） | 25（parentId 25） | -| `/svc/apply` | 办件记录（管理面） | 26 | -| `/my` | 我的办件（用户面） | 27 | -| `/apply` | 在线办理（用户面，query 传 `siteCode`/`itemCode`） | 不挂菜单 | -| `/apply-detail` | 办件详情（用户面，query 传 `id`） | 不挂菜单 | +| `/svc/apply` | 办件记录（管理面，含只读详情抽屉 + 流程图） | 26 | +| `/` | → `/svc/item` | — | +| 其他 | → `/svc/item`（旧用户面深链兜底，避免白屏） | — | -`modId` 是菜单 ↔ 路由的稳定契约（UserBase `app_module` 按本应用 appKey 配置）；`/` 与未匹配路径都回落 -`/my`（详情页走 query 传参，拼成路径参数会 no-match）。 +`modId` 是菜单 ↔ 路由的稳定契约（UserBase `app_module` 按本应用 appKey 配置）。用户面路由 +（原 `/my`、`/apply`、`/apply-detail`，modId 27）已随用户面迁出，`app_module` 里的对应菜单应删除 +或改指 `/svc-hall/public/`。 ## 目录要点 -- `src/api/module/svc.ts`：接口封装（alova；`siteApi`/`svcItemApi`/`svcDictApi`/`svcFormApi`/`svcFlowApi`/`applyApi`/`fileApi`） +- `src/api/module/svc.ts`：接口封装（alova；`siteApi`/`svcItemApi`/`svcDictApi`/`svcFormApi`/`svcFlowApi`/`applyApi`/`fileApi`）。 + **纪律：本文件不得出现 flow-center 地址**——流程能力（列表 `/api/svc/flow/list`、流程图 + `/api/svc/flow/diagram.png`）一律经 svc-hall 后端中转（后端用 SDK `YschFlowOpenApi` 出站） - `src/utils/site.ts`：当前站点上下文（`localStorage.svchall.site` 持久化，管理页共用） - `src/components/DynamicForm.vue`：表单 schema 渲染器（`{groups:[{title,fields:[…]}]}`，一期 11 类控件； 多选类值为 `string[]`，附件/图片为上传返回体数组 `[{id,fileName,fileUrl,fileSize,mimeType}]`） @@ -62,6 +70,10 @@ npm run dev # http://localhost:8087 ## 契约纪律（改表单相关代码前必读） +- 前端**不得**直接调用流程中心（无 `flowHost`）：撤回/进度/流程图走 svc-hall 后端 + `/api/apply/{id}/withdraw|progress|diagram.png`，事项的流程图为 `/api/svc/flow/diagram.png`。 + 原因是浏览器直调外部应用需要跨应用 CAS 票据与 CORS，且授权点会落到前端（BP-R4-2）。 + - schema 由后端 `FormValidator` 强校验：属性白名单 16 项（无 `precision`）、`key` 限 `^[A-Za-z0-9_]{1,64}$` 且表单内唯一、`select/radio/checkbox/multiselect` 必须有非空 `options`、 `maxSize` 单位 **MB**、`maxFiles` 缺省或 0=不限。设计器序列化只输出白名单键（剔除内部 `_uid` 与空串）。 diff --git a/src/api/module/svc.ts b/src/api/module/svc.ts index 5f07a50..d21d5bd 100644 --- a/src/api/module/svc.ts +++ b/src/api/module/svc.ts @@ -1,8 +1,8 @@ import { Method } from "alova"; import { alovaInstance } from "@/utils/alova/alova-iview"; import type { - ApplySubmitRequest, ApplyVo, + FlowProgressVo, FlowSummary, PageResult, SiteOption, @@ -18,12 +18,14 @@ import type { } from "@/types/svc"; /** - * 办事大厅接口封装（V2.0 Part B 契约）。 - * siteCode 为一切管理面/用户面定位键；conf.serviceHost 本地为空（走 vite 代理）。 + * 办事大厅后台管理端接口封装（V2.0 Part B 契约；用户面接口在独立前端 svc-hall-public）。 + * siteCode 为一切管理面定位键；conf.serviceHost 本地为空（走 vite 代理）。 + * 纪律：本文件不得出现 flow-center 地址——流程能力（列表/流程图）一律经本应用后端中转。 */ const SVC = "/api/svc"; const APPLY = "/api/apply"; + const FILE = "/api/file"; /** GET 请求 */ @@ -137,32 +139,29 @@ class SvcFlowApi { list(siteCode: string) { return get(`${SVC}/flow/list`, { siteCode }); } + /** 流程图地址（同源 /window.open；后端换免签 token 取图，前端不碰 flow-center 地址） */ + diagramUrl(siteCode: string, flowGuid: string, mode = "dept") { + return `${SVC}/flow/diagram.png?siteCode=${encodeURIComponent(siteCode)}` + + `&flowGuid=${encodeURIComponent(flowGuid)}&mode=${encodeURIComponent(mode)}`; + } } class ApplyApi { - /** 发起（用户面） */ - submit(data: ApplySubmitRequest) { - return postJSON(`${APPLY}`, data); - } - retry(id: number) { - return postForm(`${APPLY}/${id}/retry`); - } - /** 一键重提（仅驳回/撤回态；同 bizId，flow-center R4 重启推进） */ - resubmit(id: number) { - return postForm(`${APPLY}/${id}/resubmit`); - } - my(params?: Record) { - return get>(`${APPLY}/my`, params); - } - /** 发起页数据（事项要点+表单 schema） */ - item(siteCode: string, itemCode: string) { - return get>(`${APPLY}/item`, { siteCode, itemCode }); + /** 办件记录分页（管理面；用户面办件在独立前端 svc-hall-public） */ + adminPage(params: Record) { + return get>(`${SVC}/apply/page`, params); } + /** 办件详情（只读；与用户面同接口，管理员在守卫白名单内） */ detail(id: number) { return get(`${APPLY}/${id}`); } - adminPage(params: Record) { - return get>(`${SVC}/apply/page`, params); + /** 审批轨迹（只读；同上口径） */ + progress(id: number) { + return get(`${APPLY}/${id}/progress`); + } + /** 流程图地址（同源图片；后端换免签 token 取图） */ + diagramUrl(id: number, mode = "dept") { + return `${APPLY}/${id}/diagram.png?mode=${encodeURIComponent(mode)}`; } } diff --git a/src/assets/config/host.config.ts b/src/assets/config/host.config.ts index 508870a..9a11361 100644 --- a/src/assets/config/host.config.ts +++ b/src/assets/config/host.config.ts @@ -23,10 +23,6 @@ let conf: BaseConf = { baseHost: origin, ssoHost: "", serviceHost: seg.length >= 2 ? `${origin}/${seg[0]}` : "", - // 流程中心基址（BP-R2-1：我的办件/办件详情"撤回"直调 flow-center /api/flow/instance/{id}/withdraw）： - // 生产同主域 Caddy 路由 /flow-center/；本地 dev 由 VITE_FLOW_HOST 指向 http://localhost:8085 - // （flow-center CORS 已收 8087，同 Notice host.config 同款约定） - flowHost: seg.length >= 2 ? `${origin}/flow-center` : "", relayConf: { ziyuankuHost: "", zhuanxiangHost: "", @@ -50,7 +46,6 @@ applyConf(conf, { baseHost: env.VITE_BASE_HOST, ssoHost: env.VITE_SSO_HOST, serviceHost: env.VITE_IS_MOCK === "true" ? "" : env.VITE_SERVICE_HOST, - flowHost: env.VITE_FLOW_HOST, relayConf: { ziyuankuHost: env.VITE_ZIYUANKU_HOST, zhuanxiangHost: env.VITE_ZHUANXIANG_HOST, diff --git a/src/router/routes.ts b/src/router/routes.ts index cd9ad56..cf04ab9 100644 --- a/src/router/routes.ts +++ b/src/router/routes.ts @@ -1,12 +1,12 @@ import type { RouteRecordRaw } from "vue-router"; /** - * 办事大厅路由（V2.0 Part B.6）。 + * 办事大厅**后台管理端**路由（用户面在独立前端 svc-hall-public，见 /svc-hall/public/）。 * - * modId 是菜单 ↔ 路由的稳定契约（UserBase app_module 按本应用 appKey 配置）， - * 新 modId 提案（旧 CMS 21/22 随迁移退役）： - * 23=办事事项 24=服务字典 25=表单管理 26=办件记录 27=我的办件 - * 发起页 /apply 与详情 /apply-detail 为参数页，不挂菜单（parentId 仅作面包屑归属）。 + * modId 是菜单 ↔ 路由的稳定契约（UserBase app_module 按本应用 appKey 配置）： + * 23=办事事项 24=服务字典 25=表单管理 26=办件记录 + * 编辑页/设计器为参数页，不挂菜单（parentId 仅作面包屑归属）。 + * 用户面（我的办件/在线办理/办件详情）已迁出本前端（BP-R4-3）：本前端只保留管理面。 */ const routes: RouteRecordRaw[] = [ // 管理面：办事事项 @@ -49,32 +49,11 @@ const routes: RouteRecordRaw[] = [ component: () => import("@/views/svc/ApplyManage.vue"), meta: { title: "办件记录", modId: 26 }, }, - // 用户面：我的办件 - { - path: "/my", - name: "svc_apply_my", - component: () => import("@/views/svc/ApplyMy.vue"), - meta: { title: "我的办件", modId: 27 }, - }, - // 用户面：发起（CMS 指南页"我要办理"跳入：/#/apply?siteCode=&itemCode=） - { - path: "/apply", - name: "svc_apply", - component: () => import("@/views/svc/Apply.vue"), - meta: { title: "在线办理", parentId: 27 }, - }, - // 用户面：办件详情 - { - path: "/apply-detail", - name: "svc_apply_detail", - component: () => import("@/views/svc/ApplyDetail.vue"), - meta: { title: "办件详情", parentId: 27 }, - }, - // 应用入口默认页（pcUrl 直达时落到我的办件） - { path: "/", redirect: "/my" }, - // 兜底：外部深链（bizUrl 等）若拼成路径参数形态（/#/apply-detail/12）会 no-match， - // catch-all 避免静默空白页（回落我的办件，用户可自行进详情） - { path: "/:pathMatch(.*)*", redirect: "/my" }, + // 应用入口默认页（pcUrl 直达时落到办事事项） + { path: "/", redirect: "/svc/item" }, + // 兜底：外部深链（旧用户面链接 /#/apply-detail?id= 等）在本前端已无对应页面—— + // 统一回落办事事项，避免静默空白页（用户面链接请改指 /svc-hall/public/） + { path: "/:pathMatch(.*)*", redirect: "/svc/item" }, ]; export default routes; diff --git a/src/types/svc.ts b/src/types/svc.ts index 379f2b1..d51cdb8 100644 --- a/src/types/svc.ts +++ b/src/types/svc.ts @@ -222,3 +222,39 @@ export interface PageResult { list?: T[]; items?: T[]; } + +// ===== 审批进度（后端复用 SDK FlowProgress，见 /api/apply/{id}/progress）===== + +export interface FlowProgressVo { + instanceId?: number; + bizType?: string; + bizId?: string; + bizTitle?: string; + status?: number; + currentNodes?: string; + submitterId?: number; + submitterName?: string; + submitTime?: string; + finishTime?: string; + steps?: FlowProgressStep[]; +} + +export interface FlowProgressStep { + nodeId?: string; + nodeName?: string; + label?: string; + active?: boolean; + assignees?: FlowProgressTask[]; +} + +export interface FlowProgressTask { + taskId?: number; + userId?: number; + userName?: string; + status?: number; + statusLabel?: string; + opinion?: string; + arriveTime?: string; + handleTime?: string; + edgeName?: string; +} diff --git a/src/views/svc/Apply.vue b/src/views/svc/Apply.vue deleted file mode 100644 index 019a304..0000000 --- a/src/views/svc/Apply.vue +++ /dev/null @@ -1,120 +0,0 @@ - - - - - diff --git a/src/views/svc/ApplyDetail.vue b/src/views/svc/ApplyDetail.vue deleted file mode 100644 index b0befd9..0000000 --- a/src/views/svc/ApplyDetail.vue +++ /dev/null @@ -1,177 +0,0 @@ - - - - - diff --git a/src/views/svc/ApplyManage.vue b/src/views/svc/ApplyManage.vue index 10ab55e..9a8b927 100644 --- a/src/views/svc/ApplyManage.vue +++ b/src/views/svc/ApplyManage.vue @@ -1,12 +1,18 @@ - - - - diff --git a/src/views/svc/ServiceItemEdit.vue b/src/views/svc/ServiceItemEdit.vue index f8a009c..0de2878 100644 --- a/src/views/svc/ServiceItemEdit.vue +++ b/src/views/svc/ServiceItemEdit.vue @@ -11,7 +11,6 @@ import { svcItemApi, } from "@/api/module/svc"; import type { SvcDeptVo, SvcFormVo, SvcItemAttachmentVo, SvcItemSaveRequest } from "@/types/svc"; -import config from "@/assets/config/host.config"; import { useSite } from "@/utils/site"; import RichTextEditor from "@/components/RichTextEditor.vue"; @@ -125,9 +124,15 @@ async function save(publishAfter: boolean) { router.replace({ path: "/svc/item/edit", query: { id: String(id) } }); } -/** 流程图：flow-center 深链整页跳转（事项库场景用科室视图） */ +/** 流程图：走本应用后端 /api/svc/flow/diagram.png（后端换免签 token 取图）。 + * 原先是 window.open 到 flow-center 前端 /#/diagram?...——跨应用页面 + 需要流程中心的登录会话； + * 现在同源出图，浏览器只认 ，也不再把 flow-center 地址带进前端配置。 */ function openFlowDiagram() { - window.open(`${config.flowHost}/#/diagram?flowGuid=${form.value.flowGuid}&mode=dept`, "_blank"); + if (!currentSiteCode.value || !form.value.flowGuid) { + Message.warning("请先选择流程并确认当前站点"); + return; + } + window.open(svcFlowApi.diagramUrl(currentSiteCode.value, form.value.flowGuid, "dept"), "_blank"); } onMounted(loadAll); diff --git a/src/vite-env.d.ts b/src/vite-env.d.ts index 9ccf80c..d378dbe 100644 --- a/src/vite-env.d.ts +++ b/src/vite-env.d.ts @@ -4,7 +4,6 @@ interface ImportMetaEnv { readonly VITE_BASE_HOST: string; readonly VITE_SSO_HOST: string; readonly VITE_SERVICE_HOST: string; - readonly VITE_FLOW_HOST: string; readonly VITE_ZIYUANKU_HOST: string; readonly VITE_ZHUANXIANG_HOST: string; readonly VITE_IS_MOCK: string;