更新密码找回uniapp
This commit is contained in:
1 parent
7f9a66da0f
commit
3fdda89833
1304 files changed
+3503
-26132
No files matched your search
@@ -17,49 +17,21 @@ import (
|
||||
"github.com/beego/beego/v2/client/orm"
|
||||
)
|
||||
|
||||
// 移动端审批接口,挂在 AppOaController 上。
|
||||
//
|
||||
// 设计说明:
|
||||
// - 数据按 JWT 的 tid + user 双重隔离:发起列表仅看本人发起的审批,
|
||||
// 待办列表仅看本人作为审批人的待办;
|
||||
// - 复用 services/approval 引擎的 Submit / Approve,保证与 Web 端行为一致;
|
||||
// - 单据类型(biz_type)取审批流 yz_backend_approval_flow.biz_type;
|
||||
// 移动端不开放自由单据类型,仅允许本租户已配置的分类。
|
||||
//
|
||||
// 路由前缀:/api/oa/approval/*
|
||||
//
|
||||
// 接口清单:
|
||||
// GET /api/oa/approval/list 我发起的审批实例
|
||||
// GET /api/oa/approval/todo 我的待办(作为审批人)
|
||||
// GET /api/oa/approval/detail/:id 审批详情(含任务时间线)
|
||||
// POST /api/oa/approval/submit 提交审批
|
||||
// POST /api/oa/approval/approve 通过/驳回审批任务
|
||||
// POST /api/oa/approval/withdraw/:id 发起人撤回审批
|
||||
// GET /api/oa/approval/flows 可发起的流程清单(按分类)
|
||||
// GET /api/oa/approval/categories 单据类型(biz_type)下拉
|
||||
|
||||
// ============================ 入参 ============================
|
||||
|
||||
// oaApprovalSubmitPayload 提交审批入参
|
||||
type oaApprovalSubmitPayload struct {
|
||||
BizType string `json:"biz_type"` // 单据类型(必填)
|
||||
FlowCode string `json:"flow_code"` // 指定流程(可选;留空取该 biz_type 默认流)
|
||||
FlowID uint64 `json:"flow_id"` // 指定流程ID(可选)
|
||||
BizTitle string `json:"biz_title"` // 单据标题(必填)
|
||||
BizID uint64 `json:"biz_id"` // 关联业务单据ID(可选)
|
||||
FormData map[string]interface{} `json:"form_data"` // 表单数据
|
||||
BizType string `json:"biz_type"`
|
||||
FlowCode string `json:"flow_code"`
|
||||
FlowID uint64 `json:"flow_id"`
|
||||
BizTitle string `json:"biz_title"`
|
||||
BizID uint64 `json:"biz_id"`
|
||||
FormData map[string]interface{} `json:"form_data"`
|
||||
}
|
||||
|
||||
// oaApprovalApprovePayload 审批入参
|
||||
type oaApprovalApprovePayload struct {
|
||||
TaskID uint64 `json:"task_id"` // 待审批任务ID(必填)
|
||||
Pass bool `json:"pass"` // true 通过 false 驳回
|
||||
Comment string `json:"comment"` // 审批意见
|
||||
TaskID uint64 `json:"task_id"`
|
||||
Pass bool `json:"pass"`
|
||||
Comment string `json:"comment"`
|
||||
}
|
||||
|
||||
// ============================ 工具 ============================
|
||||
|
||||
// oaApprovalIDParam 解析 :id 路由参数
|
||||
func oaApprovalIDParam(c *AppOaController) uint64 {
|
||||
id, err := strconv.ParseUint(c.Ctx.Input.Param(":id"), 10, 64)
|
||||
if err != nil {
|
||||
@@ -68,7 +40,6 @@ func oaApprovalIDParam(c *AppOaController) uint64 {
|
||||
return id
|
||||
}
|
||||
|
||||
// oaApprovalClaims 解析并校验 JWT
|
||||
func oaApprovalClaims(c *AppOaController) (*jwtutil.Claims, bool) {
|
||||
claims, err := c.oaClaims()
|
||||
if err != nil {
|
||||
@@ -79,7 +50,6 @@ func oaApprovalClaims(c *AppOaController) (*jwtutil.Claims, bool) {
|
||||
return claims, true
|
||||
}
|
||||
|
||||
// oaApprovalEmployee 通过 JWT 找到当前登录用户对应的员工记录(用于取部门 ID)
|
||||
func oaApprovalEmployee(c *AppOaController, claims *jwtutil.Claims) *models.BackendEmployee {
|
||||
emp, ok := c.oaMyEmployee(claims)
|
||||
if !ok {
|
||||
@@ -88,13 +58,10 @@ func oaApprovalEmployee(c *AppOaController, claims *jwtutil.Claims) *models.Back
|
||||
return emp
|
||||
}
|
||||
|
||||
// oaApprovalSubmitUID 通过 JWT 拿到租户侧的 UID(SystemTenantUser.id),
|
||||
// 审批引擎 SubmitInput.SubmitUID 用的是租户侧用户 ID 而非平台 AdminUser.ID。
|
||||
func oaApprovalSubmitUID(claims *jwtutil.Claims) uint64 {
|
||||
return services.ResolveTenantUID(uint64(claims.TenantId), uint64(claims.UserID))
|
||||
}
|
||||
|
||||
// oaApprovalReadJSON 读取并解析 JSON 请求体,失败时输出错误响应
|
||||
func oaApprovalReadJSON(c *AppOaController, dst interface{}) bool {
|
||||
raw, err := io.ReadAll(c.Ctx.Request.Body)
|
||||
if err != nil {
|
||||
@@ -111,7 +78,6 @@ func oaApprovalReadJSON(c *AppOaController, dst interface{}) bool {
|
||||
return true
|
||||
}
|
||||
|
||||
// oaApprovalUserName 取得发起人姓名(优先员工表,否则使用 JWT 用户名)
|
||||
func oaApprovalUserName(c *AppOaController, claims *jwtutil.Claims) string {
|
||||
if emp := oaApprovalEmployee(c, claims); emp != nil && emp.Name != "" {
|
||||
return emp.Name
|
||||
@@ -119,9 +85,6 @@ func oaApprovalUserName(c *AppOaController, claims *jwtutil.Claims) string {
|
||||
return strings.TrimSpace(claims.Username)
|
||||
}
|
||||
|
||||
// ============================ 实例组装 ============================
|
||||
|
||||
// oaApprovalStatusText / oaApprovalStatusTag 状态展示文案/Tag 类型(uview-plus)
|
||||
func oaApprovalStatusText(status int8) string {
|
||||
switch status {
|
||||
case models.ApprovalInstanceDraft:
|
||||
@@ -141,7 +104,6 @@ func oaApprovalStatusText(status int8) string {
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalStatusTagType 给前端 uview-plus u-tag 用的类型映射
|
||||
func oaApprovalStatusTagType(status int8) string {
|
||||
switch status {
|
||||
case models.ApprovalInstanceRunning:
|
||||
@@ -157,7 +119,6 @@ func oaApprovalStatusTagType(status int8) string {
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalInstanceView 把 ApprovalInstance 组装为移动端列表/详情通用的视图结构
|
||||
func oaApprovalInstanceView(inst models.ApprovalInstance) map[string]interface{} {
|
||||
submitTime := ""
|
||||
if inst.SubmitTime != nil {
|
||||
@@ -190,7 +151,6 @@ func oaApprovalInstanceView(inst models.ApprovalInstance) map[string]interface{}
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalBizTypes 返回本租户已配置(启用 + 未删除)的 biz_type 列表
|
||||
func oaApprovalBizTypes(tid uint64) []map[string]interface{} {
|
||||
var flows []models.TenantApprovalFlow
|
||||
_, _ = models.Orm.QueryTable(new(models.TenantApprovalFlow)).
|
||||
@@ -220,10 +180,6 @@ func oaApprovalBizTypes(tid uint64) []map[string]interface{} {
|
||||
return list
|
||||
}
|
||||
|
||||
// ============================ 任务时间线 ============================
|
||||
|
||||
// oaApprovalTasksByInstance 取出某实例下的全部任务(按 sort / id 升序),
|
||||
// 同时按 (instance_id, node_key) 找当前节点的当前审批人。
|
||||
func oaApprovalTasksByInstance(instanceID uint64) []models.ApprovalTask {
|
||||
var tasks []models.ApprovalTask
|
||||
_, _ = models.Orm.QueryTable(new(models.ApprovalTask)).
|
||||
@@ -232,7 +188,6 @@ func oaApprovalTasksByInstance(instanceID uint64) []models.ApprovalTask {
|
||||
return tasks
|
||||
}
|
||||
|
||||
// oaApprovalTaskText / oaApprovalTaskTag 任务级状态文案/Tag 类型
|
||||
func oaApprovalTaskText(status int8) string {
|
||||
switch status {
|
||||
case models.ApprovalTaskPending:
|
||||
@@ -269,8 +224,6 @@ func oaApprovalTaskTag(status int8) string {
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalTaskView 任务视图(移动端流程时间线用)
|
||||
// nodeType 来自流程定义(开始/审批/通知/结束),取不到时按审批节点处理。
|
||||
func oaApprovalTaskView(t models.ApprovalTask, isCurrent bool, nodeType int8) map[string]interface{} {
|
||||
finishTime := ""
|
||||
if t.FinishTime != nil {
|
||||
@@ -304,7 +257,6 @@ func oaApprovalTaskView(t models.ApprovalTask, isCurrent bool, nodeType int8) ma
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalUserOrgName 审批人所属部门名,用作流程节点副标题(如「财务部」),取不到返回空串。
|
||||
func oaApprovalUserOrgName(tid, uid uint64) string {
|
||||
if tid == 0 || uid == 0 {
|
||||
return ""
|
||||
@@ -326,15 +278,11 @@ func oaApprovalUserOrgName(tid, uid uint64) string {
|
||||
return org.OrgName
|
||||
}
|
||||
|
||||
// 时间线虚拟节点的 node_key:用于标识流程的开始 / 结束,前端据此区分渲染。
|
||||
const (
|
||||
oaApprovalStartKey = "__start__"
|
||||
oaApprovalEndKey = "__end__"
|
||||
)
|
||||
|
||||
// oaApprovalFlowTimeline 组装移动端「审批流程」时间线:
|
||||
// 首尾固定为提交申请(开始)与流程结束(结束),中间是流程产生的节点任务,
|
||||
// 让发起人一眼看出流程当前走到哪、是否已经走完。
|
||||
func oaApprovalFlowTimeline(inst models.ApprovalInstance, tasks []models.ApprovalTask) []map[string]interface{} {
|
||||
nodeTypes := oaApprovalNodeTypes(inst)
|
||||
timeline := make([]map[string]interface{}, 0, len(tasks)+2)
|
||||
@@ -346,8 +294,6 @@ func oaApprovalFlowTimeline(inst models.ApprovalInstance, tasks []models.Approva
|
||||
return timeline
|
||||
}
|
||||
|
||||
// oaApprovalNodeTypes 读流程定义,取各节点类型(开始/审批/通知/结束)。
|
||||
// 流程被删除或改版时返回空表,调用方按审批节点兜底。
|
||||
func oaApprovalNodeTypes(inst models.ApprovalInstance) map[string]int8 {
|
||||
out := make(map[string]int8)
|
||||
flow, err := approvalEngine.LoadFlow(inst.Scope, inst.Tid, inst.BizType, inst.FlowID)
|
||||
@@ -360,7 +306,6 @@ func oaApprovalNodeTypes(inst models.ApprovalInstance) map[string]int8 {
|
||||
return out
|
||||
}
|
||||
|
||||
// oaApprovalStartNode 虚拟开始节点:即发起人提交动作。
|
||||
func oaApprovalStartNode(inst models.ApprovalInstance) map[string]interface{} {
|
||||
timeStr := ""
|
||||
if inst.SubmitTime != nil {
|
||||
@@ -389,7 +334,6 @@ func oaApprovalStartNode(inst models.ApprovalInstance) map[string]interface{} {
|
||||
}
|
||||
}
|
||||
|
||||
// oaApprovalEndNode 虚拟结束节点:实例运行中为「待完成」,结束后展示最终结果与完成时间。
|
||||
func oaApprovalEndNode(inst models.ApprovalInstance) map[string]interface{} {
|
||||
finishTime := ""
|
||||
if inst.FinishTime != nil {
|
||||
@@ -434,10 +378,6 @@ func oaApprovalEndNode(inst models.ApprovalInstance) map[string]interface{} {
|
||||
return end
|
||||
}
|
||||
|
||||
// ============================ 路由方法 ============================
|
||||
|
||||
// ApprovalCategories GET /api/oa/approval/categories
|
||||
// 返回本租户可用的 biz_type 下拉项,移动端「发起审批」选择单据类型使用。
|
||||
func (c *AppOaController) ApprovalCategories() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -449,9 +389,6 @@ func (c *AppOaController) ApprovalCategories() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalFlows GET /api/oa/approval/flows
|
||||
// 按 biz_type 返回本租户可发起的流程(含流程名 + 节点名列表),
|
||||
// 用于「选择流程」下拉。biz_type 为空时返回全部。
|
||||
func (c *AppOaController) ApprovalFlows() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -494,9 +431,6 @@ func (c *AppOaController) ApprovalFlows() {
|
||||
c.oaOk(map[string]interface{}{"list": list, "total": len(list)})
|
||||
}
|
||||
|
||||
// ApprovalList GET /api/oa/approval/list
|
||||
// 我发起的审批实例(移动端「我的发起」列表)。
|
||||
// 支持 keyword / status / biz_type 过滤。
|
||||
func (c *AppOaController) ApprovalList() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -559,9 +493,6 @@ func (c *AppOaController) ApprovalList() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalTodo GET /api/oa/approval/todo
|
||||
// 我的待办(作为审批人)。返回任务列表 + 关联实例基本信息,
|
||||
// 移动端「待我审批」直接展示。
|
||||
func (c *AppOaController) ApprovalTodo() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -597,7 +528,6 @@ func (c *AppOaController) ApprovalTodo() {
|
||||
|
||||
list := make([]map[string]interface{}, 0, len(tasks))
|
||||
for _, t := range tasks {
|
||||
// 关联查询实例,校验实例仍在审批中(防止实例已结束但任务未及时同步)
|
||||
var inst models.ApprovalInstance
|
||||
if err := models.Orm.QueryTable(new(models.ApprovalInstance)).
|
||||
Filter("id", t.InstanceID).Filter("is_deleted", 0).One(&inst); err != nil {
|
||||
@@ -619,8 +549,6 @@ func (c *AppOaController) ApprovalTodo() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalDetail GET /api/oa/approval/detail/:id
|
||||
// 审批详情:实例基本信息 + 任务时间线 + 当前节点可执行动作。
|
||||
func (c *AppOaController) ApprovalDetail() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -644,8 +572,6 @@ func (c *AppOaController) ApprovalDetail() {
|
||||
return
|
||||
}
|
||||
|
||||
// 权限:仅发起人或当前节点的审批人可查看
|
||||
// 两者独立判断:同一个用户既可能是发起人也可能是审批人(如自审批场景)
|
||||
isSubmitter := inst.SubmitUserID == uid
|
||||
isApprover := false
|
||||
var currentTaskID uint64
|
||||
@@ -678,8 +604,6 @@ func (c *AppOaController) ApprovalDetail() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalSubmit POST /api/oa/approval/submit
|
||||
// 提交审批(发起)。引擎内部完成:创建实例 → 找首个审批节点 → 生成任务。
|
||||
func (c *AppOaController) ApprovalSubmit() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -702,7 +626,6 @@ func (c *AppOaController) ApprovalSubmit() {
|
||||
tid := uint64(claims.TenantId)
|
||||
uid := oaApprovalSubmitUID(claims)
|
||||
|
||||
// 发起人所在部门(用于审批引擎按部门主管匹配审批人)
|
||||
var deptID uint64
|
||||
var tu models.SystemTenantUser
|
||||
if models.Orm.QueryTable(new(models.SystemTenantUser)).
|
||||
@@ -727,7 +650,6 @@ func (c *AppOaController) ApprovalSubmit() {
|
||||
|
||||
instID, err := approvalEngine.Submit(in)
|
||||
if err != nil {
|
||||
// ErrNoFlow / ErrNoApprover 等业务错误统一以 400 返回
|
||||
c.oaErr(400, 400, err.Error())
|
||||
return
|
||||
}
|
||||
@@ -742,8 +664,6 @@ func (c *AppOaController) ApprovalSubmit() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalApprove POST /api/oa/approval/approve
|
||||
// 审批人通过/驳回一条任务。
|
||||
func (c *AppOaController) ApprovalApprove() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -757,13 +677,10 @@ func (c *AppOaController) ApprovalApprove() {
|
||||
return
|
||||
}
|
||||
if p.TaskID == 0 {
|
||||
// 发起人视角在「我的发起」详情里也会看到「通过」按钮(操作入口对齐 Web 端),
|
||||
// 但发起人不是当前审批人,没有可处理的 task:给一个明确的提示而不是含糊的「缺少任务ID」。
|
||||
c.oaErr(403, 403, "您不是当前审批人,无法通过/驳回该审批")
|
||||
return
|
||||
}
|
||||
|
||||
// 校验任务归属本租户、当前审批人
|
||||
var task models.ApprovalTask
|
||||
if err := models.Orm.QueryTable(new(models.ApprovalTask)).
|
||||
Filter("id", p.TaskID).
|
||||
@@ -805,8 +722,6 @@ func (c *AppOaController) ApprovalApprove() {
|
||||
})
|
||||
}
|
||||
|
||||
// ApprovalWithdraw POST /api/oa/approval/withdraw/:id
|
||||
// 发起人撤回(仅审批中允许)。
|
||||
func (c *AppOaController) ApprovalWithdraw() {
|
||||
claims, ok := oaApprovalClaims(c)
|
||||
if !ok {
|
||||
@@ -845,13 +760,11 @@ func (c *AppOaController) ApprovalWithdraw() {
|
||||
"finish_time": now,
|
||||
"update_time": now,
|
||||
})
|
||||
// 同实例剩余待办置为已跳过
|
||||
_, _ = models.Orm.QueryTable(new(models.ApprovalTask)).
|
||||
Filter("instance_id", id).
|
||||
Filter("status", models.ApprovalTaskPending).
|
||||
Update(orm.Params{"status": models.ApprovalTaskSkipped, "update_time": now})
|
||||
|
||||
// 回写业务单据状态(如报销单置为已撤回),保持业务列表与审批中心一致
|
||||
approvalEngine.SyncBizResult(id, models.ApprovalInstanceWithdrawn)
|
||||
|
||||
var updated models.ApprovalInstance
|
||||
|
||||
Reference in new issue
Block a user