# boboboom-admin

**Repository Path**: netherworld/boboboom-admin

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-26
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 波波轰物业管理平台

这是一个基于 React + TypeScript + Ant Design 的物业管理前端系统，与波波轰物业管理服务端API完美配合。

## 功能特性

### 🏢 核心功能
- **仪表板** - 数据概览、统计图表、实时监控
- **物业管理** - 物业公司信息管理
- **小区管理** - 小区信息、统计数据
- **房屋管理** - 房屋信息、批量操作
- **住户管理** - 住户档案、审核流程
- **门禁管理** - 权限控制、访问记录
- **小区公告** - 通知发布、公告管理
- **报修管理** - 维修流程、进度跟踪
- **投诉管理** - 问题处理、满意度统计
- **访客管理** - 访客邀请、权限控制

### 🎨 界面特色
- **现代化UI** - 基于Ant Design 5.0设计语言
- **响应式布局** - 支持桌面端和移动端
- **暗黑侧边栏** - 专业的管理界面风格
- **数据可视化** - 集成Recharts图表库
- **动画效果** - 流畅的交互体验

### 🔧 技术栈
- **前端框架**: React 18 + TypeScript
- **UI组件库**: Ant Design 5.0
- **路由管理**: React Router v6
- **状态管理**: React Hooks
- **HTTP客户端**: Axios
- **图表库**: Recharts
- **构建工具**: Vite
- **代码规范**: ESLint + TypeScript

## 快速开始

### 环境要求
- Node.js >= 16.0.0
- npm >= 8.0.0

### 安装依赖
```bash
npm install
```

### 启动开发服务器
```bash
npm run dev
```

访问 http://localhost:3000 即可打开应用。

### 构建生产版本
```bash
npm run build
```

### 预览生产版本
```bash
npm run preview
```

## 项目结构

```
src/
├── components/          # 公共组件
│   └── Layout/         # 布局组件
├── pages/              # 页面组件
│   ├── Login/          # 登录页面
│   ├── Dashboard/      # 仪表板
│   ├── Property/       # 物业管理
│   ├── Community/      # 小区管理
│   ├── House/          # 房屋管理
│   ├── Resident/       # 住户管理
│   ├── Access/         # 门禁管理
│   ├── Notice/         # 小区公告
│   ├── Repair/         # 报修管理
│   ├── Complaint/      # 投诉管理
│   └── Visitor/        # 访客管理
├── services/           # API服务
│   ├── request.ts      # 请求配置
│   └── api.ts          # API接口
├── types/              # 类型定义
│   └── api.ts          # API类型
├── utils/              # 工具函数
├── hooks/              # 自定义Hooks
├── store/              # 状态管理
└── assets/             # 静态资源
```

## 配置说明

### API代理配置
开发环境下，API请求会自动代理到后端服务：
```typescript
// vite.config.ts
server: {
  proxy: {
    '/api': {
      target: 'http://localhost:8080',
      changeOrigin: true
    }
  }
}
```

### 环境变量
创建 `.env.local` 文件配置环境变量：
```env
VITE_API_BASE_URL=http://localhost:8080
```

## API接口对接

本前端系统完全契合后端API设计，主要接口包括：

### 认证相关
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/logout` - 用户登出
- `GET /api/auth/user-info` - 获取用户信息

### 物业管理
- `GET /api/property/properties` - 分页查询物业信息
- `POST /api/property/properties` - 创建物业信息
- `PUT /api/property/properties/{id}` - 更新物业信息
- `DELETE /api/property/properties/{id}` - 删除物业信息

### 小区管理
- `GET /api/property/communities` - 分页查询小区信息
- `GET /api/property/communities/{id}/statistics` - 获取小区统计

### 其他模块
详细的API接口文档请参考后端项目的API设计文档。

## 开发指南

### 添加新页面
1. 在 `src/pages/` 下创建新的页面组件
2. 在 `src/App.tsx` 中添加路由配置
3. 在 `src/components/Layout/MainLayout.tsx` 中添加菜单项

### 添加新API
1. 在 `src/types/api.ts` 中定义数据类型
2. 在 `src/services/api.ts` 中添加API接口方法
3. 在页面组件中调用API

### 样式定制
使用CSS Modules或直接编写CSS文件，支持Less预处理器。

## 默认登录信息

系统提供演示账号：
- **用户名**: admin
- **密码**: admin123

## 浏览器支持

- Chrome >= 87
- Firefox >= 78
- Safari >= 14
- Edge >= 87

## 许可证

Copyright © 2024 波波轰物业管理平台. All rights reserved.

## 联系我们

如有问题或建议，请联系开发团队。