本页适用于计划随 SandAdmin 发布或独立分发的插件。具体业务约束由插件自己的 README 补充。
每个可发布插件至少应包含:
README.md:用途、非目标、宿主兼容范围、安装/升级/卸载、配置、权限、验证步骤和已知限制。- 版本元数据与依赖声明,例如
info.ini、config.json。 - 对应的安装、升级、卸载生命周期实现和 PostgreSQL SQL。
- 后端与前端载荷的实际目录说明;若有宿主镜像副本,说明唯一权威来源与同步方式。
- 适用的许可证、来源与第三方署名文件,确保单独分发后仍可追溯。
- 新业务表使用
sand_<domain>_*前缀,并使用 PostgreSQL 语法和类型。 - 不将 MySQL 方言、会话变量或原地迁移承诺混入 PostgreSQL 安装包。
- 安装、升级、卸载必须对应实际版本生命周期;卸载的影响和数据保留策略要在 README 中写明。
- 版本号、README、发布说明和实际包内容一致。
- 在干净 PostgreSQL 验证环境完成安装;升级和卸载按插件风险单独验证。
- 验证菜单、权限、后端加载和至少一条核心业务路径。
- 对比发布包与权威源码,确认未漏掉前端、SQL、文档或许可证文件。
- 在宿主 README 的插件目录和兼容矩阵中更新可支持的版本范围。
静态检查或构建通过不能替代真实宿主安装和业务路径验收。