feat: improve claude

2026-04-10 21:19:49 +08:00
parent ecbe7d9a5c
commit c7ab89b836
14 changed files with 224 additions and 1 deletions
--- a/.claude.local.md
+++ b/.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 前缀旧命名体系 |