# catchAdmin

**Repository Path**: php-backend-base/catchAdmin

## Basic Information

- **Project Name**: catchAdmin
- **Description**: CatchAdmin 是一个功能强大、易于扩展的现代化 PHP 后台管理系统。它采用前后端分离架构：后端基于强大的 PHP 框架 Laravel，纯粹提供 API 接口；前端则拥抱现代技术栈，使用 Vue 3 和 Element Plus 构建用户界面。  通过精心的模块化设计，CatchAdmin 极大地降低了后台管理系统中各个模块的耦合度，为开发者提供了灵活、高效的二次开发体验
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: v5
- **Homepage**: https://catchadmin.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 415
- **Created**: 2025-12-12
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: laravel12

## README

<br />
<div align="center">
    <img src="https://image.catchadmin.com/202601101626397.png" alt="logo" width="300"/>
    <h1 style="font-size:36px;font-weight:600;margin:0 0 6px 0;
  background:linear-gradient(
    120deg,
    #42a5f5 0%,
    #6a8dff 25%,
    #42a5f5 50%,
    #5c6bc0 75%,
    #42a5f5 100%
  );
  color:transparent;
  background-clip:text;
  -webkit-background-clip:text;
">CatchAdmin</h1>
    <p style="font-size:17px;color:#6a8bad;margin-bottom:10px;">
        Build a full-featured admin system with a powerful built-in permission system in just 5 minutes
    </p>
    <a href="https://catchadmin.com" target="_blank">Official Site</a> |
    <a href="https://v5.catchadmin.com" target="_blank">Live Demo</a> |
    <a href="https://catchadmin.vip/forum" target="_blank">Community</a> |
    <a href="https://catchadmin.vip/plugins" target="_blank">Plugins</a> |
    <a href="https://doc.catchadmin.com/" target="_blank">Documentation</a> |
    <a href="https://gitee.com/catchadmin/catchAdmin" target="_blank">Gitee</a> |
    <a href="https://github.com/JaguarJack/catch-admin" target="_blank">GitHub</a>
</div>
<br />
<p align="center">
    <a href="https://php.net/" target="_blank">
        <img src="https://img.shields.io/badge/PHP-8.2-777bb4?style=for-the-badge&logo=php&logoColor=white" alt="PHP">
    </a>
    <a href="https://laravel.com/" target="_blank">
        <img src="https://img.shields.io/badge/Laravel-12-red?style=for-the-badge&logo=laravel&logoColor=white" alt="Laravel">
    </a>
    <a href="https://vuejs.org/" target="_blank">
        <img src="https://img.shields.io/badge/Vue-3.x-42b883?style=for-the-badge&logo=vuedotjs&logoColor=white" alt="Vue">
    </a>
    <a href="https://element-plus.org/" target="_blank">
      <img src="https://img.shields.io/badge/Element%20Plus-UI-409EFF?style=for-the-badge&logo=element&logoColor=white" alt="Element Plus">
    </a>
    <a href="https://vitejs.dev/" target="_blank">
        <img src="https://img.shields.io/badge/Vite-7.x-646CFF?style=for-the-badge&logo=vite&logoColor=white" alt="Vite">
    </a>
    <a href="https://httpd.apache.org/" target="_blank">
      <img src="https://img.shields.io/badge/Apache-2.0-D22128?style=for-the-badge&logo=apache&logoColor=white" alt="Apache">
    </a>
</p>

## Introduction

