SandAdmin 是一个基于 Webman 的 PostgreSQL 原生后台管理项目，提供权限管理、系统配置、代码生成、任务调度和插件化扩展能力。仓库同时维护完整的 server/ Webman 后端和 sandadmin-artd/ Vue 管理前端；克隆仓库即可分别安装依赖并运行。
来源说明：SandAdmin 是基于 SaiAdmin 6.x 修改和维护的独立 PostgreSQL fork。它不是 SaiAdmin 官方发行版，也不代表 SaiAdmin 或其作者的背书。名称、目录和运行配置已按 SandAdmin 维护；为了已有实例与第三方依赖兼容，部分历史标识仍会保留在实现层。
- PostgreSQL 优先：核心安装器按数据库驱动选择初始化脚本，核心 SQL 位于
server/plugin/sandadmin/db/。 - 插件化：Sand 平台新插件使用
sand_<domain>_*表前缀；可选插件独立打包发布，插件仓库直接读取 GitHub 清单和 Release 附件，无需独立市场平台。 - 兼容优先：部分历史核心
sa_*表和必要的第三方兼容标识不会因品牌更名被强制改写。 - 非迁移工具：本仓库不承诺将既有 MySQL 实例原地迁移到 PostgreSQL；升级或迁移应先在隔离环境验证。
运行环境、配置项和首次安装步骤见本地运行与首次安装。简要流程为：
- 克隆仓库：
git clone https://github.com/supdger/sandadmin.git。 - 在
server/执行composer install，保持.env不存在并运行php start.php。 - 在
sandadmin-artd/按需复制.env*.example，执行corepack pnpm install --frozen-lockfile和corepack pnpm dev。 - 自行准备空 PostgreSQL 数据库，访问
http://localhost:8787/core/install完成初始化。
supdger/sandadmin:6.1.5 曾作为 Composer 后端包发布，保留供已锁定消费者追溯；当前主线不再继续发布新的 Composer 后端包，也不再把下列命令作为新项目安装入口：
composer require supdger/sandadmin:6.1.5全新安装完成后，使用 admin / 123456 登录管理后台，并在首次登录后立即修改默认密码。该初始凭据仅适用于由当前安装器创建的全新数据库；已安装实例不会被安装器重置管理员密码。
默认前端目录为 sandadmin-artd；服务与 Channel 端口变量为 SANDADMIN_SERVER_PORT、SANDADMIN_CHANNEL_PORT。
根目录 catalog.json 只维护统一插件目录。每个可选插件拥有独立源码仓库和 Release，宿主不保存业务插件源码、安装包、运行副本或专属自动加载映射。安装器按目录声明的受信仓库下载所选插件；未选择插件的用户只会获取 SandAdmin 主体。
统一演示与验收宿主只从 SandAdmin 和各插件权威仓库单向接收源码或发布包，不反向承载源码开发。插件实际安装与验收仍在消费工作区或可丢弃隔离宿主完成。
插件发布包必须在其自己的源码单元保留安装、升级、卸载、权限、兼容性和 已知限制说明；宿主只维护公共约定与兼容性入口，避免两处文档漂移。
版本变化见 CHANGELOG。
本仓库及保留的上游源代码遵循 MIT 许可证。发布、分发或再修改时，必须保留适用的版权与许可证声明；完整来源和第三方组件说明见 NOTICE。