documents/repair/weekend.md

维修工单系统 (weekend)

总览

flowchart LR
    S[sunday] --> L[logto]
    S --> Sa[saturday]
    H[hawaii] --> Sa
    Sa --> L
    L --> |webhook| Sa
    Sa --> D[(Database)]
    Sa --> G[Github]
    G --> |webhook| Sa
    Sa --> N[nsq]

地址	仓库	描述
https://repair.nbtca.space/api	nbtca/saturday	后端
https://repair.nbtca.space	nbtca/sunday	管理页面
NA	nbtca/hawaii	微信小程序，用于报修
https://auth-admin.app.nbtca.space	logto-io/logto	鉴权
NA	nsqio/nsq	消息队列，用于推送维修事件

角色

角色名	权限描述
client	创建维修事件，取消事件
member	接受维修事件，提交维修描述，放弃事件
admin	审核维修描述，关闭事件, 添加member

维修人员基本信息

为了管理员验证成员身份，以及后续申报志愿者时长，需要收集成员的个人信息。

字段名	描述
member_id	学号
name	真实姓名
phone	手机号
qq	QQ号

维修事件

flowchart LR
    A[Open] --> |Drop| B[Canceled]
    A --> |Accept| C[Accepted]
    C --> |Commit| D[Commited]
    D --> |AlterCommit| D
    D --> |Approve| E[Closed]
    D --> |Reject| C

事件状态(status)

状态名	status	描述
待处理	open	维修事件未被成员接受
取消	cancelled	维修事件被用户取消，不需要再进行处理
受理	accepted	维修事件已被成员接受
待审核	committed	成员提交了维修描述，管理员尚未审核
关闭	closed	维修事件已解决，不能再更改该事件

事件行为(action)

操作名	action	操作权限	事件状态变更	描述
创建	create	client	nil => open	用户创建了维修事件
受理	accept	member	open => accepted	成员接受了维修事件
取消	cancel	current client	open => canceled	用户取消了自己创建的维修事件
放弃	drop	current member	accept => open	成员放弃了自己接受的维修事件
提交	commit	current member	accept => committed	成员维修完成，添加维修描述后提交给管理员审核
修改提交	alterCommit	current member	committed => committed	成员修改 未被审核的维修提交
拒绝提交	reject	admin	committed => accepted	管理员拒绝提交
关闭	close	admin	committed => closed	管理员通过提交