feat: improve claude

.claude.local.md

@@ -0,0 +1,209 @@
+# 首页菜单页面地图
+
+> **重要**：修改任何业务页面前，先在此处确认目标 Activity 是否为当前活跃页面。
+> 若存在新旧两个同名/近名实现，以本文件中列出的为准（旧版已加 `@Deprecated`）。
+>
+> 菜单入口代码：`app/src/main/java/com/lukouguoji/aerologic/ui/fragment/HomeFragment.kt`
+> 路由常量：`module_base/src/main/java/com/lukouguoji/module_base/router/ARouterConstants.kt`
+
+---
+
+## 一级菜单总览
+
+| 菜单ID | 名称 | 模块 |
+|--------|------|------|
+| `DomExp` | 国内出港 | `module_gnc` |
+| `DomImp` | 国内进港 | `app/page/gnj` |
+| `IntExp` | 国际出港 | `module_gjc` |
+| `IntImp` | 国际进港 | `module_gjj` |
+| `Flight` | 航班查询 | `module_hangban` |
+| `CargoStatus` | 货物追踪 | `module_cargo` |
+| `Supervision` | 监装监卸 | `module_mit` + `app/page` |
+| `Comprehensive` | 综合管理 | `app/page` |
+
+---
+
+## 国内出港（DomExp）
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 文件路径 |
+|--------|--------|----------|---------|
+| 出港收运 | `AppDomExpCheckIn` | `GncShouYunUnListActivity` | `module_gnc/.../page/shouyun/unlist/` |
+| 出港复磅 | `AppDomExpWeighting` | `GncFuBangListActivity` | `module_gnc/.../page/fubang/list/` |
+| 出港组装 | `AppDomExpAssemble` | `GncAssembleListActivity` | `module_gnc/.../page/assemble/list/` |
+| 出港分配 | `AppDomExpDistribution` | `GncDistributionHomeActivity` | `module_gnc/.../page/distribution/home/` |
+| 出港存放 | `AppDomExpDeposit` | `GncDepositListActivity` | `module_gnc/.../page/deposit/list/` |
+| 仓库管理 | `AppDomExpWareHouse` | `GncWareHouseActivity` | `module_gnc/.../activity/GncWareHouseActivity.kt` |
+| 出港查询 | `AppDomExpSearch` | `GncQueryListActivity` | `module_gnc/.../activity/GncQueryListActivity.kt` |
+
+### 三级页面（出港收运）
+
+| 页面名 | Activity | 路径 |
+|--------|----------|------|
+| 待收运列表 | `GncShouYunUnListActivity` | `.../shouyun/unlist/` |
+| 开始收运（详情） | `GncShouYunDetailsActivity` | `.../shouyun/details/` |
+| 已收运列表 | `GncShouYunListActivity` | `.../shouyun/list/` |
+
+> ⚠️ 旧版文件（已加 `@Deprecated`）：`module_gnc/.../activity/` 下的 `Gout*` 系列 7 个 Activity
+
+---
+
+## 国内进港（DomImp）
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 文件路径 |
+|--------|--------|----------|---------|
+| 进港舱单 | `AppDomImpManiFest` | `GnjManifestListActivity` | `app/.../page/gnj/manifest/list/` |
+| 进港出库 | `AppDomImpPickUpDLV` | `GnjMoveStashListActivity` | `app/.../page/gnj/move/stash/list/` |
+| 进港移库 | `AppDomImpMove` | `GnjMoveStashListActivity` | `app/.../page/gnj/move/stash/list/` |
+| 仓库管理 | `AppDomImpWareHouse` | `GnjStashListActivity` | `app/.../page/gnj/stash/list/` |
+| 进港查询 | `AppDomImpSearch` | `GnjQueryListActivity` | `app/.../page/gnj/query/list/` |
+| 进港交接 | `AppDomImpHandover` | `GnjHandoverListActivity` | `app/.../page/gnj/jiaojie/` |
+| 入库确认 | `AppDomImpConfirm` | 路由 `/gnj/GnjRuKuActivity` | — |
+
+### 三级页面（进港舱单）
+
+| 页面名 | Activity | 路径 |
+|--------|----------|------|
+| 舱单列表 | `GnjManifestListActivity` | `.../manifest/list/` |
+| 新增/修改舱单 | `GnjManifestAddActivity` | `.../manifest/add/` |
+
+---
+
+## 国际出港（IntExp）
+
+路由前缀：`/gjc/`
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 路由常量 |
+|--------|--------|----------|---------|
+| 收运检查 | `AppIntExpInspection` | `GjcInspectionActivity` | `ACTIVITY_URL_GJC_INSPECTION` |
+| 出港计重 | `AppIntExpCheckWeighing` | `GjcWeighingListActivity` | `ACTIVITY_URL_GJC_WEIGHING_LIST` |
+| 出港运抵 | `AppIntExpArrive` | `IntExpArriveActivity` | `ACTIVITY_URL_INT_EXP_ARRIVE` |
+| 组装分配 | `AppIntExpAssembleAllocate` | `GjcAssembleAllocateActivity` | `ACTIVITY_URL_GJC_ASSEMBLE_ALLOCATE` |
+| 出港组装 | `AppIntExpAssemble` | `IntExpAssembleActivity` | `ACTIVITY_URL_INT_EXP_ASSEMBLE` |
+| 板箱过磅 | `GjcFuBangActivity`（权限ID，非类名）| `GjcBoxWeighingActivity` | `ACTIVITY_URL_GJC_BOX_WEIGHING` |
+| 出港装载 | `AppIntExpLoad` | `IntExpLoadActivity` | `ACTIVITY_URL_INT_EXP_LOAD` |
+| 出库交接 | `AppIntExpOutHandover` | `IntExpOutHandoverActivity` | `ACTIVITY_URL_INT_EXP_OUT_HANDOVER` |
+| 出港理货 | `AppIntExpTally` | `IntExpTallyActivity` | `ACTIVITY_URL_INT_EXP_TALLY` |
+| 出港移库 | `AppIntExpMove` | `IntExpMoveActivity` | `ACTIVITY_URL_INT_EXP_MOVE` |
+| 出港仓库 | `AppIntExpStorageUse` | `IntExpStorageUseActivity` | `ACTIVITY_URL_INT_EXP_STORAGE_USE` |
+| 出港查询 | `AppIntExpSearch` | `GjcQueryListActivity` | `ACTIVITY_URL_GJC_QUERY_LIST` |
+
+> ⚠️ 旧版文件（已加 `@Deprecated`）：`GjcFuBangActivity`（`module_gjc/.../activity/`），已被 `GjcBoxWeighingActivity` 替代
+
+---
+
+## 国际进港（IntImp）
+
+路由前缀：`/gjj/`
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 路由常量 |
+|--------|--------|----------|---------|
+| 电报解析 | `AppIntImpMsgParse` | `IntImpMsgParseActivity` | `ACTIVITY_URL_INT_IMP_MSG_PARSE` |
+| 进港舱单 | `AppIntImpManifest` | `IntImpManifestActivity` | `ACTIVITY_URL_INT_IMP_MANIFEST` |
+| 原始舱单 | `AppIntArrAirManifest` | `IntArrAirManifestActivity` | `ACTIVITY_URL_INT_ARR_AIR_MANIFEST` |
+| 理货报告 | `AppIntImpTally` | `IntImpTallyActivity` | `ACTIVITY_URL_INT_IMP_TALLY` |
+| 进港仓库 | `AppIntImpWareHouse` | `GjjWareHouseActivity` | `ACTIVITY_URL_GJJ_WARE_HOUSE` |
+| 提取记录 | `AppIntImpPickUpRecord` | `IntImpPickUpRecordActivity` | `ACTIVITY_URL_INT_IMP_PICK_UP_RECORD` |
+| 提取出库 | `AppIntImpPickUpDLV` | `IntImpPickUpDLVActivity` | `ACTIVITY_URL_INT_IMP_PICK_UP_DLV` |
+| 进港查询 | `AppIntImpSearch` | `IntImpQueryActivity` ⚡ | `ACTIVITY_URL_GJJ_QUERY_LIST` |
+| 事故签证 | `AppIntImpAccidentVisa` | `IntImpAccidentVisaActivity` | `ACTIVITY_URL_INT_IMP_ACCIDENT_VISA` |
+
+### 三级页面（进港舱单）
+
+| 页面名 | Activity | 说明 |
+|--------|----------|------|
+| 舱单列表（入口） | `IntImpManifestActivity` | 二级入口页 |
+| 舱单子列表 | `GjjManifestListActivity` | 活跃，独立路由 `ACTIVITY_URL_GJJ_MANIFEST` |
+| 舱单详情 | `GjjManifestDetailsActivity` / `IntImpManifestDetailsActivity` | 两个活跃详情页 |
+| 分单编辑 | `GjjManifestAddActivity` / `IntImpManifestSubEditActivity` | 活跃编辑页 |
+
+### 三级页面（进港查询）
+
+| 页面名 | Activity | 说明 |
+|--------|----------|------|
+| 查询列表（入口） | `IntImpQueryActivity` | 二级入口页（注意：非 GjjQueryListActivity）|
+| 查询详情 | `IntImpQueryDetailsActivity` | 活跃 |
+| 运单修改 | `IntImpQueryEditActivity` | 活跃 |
+
+> ⚠️ 旧版（已加 `@Deprecated`）：`GjjQueryListActivity`、`GjjQueryInfoActivity`
+
+---
+
+## 航班查询（Flight）
+
+直接跳转，无二级菜单。
+
+| Activity | 路由 | 文件路径 |
+|----------|------|---------|
+| `HbQueryListActivity` | `/hb/HbQueryListActivity` | `module_hangban/...` |
+
+> ⚠️ 旧版：`FlightQueryListActivity`（`app/.../page/flight/query/list/`）已加 `@Deprecated`，由 HomeFragment 注释确认废弃
+
+---
+
+## 货物追踪（CargoStatus）
+
+直接跳转，无二级菜单。
+
+| Activity | 路由 |
+|----------|------|
+| `CargoTrackingActivity` | `/cg/CargoTrackingActivity` |
+
+---
+
+## 监装监卸（Supervision）
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 文件路径 |
+|--------|--------|----------|---------|
+| 进港卸机 | `AppImpLoad` | `GnjUnloadListActivity` | `app/.../page/gnj/unload/list/` |
+| 事故签证（监装） | `AppAccidentVisa` | `AccidentVisaActivity` | 路由 `/mit/AccidentVisaActivity` |
+| 事故签证（综合） | `AppComprehensiveAccidentVisa` | `AccidentVisaListActivity` | `app/.../page/accident/visa/list/` |
+| 出港装板 | `AppExpLoad` | `OutLoadingActivity` | 路由 `/mit/OutLoadingActivity` |
+
+---
+
+## 综合管理（Comprehensive）
+
+### 二级菜单
+
+| 菜单名 | 权限ID | Activity | 文件路径 |
+|--------|--------|----------|---------|
+| 消息管理 | `AppComprehensiveMessage` | `MessageListActivity` | `app/.../page/message/list/` |
+| 电报管理 | `AppComprehensiveTelegram` | `TelegramListActivity` | `app/.../page/telegram/list/` |
+| 货物转运 | `AppComprehensiveTransfer` | `GoodsTransportActivity` | `app/.../page/transport/` |
+| 平板车管理 | `AppComprehensiveCar` | `CarListActivity` | `app/.../page/car/list/` |
+| 日志查询 | `AppComprehensiveLog` | `LogQueryActivity` | `app/.../page/log/list/` |
+| 转运记录 | `AppTransportLog` | `TransportLogActivity` | `app/.../page/transportLog/list/` |
+| ULD管理 | `AppComprehensiveUld` | `UldListActivity` | `app/.../page/uld/list/` |
+| 冷库登记 | `AppComprehensiveColdStorage` | `ColdStorageActivity` | `app/.../page/coldStorage/list/` |
+
+---
+
+## 废弃页面清单（已加 @Deprecated）
+
+以下页面确认废弃，勿修改、勿参考：
+
+| 废弃类名 | 文件路径 | 替代页面 | 依据 |
+|----------|---------|---------|------|
+| `FlightQueryListActivity` | `app/.../page/flight/query/list/` | `HbQueryListActivity` | HomeFragment 注释"已废弃" |
+| `HangBanQueryActivity` | `module_hangban/.../activity/` | `HbQueryListActivity` | 路由注释"已废弃，使用 HbQueryListActivity" |
+| `HangBanQueryInfoActivity` | `module_hangban/.../activity/` | — | 仅被废弃的 HangBanQueryActivity 调用，实际不可达 |
+| `GjcFuBangActivity` | `module_gjc/.../activity/` | `GjcBoxWeighingActivity` | HomeFragment 注释"旧版跳转" |
+| `GjjQueryListActivity` | `module_gjj/.../activity/` | `IntImpQueryActivity` | 路由被注释，IntImpQueryActivity 接管同一路由 |
+| `GjjQueryInfoActivity` | `module_gjj/.../activity/` | `IntImpQueryDetailsActivity` | 路由注释"已替换为 IntImpQueryDetailsActivity" |
+| `GoutChuKuListActivity` | `module_gnc/.../activity/` | Gnc 新版出库页面 | Gout 前缀旧命名体系 |
+| `GoutCollectionActivity` | `module_gnc/.../activity/` | `GncShouYunUnListActivity` | Gout 前缀旧命名体系 |
+| `GoutFuBangActivity` | `module_gnc/.../activity/` | `GncFuBangListActivity` | Gout 前缀旧命名体系 |
+| `GoutFuBangCotActivity` | `module_gnc/.../activity/` | `GncFuBangListActivity` | Gout 前缀旧命名体系 |
+| `GoutStartCotActivity` | `module_gnc/.../activity/` | `GncShouYunUnListActivity` | Gout 前缀旧命名体系 |
+| `GoutTransferActivity` | `module_gnc/.../activity/` | Gnc 新版转运页面 | Gout 前缀旧命名体系 |
+| `GoutTransferInfoActivity` | `module_gnc/.../activity/` | Gnc 新版转运详情 | Gout 前缀旧命名体系 |

