临时保存

docs/common/map.md

@@ -0,0 +1,102 @@
+
+# 这个文件在哪里被用到了，请给出详细的说明
+
+
+          
+我需要搜索代码库中对 map.html 文件的引用，以确定它在哪里被使用。
+        
+            
+toolName: search_codebase
+            
+status: success
+          
+query: 查找对 /src/app/shop/view/config/map.html 文件的引用
+          
+我需要使用正则表达式进行更精确的搜索，查找对 map.html 文件的直接引用。
+        
+            
+toolName: search_by_regex
+            
+status: success
+          
+query: shop/config/map
+          
+让我查看处理 'shop/config/map' 路由的控制器文件，以确定它是如何被使用的。
+        
+            
+toolName: search_by_regex
+            
+status: success
+          
+query: class.*Config.*Controller|function.*map
+          
+我需要查看 Config.php 控制器中的 map() 方法实现，了解 map.html 文件是如何被使用的。
+        
+            
+toolName: view_files
+            
+status: success
+          
+            
+filePath: src/app/shop/controller/Config.php
+          
+`/src/app/shop/view/config/map.html` 文件在项目中主要用于店铺的地图配置功能。以下是详细说明：
+
+## 文件用途
+该文件是一个视图模板，用于展示和配置腾讯地图相关的设置，主要包括腾讯地图 KEY 的配置和手机端定位功能的启用/关闭。
+
+## 使用方式
+
+### 1. 控制器调用
+该视图文件由 <mcfile name="Config.php" path="src/app/shop/controller/Config.php"></mcfile> 控制器中的 <mcsymbol name="map" filename="Config.php" path="src/app/shop/controller/Config.php" startline="168" type="function"></mcsymbol> 方法调用和渲染。当用户访问对应路由时，控制器会通过以下代码渲染该视图：
+```php
+return $this->fetch('config/map');
+```
+
+### 2. 菜单配置
+
+**老配置**
+在 <mcfile name="menu_shop.php" path="src/config/menu_shop.php"></mcfile> 文件中，该页面被注册为店铺后台的一个菜单项，位于"店铺设置" > "其他设置" > "地图配置"，对应的路由为 `shop/config/map`。
+
+**最新配置**
+现在关于菜单的处理，全部放到数据库中，_menu 表中, 查看配置处理
+
+``` sql
+-- auto-generated definition
+create table lucky_menu
+(
+    id             int(11) unsigned auto_increment comment '菜单ID'
+        primary key,
+    app_module     varchar(255) default 'admin' not null comment '应用模块',
+    addon          varchar(255) default ''      not null comment '所属插件',
+    title          varchar(50)  default ''      not null comment '菜单标题',
+    name           varchar(50)  default ''      not null comment '菜单关键字',
+    parent         varchar(255) default ''      not null comment '上级菜单',
+    level          int          default 1       not null comment '深度等级',
+    url            varchar(255) default ''      not null comment '链接地址',
+    is_show        tinyint      default 0       not null comment '是否展示',
+    sort           int          default 0       not null comment '排序（同级有效）',
+    `desc`         varchar(255) default ''      not null comment '描述',
+    is_icon        tinyint      default 0       not null comment '是否是矢量菜单图',
+    picture        varchar(255) default ''      not null comment '图片(矢量图)',
+    picture_select varchar(255) default ''      not null comment '图片(矢量图)(选中)',
+    is_control     tinyint      default 1       not null comment '是否控制权限'
+)
+    comment '菜单表' charset = utf8
+                     row_format = DYNAMIC;
+```
+
+
+### 3. 其他页面引用
+该配置页面在以下几个页面中被引用，作为地图配置的入口点：
+- <mcfile name="local.html" path="src/app/shop/view/local/local.html"></mcfile>：当地址定位功能无法使用时，提供配置入口
+- <mcfile name="contact.html" path="src/app/shop/view/shop/contact.html"></mcfile>：提供地图配置的入口（目前被注释掉）
+
+## 功能实现
+1. **数据提交**：通过 AJAX 提交表单数据到 `shop/config/map` 路由
+2. **数据处理**：控制器接收数据后，调用 `ConfigModel` 的方法验证和保存地图配置
+3. **配置存储**：配置信息存储在系统配置中，包括腾讯地图 KEY 和手机端定位开关状态
+
+## 关联功能
+该地图配置主要用于支持项目中的定位功能，特别是在门店地图展示、地址选择等场景中使用。
+