# pxi-sys

**Repository Path**: vacrain/pxi-sys

## Basic Information

- **Project Name**: pxi-sys
- **Description**: pxi-syspxi-syspxi-sys
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 经销商管理系统 (PXI-SYS)

基于现代技术栈构建的经销商业务管理系统，支持订单管理、仓储管理、财务管理、档案管理等核心业务流程。

## 系统特性

- 🎯 **多端支持**: Web 管理端 + 小程序端，覆盖不同使用场景
- 🔐 **权限管理**: 基于 RBAC 的角色权限控制，支持多角色协同
- 📊 **数据分析**: 实时业务数据分析和报表导出
- 🏪 **业务闭环**: 订单→审核→出库→配送→回款完整流程
- 🎨 **现代界面**: 响应式设计，支持深色模式
- 🔄 **实时同步**: 状态实时更新，多端数据同步

## 技术架构

### 前端技术栈
- **Web 管理端**: Vue 3 + TypeScript + Vite + Naive UI + Pinia
- **小程序端**: uni-app + Vue 3 + TypeScript
- **状态管理**: Pinia (Web) / Vuex (小程序)
- **路由管理**: Vue Router 4
- **HTTP 客户端**: Axios with 拦截器

### 后端技术栈
- **框架**: Spring Boot 3.x
- **数据库**: PostgreSQL 15+
- **缓存**: Redis
- **文件存储**: MinIO
- **认证**: JWT Token
- **API 文档**: OpenAPI 3.0

## 环境要求

- Node.js 20 LTS（或 18 LTS）
- pnpm 10.x
- JDK 17
- Maven 3.9+
- Docker Desktop 4.x+
- PostgreSQL 15+
- Redis 7+

详细安装说明请查看：`docs/PROJECT_INIT.md`

## 项目结构

```
pxi-sys/
├── apps/
│   ├── backend/        # Spring Boot 后端服务
│   ├── web-admin/      # Vue 3 Web 管理端
│   └── miniapp/        # uni-app 小程序端
├── docs/               # 项目文档
├── db/                 # 数据库脚本
├── scripts/            # 构建脚本
└── docker-compose.yml  # 开发环境配置
```

## 快速启动

### 1. 启动基础服务

```bash
# 启动 PostgreSQL、Redis、MinIO
docker compose up -d
```

### 2. 启动 Web 管理端

```bash
# 安装依赖
pnpm -C apps/web-admin install

# 启动开发服务器
pnpm -C apps/web-admin dev

# 访问地址: http://localhost:5173
# 默认账号: admin / admin123
```

#### Mock API 模式（无需后端）

前端支持 Mock API 模式，可以在没有后端服务的情况下进行开发和测试：

```bash
# 方式1: 使用 .env.development 配置（推荐）
# 编辑 apps/web-admin/.env.development
VITE_USE_MOCK_API=true

# 方式2: 通过 URL 参数临时启用
# 访问 http://localhost:5173?useMock=true

# 方式3: 在浏览器控制台动态切换
window.__apiConfig__.useMock()   # 切换到 Mock API
window.__apiConfig__.useReal()   # 切换到真实 API
window.__apiConfig__.reset()     # 重置为默认配置
```

**Mock API 特性：**
- ✅ 完整的 CRUD 操作支持
- ✅ 数据持久化（localStorage）
- ✅ 模拟网络延迟（100-300ms）
- ✅ 开发者工具（`window.__mockData__`）
- ✅ 右下角 Mock Mode 标识

**开发者工具使用：**
```javascript
// 查看 Mock 数据
__mockData__.products()
__mockData__.users()

// 修改数据
__mockData__.updateProduct(1, { name: "新名称", price: 99.99 })

// 导入导出
const backup = __mockData__.export()
__mockData__.import(backup)

// 重置数据
__mockData__.reset()

// 查看帮助
__mockData__.help()
```

### 3. 启动小程序端

```bash
# 安装依赖
pnpm -C apps/miniapp install

# 启动开发服务器
pnpm -C apps/miniapp dev
```

