feat: add AMap Autocomplete for precise location selection

Problem: Ambiguous addresses like "陈村地铁站" were being geocoded to wrong
locations (Zhaoqing instead of Foshan Shunde).

Solution: Implement AMap Autocomplete that lets users select exact locations
from a dropdown. Selected coordinates are sent directly to backend, bypassing
geocoding entirely.

Changes:
- api/index.py: Add LocationCoord model, /api/config/amap endpoint with
  separate AMAP_JS_API_KEY for frontend maps
- public/meetspot_finder.html: Integrate AMap AutoComplete plugin (note:
  capital C in AMap 2.0), capture coordinates on selection
- app/tool/meetspot_recommender.py: Accept pre_resolved_coords parameter,
  skip geocoding when coordinates provided
- data/address_aliases.json: External file for address mappings
- CLAUDE.md: Document postmortem system and address alias sources

Tested: "陈村北(地铁站)" now correctly resolves to Foshan Shunde (113.245,22.976)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: calderbuild

CLAUDE.md

@@ -31,10 +31,18 @@ python tests/test_seo.py http://localhost:8000  # SEO validation (standalone)
 
 # Quality gates (run before PRs)
 black . && ruff check . && mypy app/
+
+# Postmortem regression check (optional, runs in CI)
+python tools/postmortem_check.py         # Check for known issue patterns
 ```
 
 **Key URLs**: Main UI (`/`), API docs (`/docs`), Health (`/health`)
 
+## Repo Rules
+
+- Follow `AGENTS.md` for repo-local guidelines (style, structure, what not to commit). In particular: runtime-generated files under `workspace/js_src/` must not be committed.
+- There are no Cursor/Copilot rule files in this repo (no `.cursorrules`, no `.cursor/rules/`, no `.github/copilot-instructions.md`).
+
 ## Environment Setup
 
 **Conda**: `conda env create -f environment.yml && conda activate meetspot` (env name is `meetspot`, not `meetspot-dev`)
@@ -140,13 +148,39 @@ The `max_distance` filter applies after POI retrieval during ranking. To change
 `BRAND_FEATURES` dict in `meetspot_recommender.py` contains 50+ brand profiles (Starbucks, Haidilao, etc.) with feature scores (0.0-1.0) for: quiet, WiFi, business, parking, child-friendly, 24h. Used in requirements matching - brands scoring >=0.7 satisfy the requirement. Place types prefixed with `_` (e.g., `_library`) provide defaults.
 
 ### Adding Address Mappings
-In `_enhance_address()` method:
-- `university_mapping` dict for university abbreviations
-- `landmark_mapping` dict for city landmarks (prevents cross-city geocoding errors)
+Two sources for address resolution:
+1. **External file**: `data/address_aliases.json` - JSON file with `university_aliases` and `landmark_aliases` dicts. Preferred for new mappings.
+2. **Internal dicts**: `university_mapping` and `landmark_mapping` in `_enhance_address()` method of `meetspot_recommender.py`. Use for mappings requiring city prefixes (prevents cross-city geocoding errors).
 
 ### Adding Venue Themes
 Add entry to `PLACE_TYPE_CONFIG` with: Chinese name, Boxicons icons, 6 color values.
 
+## Postmortem System
+
+Automated regression prevention system that tracks historical fixes and warns when code changes might reintroduce past bugs.
+
+### Structure
+```
+postmortem/
+  PM-2025-001.yaml ... PM-2026-xxx.yaml  # Historical fix documentation
+tools/
+  postmortem_init.py     # Generate initial knowledge base from git history
+  postmortem_check.py    # Check code changes against known patterns
+  postmortem_generate.py # Generate postmortem for a single commit
+```
+
+### CI Integration
+- `postmortem-check.yml`: Runs on PRs, warns if changes match known issue patterns
+- `postmortem-update.yml`: Auto-generates postmortem when `fix:` commits merge to main
+
+### Adding New Postmortems
+When fixing a bug, the CI will auto-generate a postmortem. For manual creation:
+```bash
+python tools/postmortem_generate.py <commit-hash>
+```
+
+Each postmortem YAML contains triggers (file patterns, function names, regex, keywords) that enable multi-dimensional pattern matching.
+
 ## Debugging
 
 | Issue | Solution |

api/index.py

@@ -40,6 +40,14 @@
     print(f"⚠️ 导入模块警告: {e}")
     config = None
     config_available = False
+    # 创建 fallback logger（当 app.logger 导入失败时）
+    import logging
+    logging.basicConfig(level=logging.INFO)
+    logger = logging.getLogger("meetspot")
+
+    # Fallback for init_db
+    async def init_db():
+        logger.warning("Database module not available, skipping init")
 
 # 导入 Agent 模块（高内存消耗，暂时禁用以保证稳定性）
 agent_available = False  # 禁用 Agent 模式，节省内存
@@ -196,6 +204,15 @@ class LocationRequest(BaseModel):
     venue_types: Optional[List[str]] = ["咖啡馆"]
     user_requirements: Optional[str] = ""
 
+class LocationCoord(BaseModel):
+    """预解析的地址坐标信息（来自前端 Autocomplete 选择）"""
+    name: str                              # 用户选择的地点名称
+    address: str                           # 完整地址
+    lng: float                             # 经度
+    lat: float                             # 纬度
+    city: Optional[str] = ""               # 城市名
+
+
 class MeetSpotRequest(BaseModel):
     locations: List[str]
     keywords: Optional[str] = "咖啡馆"
@@ -205,6 +222,8 @@ class MeetSpotRequest(BaseModel):
     min_rating: Optional[float] = 0.0      # 最低评分 (0-5)
     max_distance: Optional[int] = 100000   # 最大距离 (米)
     price_range: Optional[str] = ""        # 价格区间: economy/mid/high
+    # 预解析坐标（可选，由前端 Autocomplete 提供）
+    location_coords: Optional[List[LocationCoord]] = None
 
 class AIChatRequest(BaseModel):
     message: str
@@ -267,6 +286,7 @@ class AIChatRequest(BaseModel):
 
 # 环境变量配置（用于 Vercel）
 AMAP_API_KEY = os.getenv("AMAP_API_KEY", "")
+AMAP_JS_API_KEY = os.getenv("AMAP_JS_API_KEY", "")  # JS API key for frontend map
 AMAP_SECURITY_JS_CODE = os.getenv("AMAP_SECURITY_JS_CODE", "")
 
 # 创建 FastAPI 应用
@@ -770,15 +790,31 @@ async def _process_meetspot_request(request: MeetSpotRequest, start_time: float)
             recommender = CafeRecommender()
 
             print("🚀 开始执行推荐...")
+            # 转换 location_coords 为推荐器期望的格式
+            pre_resolved_coords = None
+            if request.location_coords:
+                pre_resolved_coords = [
+                    {
+                        "name": coord.name,
+                        "address": coord.address,
+                        "lng": coord.lng,
+                        "lat": coord.lat,
+                        "city": coord.city or ""
+                    }
+                    for coord in request.location_coords
+                ]
+                print(f"📍 使用前端预解析坐标: {len(pre_resolved_coords)} 个")
+
             # 调用推荐工具
             result = await recommender.execute(
                 locations=request.locations,
-                keywords=request.keywords,
-                place_type=request.place_type,
-                user_requirements=request.user_requirements,
-                min_rating=request.min_rating,
-                max_distance=request.max_distance,
-                price_range=request.price_range
+                keywords=request.keywords or "咖啡馆",
+                place_type=request.place_type or "",
+                user_requirements=request.user_requirements or "",
+                min_rating=request.min_rating or 0.0,
+                max_distance=request.max_distance or 100000,
+                price_range=request.price_range or "",
+                pre_resolved_coords=pre_resolved_coords
             )
 
             processing_time = time.time() - start_time
@@ -962,6 +998,34 @@ async def get_recommendations(request: LocationRequest):
     # 直接调用主端点并返回相同格式
     return await find_meetspot(meetspot_request)
 
+
+@app.get("/api/config/amap")
+async def get_amap_config():
+    """返回 AMap 配置（用于前端地图和 Autocomplete）
+
+    Note: 前端需要 JS API key，与后端 geocoding 使用的 Web服务 key 不同
+    """
+    # 优先使用 JS API key（前端地图专用）
+    js_api_key = AMAP_JS_API_KEY
+    security_js_code = AMAP_SECURITY_JS_CODE
+
+    # 从 config.toml 获取（如果存在）
+    if config and hasattr(config, "amap") and config.amap:
+        if not js_api_key:
+            js_api_key = getattr(config.amap, "js_api_key", "") or getattr(config.amap, "api_key", "")
+        if not security_js_code:
+            security_js_code = getattr(config.amap, "security_js_code", "")
+
+    # 最后回退到 Web服务 key（不推荐，可能无法加载地图）
+    if not js_api_key:
+        js_api_key = AMAP_API_KEY
+
+    return {
+        "api_key": js_api_key,
+        "security_js_code": security_js_code
+    }
+
+
 @app.get("/api/status")
 async def api_status():
     """API状态检查"""