# 审批平台架构

## 产品定位

ApprovaPlat 是基于 RuoYi 前后端分离框架和 Flowable 8 的企业审批平台。每项正式能力都由真实业务入口、后端规则、正式持久化、审计与运维链路共同实现。

平台覆盖流程分类、表单、BPMN 模型、部署、DMN、扩展注册表、HTTP/SQL 连接器、运行事件、发起与审批工作台、附件、审计和实例运维。

## 运行结构

```mermaid
flowchart LR
    Browser["Vue 3 前端"] --> Nginx["Nginx TLS 入口"]
    Nginx --> Admin["ruoyi-admin HTTP 边界"]
    Admin --> Domain["ruoyi-flowable 领域服务"]
    Domain --> Engine["Flowable 8 Process/DMN"]
    Domain --> Business["MyBatis 业务持久化"]
    Engine --> MySQL["MySQL 正式基线"]
    Business --> MySQL
    Admin --> Redis["Redis 登录与缓存"]
    Domain --> Storage["私有附件持久卷"]
```

## 模块职责

- `ruoyi-admin`：HTTP 协议、参数校验、登录用户权限、下载响应和操作日志入口。
- `ruoyi-flowable`：对象授权、状态校验、事务、Flowable 命令、业务表写入、附件和集成能力。
- `ruoyi-system`：用户、角色、部门、菜单和系统操作日志主数据。
- `ruoyi-ui`：真实 API 调用、管理页面、工作台、BPMN 设计/查看和表单运行时。
- `sql/flowable`：Flowable 官方表、工作流业务表和菜单权限。

## 接口边界

- `com.ruoyi.web.controller.workflow` 下的工作流 Controller 提供正式登录用户入口，并由五角色 RBAC 矩阵冻结方法、路径和权限表达式。
- 运行事件由独立 Controller 提供 3 个机器调用入口，并通过专用集成 Token、限流、幂等和审计校验。
- 每个流程实例、任务、附件、部署和审计查询同时执行 URL 权限与对象授权，验证当前用户和目标对象的业务关系。

## 数据与事务

- Flowable `ACT_*` 与项目 `wf_*` 共用主数据源和 Spring 事务管理器。
- 一次审批动作涉及的引擎状态、业务记录、附件绑定和审计结果必须原子提交或整体回滚。
- 已部署流程以不可变表单、扩展和 DMN 快照作为运行语义；编辑态模板变化只作用于后续部署。
- 生产配置固定 `flowable.database-schema-update=false`，数据库结构通过仓库维护的正式 SQL 升级。

## 安全边界

- 用户身份只来自正式 `sys_user`、`sys_role`、`sys_dept` 数据。
- BPMN 扩展通过服务端已安装实现目录选择，类名、脚本和网络访问均由固定白名单控制。
- 附件只保存受控相对路径，文件位于 Web 根目录之外；上传、读取和删除同时执行权限、对象、容量和生命周期校验。
- 凭据通过受控环境变量、私有密钥文件或加密密钥系统注入；源码、SQL、发布包清单和测试报告只保存公开配置与密钥引用。

## 运行原则

- executor 默认关闭，在数据库、拓扑、容量、监控和唯一执行协调全部验收通过后启用。
- 单节点使用本地持久卷；多节点共享 Token 密钥、附件存储和经过验证的 executor/清理锁拓扑。
- readiness 汇总数据库、Redis、工作流运行快照、附件存储和关键低基数指标，全部达到就绪状态后接收流量。