### 4. 启动后端服务

```bash
cd apps/backend
mvn spring-boot:run

# API 地址: http://localhost:8080
# 健康检查: http://localhost:8080/health
```

## 核心功能

### 📋 订单管理
- 订单创建、编辑、审核、取消
- 多级审批流程（业务经理→文员）
- 订单状态实时跟踪
- 批量操作和导出

### 📦 仓储管理
- 入库/出库单管理
- 实时库存查询
- 库存盘点和调整
- 批次和有效期管理

### 💰 财务管理
- 应收/应付账款管理
- 收款/付款登记
- 对账单生成
- 财务报表分析

### 📁 档案管理
- 客户档案维护
- 产品信息管理（支持多包装单位）
- 供应商档案
- 价格体系管理

### 📊 数据分析
- 销售业绩分析
- 客户贡献度分析
- 产品销量排行
- 库存周转分析

## 用户角色

| 角色 | 主要功能 |
|------|----------|
| 业务员 | 订单创建、客户维护、业绩查看 |
| 业务经理 | 订单审核、团队管理、业绩分析 |
| 司机 | 配送任务、签收确认、异常反馈 |
| 库管员 | 库存管理、出入库审核、盘点 |
| 财务 | 收付款管理、对账、财务分析 |
| 总经理 | 全局数据看板、经营分析 |

## 开发指南

### 代码规范
- 使用 TypeScript 进行类型检查
- 遵循 Vue 3 Composition API 最佳实践
- 统一的代码格式化（Prettier + ESLint）
- Git 提交信息规范

### 数据库设计
- 支持多包装单位的产品管理
- 完整的订单状态流转
- 财务数据的准确性和一致性
- 操作日志和审计追踪

### API 设计
- RESTful API 设计原则
- 统一的响应格式
- JWT 认证和权限控制
- 完整的错误处理

## 部署说明

### 开发环境
```bash
# 一键启动所有服务
docker compose up -d
pnpm dev:all
```

### 生产环境
- 推荐使用阿里云 SAE 部署后端
- 使用阿里云 RDS PostgreSQL
- 使用阿里云 OSS 存储文件
- 配置 CDN 加速前端资源

## Web 管理端功能模块

Web 管理端提供完整的业务管理功能，包含 12 个核心模块：

### 业务功能模块
- **[仪表盘](docs/admin/admin-dashboard.md)** - 数据概览和业务监控
- **[订单管理](docs/admin/admin-orders.md)** - 订单全生命周期管理
- **[档案管理](docs/admin/admin-archives.md)** - 客户、产品、供应商等基础数据维护
- **[仓库管理](docs/admin/admin-warehouse.md)** - 库存和出入库管理
- **[财务管理](docs/admin/admin-finance.md)** - 应收应付和财务报表
- **[活动管理](docs/admin/admin-activities.md)** - 促销活动管理
- **[数据分析](docs/admin/admin-analysis.md)** - 多维度数据分析

### 技术基础模块
- **[认证授权](docs/admin/admin-auth.md)** - 用户登录和权限控制
- **[通用组件库](docs/admin/admin-components.md)** - 可复用 UI 组件
- **[API 层](docs/admin/admin-api-layer.md)** - 后端接口封装
- **[工具函数库](docs/admin/admin-utils.md)** - 常用辅助函数
- **[状态管理](docs/admin/admin-state-management.md)** - 全局状态管理

📖 **[查看完整功能模块文档](docs/admin/README.md)**

## 相关文档

- [项目初始化指南](docs/PROJECT_INIT.md)
- [开发流程说明](docs/DEV_FLOW.md)
- [开发规范](docs/DEV_STANDARDS.md)
- [CI/CD 配置](docs/CI_CD.md)
- [详细功能文档](docs/dealer-system-dev-doc.md)
- [数据字典](docs/data-dictionary/README.md) - 前后端数据结构说明文档
- **[Web 管理端功能模块](docs/admin/README.md)** - 功能模块详细文档

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。