SandWorkflow Installation

安装、升级与卸载 SandWorkflow

面向 SandAdmin 管理员。完成后，目标账号能打开 SandWorkflow 页面并进行最小流程验证。

准备已初始化的 SandAdmin 0.1.x PostgreSQL 宿主、插件管理权限及需要分配角色的权限。
从维护者提供的发行入口获取与目标版本一致的完整 SandPackage ZIP；源码目录不是可运行宿主。当前源码为 1.0.7，本页不声称某个 ZIP 已公开发布。
确认宿主存在名为 pgsql 的 PostgreSQL 连接；不要为了安装隐式创建新库。
插件依赖宿主已有用户、角色和部门。准备一个流程管理员、一个发起人、一个启用的审批人。
在隔离环境先验证宿主与插件的具体版本组合，记录备份和恢复安排。

在宿主的插件管理入口上传并安装完整发行包。包应含根部元数据、三份生命周期 SQL、plugin/sandworkflow/ 后端、sandadmin-artd/src/views/plugin/sandworkflow/ 前端及许可证材料。
安装完成后刷新后台菜单；若宿主需要重载路由或配置，交由宿主管理员按既定运维方式处理。
在角色权限管理中分配 SandWorkflow 菜单和相应按钮权限，见角色与权限。
用目标账号重新登录，确认流程分组、流程定义和流程中心页面可打开，再完成最小流程。

首次安装不是修复入口。 当前 install.sql 开头会删除同名工作流表，再创建结构；已有业务数据时不能手动重跑它。菜单存在但页面缺失时先按故障排查核对完整载荷。

记录旧版本、目标版本、宿主版本与包来源，备份 PostgreSQL 业务数据和对应安装材料。
在隔离副本中通过 SandPackage 的升级生命周期升级。当前 Install::update() 执行 update.sql，随后补齐表单变更审计字段、迁移旧运行标识并检查 NanoID 表结构。
核对历史定义、运行中的实例、待办和实例详情；验证一次新发起和审批，并检查升级前运行中的实例仍使用原定义快照。
隔离验证完成后，再按组织的发布安排升级正式宿主并复核授权与菜单。

当前升级脚本针对现有 sand_workflow_* 结构；旧指南中的“直接重命名全部 sa_workflow_* 表”不能作为 1.0.7 的通用升级承诺。发现旧 SaiWorkflow 表、MySQL 数据或未知旧版本时，先确定版本及迁移方案，不能以重跑安装代替升级。

卸载会执行 uninstall.sql，删除工作流菜单、权限关联及七张 sand_workflow_* 表。此操作会清除流程定义、实例、任务和日志；需要保留的业务数据应先按组织要求导出并验证备份。

确认卸载权限、数据处置和恢复方案后，通过 SandPackage 卸载。完成后核对工作流入口与权限已清理、通用宿主仍可登录和使用。卸载不是回滚工具；不要用“卸载再安装”恢复未知故障。

本轮仅核对文档与生命周期源码，未执行安装、升级、卸载或 SQL。