# lhpadmin

**Repository Path**: dragonlhp/lhpadmin

## Basic Information

- **Project Name**: lhpadmin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-11
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lhp Admin 后台管理系统

## 项目简介

Lhp Admin 是一个基于 ThinkPHP 8.0 和 React 17 开发的现代化后台管理系统，采用前后端分离架构，提供了完善的权限管理、内容管理和插件系统，适用于各种企业级应用开发。

## 核心功能

- **权限管理**: 基于 Casbin 的 RBAC 权限管理，支持细粒度的权限控制
- **内容管理**: 灵活的内容管理系统，支持多种内容类型
- **插件系统**: 模块化的插件架构，支持热插拔和扩展
- **前后端分离**: 基于 React + TypeScript + amis 的现代化前端架构
- **RESTful API**: 标准化的 API 设计，支持多客户端接入
- **JWT 认证**: 基于 JWT 的无状态认证机制
- **多数据库支持**: 支持 MySQL、PostgreSQL、SQLite 等多种数据库

## 技术栈

### 后端
- **框架**: ThinkPHP 8.0
- **语言**: PHP 8.0+
- **权限管理**: Casbin
- **认证**: JWT
- **ORM**: ThinkPHP ORM
- **依赖管理**: Composer

### 前端
- **框架**: React 17 + TypeScript
- **低代码框架**: amis 6.13.0
- **UI 组件库**: Ant Design 5
- **构建工具**: Vite
- **依赖管理**: pnpm
- **路由**: React Router 6
- **状态管理**: React Context + useReducer

## 开发文档

项目提供了详细的开发文档和规范，位于 `.trae/documents` 目录下：

1. **项目概述**: 项目介绍、核心功能、设计理念和使用场景
2. **技术栈详情**: 详细的后端和前端技术栈说明
3. **开发环境搭建**: 环境要求、安装步骤和常见问题
4. **项目结构详解**: 目录结构、多应用架构和核心模块
5. **后端编码规范**: PHP 编码规范、命名约定和最佳实践
6. **前端编码规范**: React/TypeScript 编码规范、CSS 约定和性能优化
7. **数据库设计规范**: 数据库命名规范、表设计原则和索引优化
8. **API 开发规范**: RESTful API 设计、请求/响应格式和错误处理
9. **插件开发规范**: 插件目录结构、钩子系统和开发流程
10. **部署流程**: 部署环境要求、步骤和生产环境优化
11. **测试规范**: 测试策略、框架和用例编写规范
12. **代码审查规范**: 代码审查流程、规范和最佳实践

## 快速开始

### 环境要求

- PHP 8.0.0+
- MySQL 5.7+ 或 PostgreSQL 10+
- Node.js 16+ 和 pnpm
- Composer

### 安装步骤

1. **克隆代码**
   ```bash
   git clone https://your-repo-url/lhpadmin.git
   cd lhpadmin
   ```

2. **安装后端依赖**
   ```bash
   composer install
   ```

3. **安装前端依赖**
   ```bash
   cd backend-ui
   pnpm install
   pnpm run build
   cd ..
   ```

4. **配置数据库**
   复制 `.env.example` 为 `.env`，并配置数据库连接：
   ```env
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=lhpadmin
   DB_USERNAME=root
   DB_PASSWORD=your_password
   ```

5. **执行数据库迁移**
   ```bash
   php think migrate:run
   php think seed:run
   ```

6. **启动开发服务器**
   ```bash
   # 启动后端开发服务器
   php think run
   
   # 启动前端开发服务器（可选）
   cd backend-ui
   pnpm run dev
   ```

7. **访问系统**
   - 后端 API: http://localhost:8000
   - 前端页面: http://localhost:8000/admin

## 项目结构

```
lhpadmin/
├── app/                  # 后端应用目录
│   ├── admin/            # 管理后台应用
│   ├── cms/              # 内容管理系统
│   └── common/           # 公共模块
├── backend-ui/           # 前端代码目录
│   ├── src/              # 前端源代码
│   ├── public/           # 前端静态资源
│   └── package.json      # 前端依赖配置
├── config/               # 配置文件目录
├── database/             # 数据库迁移和种子文件
├── extend/               # 扩展库目录
├── plugin/               # 插件目录
├── public/               # 公共资源目录
├── runtime/              # 运行时目录
├── tests/                # 测试目录
├── .env.example          # 环境变量示例
├── composer.json         # 后端依赖配置
└── README.md             # 项目说明文档
```

