Files
shanxia2.0/docs/superpowers/specs/2026-08-15-duty-grab-user-select-design.md
T
2026-08-16 14:58:19 +08:00

36 lines
979 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 公开抢班:系统用户可搜索下拉 — 设计
> 日期: 2026-08-15
> 状态: 已确认(方案 A)
## 目标
公开 H5 抢班不再手输姓名,改为从本租户 `sys_user` 模糊搜索后点选;提交必须为有效用户;同一班次同一用户只能抢一次。
## 接口
### `GET /api/public/duty/{token}`
在原有字段外增加:
```json
"users": [{ "id": "<sys_user.id>", "label": "<nick_name|user_no>" }]
```
过滤:`tenant_no` = 值班日租户,`del_flag=0`,`status=1`。不返回手机号等敏感字段。
### `POST /api/public/duty/{token}/grab`
Body:
```json
{ "shiftType": "evening", "userId": "<sys_user.id>" }
```
校验:开链、用户同租户且启用、班次存在、名额未满、该班次无同一 `user_id` 占位。
写入:`user_id` + `person_name`(昵称或工号)。
## 前端
公开页每班次:可输入过滤的下拉,必须点选一项后才能提交;文案改为「选择姓名」。