mgmt / tpl-admin

1.0.0 2026-09-04 07:59 UTC

Requires

• php: >=8.2
• ext-gd: *
• ext-zip: *
• illuminate/support: ^11.0|^12.0|^13.0
• laravel/sanctum: ^4.0
• slowlyo/laravel-support: *

MIT

• mgmt

• admin
• laravel
• amis
• tpl-admin

Published on Packagist.org on 2026-09-04 09:04 UTC

README

<h1 align="center">
    Tpl Admin
</h1>
<h4 align="center">
    快速且灵活的后台框架
</h4>

基于 Laravel、amis 的后台框架扩展包 mgmt/tpl-admin

码云仓库

项目介绍

基于 Laravel 、 amis 开发的后台框架, 快速且灵活~

当前版本支持 Laravel 11.x - 13.x。

• 基于 amis 以 json 的方式在后端构建页面，减少前端开发工作量，提升开发效率。
• 在 amis 150多个组件都不满足的情况下, 可自行开发前端。
• 框架为前后端分离 (不用再因为框架而束手束脚~)。

组件用法见 开发文档：全部组件。

内置功能

• 基础后台功能
  • 后台用户管理
  • 角色管理
  • 权限管理
  • 菜单管理
  • 数据字典
  • 通知公告
  • 操作日志 / 登录日志
  • 登录失败锁定（防暴力破解）
  • 顶部菜单搜索
• 代码生成器
  • 保存生成记录
  • 导入/导出生成记录
  • 可使用命令清除生成的内容
  • 无需更改代码即可生成完整功能
• amis 全组件封装 150+ , 无需前端开发即可完成复杂页面
• 多模块支持
• 图形化扩展管理
• 动态 API 模板管理（CRUD / 选项 / 设置 / 状态切换 / 聚合统计）

安装

👉 注意: TplAdmin 是 laravel 的扩展包, 安装前请确保你会使用 laravel

1. 创建 laravel 项目

composer create-project laravel/laravel example-app

2. 配置数据库信息并安装 API 模块

# .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=tpl_admin
DB_USERNAME=root
DB_PASSWORD=

安装 API 模块 (Laravel 11+)

php artisan install:api

3. 获取 Tpl Admin

本包尚未发布到 Packagist。不要在本仓库根目录执行 composer require mgmt/tpl-admin（这里本身就是该包）。

在 Laravel 宿主项目 的 composer.json 增加仓库源后安装，任选其一：

方式 A：码云 VCS（推荐）

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://gitee.com/zhaohongxiang/mgmt-tpl-admin.git"
        }
    ]
}

composer require mgmt/tpl-admin:dev-main

方式 B：本地 path 开发

{
    "repositories": [
        {
            "type": "path",
            "url": "../mgmt-tpl-admin"
        }
    ]
}

url 改成你本机 mgmt-tpl-admin 目录的相对或绝对路径，然后执行：

composer require mgmt/tpl-admin:@dev

4. 安装

# 先发布框架资源
php artisan tpl:publish
# 执行安装 (可以在执行安装命令前在 config/admin.php 中修改部分配置)
php artisan tpl:install

5. 安装 AI 编辑器开发资料（可选）

如果你希望在 Codex、Cursor、Claude Code、Trae 等 AI 编辑器中开发 Tpl Admin 项目，可以执行：

php artisan tpl:ai-install

该命令会在项目根目录生成 .agents 目录：

• .agents/skills：Codex、Cursor 等支持 Agent Skills 的工具可直接读取
• .agents/adapters：提供 Claude Code、Cursor、Trae 等编辑器的规则适配文件
• .agents/README.md：说明不同编辑器如何使用这些文件

内置 skills 覆盖后台业务开发、amis 页面、扩展多模块、代码生成器、动态 API、安装升级命令、前端资源、框架原理、助手函数、组件管道、系统设置、动态页面、开发示例和常见问题等场景，并按主题合并为少量入口，减少 AI 选择噪音。

常用编辑器复制方式：

# Cursor 项目规则
mkdir -p .cursor/rules
cp .agents/adapters/cursor/owl-admin.mdc .cursor/rules/owl-admin.mdc

# Claude Code 项目规则
cp .agents/adapters/CLAUDE.md CLAUDE.md

# Claude Code Agent Skills
mkdir -p .claude/skills
cp -R .agents/skills/* .claude/skills/

# Trae 项目规则
mkdir -p .trae/rules
cp .agents/adapters/trae/owl-admin.md .trae/rules/owl-admin.md

如果本地已调整过 .agents 文件，可使用 --force 覆盖：

php artisan tpl:ai-install --force

6. 已安装环境升级

升级到包含日志、字典、公告、登录锁定等功能时，在宿主项目执行：

php artisan tpl:update --yes

该命令会创建新表、写入对应菜单，并发布前端资源。完成后强制刷新浏览器即可使用顶部菜单搜索。

仅更新前端资源（如替换 Logo）时：

php artisan tpl:publish --assets --force --yes

7. 运行项目

启动服务, 访问 /admin 路由即可
初始账号密码都是 admin

仓库

• 码云：https://gitee.com/zhaohongxiang/mgmt-tpl-admin
• Git 克隆：git clone https://gitee.com/zhaohongxiang/mgmt-tpl-admin.git

支持项目

你可以通过以下方式支持项目:

• 报告 Bug
• 提交 PR（参见 贡献文档）