## 开发规范

### 编码规范

- **后端**: 遵循 PSR 规范，使用 PHPStan 进行静态分析
- **前端**: 遵循 ESLint 和 Prettier 规范，使用 TypeScript 进行类型检查
- **数据库**: 遵循数据库设计规范，使用迁移脚本管理数据库结构

### 提交规范

使用 Conventional Commits 规范，提交信息格式：
```
<type>(<scope>): <description>

[optional body]

[optional footer(s)]
```

常用类型：
- **feat**: 新功能
- **fix**: 修复bug
- **docs**: 文档更新
- **style**: 代码风格更新
- **refactor**: 代码重构
- **test**: 测试更新
- **chore**: 构建或配置更新

## 测试

### 后端测试

使用 PHPUnit 进行单元测试和集成测试：
```bash
vendor/bin/phpunit
```

### 前端测试

使用 Jest 进行单元测试：
```bash
cd backend-ui
pnpm test
```

使用 Playwright 进行端到端测试：
```bash
cd backend-ui
pnpm run e2e
```

## 部署

### 生产环境部署

1. **代码部署**: 使用 Git 克隆代码或上传打包文件
2. **依赖安装**: 安装后端和前端依赖
3. **环境配置**: 配置生产环境变量
4. **数据库迁移**: 执行数据库迁移
5. **静态资源**: 构建前端静态资源
6. **Web 服务器配置**: 配置 Nginx 或 Apache
7. **权限设置**: 设置目录权限
8. **缓存优化**: 生成路由缓存和配置缓存

详细部署流程请参考 `.trae/documents/10-部署流程.md`

## 安全

- **输入验证**: 所有输入都经过验证和过滤
- **SQL 注入防护**: 使用参数化查询和 ORM 框架
- **XSS 防护**: 输出数据进行转义
- **CSRF 防护**: 实现 CSRF 令牌机制
- **密码加密**: 使用 bcrypt 进行密码加密
- **JWT 认证**: 基于 JWT 的无状态认证

## 插件开发

Lhp Admin 支持插件化开发，插件可以扩展系统功能，支持热插拔。详细的插件开发指南请参考 `.trae/documents/09-插件开发规范.md`

## 贡献

欢迎贡献代码，提交 Pull Request 前请确保：

1. 代码符合项目编码规范
2. 所有测试通过
3. 添加了适当的测试用例
4. 提交信息符合 Conventional Commits 规范

## 许可证

本项目采用 MIT 许可证，详情请参考 LICENSE 文件。

## 联系方式

- **项目地址**: https://github.com/your-username/lhpadmin
- **问题反馈**: https://github.com/your-username/lhpadmin/issues
- **文档地址**: https://github.com/your-username/lhpadmin/tree/main/.trae/documents

## 更新日志

### v1.0.0 (2025-12-12)
- 初始版本发布
- 完成核心功能开发
- 提供详细的开发文档

## 致谢

感谢以下开源项目的支持：

- [ThinkPHP](https://www.thinkphp.cn/)
- [React](https://reactjs.org/)
- [Casbin](https://casbin.org/)
- [amis](https://aisuda.bce.baidu.com/amis/)
- [Ant Design](https://ant.design/)

## 注意事项

1. 本项目仅用于学习和开发，生产环境使用前请进行充分测试
2. 请根据实际需求配置安全参数
3. 定期更新依赖包，修复安全漏洞
4. 建议使用 HTTPS 协议部署生产环境

## 文档索引

| 文档名称 | 路径 |
|---------|------|
| 项目概述 | .trae/documents/01-项目概述.md |
| 技术栈详情 | .trae/documents/02-技术栈详情.md |
| 开发环境搭建 | .trae/documents/03-开发环境搭建.md |
| 项目结构详解 | .trae/documents/04-项目结构详解.md |
| 后端编码规范 | .trae/documents/05-后端编码规范.md |
| 前端编码规范 | .trae/documents/06-前端编码规范.md |
| 数据库设计规范 | .trae/documents/07-数据库设计规范.md |
| API 开发规范 | .trae/documents/08-API开发规范.md |
| 插件开发规范 | .trae/documents/09-插件开发规范.md |
| 部署流程 | .trae/documents/10-部署流程.md |
| 测试规范 | .trae/documents/11-测试规范.md |
| 代码审查规范 | .trae/documents/12-代码审查规范.md |