This commit is contained in:
@@ -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` 与空串)。
|
||||
|
||||
Reference in New Issue
Block a user