lijing
7daf3502bd
build / build (push) Successful in 9m1s
家长端回执弹窗的专属区动态规则此前只写 required + trigger、没给 type。
async-validator 的 getValidationMethod 仅在规则「除掉 message 后只剩 required」
时才走 required 校验器；带上 trigger 后会回退到默认 string 校验器，而 DatePicker
的 v-model 给出的是 Date 对象，被判类型不符。真正的报错又在 cb() 里被自定义
message 顶掉，界面上只剩「请填写XX」——表现为字段明明填了却不让提交。
- ParentNotices.vue: 新增 ruleTypeOf() 统一映射规则类型
（number -> type:"number"，date/datetime -> type:"date"，其余保持默认 string）。
注意 async-validator 没有 datetime 类型，写上去会导致 validate 抛异常。
- ParentNotices.vue: 日期字段回填统一转 Date（本地时间语义，避免 new Date("yyyy-MM-dd")
的 UTC 偏移），提交时序列化成 yyyy-MM-dd / yyyy-MM-dd HH:mm。
这同时修掉一处数据污染：此前 String(Date) 会把
"Tue Sep 22 2026 10:33:00 GMT+0800 (中国标准时间)" 这类 locale 脏串写进 fillData。
- NewNotice.vue: 定时发布时间弹窗的规则存在同类问题，补 type:"date"。
- 覆盖四类回执单：stay / visit / adjust 的日期字段曾坏，general 及公共区字段本就正常。
.gitignore 追加 .workbuddy/（本地 AI 工作目录，不入库）。
家校宿舍通知（dorm-notice）
武校家校信息发布模块 —— 宿舍通知 子模块。用于德育处 / 生活管理科 / 宿管向住宿生家长发布宿舍类通知， 并回收家长的已读与回执（确认知悉 / 按单据填报）。
以
D:\项目管理\FamilyActivity（家校活动信息发布）为模板工程改造：保留其 Vue3 + Vite + view-ui-plus + alova + vite-plugin-mock 技术栈、布局壳层、权限菜单契约、表格/分页/选人/富文本/附件等基础设施，业务域整体替换为「宿舍通知」。 完整的功能与接口说明见docs/宿舍通知模块-功能与接口说明-v1.md。
快速开始
# 纯前端演示（内置 mock 数据，无需后端）
npm run dev:mock
# 联调本地后端
npm run dev
# 构建（产物直出 dist/）
npm run build
mock 模式默认访问 http://localhost:8078/（端口被占用时 Vite 会自动改用 8079，以控制台输出为准）。
环境要求：Node 20（
package.json里nodeversion: 20.19.4）。
与「活动」模块的核心差异
| 维度 | 活动信息发布 | 宿舍通知 |
|---|---|---|
| 收件人粒度 | 班级（receiveType=class） |
宿舍房间（receiveType=room） |
| 应收人数口径 | 班级学生数 | 覆盖房间的实际入住床位数 |
| 回执形态 | 报名（人数 + 随行 + 费用） | 仅通知 / 需确认（打开即确认） / 需填报（按单据字段） |
| 回执字段 | 固定 | 动态，由发布方声明 |
| 紧急程度 | 无 | 普通 / 重要 / 紧急（家长端置顶标红） |
| 宿管协同 | 无 | needSupervisor 需宿管到场配合 |
| 覆盖统计 | 按班 | 按楼栋统计房间数 / 床位数 |
为什么必须下沉到房间：武校寄宿制下同班学生分住不同楼栋房间，按班级下发会让「1号楼 3 层明日停水」触达全校家长， 真正受影响的房间只占少数，回执率也失去管理意义。
功能范围
发布端（教师 / 宿管 / 德育处）
| 菜单 | 路由 | 说明 |
|---|---|---|
| 我发布的 | /list |
自己发布的通知，按流程状态分标签（全部/已发布/已截止/已结束/草稿） |
| 全部通知 | /noticelist |
管理端全量列表（同一组件，去掉 scope=user） |
| 发布通知 | /list/new |
新建 / 编辑 / 复用再发；支持存草稿与定时发布 |
| 通知详情 | /list/detail、/noticelist/detail |
type=0 管理视角（已读进度 + 回执进度 + 编辑/打印/复用）；type=1 查看视角 |
| 回执情况 | /receipts |
按「楼栋 · 房间」分组的回执/填报名单 + 汇总卡 + 代确认/取消/退回 + 催办 + 导出 CSV |
| 通知统计 | /stats |
总量卡、类型分布、月度趋势、楼栋覆盖、发布人分布、我发布通知的回执明细 |
| 宿舍设置 | /setting |
通知类型字典（拖拽排序/启停）+ 宿舍楼栋房间台账（含住宿生床位安排 / 宿舍长指定）+ 自定义组（宿管/生活老师） |
家长端（家长 / 学生，演示用）
| 菜单 | 路由 | 说明 |
|---|---|---|
| 宿舍通知箱 | /par/notices |
左侧分桶列表（全部/待回执/已回执/已结束）+ 右侧详情与回执操作 |
| 我的回执 | /par/mine |
同一组件，默认落「已回执」 |
三档回执方式
- 仅通知（
none）：阅读即知悉，不产生回执记录，只统计已读。适合作息调整、停水停电、卫生检查、违规通报、假期安排。 - 需确认（
confirm）：家长打开通知详情即自动确认，无需点击；仅在自动确认失败时给手动兜底按钮。 - 需填报（
fill）：家长按发布方声明的字段提交单据（留宿申请 / 家长探视 / 宿舍调整），截止前可修改、可取消。
三套预设填报模板
留宿申请单、家长探视预约单、宿舍调整确认单 —— 字段口径与后端一致，可一键套用后按需增删。
目录结构（本模块相关）
src/
├── api/module/dorm.ts # 接口封装：baseApi / noticeApi / dormApi / settingApi
├── types/dorm.ts # 类型契约（枚举、VO/DTO、请求入参）
├── assets/mock/dormapi.ts # 全量 mock（约 2200 行，确定性伪随机）
├── views/dorm/
│ ├── NoticeList.vue # 我发布的 / 全部通知
│ ├── NewNotice.vue # 发布通知（含宿舍选择器、填报字段编辑器）
│ ├── NoticeDetails.vue # 通知详情
│ ├── Receipts.vue # 回执情况
│ ├── NoticeStats.vue # 通知统计
│ ├── DormSetting.vue # 宿舍设置（通知类型 / 楼栋房间 / 自定义组）
│ └── ParentNotices.vue # 家长端通知箱
├── router/routes.ts # 路由 + modId 契约
├── assets/config/menu.ts # 本地菜单兜底
└── utils/menuRoute.ts # 平台模块配置 → 内部路由的统一解析器
docs/宿舍通知模块-功能与接口说明-v1.md
mock 数据（演示要点）
- 4 栋宿舍楼：1/2 号男生（6+5 层 × 8 间 × 8 床）、3 号女生（4 层 × 6 间 × 6 床）、4 号武术特长班（3 层 × 6 间 × 4 床）
roomId = buildingId*10000 + floor*100 + index，如10305= 1 号楼 3 层 05 房（房间号305）- 1 床 1 生，含武校风格姓名、文化班 + 套路表演班/散打竞技班/拳击班混合编排、家长信息
- 14 条通知覆盖 13 种类型 × 4 种流程状态 × 3 档回执方式 × 3 种紧急程度，含草稿 / 已撤回 / 定时未到 / 已截止等边界
- 家长端演示身份固定为 1 号楼 305 室 的第一位学生，只看该房间命中的通知
- 写操作（发布、编辑、删除、处理回执、提交回执）都会改内存数据，刷新后行为一致；重启 dev server 复位
接入后端时需改的地方
vite.config.ts中/api代理 target —— 现仍指向模板的familyactivity上下文，需换成本模块后端。src/assets/config/menu.ts—— 本地菜单兜底，接入GetUserMod后以接口返回为准（modId契约见路由注释）。src/assets/mock/index.ts—— prod mock 入口，正式构建不启用（localEnabled: mode === "mock"）。