`CatchAdmin` is an open-source PHP admin system built on top of [Laravel 12.x](https://laravel.com) and [Vue 3](https://vuejs.org/), using a fully decoupled frontend-backend architecture. It is designed for enterprise-level backend scenarios and provides a modular, extensible framework with rich features out of the box.

The system includes Token-based authentication, permission management (menu, button, and data-level permissions), dynamic routing, dynamic tables, pagination abstraction, resource authorization, upload/download support, a code generator (with one-click import/export), recycle bin, attachment management, and more—covering common needs from security and access control to high-efficiency development.

From an architectural perspective, `Laravel` is used strictly as an `API` service layer, minimizing coupling between business modules. Each module is fully independent, with its own controllers, routes, models, and database tables, enabling modular development, on-demand loading, and independent evolution. This significantly reduces development complexity while improving maintainability and iteration speed. In addition, many common utilities are encapsulated (such as unified responses, exception handling, pagination, and resource wrappers), allowing developers to focus more on business logic.

Based on `CatchAdmin`, you can quickly build systems such as `CMS`, `CRM`, and `OA`, and continuously extend business modules on top of a stable infrastructure to meet the needs of teams of different sizes.

[Chinese](./README.md) | [English](./README-en.md)

## Features

- ☑️ **User Management**: Create, edit, delete, disable users, reset passwords, and manage profiles; different users can see different dashboards and features
- ☑️ **Department Management**: Multi-level organization structure (company/department/team) with tree-based management and personnel assignment
- ☑️ **Position Management**: Unified management of positions (roles/jobs), supporting primary and multiple positions per user
- ☑️ **Role Management**: Tree-based role system supporting menu permissions, button-level permissions, and data access control
- ☑️ **Menu Management**: Visual configuration of menus, routes, and buttons with sorting, hierarchy, and visibility control
- ☑️ **Dictionary Management**: Centralized management of enums, statuses, and common constants with grouping and enable/disable support
- ☑️ **System Configuration**: Centralized configuration of system parameters with dynamic loading and fast effect
- ☑️ **Operation Logs**: Records key user operations with multi-dimensional querying for auditing and troubleshooting
- ☑️ **Login Logs**: Tracks login history (time/IP/device, depending on implementation) for security analysis
- ☑️ **File Upload**: Unified upload mechanism supporting `Local`, `Qiniu`, `Aliyun OSS`, and `Tencent COS`
- ☑️ **Attachment Management**: Centralized management of uploaded files and images with search, preview, and cleanup
- ☑️ **Database Maintenance**: Table optimization, fragment cleanup, and data recycle/destroy management
- ☑️ **Code Generator**: One-click generation of backend (`PHP`), frontend (`Vue`), and database migration code
- ☑️ **Vue Instant Rendering**: Supports instant Vue rendering without build steps, accelerating development and debugging
- ☑️ **Plugin System**: Plugins are Composer packages, deeply integrated with the Composer ecosystem for modular extension
    - Docs: [CatchAdmin Plugin Quick Start](https://doc.catchadmin.com/docs/5.0/plugin/quickstart)

## Frontend Project

[catchadmin-vue](https://gitee.com/catchadmin/catch-admin-vue)

## Live Demo

[Demo Site](https://v5.catchadmin.com)

- Account: `catch@admin.com`
- Password: `catchadmin`

## Discussion

- You can submit issues following the issue template
- Join the community via WeChat (add and note `catchadmin`)

<img src="./resources/screenshoots/wechat.png" width="200"/>
## Preview

|                                                |                                                     |
|------------------------------------------------|-----------------------------------------------------|
| ![Login](./resources/screenshoots/login.png)      | ![Dashboard](./resources/screenshoots/dashboard.png)      |
| ![Permissions](./resources/screenshoots/permission.png) | ![Layout](./resources/screenshoots/layouts.png)         |
| ![Upload](./resources/screenshoots/upload.png)     | ![Code Generator](./resources/screenshoots/code_generate.png) |
| ![Menu](./resources/screenshoots/menu.png)       | ![Template](./resources/screenshoots/template.png)        |

## Video Tutorials

- [CatchAdmin Installation](https://www.bilibili.com/video/BV1eY411v71J/)
- [CatchAdmin – Module Creation](https://www.bilibili.com/video/BV1jP41127aW/)
- [CatchAdmin – Rapid Development](https://www.bilibili.com/video/BV1Qh4y1J7eB/)

## Related Resources

- [Laravel Chinese Documentation](https://laravel-docs.catchadmin.com/)
- [Laravel Free Beginner Tutorial](https://laravel-study.catchadmin.com)
- [Laravel Livewire Chinese Documentation](https://laravel-livewire.catchadmin.com/)

## Code Standards

### PHP

Format code using Laravel Pint:

```shell
composer format
```

Static analysis using PHPStan
```shell
composer analyse
```
## Acknowledgements 🙏
- [Laravel](https://laravel.com)
- [Vue](https://cn.vuejs.org/)
- [ElementPlus](https://element-plus.org)
- [VitePress](https://vitepress.dev/zh/)