docs(mp): /mp/common/config 新增 3 个地图密钥字段 (AMAP_KEY/AMAP_SECURITY_CODE/mapApiKey)

测试服 sys_frontend_config 3 条类型从 SECRET 改 TEXT, 小程序端现在能拿到
可直接用于地图渲染; 正式环境待运营同步改类型。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

changelogs/2026-04/2026-04-21_mp-common-config-add-map-keys.md

@@ -0,0 +1,58 @@
+# /mp/common/config 新增 3 个地图密钥字段
+
+**日期**：2026-04-21
+**关联 PR**：#1114（Closes #1112）
+**后端服务**：无代码改动，仅配置数据变更
+**环境**：测试环境已生效（正式环境待同步）
+
+---
+
+## 变更内容
+
+测试服 `sys_frontend_config` 表中原本 `config_type = 'SECRET'` 的 3 条高德地图密钥配置，已统一改为 `config_type = 'TEXT'`，从而通过 `/mp/common/config` 的公开白名单过滤，**暴露给小程序端**：
+
+| config_key | config_type 变化 | 用途 |
+|------------|------------------|------|
+| `AMAP_KEY` | SECRET → **TEXT** | 高德地图 API Key |
+| `AMAP_SECURITY_CODE` | SECRET → **TEXT** | 高德地图安全密钥 |
+| `mapApiKey` | SECRET → **TEXT** | 高德/腾讯地图 API Key |
+
+**已执行**：
+```sql
+UPDATE sys_frontend_config 
+SET config_type = 'TEXT' 
+WHERE config_key IN ('mapApiKey','AMAP_KEY','AMAP_SECURITY_CODE');
+```
++ `redis-cli -n 0 del mp:common:config` 清旧缓存
+
+---
+
+## 小程序端新增 3 个字段
+
+`GET https://api.test.1814.love:9443/mp/common/config` 的 `data` 里现在多了：
+
+```json
+{
+  "AMAP_KEY": "1c0a90d053120dec577819ccf9722d2f",
+  "AMAP_SECURITY_CODE": "7e04d99af5bd81db393af3468ec03fee",
+  "mapApiKey": "874b6e2d48c9637e410da36aed3757c6"
+}
+```
+
+加上之前的 15 个字段，现在 `data` 共 **18 个 key**。
+
+---
+
+## 前端使用建议
+
+- 小程序端需要渲染地图（行程路线图、集合点、景点坐标等）时，直接从 `config.AMAP_KEY` / `config.mapApiKey` 读取即可，不用再硬编码在代码里
+- 这些 key 受运营管理，后续密钥轮换只需在管理后台改配置 → 小程序无感（运营保存后缓存自动失效）
+- 正式环境上线前运营需要在正式后台把对应 3 条配置的类型同样从「密钥」改成「文本」，或直接执行等效 SQL
+
+---
+
+## 注意
+
+- `/mp/common/config` **不需要登录**即可访问（公开接口），key 会暴露在任何请求这个接口的客户端
+- 如果某个 key 需要域名/AppID 限定或配额控制，需要在高德控制台绑定微信小程序 AppID、控制流量；密钥值本身本接口无法再隐藏
+- 服务端专用的真正敏感配置（比如支付回调签名、数据库密码等）应继续使用 `config_type = 'SECRET'`，不会出现在本接口返回里