多机型语音播报模板运营系统

支持 X11/Hplus/Ultra/F2 Multi/Seeker/X11 Ultra 等多机型的语音播报 Jinja2 模板管理系统。

功能特性

✅ 多机型模板管理（X11/Hplus/Ultra/F2 Multi/Seeker/X11 Ultra）
✅ 设备类型筛选（洗涤/干衣）
✅ 模板类型筛选（通用/人气/定制/季节/关怀/环保/天气/健康）
✅ 可视化模板编辑和预览
✅ Jinja2 模板实时渲染
✅ 模板分类和分组展示

技术栈

后端：FastAPI + Pydantic + JSON 文件存储
前端：Vue 3 + Vite + 原生 Fetch API

本地部署和启动

前置条件

Python 3.9+（已配置 conda 环境 rec）
Node.js 16+

启动后端

# 激活 conda 环境
conda activate rec

# 进入后端目录
cd d:\00_26code\x11_template_vue\backend

# 安装依赖（如果还没安装）
pip install -r requirements.txt

# 启动后端服务（默认端口 8000）
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

后端服务启动后访问：

API 文档：http://localhost:8000/docs
健康检查：http://localhost:8000/api/health

启动前端

打开新终端：

# 进入前端目录
cd d:\00_26code\x11_template_vue\frontend

# 安装依赖（首次运行）
npm install

# 启动前端开发服务器（默认端口 5173）
npm run dev

前端访问地址：http://localhost:5173

一键启动脚本（Windows PowerShell）

在项目根目录创建 start.ps1：

# 启动后端
Start-Process pwsh -ArgumentList "-NoExit", "-Command", "conda activate rec; cd backend; uvicorn app.main:app --reload --host 0.0.0.0 --port 8000"

# 等待 2 秒
Start-Sleep -Seconds 2

# 启动前端
Start-Process pwsh -ArgumentList "-NoExit", "-Command", "cd frontend; npm run dev"

Write-Host "后端: http://localhost:8000/docs" -ForegroundColor Green
Write-Host "前端: http://localhost:5173" -ForegroundColor Green

运行：

.\start.ps1

API 接口

模板管理

GET /api/templates - 获取模板列表（支持筛选参数）
GET /api/templates/{template_id} - 获取单个模板
POST /api/templates - 创建模板
PUT /api/templates/{template_id} - 更新模板
DELETE /api/templates/{template_id} - 删除模板

筛选接口

GET /api/templates/machine-models - 获取所有机型列表
GET /api/templates/device-types?machine_model=x11 - 获取设备的类型列表
GET /api/templates/template-types?machine_model=x11&device_type=wash - 获取模板类型列表
GET /api/templates/categories?machine_model=x11 - 获取分类列表

渲染接口

POST /api/templates/preview - 本地预览模板
POST /api/templates/render - 使用已保存模板渲染

机型说明

机型	标识符	设备类型	说明
X11	x11	wash/dry	X11 洗衣机/干衣机
Hplus	hplus	wash	Hplus 洗衣机
Ultra	ultra	wash	Ultra 洗衣机
F2 Multi	f2_multi	wash	F2 Multi 多卡洗涤
Seeker	seeker	dry	Seeker 干衣机
X11 Ultra	x11_ultra	dry	X11 Ultra 干衣机

模板类型说明

类型	标识符	说明
通用	common	基础播报模板
人气	time_popular	人气程序推荐
定制	time_custom	用户习惯定制
季节	time_season	季节换季推荐
关怀	time_care	夜间/特殊关怀
环保	time_environmental	错峰用电提醒
天气	time_weather	天气相关建议
健康	time_health	清洁/健康提醒

数据存储

模板数据存储在 backend/data/templates.json，采用 JSON 文件格式，支持持久化和备份。

注意事项

本系统独立运行，不修改 daping_rec_online_api 任何代码
模板格式与 daping_rec_online_api 中的 Jinja2 模板完全兼容
可按需导入现有模板到本系统管理

README_DEPLOY.md 4.0 KB لینک دائمی تاريخچه خام