数智人事 (HRM System)

flowchart TD
    subgraph ApprovalFlow["1. 请假与加班审批流转链路"]
        A1[员工端发起申请] --> A2{是否满足申请校验}
        A2 -- 余额/天数合法 --> A3[写入业务申请表并启动 Flowable 流程]
        A2 -- 校验不通过 --> A1
        A3 --> A4[主管/审批人接收任务]
        A4 --> A5{审批决策}
        A5 -- 驳回 --> A6[更新业务单据状态为 REJECT]
        A5 -- 批准 --> A7[触发 LeaveApprovalSideEffects 副作用链]
        A7 --> A8[扣减员工请假天数 / 增加调休时长]
        A8 --> A9[写入考勤状态记录与站内通知]
    end

    subgraph RagFlow["2. 企业知识库与智能问答链路"]
        B1[管理员上传制度文档] --> B2[MinIO 原始文件存储]
        B2 --> B3[ETL 管道: 文档解析与切块]
        B3 --> B4[DashScope Embedding 向量化]
        B4 --> B5[(PostgreSQL pgvector 向量库)]
        
        C1[员工发送人事咨询问题] --> C2[智能问答意图识别]
        C2 --> C4[语义向量相似度检索]
        C4 --> B5
        B5 --> C5[召回相关文档切块上下文]
        C5 --> C6[组合检索上下文与员工档案 Prompt]
        C6 --> C7[大模型生成回答（由 CHAT_PROVIDER_MODEL 配置）]
        C7 --> C8[流式/同步反馈给员工前端]
    end

graph TB
    subgraph Client["前端展现层 (hrm-admin)"]
        UI[Vue 2.6 + Element UI]
        Router[动态路由 / 权限守卫]
        Vuex[全局状态管理]
        AxiosInter[Axios 拦截器: 双 Token 无感续期]
    end

    subgraph Security["安全控制与网关切面"]
        Filter[JwtAuthenticationFilter: Cookie 解析与认证]
        PermChecker[Spring Security: RBAC 角色/权限检查]
    end

    subgraph CoreBackend["后端核心业务服务 (hrm-server)"]
        subgraph Domains["纯计算/高内聚领域模块"]
            Overtime[OvertimeCalculator<br/>加班时长核算]
            Salary[SalaryCalculation<br/>薪资社保核算]
            LeaveSide[LeaveApprovalSideEffects<br/>审批副作用流转]
        end

        subgraph Modules["应用服务层"]
            StaffSvc[员工/部门管理服务]
            AttendanceSvc[考勤与打卡分析服务]
            FlowEngine[Flowable 8.0 工作流引擎]
            KnowledgeSvc[RAG IngestionPipeline 知识切块]
            AiAssistantSvc[智能问答（检索增强问答）]
        end
    end

    subgraph ExternalModel["可配置的大模型服务"]
        LLM[对话模型：由 CHAT_PROVIDER_MODEL 配置]
        Embed[Embedding 模型：由 DASHSCOPE_EMBEDDING_MODEL 配置]
    end

    subgraph Persistence["多引擎存储层"]
        DB_Master[(MySQL: hrm 业务主库)]
        DB_Flowable[(MySQL: hrm_flowable 流程专库)]
        DB_Vector[(PostgreSQL + pgvector: 向量库)]
        Cache_Redis[(Redis: 缓存/验证码)]
        Storage_MinIO[(MinIO: 附件与制度文档存储)]
    end

    Client -->|HTTP/REST /api| Filter
    Filter --> PermChecker
    PermChecker --> Modules
    Modules --> Domains

    StaffSvc --> DB_Master
    AttendanceSvc --> DB_Master
    Salary --> DB_Master
    FlowEngine --> DB_Flowable
    
    KnowledgeSvc --> Storage_MinIO
    KnowledgeSvc --> Embed
    KnowledgeSvc --> DB_Vector

    AiAssistantSvc --> LLM
    AiAssistantSvc -.检索召回.-> DB_Vector

    Filter -.验证码与黑名单.-> Cache_Redis