refactor(front): 后台化收口——删用户面三页,流程图/进度走后端中转接口,清 flowHost 残留
build / build (push) Successful in 2m28s

This commit is contained in:
chenxing
2026-09-17 01:05:51 +08:00
parent 6d972fe0cc
commit 166e55230f
12 changed files with 272 additions and 509 deletions
+22 -10
View File
@@ -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` 与空串)。