# smartlock-app

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

## Basic Information

- **Project Name**: smartlock-app
- **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

# 智能锁 App

[![uni-app](https://img.shields.io/badge/uni--app%20X-latest-green)](https://uniapp.dcloud.net.cn/)
[![Vue](https://img.shields.io/badge/Vue-3.x-brightgreen)](https://vuejs.org/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

基于 uni-app X 开发的智能锁管理App，支持 Android、iOS、鸿蒙多端发布。

## ✨ 功能特性

### 核心功能

| 功能模块 | 描述 |
|---------|------|
| 🔐 用户登录 | 短信验证码登录，安全便捷 |
| 📱 设备管理 | 设备列表、状态查看、设备绑定 |
| 🔑 远程开锁 | 一键远程开锁，响应时间<2秒 |
| 🎫 临时密码 | 生成一次性/限时密码分享给访客 |
| 📋 开锁日志 | 完整开锁记录，支持筛选查询 |
| 🏠 房源管理 | 多房源管理，设备分组 |
| 👤 个人中心 | 用户信息、设置管理 |

### 支持平台

- ✅ Android
- ✅ iOS  
- ✅ 鸿蒙 (HarmonyOS)

## 🏗️ 技术架构

```
┌─────────────────────────────────────┐
│            App 应用层               │
├─────────────────────────────────────┤
│  Pages                              │
│  ├── 登录页 (login)                 │
│  ├── 首页 (index)                   │
│  ├── 设备列表 (device)              │
│  ├── 开锁页 (unlock)                │
│  ├── 临时密码 (temp-password)       │
│  ├── 开锁日志 (log)                 │
│  ├── 房源管理 (house)               │
│  └── 个人中心 (user)                │
├─────────────────────────────────────┤
│  API Layer                          │
│  ├── userApi    用户相关接口         │
│  ├── deviceApi  设备相关接口         │
│  └── lockApi    开锁相关接口         │
├─────────────────────────────────────┤
│  Store (Pinia)                      │
│  └── userStore  用户状态管理         │
└─────────────────────────────────────┘
```

## 🛠️ 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| uni-app X | latest | 跨平台开发框架 |
| Vue | 3.x | 前端框架 |
| TypeScript | 5.x | 类型支持 |
| Pinia | 2.x | 状态管理 |
| uView UI | 3.x | UI组件库 |

## 🚀 快速开始

### 环境要求

- HBuilderX 最新版
- Node.js 18+
- npm 或 yarn

### 开发运行

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

# 2. 安装依赖
npm install

# 3. HBuilderX 打开项目，运行到模拟器或真机
```

### 配置后端地址

修改 `src/api/index.ts`：

```typescript
// 开发环境
const BASE_URL = 'http://localhost:8080/api/v1'

// 生产环境
const BASE_URL = 'https://api.smartlock.com/api/v1'
```

## 📁 项目结构

```
smartlock-app/
├── src/
│   ├── api/                  # API接口
│   │   └── index.ts          # 接口定义
│   ├── pages/                # 页面
│   │   ├── user/             # 用户相关
│   │   ├── device/           # 设备相关
│   │   ├── log/              # 日志
│   │   ├── house/            # 房源
│   │   └── index/            # 首页
│   └── store/                # 状态管理
│       └── user.ts           # 用户状态
├── App.vue                   # 应用入口
├── main.uts                  # 主入口
├── pages.json                # 页面配置
├── manifest.json             # 应用配置
└── uni.scss                  # 全局样式
```

## 📱 页面截图

| 登录页 | 首页 | 设备列表 |
|-------|------|---------|
| 🔐 | 🏠 | 📱 |

| 开锁 | 临时密码 | 日志 |
|-----|---------|------|
| 🔑 | 🎫 | 📋 |

## 🔌 API接口

### 用户模块

```typescript
// 发送验证码
userApi.sendSms(mobile: string, type: string)

// 登录
userApi.login(mobile: string, code: string)

// 获取用户信息
userApi.getProfile()
```

### 设备模块

```typescript
// 获取设备列表
deviceApi.getList()

// 获取设备状态
deviceApi.getStatus(deviceId: string)
```

### 开锁模块

```typescript
// 远程开锁
lockApi.unlock(deviceId: string, unlockType: string)

// 生成临时密码
lockApi.createTempPassword(data: TempPasswordData)

// 获取开锁日志
lockApi.getLogs(deviceId: string)
```

## 🔐 安全设计

- **JWT Token认证**: Access Token + Refresh Token
- **HTTPS传输**: 生产环境强制HTTPS
- **敏感数据加密**: 手机号脱敏显示
- **请求签名**: timestamp + nonce + sign

## 📦 打包发布

### Android

```bash
# HBuilderX -> 发行 -> 原生App-云打包
```

### iOS

```bash
# HBuilderX -> 发行 -> 原生App-云打包
# 需要Apple开发者账号证书
```

## 👥 相关仓库

- [smartlock-service](https://gitee.com/dadadadarenna/smartlock-service) - 后端微服务
- [smartlock-web](https://gitee.com/dadadadarenna/smartlock-web) - Web管理后台

## 📄 License

MIT License