更新密码找回uniapp

This commit is contained in:
hero920103 committed 2026-11-16 17:22:50 +08:00
1 parent 7f9a66da0f
commit 3fdda89833
1304 files changed
+3503 -26132

No files matched your search

+9 -96
View File
@@ -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