# smartlock-web

**Repository Path**: dadadadarenna/smartlock-web

## Basic Information

- **Project Name**: smartlock-web
- **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-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能锁 Web管理后台

[![Vue](https://img.shields.io/badge/Vue-3.x-brightgreen)](https://vuejs.org/)
[![Element Plus](https://img.shields.io/badge/Element%20Plus-2.x-409eff)](https://element-plus.org/)
[![Vite](https://img.shields.io/badge/Vite-5.x-646cff)](https://vitejs.dev/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

基于 Vue 3 + Element Plus 开发的智能锁管理平台Web后台。

## ✨ 功能特性

| 功能模块 | 描述 |
|---------|------|
| 👥 用户管理 | 用户列表、权限分配、状态管理 |
| 📱 设备管理 | 设备列表、状态监控、批量操作 |
| 🏠 房源管理 | 房源CRUD、设备绑定 |
| 🔑 开锁记录 | 开锁日志查询、统计分析 |
| ⚙️ 系统设置 | 参数配置、权限管理 |

## 🏗️ 技术架构

```
┌─────────────────────────────────────┐
│          Web管理后台                │
├─────────────────────────────────────┤
│  Views                              │
│  ├── 用户管理 (user)                │
│  ├── 设备管理 (device)              │
│  ├── 房源管理 (house)               │
│  ├── 开锁记录 (log)                 │
│  └── 系统设置 (settings)            │
├─────────────────────────────────────┤
│  Components                         │
│  ├── 表格组件                       │
│  ├── 表单组件                       │
│  └── 图表组件                       │
├─────────────────────────────────────┤
│  API Layer (Axios)                  │
│  ├── userApi                        │
│  ├── deviceApi                      │
│  └── ...                            │
├─────────────────────────────────────┤
│  Store (Pinia)                      │
│  ├── userStore                      │
│  └── appStore                       │
└─────────────────────────────────────┘
```

## 🛠️ 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.x | 前端框架 |
| Vite | 5.x | 构建工具 |
| Element Plus | 2.x | UI组件库 |
| Pinia | 2.x | 状态管理 |
| Vue Router | 4.x | 路由管理 |
| Axios | 1.x | HTTP请求 |
| ECharts | 5.x | 图表库 |

## 🚀 快速开始

### 环境要求

- Node.js 18+
- npm 或 yarn

### 开发运行

```bash
# 1. 克隆项目
git clone https://gitee.com/dadadadarenna/smartlock-web.git
cd smartlock-web

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev

# 4. 浏览器访问
# http://localhost:5173
```

### 生产构建

```bash
# 构建
npm run build

# 预览构建结果
npm run preview
```

## 📁 项目结构

```
smartlock-web/
├── src/
│   ├── api/                  # API接口
│   ├── assets/               # 静态资源
│   ├── components/           # 公共组件
│   ├── layouts/              # 布局组件
│   ├── router/               # 路由配置
│   ├── store/                # 状态管理
│   ├── styles/               # 样式文件
│   ├── utils/                # 工具函数
│   └── views/                # 页面组件
├── public/                   # 公共资源
├── index.html               # 入口HTML
├── vite.config.ts           # Vite配置
└── package.json             # 项目配置
```

## 📱 页面预览

| 登录页 | 仪表盘 | 用户管理 |
|-------|-------|---------|
| 🔐 | 📊 | 👥 |

| 设备管理 | 开锁记录 | 系统设置 |
|---------|---------|---------|
| 📱 | 📋 | ⚙️ |

## 🔌 API配置

修改 `.env.development` 或 `.env.production`：

```env
# 开发环境
VITE_API_BASE_URL=http://localhost:8080/api/v1

# 生产环境
VITE_API_BASE_URL=https://api.smartlock.com/api/v1
```

## 👥 用户角色

| 角色 | 权限 |
|------|------|
| 超级管理员 | 全部权限 |
| 管理员 | 用户管理、设备管理、日志查看 |
| 运营人员 | 设备管理、日志查看 |

## 👥 相关仓库

- [smartlock-service](https://gitee.com/dadadadarenna/smartlock-service) - 后端微服务
- [smartlock-app](https://gitee.com/dadadadarenna/smartlock-app) - App前端

## 📄 License

MIT License