# 智能交互技术-智能家居系统

**Repository Path**: pzw321/iit

## Basic Information

- **Project Name**: 智能交互技术-智能家居系统
- **Description**: 基于提示词实现家居控制的系统，支持自然语言输入、语言输入以及手动控制。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://8.138.146.163/
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 0
- **Created**: 2025-11-19
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AI, 语音交互, JavaScript, 智能家居, Python

## README

# 智能家居软件模拟系统（Vue + FastAPI）

基于提示词实现的课程设计样板：前端使用 Vue 3 + Pinia，后端使用 FastAPI，WebSocket 实时同步虚拟设备状态，无需真实硬件即可模拟控制与反馈。

## 功能概览
- 设备列表：示例设备（灯、空调、门锁）在线状态与实时状态展示
- 设备控制：开关、调节温度、锁/解锁，指令走 WebSocket/HTTP 回退
- 状态同步：FastAPI WebSocket 广播，多个客户端实时更新
- 健康检查：`/health`，API 列表：`/api/devices`，指令：`/api/devices/{id}/command`

## 目录结构
- `backend/`: FastAPI 应用（`app/main.py`、配置 `core/config.py`、依赖 `requirement.txt`）
- `frontend/app/`: Vue 前端（`src/App.vue`、`src/stores/devices.js`、Vite 配置）

## 快速启动
### 后端
```bash
cd iit/backend
pip install -r requirement.txt
uvicorn app.main:app --reload --port 8000
```

### 前端
```bash
cd iit/frontend/app
pnpm install   # 或 npm install
pnpm dev       # 默认 http://localhost:5173
```

> 若后端端口或地址有调整，可在前端设置环境变量：
> `VITE_API_BASE=http://localhost:8000/api`
> `VITE_WS_URL=ws://localhost:8000/ws`

## 部署提示
- 开发态可用 SQLite/内存存储；生产可替换 PostgreSQL 并完善鉴权
- 可按需增加 Dockerfile 与 Nginx 反向代理，前后端分离部署

## 后续可扩展
- 用户鉴权、设备分组、自动化规则引擎
- 操作日志入库，设备历史曲线
- PWA 手机端界面与离线缓存