.claude/settings.local.json

@@ -128,7 +128,9 @@
       "mcp__api-doc__search_endpoints",
       "mcp__api-doc__get_endpoint_detail",
       "mcp__api-doc__list_modules",
-      "mcp__api-doc__list_endpoints"
+      "mcp__api-doc__list_endpoints",
+      "Bash(sed -n '11,15p' /Users/kid/Development/Fusion/Projects/aerologic-app/app/src/main/java/com/lukouguoji/aerologic/page/flight/query/list/FlightQueryListActivity.kt)",
+      "Bash(sed -n '23,27p' /Users/kid/Development/Fusion/Projects/aerologic-app/module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcFuBangActivity.kt)"
     ],
     "deny": [],
     "ask": []

module_gjc/src/main/java/com/lukouguoji/gjc/activity/GjcFuBangActivity.kt

@@ -21,6 +21,7 @@ import com.lukouguoji.module_base.util.Common
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版板箱过磅，使用 GjcBoxWeighingActivity 替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GJC_FU_BANG)
 class GjcFuBangActivity : BaseActivity(), View.OnClickListener {
     private lateinit var viewModel: GjcFuBangViewModel

module_gjj/src/main/java/com/lukouguoji/gjj/activity/GjjQueryInfoActivity.kt

@@ -24,6 +24,7 @@ import com.lukouguoji.module_base.BaseActivity
 import com.lukouguoji.module_base.common.Constant
 import com.lukouguoji.module_base.router.ARouterConstants
 
+@Deprecated("旧版国际进港查询详情，使用 IntImpQueryDetailsActivity 替代")
 // @Route(path = ARouterConstants.ACTIVITY_URL_GJJ_QUERY_INFO) // 已替换为 IntImpQueryDetailsActivity
 class GjjQueryInfoActivity : BaseActivity(), View.OnClickListener {
 

module_gjj/src/main/java/com/lukouguoji/gjj/activity/GjjQueryListActivity.kt

@@ -27,6 +27,7 @@ import com.scwang.smart.refresh.layout.api.RefreshLayout
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版国际进港查询列表，使用 IntImpQueryActivity 替代")
 //@Route(path = ARouterConstants.ACTIVITY_URL_GJJ_QUERY_LIST)
 class GjjQueryListActivity : BaseActivity(), View.OnClickListener {
     private val currentTitleName = "国际进港查询"

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutChuKuListActivity.kt

@@ -30,6 +30,7 @@ import com.scwang.smart.refresh.header.ClassicsHeader
 import com.scwang.smart.refresh.layout.api.RefreshLayout
 import java.util.*
 //出库装机操作页面
+@Deprecated("旧版国内出港出库，已由 Gnc 前缀新版页面替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_CHU_KU_LIST_ACTIVITY)
 class GoutChuKuListActivity : BaseActivity() {
     public lateinit var viewModel: GoutFuBangListViewModel

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutCollectionActivity.kt

@@ -32,6 +32,7 @@ import dev.utils.common.StringUtils
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版国内出港收运，已由 Gnc 前缀新版页面替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_COLLECTION_ACTIVITY)
 class GoutCollectionActivity : BaseActivity(), View.OnClickListener {
 

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutFuBangActivity.kt

@@ -25,6 +25,7 @@ import dev.utils.common.StringUtils
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版国内出港复磅，使用 GncFuBangListActivity 替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_FU_BANG_ACTIVITY)
 class GoutFuBangActivity : BaseActivity(), View.OnClickListener {
     private lateinit var checkintongdao:Spinner

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutFuBangCotActivity.kt

@@ -27,6 +27,7 @@ import com.scwang.smart.refresh.layout.api.RefreshLayout
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版国内出港复磅（组合），使用 GncFuBangListActivity 替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_FU_BANG_LIST_ACTIVITY)
 class GoutFuBangCotActivity : BaseActivity(), View.OnClickListener {
     private lateinit var viewModel: GoutFuBangListViewModel

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutStartCotActivity.kt

@@ -34,6 +34,7 @@ import java.util.*
 import kotlin.math.abs
 
 
+@Deprecated("旧版国内出港收运开始，使用 GncShouYunUnListActivity 替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_START_COT_ACTIVITY)
 class GoutStartCotActivity : BaseActivity(), View.OnClickListener ,OnItemSelectedListener{
     private lateinit var checkintongdao:Spinner

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutTransferActivity.kt

@@ -26,6 +26,7 @@ import com.scwang.smart.refresh.layout.api.RefreshLayout
 import java.text.SimpleDateFormat
 import java.util.*
 
+@Deprecated("旧版国内出港转运，已由 Gnc 前缀新版页面替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_TRANSFER_ACTIVITY)
 class GoutTransferActivity : BaseActivity(), View.OnClickListener {
     private lateinit var viewModel: GoutTransferViewModel

module_gnc/src/main/java/com/lukouguoji/gnc/activity/GoutTransferInfoActivity.kt

@@ -18,6 +18,7 @@ import com.lukouguoji.module_base.common.Constant
 import com.lukouguoji.module_base.router.ARouterConstants
 import com.lukouguoji.module_base.util.Common
 
+@Deprecated("旧版国内出港转运详情，已由 Gnc 前缀新版页面替代")
 @Route(path = ARouterConstants.ACTIVITY_URL_GOUT_TRANSFER_INFO_ACTIVITY)
 class GoutTransferInfoActivity : BaseActivity(), View.OnClickListener {
     private lateinit var viewModel: GoutTransferInfoViewModel

module_hangban/src/main/java/com/lukouguoji/hangban/activity/HangBanQueryActivity.kt

@@ -30,6 +30,7 @@ import java.text.SimpleDateFormat
 import java.util.*
 
 
+@Deprecated("旧版航班查询，使用 HbQueryListActivity 替代")
 // @Route(path = ARouterConstants.ACTIVITY_URL_HANG_BAN_QUERY) // 已废弃，使用 HbQueryListActivity
 @Deprecated("使用 HbQueryListActivity 替代")
 class HangBanQueryActivity : BaseActivity(), View.OnClickListener {

module_hangban/src/main/java/com/lukouguoji/hangban/activity/HangBanQueryInfoActivity.kt

@@ -17,6 +17,7 @@ import com.lukouguoji.module_base.BaseActivity
 import com.lukouguoji.module_base.common.Constant
 import com.lukouguoji.module_base.router.ARouterConstants
 
+@Deprecated("旧版航班查询详情，仅被废弃的 HangBanQueryActivity 调用，实际不可达")
 @Route(path = ARouterConstants.ACTIVITY_URL_HANG_BAN_QUERY_INFO)
 class HangBanQueryInfoActivity : BaseActivity(), View.OnClickListener {
     private lateinit var viewModel: HangBanQueryInfoViewModel