# business-dashboard-master

**Repository Path**: coderlaogu/business-dashboard-master

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-17
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Business Dashboard Master - Admin Backend

商业仪表板后台管理系统，为 [business-dashboard](../business-dashboard) 前端应用提供完整的后台管理功能。

## 项目概述

Business Dashboard Master 是一个基于 Spring Boot 2.2.6 开发的企业级后台管理系统，专门为商业仪表板前端应用提供数据管理、用户管理、内容管理等核心后台功能。

## 技术栈

- **框架**: Spring Boot 2.2.6
- **安全**: Spring Security + JWT
- **数据库**: MySQL 5.7+ / 8.0+
- **ORM**: MyBatis-Plus 3.5.3.2
- **连接池**: Druid
- **缓存**: Redis
- **构建工具**: Maven 3.6+
- **Java版本**: JDK 1.8+

## 核心功能

### 系统管理
- 管理员账户管理（CRUD）
- 角色权限管理（RBAC）
- 系统配置管理
- 操作日志审计

### 业务数据管理
- 前端用户数据管理
- 商业计划书数据管理
- 资讯内容管理
- 系统通知管理

### 安全特性
- JWT token 认证
- 角色权限控制
- 密码加密存储
- 操作日志记录
- IP 地址追踪

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- MySQL 5.7+
- Redis 3.0+

### 安装步骤

1. **克隆项目**
```bash
cd /mnt/d/project/website
# 项目已存在于 business-dashboard-master 目录
```

2. **数据库初始化**
```bash
# 创建数据库并导入初始数据
mysql -u root -p < sql/init.sql
```

3. **修改配置**
编辑 `src/main/resources/application.properties` 文件，修改数据库连接信息：
```properties
spring.datasource.url=jdbc:mysql://localhost:3306/business_dashboard_admin?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=your_password
```

4. **编译运行**
```bash
# 编译项目
mvn clean compile

# 运行应用
mvn spring-boot:run

# 或者打包运行
mvn clean package
java -jar target/business-dashboard-master-1.0-SNAPSHOT.jar
```

5. **访问系统**
- 后台API地址: http://localhost:8232/admin-api
- 默认管理员账户: admin / admin123

## API 文档

### 管理员用户管理

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/admin/users/list` | 获取管理员用户列表 |
| GET | `/api/admin/users/{id}` | 获取指定管理员用户 |
| POST | `/api/admin/users/create` | 创建管理员用户 |
| PUT | `/api/admin/users/update/{id}` | 更新管理员用户 |
| DELETE | `/api/admin/users/delete/{id}` | 删除管理员用户 |
| PUT | `/api/admin/users/status/{id}` | 更新用户状态 |

### 响应格式
```json
{
  "code": 200,
  "message": "操作成功",
  "data": { ... },
  "timestamp": 1625097600000,
  "traceId": "uuid"
}
```

## 数据库设计

### 核心表结构

- `admin_users`: 管理员用户表
- `admin_roles`: 角色表
- `admin_permissions`: 权限表
- `admin_role_permissions`: 角色权限关联表
- `dashboard_users`: 前端用户管理表
- `business_plans`: 商业计划书管理表
- `news_articles`: 资讯管理表
- `system_notifications`: 系统通知表
- `system_configs`: 系统配置表
- `operation_logs`: 操作日志表

详细的数据库架构请参考 `sql/init.sql` 文件。

## 开发指南

### 项目结构
```
src/main/java/com/business/dashboard/
├── controller/          # 控制器层
├── service/            # 服务层
│   └── impl/           # 服务实现
├── dao/                # 数据访问层
├── entity/             # 实体类
├── model/              # 数据传输对象
├── utils/              # 工具类
└── BusinessDashboardApplication.java  # 启动类

src/main/resources/
├── mapper/             # MyBatis XML 映射文件
├── application.properties  # 应用配置
└── generatorConfig.xml # MyBatis Generator 配置
```

### 开发规范

1. **API设计**: 遵循RESTful规范
2. **响应格式**: 统一使用 `ResultUtil<T>` 包装响应
3. **异常处理**: 统一异常处理和错误码
4. **日志记录**: 关键操作必须记录日志
5. **安全性**: 敏感操作需要权限验证

### 代码生成
使用 MyBatis Generator 快速生成基础代码：
```bash
mvn mybatis-generator:generate
```

## 部署说明

### 开发环境
- 端口: 8232
- 上下文路径: `/admin-api`
- 数据库: `business_dashboard_admin`

### 生产环境
1. 修改数据库连接配置
2. 更新JWT密钥
3. 配置Redis集群
4. 启用HTTPS
5. 配置反向代理

## 与前端集成

该后台系统为 `business-dashboard` 前端项目提供数据支持：

- **前端项目路径**: `../business-dashboard`
- **前端端口**: 3000
- **API调用**: 前端通过 HTTP 请求调用后台 API
- **认证机制**: JWT token 认证
- **CORS配置**: 已配置跨域支持

## 监控和运维

### 健康检查
- 端点: `/admin-api/actuator/health`
- 监控指标: `/admin-api/actuator/metrics`

### 日志管理
- 应用日志: `logs/business-dashboard-admin.log`
- 操作审计: 存储在 `operation_logs` 表

## 许可证

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

## 贡献指南

1. Fork 本项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 联系方式

如有问题或建议，请通过以下方式联系：

- 项目地址: `/mnt/d/project/website/business-dashboard-master`
- 相关项目: `/mnt/d/project/website/business-dashboard`

---

**注意**: 这是一个后台管理系统，请确保在安全的环境中运行，并定期更新依赖包以确保安全性。