# POS 端 APK 构建与安装说明（v0.3.0-order-userinfo）

## 本轮新增内容（2026-09-05 三端订单同步用户头像昵称）

### POS 收银端（本 APK）
- **订单列表显示下单用户头像昵称**：线上订单卡片收件人行前置圆形头像（26dp，无头像显示灰底圆占位），昵称实时同步用户库最新值——用户在小程序改头像/昵称后，POS 订单列表即时显示最新信息，非下单时快照
- **空昵称回退**：昵称仅含不可见控制字符的用户（真值却显示为空）净化后回退显示「微信用户」，不留空白
- **扫码取单详情同步**：订单详情头部同样显示下单用户头像昵称

### 管理后台（配套，浏览器打开即生效）
- 订单管理「用户」列显示圆形头像 + 昵称（实时同步，昵称净化 + 空值回退「微信用户」）
- 新增「系统支持 → 域名绑定」页：各端子域名分开绑定（管理后台 `admin` / API `api` / POS 下载页 `pos` / 小程序 / H5 `m`），可编辑主域/子域/路径/状态，访问链接一键复制，附子域名生效步骤说明

### 小程序端（配套，需重新构建发布）
- 订单详情「订单信息」新增**下单人**单元格：圆形头像 + 昵称（后端按 userId 实时回查下发）
- 「我的」订单四宫格「配送中」图标换为 vant 自带物流货车线条图标（撤下原骑手摩托车图）
- 底部 tabBar 首页/购物车图标换为极简线条版（灰/橙两态）
- 修复购物车勾选自动消失 bug：本地勾选后 10 秒内跳过云端购物车覆盖 + 覆盖时按 key 合并保留本地勾选状态

## 构建信息

| 项目 | 值 |
|---|---|
| 版本 | versionName 0.3.0-order-userinfo（versionCode 11） |
| 包名 | com.zhouxiansheng.pos |
| 构建类型 | release（强制 HTTP 网关，不回退演示订单） |
| SDK | compileSdk 35 / targetSdk 35 / minSdk 26 |
| 签名 | 仓库内固定 Debug 密钥（与历史版本一致，可直接覆盖安装） |
| 构建参数 | API `https://zhouxiansheng.cn/api/v1` / 仓库 `warehouse-central-001` / 设备 `SCALE-CENTRAL-01` / 序列号 `HPOS20260801001` |

## 安装到设备

### 方式一：USB 连接 + adb（推荐）

设备开启「开发者选项 → USB 调试」后连接电脑：

```bash
adb install -r zhou-xiansheng-pos.apk
```

### 方式二：设备直接安装

APK 拷贝到设备后点击安装，首次需允许「安装未知来源应用」。旧版本（0.2.8 及之前）无需卸载，签名一致直接覆盖，登录态与设备绑定凭据保留。

### 方式三：管理后台下载

APK 已发布到管理后台下载目录（`downloads/zhou-xiansheng-pos.apk` 已更新为本版），后台部署后从下载入口获取。

## 安装后验证

1. 登录后进入「线上订单」：每个订单卡片收件人名字前有圆形头像；小程序用户改头像/昵称后（下一次订单轮询 ≤30 秒）POS 显示最新值
2. 含不可见字符昵称的用户订单显示「微信用户」，无空白行
3. 扫码取单：订单详情同样显示下单用户头像昵称
4. 配套管理后台订单管理「用户」列头像昵称一致；「域名绑定」页五端齐全可编辑