YANG JIANKUAN
db062c8ee3
- 落地手机端双形态适配框架：同名布局+资源限定符（layout/手机、 layout-sw600dp/平板）自动切换，DeviceUtil 设备形态判定，7个 手机版公共组件（PhoneSearchBar/StatusTab/DataLayout/FilterPanel/ BottomBar/StatBox/KvItem） - 完成「国际出港移库」「国际出港出库交接」两页手机端适配，新增 各自详情页（IntExpMoveDetailActivity/IntExpOutHandoverDetailActivity） - 手机端首页菜单接入"出港移库""出库交接"入口 - 修复手机端进入页面先横屏后转竖屏的闪屏问题：Manifest 全项目 192 处改为 screenOrientation="unspecified"，由 BaseActivity 按设备形态运行时锁定方向 - 修复该方案的中间版本在平板端引入的回归（先竖后横 + UI放大1.6倍） - AutoSize 补充手机竖屏 390×844 设计基准 - 修复 CHANGELOG.md 因脚本异常导致的内容重复损坏（膨胀至12万行）， 恢复正常结构并补充本次变更记录 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
56 lines
3.3 KiB
Markdown
56 lines
3.3 KiB
Markdown
# 5.5 寸手持端适配 —— 后端接口补充清单
|
||
|
||
适配手机端时，设计稿要求展示/筛选的部分内容，现有接口没有提供或未生效。
|
||
以下为**实机联调（内网真实数据）验证过**的结论，客户端侧已按设计稿把 UI 与参数都做好，
|
||
后端补齐后即可直接生效，客户端基本无需再改。
|
||
|
||
整理时间：2026-07-29 验证环境：内网 `192.168.1.250:8093`，账号 ADMIN
|
||
|
||
---
|
||
|
||
## 一、参数已发送但后端未生效（客户端已就绪，等后端支持）
|
||
|
||
| 接口 | 参数 | 用途 | 实测现象 |
|
||
|------|------|------|----------|
|
||
| `IntExpOutHandover/pageQuery`<br>`IntExpOutHandover/pageQueryTotal` | `hoState`<br>（"0" 待交接 / "1" 已交接） | 出库交接页「待交接 / 已交接」Tab 过滤与角标计数 | 请求体确认携带 `"hoState":"0"` / `"1"`，但两个 Tab 返回**完全相同**的数据；`pageQueryTotal` 的 `wbNumber` 也不随之变化 |
|
||
| `IntExpMove/pageQuery`<br>`IntExpMove/pageQueryTotal` | `spCode`<br>（特码，如 "PER"） | 出港移库页筛选弹层「特码」 | 请求体确认携带 `"spCode":"PER"`，但返回结果中仍含特码为 `PEF` 的记录，角标计数也无变化 |
|
||
|
||
> 对照参考：同一接口的 `moveState`、`by1`（承运人）、`awbType`（运单类型）**均正常生效**
|
||
> （实测承运人填 MU 后待移库数量 67 → 60），因此可以排除客户端传参方式的问题。
|
||
>
|
||
> 若贵方使用的参数名与上表不同，请告知正确名称，客户端改一处常量即可。
|
||
|
||
---
|
||
|
||
## 二、接口未返回、设计稿需要展示的字段
|
||
|
||
以下字段目前接口完全不返回，或恒为 `null`。客户端已按设计稿保留完整 UI 结构，
|
||
数据为空时统一占位 `-`，后端补齐后自动显示。
|
||
|
||
### 2.1 `IntExpMove/pageQuery`（出港移库）
|
||
|
||
| 设计稿位置 | 需要的字段 | 当前状况 |
|
||
|------------|-----------|----------|
|
||
| 列表卡片第二行「航班信息：20260709/MU2311」 | 航班日期 + 航班号（如 `fdate` / `fno`） | **接口无任何航班相关字段** |
|
||
| 详情页「移库信息」卡片 —— 移库人 | 移库人**姓名**（现只有 `opId`） | `opId` 恒为 `null`，且即便有值也是 ID 而非姓名 |
|
||
| 详情页「移库信息」卡片 —— 移库时间 | `opdate` | 恒为 `null`，**已移库记录也是 null** |
|
||
| 详情页蓝色表头右侧时间戳 | 同上 `opdate` | 同上 |
|
||
| 详情页类型行右侧「普通货物运输」 | `businessType` 或 `cargoType` | 两者均恒为 `null` |
|
||
|
||
### 2.2 说明
|
||
|
||
- 出库交接页的详情所需字段（板型、库位、复磅人/时间等）接口均已返回，无需补充。
|
||
- 移库详情页红色标签绑的是 `awbTypeName`（真实值形如「国际出港（国际直航）」），已正常。
|
||
设计稿上写的「国际进港」经判断为设计稿笔误（该页属国际出港），未按字面实现。
|
||
|
||
---
|
||
|
||
## 三、附：字典接口调用口径（客户端已按此对齐，仅作备忘）
|
||
|
||
`typeCode/getSpecialCodeByParam`（特码字典）：
|
||
|
||
- `flag=1`（国际）+ `ieFlag=""`（**留空**）→ 正常返回 RXE/PER/PEM/PEF/LDP/GJJ/DGR 等
|
||
- `flag=1` + `ieFlag="E"` → 返回 `"data": []` 空数组
|
||
|
||
国际出港各页面统一使用 `ieFlag=""`。如该行为非预期，请后端确认 `ieFlag` 的取值约定。
|