# mpwechaty

**Repository Path**: HesenjanJava/mpwechaty

## Basic Information

- **Project Name**: mpwechaty
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mpwechaty - 微信公众号信息分析与分发系统

**项目类型**: 全栈应用 (Node.js + React)

---

## 📁 项目结构

```
mpwechaty/
├── src/                  # 后端代码 (Express + Node.js)
│   ├── app.js           # 主应用入口
│   ├── routes/          # API 路由
│   ├── controllers/     # 控制器
│   ├── services/        # 业务逻辑
│   ├── models/          # 数据模型
│   └── db/              # 数据库配置
├── frontend/            # 前端代码 (React + Vite + TDesign)
│   ├── src/             # 前端源码
│   │   ├── components/  # 组件
│   │   ├── pages/       # 页面
│   │   ├── services/    # API 服务
│   │   ├── stores/      # 状态管理
│   │   └── styles/      # 样式
│   ├── package.json     # 前端依赖
│   └── vite.config.ts   # Vite 配置
├── package.json         # 后端依赖
├── .env                 # 环境变量
└── start-all.bat        # 一键启动脚本
```

---

## 🚀 快速开始

### 方式 1: 一键启动（推荐）

双击运行 `start-all.bat`

### 方式 2: 手动启动

```bash
# 1. 启动后端
cd D:\Project\WebStromProjects\mpwechaty
npm start

# 2. 启动前端（新终端）
cd D:\Project\WebStromProjects\mpwechaty\frontend
npm run dev
```

---

## 🌐 访问地址

| 服务 | 地址 | 说明 |
|------|------|------|
| 后端 API | http://localhost:3000 | Express 服务 |
| 前端界面 | http://localhost:3002 | Vite 开发服务器 |
| 管理后台 | http://localhost:3002 | TDesign React |

---

## 🔐 登录信息

- **用户名**: `admin`
- **密码**: `admin123`

---

## 📦 技术栈

### 后端
- Node.js >= 18
- Express
- MySQL2
- Wechaty
- jsonwebtoken (JWT 认证)

### 前端
- React 18
- Vite 5
- TDesign React
- React Router 6
- Zustand (状态管理)
- Axios (HTTP 客户端)

---

## 🛠️ 开发指南

### 后端开发

```bash
cd D:\Project\WebStromProjects\mpwechaty
npm install
npm start
```

### 前端开发

```bash
cd D:\Project\WebStromProjects\mpwechaty\frontend
npm install
npm run dev
```

### 构建生产版本

```bash
cd D:\Project\WebStromProjects\mpwechaty\frontend
npm run build
```

构建后的文件在 `frontend/dist/` 目录。

---

## 🔧 环境配置

### 后端环境变量 (.env)

```env
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=123456
DB_NAME=mpwechaty

# JWT 密钥
JWT_SECRET=your-secret-key

# 服务端口
PORT=3000
```

### 前端环境变量 (frontend/.env)

```env
VITE_API_BASE_URL=http://localhost:3000/api/admin/v2
```

---

## 📊 功能模块

### 后台管理系统

1. **仪表板** - 数据概览
   - 用户统计
   - 消息统计
   - 支付统计
   - 分红统计

2. **用户管理** - 用户信息管理
   - 用户列表
   - 用户详情
   - 会员状态

3. **消息管理** - 消息内容管理
   - 消息列表
   - 分类筛选
   - 地区筛选

4. **支付管理** - 支付记录管理
   - 订单列表
   - 支付状态
   - 金额统计

5. **分红管理** - 分红记录管理
   - 分红列表
   - 金额统计

---

## 🐛 常见问题

### Q1: 端口被占用

```bash
# Windows 查找占用端口的进程
netstat -ano | findstr :3000
netstat -ano | findstr :3002

# 结束进程
taskkill /PID <进程ID> /F
```

### Q2: 数据库连接失败

检查 `.env` 文件中的数据库配置是否正确。

### Q3: 前端页面空白

1. 清除浏览器缓存
2. 按 Ctrl+Shift+R 强制刷新
3. 检查控制台错误信息

---

## 📝 更新日志

### 2026-07-03
- ✅ 创建 TDesign React 后台管理系统
- ✅ 实现 JWT 管理员认证
- ✅ 实现仪表板、用户、消息、支付、分红管理页面
- ✅ 修复图标导入错误
- ✅ 合并前后端项目到统一仓库
- ✅ 删除冗余的 /admin 路由
- ✅ 重命名 admin 目录为 frontend

---

## 👥 团队

- **开发**: AI Assistant
- **维护**: Your Team

---

## 📄 许可证

MIT License