# 简介

欢迎使用 PPanel！这是一个纯粹、专业、完美的开源代理面板工具，旨在为用户提供完整的管理解决方案。

## 什么是 PPanel？

PPanel 是一个现代化的代理面板系统，采用前后端分离架构，提供完整的用户管理、订阅服务、订单管理、节点管理等功能。无论您是个人用户还是企业用户，PPanel 都能满足您的需求。

## 核心特性

- **🎯 完整管理**: 服务器管理、节点配置、订阅系统、产品管理等
- **💼 商务运营**: 订单管理、优惠券系统、营销活动、公告发布
- **👥 用户支持**: 用户管理、工单系统、文档中心，提供全方位用户服务
- **📊 数据分析**: 12 种类型日志，全面的流量、余额、佣金数据分析
- **🔧 灵活配置**: 支付配置、认证控制、广告管理，灵活的系统选项
- **🚀 现代技术栈**: 基于 React 19 + TypeScript + TailwindCSS + shadcn/ui 构建

## 术语说明

PPanel 的一些术语与其他面板系统存在差异，为确保您能准确理解文档内容并避免误解，建议在阅读前先了解以下术语：

### 用户端
为最终用户提供的界面，用户通过该界面与系统进行交互。您可以根据需求自定义或重构该界面，实现站点的个性化定制。

### 管理端
用于管理员操作的界面，负责管理系统、用户及数据。您可以根据需求对该界面进行定制或重构，以适应您的管理需求。

### 服务端
PPanel 的 API 层，处理与前端的所有数据交互，负责业务逻辑的执行与数据服务的提供。

### 节点端
负责 PPanel 服务端与各节点（落地端）的通信，确保网络节点的连接与服务的稳定性。

### 客户端
用户用来连接系统的应用程序，通常是指用户的设备端软件或应用，负责与系统建立连接并使用相关服务。

## 项目架构

PPanel 采用 Monorepo 架构，便于统一管理和维护：

### 前端应用
- **apps/admin**: 管理后台应用，提供完整的后台管理功能
- **apps/user**: 用户端应用，为最终用户提供服务界面

### 共享包
- **packages/ui**: 共享 UI 组件库，包含所有可复用的 UI 组件
- **packages/typescript-config**: 统一的 TypeScript 配置

### 技术栈
- **框架**: React 19 + TypeScript
- **路由**: TanStack Router
- **状态管理**: Zustand
- **样式**: TailwindCSS 4.0
- **UI 组件**: shadcn/ui
- **构建工具**: Vite + Turbo
- **代码规范**: Biome
- **Git 规范**: Lefthook + Gitmoji

## 主要功能

### 运维管理
- 服务器管理
- 节点管理
- 订阅配置
- 产品管理

### 商务管理
- 订单管理
- 优惠券管理
- 营销管理
- 公告管理

### 用户与支持
- 用户管理
- 工单系统
- 文档管理

### 系统管理
- 系统配置
- 认证控制
- 支付配置
- 广告配置

### 日志与分析
- 完整的操作日志记录
- 流量统计分析
- 财务数据追踪

## 下一步

- [安装部署](/zh/guide/installation/) - 了解如何部署 PPanel
- [配置指南](/zh/guide/configuration) - 配置你的 PPanel 实例
- [管理后台](/zh/admin/dashboard) - 开始使用管理功能