README

SandAdmin 是一个基于 Webman 的 PostgreSQL 原生后台管理包，提供权限管理、系统配置、代码生成、任务调度和插件化扩展能力。源码仓库只维护 server/ 后端源码、sandadmin-artd/ Vue 前端源码和公共文档；完整 Webman 运行环境、依赖和演示数据属于 /Users/code/project/sand_demo 等消费项目，不在本仓重复维护。

来源说明：SandAdmin 是基于 SaiAdmin 6.x 修改和维护的独立 PostgreSQL fork。它不是 SaiAdmin 官方发行版，也不代表 SaiAdmin 或其作者的背书。名称、目录和运行配置已按 SandAdmin 维护；为了已有实例与第三方依赖兼容，部分历史标识仍会保留在实现层。

特性与边界

• PostgreSQL 优先：核心安装器按数据库驱动选择初始化脚本，核心 SQL 位于 server/plugin/sandadmin/db/。
• 插件化：Sand 平台新插件使用 sand_<domain>_* 表前缀；可选插件独立打包发布，插件仓库直接读取 GitHub 清单和 Release 附件，无需独立市场平台。
• 兼容优先：部分历史核心 sa_* 表和必要的第三方兼容标识不会因品牌更名被强制改写。
• 非迁移工具：本仓库不承诺将既有 MySQL 实例原地迁移到 PostgreSQL；升级或迁移应先在隔离环境验证。

快速开始

运行环境、配置项和首次安装步骤见本地运行与首次安装。简要流程为：

1. 创建标准 Webman 项目：composer create-project workerman/webman server。
2. 在该项目中通过 Composer 安装 supdger/sandadmin；安装器会复制 SandAdmin 与 SandPackage 后端载荷。
3. 参考包内 server/install/ 配置 PostgreSQL；首次访问安装页前不要预建 .env。前端从 sandadmin-artd/ 独立安装或构建。
4. 仅在已明确准备的全新数据库上访问 /install 完成初始化。

已登记 Packagist，可直接安装最新稳定版：

composer require supdger/sandadmin

需要锁定特定版本时再使用 composer require supdger/sandadmin:6.1.5。升级时应提交消费者的 composer.lock。

全新安装完成后，使用 admin / 123456 登录管理后台，并在首次登录后立即修改默认密码。该初始凭据仅适用于由当前安装器创建的全新数据库；已安装实例不会被安装器重置管理员密码。

默认前端目录为 sandadmin-artd；服务与 Channel 端口变量为 SANDADMIN_SERVER_PORT、SANDADMIN_CHANNEL_PORT。

文档

• 文档总览
• 本地运行与首次安装
• 架构与插件边界
• 仓库与插件治理
• 插件开发与发布约定
• 仓库插件分发
• 插件管理端载荷激活契约
• 宿主发布与消费同步
• 更名与插件兼容性通知
• 上游来源、署名与许可证说明

可选插件

根目录 catalog.json 只维护统一插件目录。每个可选插件拥有独立源码仓库和 Release，宿主不保存业务插件源码、安装包、运行副本或专属自动加载映射。安装器按目录声明的受信仓库下载所选插件；未选择插件的用户只会获取 SandAdmin 主体。

SandAdmin 不主动写入其他工作区；每个消费者负责拉取并锁定所需宿主版本。插件实际安装与验收仍在消费工作区的独立验证宿主完成。

插件发布包必须在其自己的源码单元保留安装、升级、卸载、权限、兼容性和 已知限制说明；宿主只维护公共约定与兼容性入口，避免两处文档漂移。

版本

版本变化见 CHANGELOG。

来源与许可证

本仓库及保留的上游源代码遵循 MIT 许可证。发布、分发或再修改时，必须保留适用的版权与许可证声明；完整来源和第三方组件说明见 NOTICE。