Files

T

build / build (push) Successful in 10m17s

Details

feat: 提交校园公告前端工程源码（Vue3 + Vite + view-ui-plus）

- 同步仓库 CI 配置 .gitea/workflows/build.yml
- 纳入 src/public/config/scripts 等工程文件
- .gitignore 增加 .scratch/.backup/.trash，排除本地临时产物

2026-09-15 11:15:03 +08:00

4.7 KiB

Raw Blame History

校园公告前端（Vue3 + Vite + view-ui-plus）

本地启动

npm install

1）纯前端调试（推荐，后端不可用时）

本地连不上 sso.yunhaixingtong.com / base.yunhaixingtong.com 时，后端 CAS 过滤器会拦截 /api/* 请求导致所有接口失败。此时使用内置 mock 调试前端页面：

npm run dev:mock

启用 src/assets/mock/noticeapi.ts 中的内存 mock（vite-plugin-mock），覆盖全部页面接口：用户/菜单、发文部门字典、通知增删改查、阅读情况、联系组、选择用户树、附件上传等。
mock 数据为内存态，刷新页面即还原；修改 mock 文件后需重启 dev server 才生效。
mock 模式下请求走 vite 同源（host.config.ts 中 serviceHost 为空串）。

2）连接后端调试

npm run dev

.env.dev：VITE_SERVICE_HOST=http://localhost:8070/notice（Java 后端，见 ../service）。
后端需要能访问 CAS（yh.sso.server-url-prefix）与用户中心（yh.open.*），否则接口 302/失败。

信息架构（对齐后端测试台 api-test.html 六视图）

路由	页面
`/`	我的通知（左列表 + 右详情；未读/已读/类型筛选，三 tab 带条数 `notice/ReadTabCount`；详情 `上一篇/下一篇`（`notice/GetNextPrev?type=1`）+ 打印；附件/回执提示）
`/list`	已发管理（状态/类型筛选、审批进度、撤回/置顶/催读/转发、阅读回执、驳回重提）
`/list/new`	写通知（新建/编辑 `?serid=`/草稿续编/转发 `?fid=`；推送范围+预估、回执勾选、直接发布/存草稿/提交审批三态）
`/drafts`	草稿箱（继续编辑/提交审批/删除）
`/noticelist`	全部通知（管理端）
`/approval`	审批中心（待我审批/已通过/已驳回/全部，多步流程进度）
`/approval-setting`	审核设置（审批人池）
`/stats`	通知统计（开发中）
`/setting`	应用设置（发文部门卡片 + 自定义组）
`/list/detail` `/noticelist/detail`	通知详情（`type=0` 管理视角含阅读进度/审批轨迹/编辑/打印，`type=1` 查看）

旧版路径（/notice/*、/accept、/manage 等）已保留重定向兼容。

关键组件

components/PushScopePanel.vue：推送范围面板（全校/学段/年级/班级树 + chips + ScopePreview 接收人数预估，notice/ScopeTree）。
components/ApprovalFlowEditor.vue：多步审批流编辑器（或签/会签、步骤排序）。
components/UserCheckModal.vue：选择用户弹窗（组织树勾选 + 已选列表，移植自旧前端 oldfront/src/components/userCheck.vue）。
components/NoticeUpload.vue：通知附件上传（选择文件 + 200MB 限制，移植自旧 uploadFile.vue）。
utils/noticePrint.ts：公告打印公共工具（v17）。「已收到」与「通知详情」共用，打印件含标题/来源·发布人·发布时间/接收范围/正文/附件文件名清单/打印时间；buildPrintHtml 为纯函数，可被 .scratch 脚本直接断言（弹窗被浏览器拦截时 printNotice 返回 false 由页面提示）。
发文部门卡片：见 views/notice/NoticeSetting.vue，样式与交互对齐 UserBase「应用类型」（UserBase/front/src/views/app/AppCategory.vue），额外支持停用/启用。

菜单说明

左侧菜单数据源为平台用户中心 base/GetUserMod（库表配置）。栏目名称直接显示接口返回的 name，前端不做改名（v10 起已移除原 MENU_NAME_MAP 展示层映射）：在平台管理后台把模块名改成「我的通知 / 已发管理 / …」，前端刷新即生效；平台仍配旧叫法则显示旧叫法。

应用内保留三层处理（components/layout.vue + utils/menuRoute.ts）：

平台配置的 page 格式不可控，统一解析为内部路由（path 精确 → 原始模块名别名 → 外链整页跳转 → modId 契约兜底）；解析使用接口原始 name，与显示名互不影响，配错时显式提示而非静默跳默认页；
「草稿箱」菜单项注入（平台无对应模块，挂「已发管理」之后），无需改动平台模块表；
栏目顺序按接口 orderNumber 升序（utils/menuRoute.ts sortByOrderNumber，v11）：后端 GetUserMod 保持用户中心返回行序不重排，排序在前端完成，平台改模块「排序号」即换序； orderNumber 缺失/非数值的项沉底，同值保持接口原序。

assets/config/menu.ts 为早期本地菜单兜底数据，现已无引用，仅作历史参考。

统计说明

统计相关前端已按需求移除（Notice_statis 接口封装、菜单、图标等），后期统计不在本应用内做。

4.7 KiB Raw Blame History Unescape Escape