# 状态中心 Web 版

## 一键启动联调环境

在项目根目录执行：

macOS/Linux：

```bash
./.venv_test/bin/python scripts/dev.py start
```

Windows PowerShell：

```powershell
.\.venv_test\Scripts\python.exe scripts\dev.py start
```

启动器会复用或创建 Docker MySQL 容器 `rpa-center-mysql`，然后启动 FastAPI 和 Vite。

```bash
python scripts/dev.py status
python scripts/dev.py stop
```

`status` 只有在 MySQL 端口、FastAPI `/health`（包含数据库探测）和 Vite 端口都正常时才返回成功。

## 手动启动

```bash
cd state_center_web
npm install
npm run dev
```

默认地址：`http://localhost:5173`

后端另开一个终端：

macOS/Linux：

```bash
python -m pip install -r state_center/requirements.txt
DEV_MODE=true python -m uvicorn state_center.app.main:app --reload --port 8000
```

Windows PowerShell：

```powershell
$env:DEV_MODE = "true"
python -m pip install -r state_center\requirements.txt
python -m uvicorn state_center.app.main:app --reload --port 8000
```

浏览器访问：`http://localhost:5173/`。同一套页面适用于 Windows 和 macOS；前端不会自行推导流程下一节点，所有节点状态都来自 FastAPI。

## 说明

- 页面全中文。
- 后端可连时，直接读 `state_center` 的 FastAPI 接口。
- 后端没起时，页面自动切到本地演示数据，仍可看到单据列表、流程状态图和待办面板。
- 页面顶部会明确显示“本地演示数据”或“后端已连接”。
- 对码待办可直接选择候选货品；人工节点按节点显示对应动作。
- 节点回调模拟区只在开发环境构建中显示。
- 开发令牌只保存在浏览器会话里，不会写进代码。