Files
aerologic-app/documents/5.5寸手持端-后端字段补充清单.md
YANG JIANKUAN db062c8ee3 feat: 完成国际出港移库/出库交接页面5.5寸手机端适配
- 落地手机端双形态适配框架:同名布局+资源限定符(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>
2026-07-29 14:18:29 +08:00

3.3 KiB
Raw Blame History

5.5 寸手持端适配 —— 后端接口补充清单

适配手机端时,设计稿要求展示/筛选的部分内容,现有接口没有提供或未生效。 以下为实机联调(内网真实数据)验证过的结论,客户端侧已按设计稿把 UI 与参数都做好, 后端补齐后即可直接生效,客户端基本无需再改。

整理时间2026-07-29  验证环境内网 192.168.1.250:8093,账号 ADMIN


一、参数已发送但后端未生效(客户端已就绪,等后端支持)

接口 参数 用途 实测现象
IntExpOutHandover/pageQuery
IntExpOutHandover/pageQueryTotal
hoState
"0" 待交接 / "1" 已交接)
出库交接页「待交接 / 已交接」Tab 过滤与角标计数 请求体确认携带 "hoState":"0" / "1",但两个 Tab 返回完全相同的数据;pageQueryTotalwbNumber 也不随之变化
IntExpMove/pageQuery
IntExpMove/pageQueryTotal
spCode
(特码,如 "PER"
出港移库页筛选弹层「特码」 请求体确认携带 "spCode":"PER",但返回结果中仍含特码为 PEF 的记录,角标计数也无变化

对照参考:同一接口的 moveStateby1(承运人)、awbType(运单类型)均正常生效 (实测承运人填 MU 后待移库数量 67 → 60因此可以排除客户端传参方式的问题。

若贵方使用的参数名与上表不同,请告知正确名称,客户端改一处常量即可。


二、接口未返回、设计稿需要展示的字段

以下字段目前接口完全不返回,或恒为 null。客户端已按设计稿保留完整 UI 结构, 数据为空时统一占位 -,后端补齐后自动显示。

2.1 IntExpMove/pageQuery(出港移库)

设计稿位置 需要的字段 当前状况
列表卡片第二行「航班信息20260709/MU2311」 航班日期 + 航班号(如 fdate / fno 接口无任何航班相关字段
详情页「移库信息」卡片 —— 移库人 移库人姓名(现只有 opId opId 恒为 null,且即便有值也是 ID 而非姓名
详情页「移库信息」卡片 —— 移库时间 opdate 恒为 null已移库记录也是 null
详情页蓝色表头右侧时间戳 同上 opdate 同上
详情页类型行右侧「普通货物运输」 businessTypecargoType 两者均恒为 null

2.2 说明

  • 出库交接页的详情所需字段(板型、库位、复磅人/时间等)接口均已返回,无需补充。
  • 移库详情页红色标签绑的是 awbTypeName(真实值形如「国际出港(国际直航)」),已正常。 设计稿上写的「国际进港」经判断为设计稿笔误(该页属国际出港),未按字面实现。

三、附:字典接口调用口径(客户端已按此对齐,仅作备忘)

typeCode/getSpecialCodeByParam(特码字典):

  • flag=1(国际)+ ieFlag=""留空)→ 正常返回 RXE/PER/PEM/PEF/LDP/GJJ/DGR 等
  • flag=1 + ieFlag="E" → 返回 "data": [] 空数组

国际出港各页面统一使用 ieFlag=""。如该行为非预期,请后端确认 ieFlag 的取值约定。