# 园区大屏（park-desktop / DPM）

> 核对：2026-10-19 · 依据 park-desktop `main@a2fbad8` · 以实现为准

**DPM**（Digital Playback Media）—— 基于 **Tauri 2 + React 19** 的园区大屏客户端，为昆明市大学生创业园 OPC 运营中心提供数据大屏、数字孪生、AI 助手、媒体轮播、任务大屏与企业墙。

> 园区后端已并入 **server-core `/park`**（不再有独立 `:10085` 后端）；管理后台为后端 **FastAPI + Jinja** 页面（`GET /admin`），**不由 React 路由接管**。实时控制走 **MQTT（EMQX `:8083`）**，不再使用内置 Axum HTTP 服务 / SSE / nps。

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端框架 | React 19 + React Router 7 |
| 构建工具 | Vite 7 + Tailwind 4.3（`@tailwindcss/vite`） |
| 桌面框架 | Tauri 2（Rust，`src-tauri/`，本地 `wry` 补丁） |
| 三维 / 可视化 | three 0.185（`@react-three/fiber` / `drei`）、`@appica/ui-react` |
| 实时通信 | MQTT 5.15（`mqtt.js`，EMQX） |
| 二维码 | `qrcode.react` |

## 页面（`src/App.jsx`）

| 路由 | 页面 | 说明 |
|------|------|------|
| `/` | `DataScreen` | 园区数据大屏（概览/数据快照） |
| `/twin` | `DigitalTwin` | 数字孪生（3D 园区） |
| `/ai` | `AiAssistant` | 园区 AI 助手（含语音 s2s） |
| `/screen` | `MediaScreen` | 全屏媒体轮播（视频/图片，MQTT 受控） |
| `/tasks` | `TaskDisplay` | 任务大屏（轮播卡 + 二维码扫码接单） |
| `/wall` | `CompanyWall` | 入驻企业展示墙 |

- 统一页眉布局 `components/ScreenLayout`；`/voice` 有 `VoiceAssistant` 组件但**当前未挂路由**。
- 首启可走 **屏幕绑定**（`components/BindScreen` + `utils/tenant`，绑定后按租户拉数据）；支持双屏（`set_dual_screen`）、全屏、开机自启（`tauri-plugin-autostart`）、应用内自动更新（`components/UpdateNotify` + `utils/updateCheck`）。

## 功能概览

- **媒体轮播**（`pages/MediaScreen.jsx`）：视频/图片全屏轮播、沉浸式空间背景、自动播放、点击暂停/恢复、音量与顺序/随机播放、播放状态上报（`opc/display/*` MQTT 主题）。
- **任务大屏**（`pages/TaskDisplay.jsx`）：任务轮播卡 + 二维码扫码接单。
- **园区数据 / 数字孪生 / 企业墙**：数据快照（`opc/dashboard/tick`）、3D 园区、入驻企业展示。
- **AI 助手**：对话面板 + 语音 s2s（`src/voice/`）。
- **设备与运维**：屏幕绑定/租户隔离、心跳上报（`opc/display/heartbeat`，后端统计在线）、双屏、全屏、开机自启、自动更新。
- **管理后台**：媒体上传、播放列表编排与播放控制等由 **server-core `/park`** 的后端 `/admin` 页面提供（前端不再内置管理页）。

## 快速开始

### 环境要求

- **Rust**（edition 2021）、**Node.js** >= 18、**Yarn**（或 npm）、Tauri 2 CLI（`yarn tauri` 走本地依赖）

### 安装与运行

```bash
yarn install

yarn dev          # 仅启动 Vite（http://localhost:1420，浏览器预览大屏）
yarn tauri dev    # Tauri 桌面端（前端 + Rust 壳）
yarn build        # 前端产物 dist/
yarn tauri build  # 桌面安装包，产物在 src-tauri/target/release/
```

> ⚠️ 按团队铁律：**AI 不启动/重启任何服务（含 vite / Tauri）**，需要时通知用户亲自操作。

### 配置（`src/config.js`）

地址解析优先级：**exe 旁 `config.json`（Tauri `read_runtime_config`）> 后端 `/park/api/config` 下发 > 构建期 `VITE_*` > 内置默认**。

| 项 | 默认 | 覆盖方式 |
|----|------|---------|
| 园区 API | `http://<当前主机>:8090/park`（打包生产回退 `opc.pinesound.cn`） | `window.__DPM_API__`、`VITE_API_BASE` |
| MQTT | `ws(s)://<当前主机>:8083/mqtt`（生产 `wss`） | `window.__DPM_MQTT__`、`VITE_MQTT_URL` |
| 视频识别 | 空 = 禁用 | `window.__DPM_VISION__`、`VITE_VISION_API_BASE` |
| 大屏引导令牌 | 空 | `window.__DPM_BOOTSTRAP__`、`VITE_PARK_BOOTSTRAP_TOKEN` |

旧 `:10085` 地址一律判为失效并回退 server-core 统一入口。

## 项目结构

```
index.html
package.json                 # 包名 dpm
vite.config.js               # 端口 1420；无 dev 代理（API 由 src/config.js 直连 server-core）
public/                      # logo、语音 worklets 等静态资源
src/
  main.jsx                   # React 入口 + 运行时配置引导 + 致命错误兜底
  App.jsx                    # 6 个大屏路由
  config.js                  # API / MQTT / Vision / bootstrap 令牌解析
  pages/                     # DataScreen / DigitalTwin / AiAssistant / MediaScreen / TaskDisplay / CompanyWall
  components/                # ScreenLayout / BindScreen / PageHeader / 各类面板、弹窗
  utils/                     # api.js、mqtt.js、tenant.js、taskData.js、updateCheck.js、pageNav.js、sounds.js
  voice/                     # s2s 语音客户端、orb 可视化、worklets
  styles/                    # tokens/global/datascreen/mediascreen/task-display 等
src-tauri/
  Cargo.toml                 # tauri 2 + opener/autostart + 本地 wry 补丁
  tauri.conf.json            # productName「云超服昆创园OPC运营中心」，1200x800 全屏
  capabilities/default.json  # 窗口/自启/opener 权限
  src/{main.rs,lib.rs}       # 入口；命令：set_dual_screen / install_update / read_runtime_config
```

## 端口一览

| 端口 | 用途 |
|------|------|
| 1420 | Vite 前端开发服务器（`strictPort`） |
| 8090 | server-core（园区 API 前缀 `/park`） |
| 8083 | MQTT Broker（EMQX，`/mqtt`） |
| 10085 | **已废弃**的旧园区后端（源码已回退到统一入口，勿再使用） |

## 许可

本项目为昆明市大学生创业园公益定制开发。

---

*云南派音人工智能科技提供技术支持*