first commit

项目文档/重汽/PX3 地图拷贝功能流程图（简化版）.md

@@ -0,0 +1,117 @@
+# PX3 地图拷贝功能流程图（简化版）
+
+## 一、关键路径
+
+| 数据 | 路径 |
+|---|---|
+| U盘地图压缩包 | `/mnt/usb_storage/amapauto9.zip` |
+| Map分区地图压缩包 | `/mnt/map/amapauto9.zip` |
+| 内部地图 | `/mnt/sdcard/amapauto9/data/navi/compile_v2/chn` |
+| 内部语音 | `/mnt/sdcard/amapauto9/data/voice` |
+
+适用规则：
+
+- PX3 32G设备使用Map分区和内部存储流程。
+- 非32G设备保留原TF卡地图流程。
+- Map分区必须已正确挂载，并允许系统应用读写。
+
+## 二、点击导航
+
+```mermaid
+flowchart TD
+    A["点击导航"] --> B{"是否为PX3 32G设备?"}
+    B -- "否" --> C{"TF卡是否有地图?"}
+    C -- "是" --> D["启动高德导航"]
+    C -- "否" --> E["提示插入含地图的TF卡"]
+
+    B -- "是" --> F{"sdcard地图是否可用?"}
+    F -- "是" --> D
+    F -- "否" --> G{"Map分区是否有amapauto9.zip?"}
+    G -- "否" --> H["提示地图数据不可用"]
+    G -- "是" --> I["进入地图初始化页面"]
+    I --> J["自动解压地图并显示进度"]
+    J --> K{"初始化结果"}
+    K -- "成功" --> L["提示初始化完成"]
+    K -- "失败" --> M["提示失败，可重新操作"]
+```
+
+初始化成功后不直接进入导航，用户再次点击导航即可启动高德。
+
+## 三、工程模式地图管理
+
+```mermaid
+flowchart TD
+    A["进入工程模式"] --> B{"是否为PX3 32G设备?"}
+    B -- "否" --> C["不显示地图数据管理"]
+    B -- "是" --> D["显示地图数据管理"]
+    D --> E{"选择操作"}
+
+    E --> F["从U盘导入到Map分区"]
+    E --> G["删除Map分区地图"]
+    E --> H["复制地图到sdcard目录"]
+    E --> I["清除sdcard地图数据"]
+```
+
+首次部署建议操作顺序：
+
+```text
+如有旧数据，先删除Map分区地图
+  -> 从U盘导入到Map分区
+  -> 复制地图到sdcard目录
+```
+
+## 四、从U盘导入到Map分区
+
+```mermaid
+flowchart TD
+    A["U盘根目录放入amapauto9.zip"] --> B["点击从U盘导入到Map分区"]
+    B --> C{"U盘和压缩包是否正常?"}
+    C -- "否" --> D["提示插入U盘或检查压缩包"]
+    C -- "是" --> E{"Map分区是否已有地图文件?"}
+    E -- "是" --> F["提示先删除Map分区地图"]
+    E -- "否" --> G{"Map分区是否可写且空间足够?"}
+    G -- "否" --> H["提示权限或空间异常"]
+    G -- "是" --> I["先复制为amapauto9.zip.part"]
+    I --> J["复制完成后校验压缩包"]
+    J --> K{"校验是否通过?"}
+    K -- "否" --> L["删除临时文件并提示失败"]
+    K -- "是" --> M["重命名为/mnt/map/amapauto9.zip"]
+    M --> N["提示导入成功"]
+```
+
+## 五、复制地图到sdcard目录
+
+```mermaid
+flowchart TD
+    A["点击复制地图到sdcard目录<br/>或从导航进入初始化"] --> B{"Map压缩包是否有效?"}
+    B -- "否" --> C["提示Map地图数据不可用"]
+    B -- "是" --> D{"sdcard空间是否足够?"}
+    D -- "否" --> E["提示内部存储空间不足"]
+    D -- "是" --> F["解压地图和语音数据"]
+    F --> G["显示初始化进度"]
+    G --> H{"解压和校验是否成功?"}
+    H -- "否" --> I["保留未完成状态，允许重试"]
+    H -- "是" --> J["写入完成状态"]
+    J --> K["后台重启高德进程"]
+    K --> L["提示操作成功"]
+```
+
+只解压地图 `chn` 和语音 `voice` 数据，不处理压缩包中的其他目录。
+
+## 六、删除范围
+
+| 操作 | 删除内容 | 保留内容 |
+|---|---|---|
+| 删除Map分区地图 | `/mnt/map/amapauto9.zip`及残留`.part` | `/mnt/map`目录和其他文件 |
+| 清除sdcard地图数据 | `chn`内地图数据和可重新导入的语音数据 | `chn`、`voice`目录本身及高德语音配置文件 |
+
+清除sdcard数据时保留：
+
+```text
+voice/voice_conf
+voice/common.irf
+voice/isstts.cfg
+voice/xiaoyan.irf
+```
+
+地图任务执行期间按Home键可以后台继续；再次进入页面会恢复当前进度。同一时间只允许执行一个地图任务。