# smart-campus-hub

**Repository Path**: yr_binary/smart-campus-hub

## Basic Information

- **Project Name**: smart-campus-hub
- **Description**: 智链校园汇开源演示原型
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-13
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智链校园汇前端演示原型

本目录包含一个可截图、可演示的小程序式 Web 原型，入口文件为 `public/index.html`，本地演示 API 为 `server.js`。页面使用原生 HTML/CSS/JS 编写，不依赖外部 CDN。

## 前端页面

- 用户端：商品浏览、分类筛选、加入购物车、提交订单、模拟支付、订单追踪。
- 商家端：查看订单处理队列，确认备货并同步到配送端。
- 配送端：查看可接订单、接单配送、更新送达状态。
- 后台统计：订单时段趋势、区域需求分布、异常运营事项。
- AI 工具：货物识别模拟、智能调度建议、作业查询机器人。
- 截图导出：右上角“导出截图”会调用浏览器打印/截图入口，适合演示留档。

## 运行方式

```bash
npm install
npm run dev
```

服务默认监听 `http://127.0.0.1:5178`。直接用浏览器打开 `public/index.html` 也能展示前端静态原型；启动服务后，前端会调用 `/api/bootstrap`、`/api/orders`、`/api/orders/{id}/action`、`/api/recognize`、`/api/dispatch/recommend` 和 `/api/bot/query`，接口不可用时保留本地演示数据，保证基础截图流程可用。

## 验收脚本

### 接口冒烟测试

```bash
npm run smoke
```

脚本覆盖健康检查、演示数据、创建订单、支付、商家接单、备货、待骑手接单、骑手接单、配送、送达、完成、评价、运营快照、错误响应、AI 识别、智能调度和机器人作业查询。默认会先调用 `/api/reset` 重置演示数据，便于反复验收。

PowerShell 指定 API 地址或跳过重置：

```powershell
$env:API_BASE_URL="http://127.0.0.1:5178"
$env:SMOKE_RESET="0"
npm run smoke
```

可选变量：

| 变量 | 默认值 | 说明 |
| --- | --- | --- |
| `API_BASE_URL` | `http://127.0.0.1:5178` | API 服务地址 |
| `SMOKE_RESET` | `1` | 设置为 `0` 时不重置演示数据 |
| `SMOKE_TIMEOUT_MS` | `8000` | 单次请求超时时间 |

### 截图归档

```bash
npm run screenshots
```

脚本使用 Playwright 访问本地演示页面，自动推进真实页面按钮并校验目标节点，再生成 11 张截图：

| 子目录 | 数量 | 覆盖场景 |
| --- | --- | --- |
| `desktop` | 6 张 | 用户下单支付追踪、商家接单备货出货、配送接单状态更新、后台订单监管统计、AI 识别结果、调度推荐机器人问答 |
| `mobile` | 5 张 | 移动端用户下单支付、商家工作台、配送状态更新、后台审计统计、AI 识别调度 |

结项截图默认归档到：

`E:\qwq\智链校园汇项目资料\附件6 校级创新创业项目结项存档格式\3.成果物\1.项目相关截图`

PowerShell 指定页面地址或截图目录：

```powershell
$env:APP_BASE_URL="http://127.0.0.1:5178"
$env:SCREENSHOT_RESET="0"
$env:SCREENSHOT_DIR="E:\qwq\智链校园汇项目资料\附件6 校级创新创业项目结项存档格式\3.成果物\1.项目相关截图"
npm run screenshots
```

截图脚本默认会先调用 `/api/reset`，保证每次从干净演示数据开始；设置 `SCREENSHOT_RESET=0` 可保留当前服务内存状态继续截图。

完整 P0/P1 验收项见 [docs/验收清单.md](docs/验收清单.md)。结项前建议同时保留 `npm run smoke` 通过记录、11 张归档截图，以及下单到送达、AI 识别、后台统计、机器人查询的演示视频片段。