first commit

MeetSpot/api/routers/auth.py

@@ -0,0 +1,92 @@
+"""认证相关API路由。"""
+
+from fastapi import APIRouter, Depends, HTTPException, status
+from pydantic import BaseModel, Field
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.auth.jwt import create_access_token, get_current_user
+from app.auth.sms import send_login_code, validate_code
+from app.db import crud
+from app.db.database import get_db
+from app.models.user import User
+
+
+router = APIRouter(prefix="/api/auth", tags=["auth"])
+
+
+class SendCodeRequest(BaseModel):
+    phone: str = Field(..., min_length=4, max_length=20, description="手机号")
+
+
+class VerifyCodeRequest(BaseModel):
+    phone: str = Field(..., min_length=4, max_length=20, description="手机号")
+    code: str = Field(..., min_length=4, max_length=10, description="验证码")
+    nickname: str | None = Field(None, description="首次登录时的昵称")
+    avatar_url: str | None = Field(None, description="头像URL，可选")
+
+
+class AuthResponse(BaseModel):
+    success: bool
+    token: str
+    user: dict
+
+
+def _mask_phone(phone: str) -> str:
+    """简单脱敏手机号。"""
+    if len(phone) < 7:
+        return phone
+    return f"{phone[:3]}****{phone[-4:]}"
+
+
+def _serialize_user(user: User) -> dict:
+    """统一的用户返回结构。"""
+    return {
+        "id": user.id,
+        "phone": _mask_phone(user.phone),
+        "nickname": user.nickname,
+        "avatar_url": user.avatar_url or "",
+        "created_at": user.created_at,
+        "last_login": user.last_login,
+    }
+
+
+@router.post("/send_code")
+async def send_code(payload: SendCodeRequest):
+    """下发登录验证码，MVP阶段固定返回Mock值。"""
+    code = await send_login_code(payload.phone)
+    return {"success": True, "message": "验证码已发送", "code": code}
+
+
+@router.post("/verify_code", response_model=AuthResponse)
+async def verify_code(
+    payload: VerifyCodeRequest, db: AsyncSession = Depends(get_db)
+):
+    """验证验证码并返回JWT。"""
+    if not validate_code(payload.phone, payload.code):
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="验证码错误")
+
+    user = await crud.get_user_by_phone(db, payload.phone)
+    nickname = payload.nickname
+    avatar_url = payload.avatar_url or ""
+
+    # 首次登录创建用户；旧用户允许更新昵称
+    if not user:
+        user = await crud.create_user(db, phone=payload.phone, nickname=nickname, avatar_url=avatar_url)
+    else:
+        if nickname:
+            user.nickname = nickname
+            user.avatar_url = avatar_url or user.avatar_url
+            await db.commit()
+        await db.refresh(user)
+
+    await crud.touch_last_login(db, user)
+
+    token = create_access_token({"sub": user.id, "phone": user.phone})
+    return {"success": True, "token": token, "user": _serialize_user(user)}
+
+
+@router.get("/me")
+async def get_me(current_user: User = Depends(get_current_user)):
+    """获取当前登录用户信息。"""
+    return {"user": _serialize_user(current_user)}
+

MeetSpot/api/routers/miniprogram.py

@@ -0,0 +1,50 @@
+from typing import List, Optional, Dict, Any
+from fastapi import APIRouter, HTTPException, Depends
+from pydantic import BaseModel
+
+from app.tool.meetspot_recommender import CafeRecommender
+from app.logger import logger
+
+router = APIRouter(prefix="/api/miniprogram", tags=["miniprogram"])
+
+class LocationItem(BaseModel):
+    lng: float
+    lat: float
+    address: Optional[str] = ""
+    name: Optional[str] = ""
+
+class CalculateRequest(BaseModel):
+    locations: List[LocationItem]
+    keywords: Optional[str] = "咖啡馆"
+    requirements: Optional[str] = ""
+    min_rating: Optional[float] = 0.0
+    max_distance: Optional[int] = 100000
+    price_range: Optional[str] = ""
+
+@router.post("/calculate")
+async def calculate_meetspot(request: CalculateRequest):
+    """小程序核心计算接口：根据坐标直接计算推荐"""
+    try:
+        recommender = CafeRecommender()
+        
+        # 转换 locations 为 list of dict
+        location_dicts = [loc.model_dump() for loc in request.locations]
+        
+        result = await recommender.execute_for_miniprogram(
+            locations=location_dicts,
+            keywords=request.keywords,
+            user_requirements=request.requirements,
+            min_rating=request.min_rating,
+            max_distance=request.max_distance,
+            price_range=request.price_range
+        )
+        
+        if not result.get("success", False):
+            # 业务逻辑错误也返回 200，但在 body 中包含 error
+            return result
+            
+        return result
+        
+    except Exception as e:
+        logger.error(f"Miniprogram calculation failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))

MeetSpot/api/routers/seo_pages.py

@@ -0,0 +1,389 @@
+"""SEO页面路由 - 负责SSR页面与爬虫友好输出."""
+from __future__ import annotations
+
+import json
+import os
+from datetime import datetime
+from functools import lru_cache
+from typing import Dict, List, Optional
+
+from fastapi import APIRouter, HTTPException, Request, Response
+from fastapi.responses import HTMLResponse
+from fastapi.templating import Jinja2Templates
+from slowapi import Limiter
+from slowapi.util import get_remote_address
+
+from api.services.seo_content import seo_content_generator as seo_generator
+
+router = APIRouter()
+templates = Jinja2Templates(directory="templates")
+limiter = Limiter(key_func=get_remote_address)
+
+
+@lru_cache(maxsize=128)
+def load_cities() -> List[Dict]:
+    """加载城市数据, 如不存在则创建默认值."""
+    cities_file = "data/cities.json"
+    if not os.path.exists(cities_file):
+        os.makedirs("data", exist_ok=True)
+        default_payload = {"cities": []}
+        with open(cities_file, "w", encoding="utf-8") as fh:
+            json.dump(default_payload, fh, ensure_ascii=False, indent=2)
+        return []
+
+    with open(cities_file, "r", encoding="utf-8") as fh:
+        payload = json.load(fh)
+    return payload.get("cities", [])
+
+
+def _get_city_by_slug(city_slug: str) -> Optional[Dict]:
+    for city in load_cities():
+        if city.get("slug") == city_slug:
+            return city
+    return None
+
+
+def _build_schema_list(*schemas: Dict) -> List[Dict]:
+    return [schema for schema in schemas if schema]
+
+
+@router.get("/", response_class=HTMLResponse)
+@limiter.limit("60/minute")
+async def homepage(request: Request):
+    """首页 - 提供SEO友好内容."""
+
+    meta_tags = seo_generator.generate_meta_tags("homepage", {})
+    faq_schema = seo_generator.generate_schema_org(
+        "faq",
+        {
+            "faqs": [
+                {
+                    "question": "MeetSpot如何计算最佳聚会地点？",
+                    "answer": "我们使用球面几何算法计算所有参与者位置的地理中点, 再推荐附近高评分场所。",
+                },
+                {
+                    "question": "MeetSpot支持多少人的聚会?",
+                    "answer": "默认支持2-10人, 满足大多数团队与家人聚会需求。",
+                },
+                {
+                    "question": "需要付费吗?",
+                    "answer": "MeetSpot完全免费且开源, 无需注册即可使用。",
+                },
+            ]
+        },
+    )
+    schema_list = _build_schema_list(
+        seo_generator.generate_schema_org("webapp", {}),
+        seo_generator.generate_schema_org("website", {"search_url": "/search"}),
+        seo_generator.generate_schema_org("organization", {}),
+        seo_generator.generate_schema_org(
+            "breadcrumb", {"items": [{"name": "Home", "url": "/"}]}
+        ),
+        faq_schema,
+    )
+
+    return templates.TemplateResponse(
+        "pages/home.html",
+        {
+            "request": request,
+            "meta_title": meta_tags["title"],
+            "meta_description": meta_tags["description"],
+            "meta_keywords": meta_tags["keywords"],
+            "canonical_url": "https://meetspot-irq2.onrender.com/",
+            "schema_jsonld": schema_list,
+            "breadcrumbs": [],
+            "cities": load_cities(),
+        },
+    )
+
+
+@router.get("/meetspot/{city_slug}", response_class=HTMLResponse)
+@limiter.limit("60/minute")
+async def city_page(request: Request, city_slug: str):
+    city = _get_city_by_slug(city_slug)
+    if not city:
+        raise HTTPException(status_code=404, detail="City not found")
+
+    meta_tags = seo_generator.generate_meta_tags(
+        "city_page",
+        {
+            "city": city.get("name"),
+            "city_en": city.get("name_en"),
+            "venue_types": city.get("popular_venues", []),
+        },
+    )
+    breadcrumb = seo_generator.generate_schema_org(
+        "breadcrumb",
+        {
+            "items": [
+                {"name": "Home", "url": "/"},
+                {"name": city.get("name"), "url": f"/meetspot/{city_slug}"},
+            ]
+        },
+    )
+    schema_list = _build_schema_list(
+        seo_generator.generate_schema_org("webapp", {}),
+        seo_generator.generate_schema_org("website", {"search_url": "/search"}),
+        seo_generator.generate_schema_org("organization", {}),
+        breadcrumb,
+    )
+    city_content = seo_generator.generate_city_content(city)
+
+    return templates.TemplateResponse(
+        "pages/city.html",
+        {
+            "request": request,
+            "meta_title": meta_tags["title"],
+            "meta_description": meta_tags["description"],
+            "meta_keywords": meta_tags["keywords"],
+            "canonical_url": f"https://meetspot-irq2.onrender.com/meetspot/{city_slug}",
+            "schema_jsonld": schema_list,
+            "breadcrumbs": [
+                {"name": "首页", "url": "/"},
+                {"name": city.get("name"), "url": f"/meetspot/{city_slug}"},
+            ],
+            "city": city,
+            "city_content": city_content,
+        },
+    )
+
+
+@router.get("/about", response_class=HTMLResponse)
+@limiter.limit("30/minute")
+async def about_page(request: Request):
+    meta_tags = seo_generator.generate_meta_tags("about", {})
+    schema_list = _build_schema_list(
+        seo_generator.generate_schema_org("organization", {}),
+        seo_generator.generate_schema_org(
+            "breadcrumb",
+            {
+                "items": [
+                    {"name": "Home", "url": "/"},
+                    {"name": "About", "url": "/about"},
+                ]
+            },
+        )
+    )
+    return templates.TemplateResponse(
+        "pages/about.html",
+        {
+            "request": request,
+            "meta_title": meta_tags["title"],
+            "meta_description": meta_tags["description"],
+            "meta_keywords": meta_tags["keywords"],
+            "canonical_url": "https://meetspot-irq2.onrender.com/about",
+            "schema_jsonld": schema_list,
+            "breadcrumbs": [
+                {"name": "首页", "url": "/"},
+                {"name": "关于我们", "url": "/about"},
+            ],
+        },
+    )
+
+
+@router.get("/how-it-works", response_class=HTMLResponse)
+@limiter.limit("30/minute")
+async def how_it_works(request: Request):
+    meta_tags = seo_generator.generate_meta_tags("how_it_works", {})
+    how_to_schema = seo_generator.generate_schema_org(
+        "how_to",
+        {
+            "name": "使用MeetSpot AI Agent规划公平会面",
+            "description": "5步AI推理流程, 从输入地址到生成推荐, 5-30秒内完成。",
+            "total_time": "PT1M",
+            "steps": [
+                {
+                    "name": "解析地址",
+                    "text": "AI智能识别地址/地标/简称，'北大'自动转换为'北京市海淀区北京大学'，校验经纬度。",
+                },
+                {
+                    "name": "计算中心点",
+                    "text": "使用球面几何（Haversine公式）计算地球曲面真实中点，数学上对每个人公平。",
+                },
+                {
+                    "name": "搜索周边场所",
+                    "text": "在中心点周边搜索匹配场景的POI，支持咖啡馆、餐厅、图书馆等12种场景主题。",
+                },
+                {
+                    "name": "GPT-4o智能评分",
+                    "text": "AI对候选场所进行多维度评分：距离、评分、停车、环境、交通便利度。",
+                },
+                {
+                    "name": "生成推荐",
+                    "text": "综合排序输出最优推荐，包含地图、评分、导航链接，可直接分享给朋友。",
+                },
+            ],
+            "tools": ["MeetSpot AI Agent", "AMap API", "GPT-4o"],
+            "supplies": ["参与者地址", "场景选择", "特殊需求（可选）"],
+        },
+    )
+    schema_list = _build_schema_list(
+        seo_generator.generate_schema_org("website", {"search_url": "/search"}),
+        seo_generator.generate_schema_org("organization", {}),
+        seo_generator.generate_schema_org(
+            "breadcrumb",
+            {
+                "items": [
+                    {"name": "Home", "url": "/"},
+                    {"name": "How it Works", "url": "/how-it-works"},
+                ]
+            },
+        ),
+        how_to_schema,
+    )
+    return templates.TemplateResponse(
+        "pages/how_it_works.html",
+        {
+            "request": request,
+            "meta_title": meta_tags["title"],
+            "meta_description": meta_tags["description"],
+            "meta_keywords": meta_tags["keywords"],
+            "canonical_url": "https://meetspot-irq2.onrender.com/how-it-works",
+            "schema_jsonld": schema_list,
+            "breadcrumbs": [
+                {"name": "首页", "url": "/"},
+                {"name": "使用指南", "url": "/how-it-works"},
+            ],
+        },
+    )
+
+
+@router.get("/faq", response_class=HTMLResponse)
+@limiter.limit("30/minute")
+async def faq_page(request: Request):
+    meta_tags = seo_generator.generate_meta_tags("faq", {})
+    faqs = [
+        {
+            "question": "MeetSpot 是什么？",
+            "answer": "MeetSpot（聚点）是一个智能会面地点推荐系统，帮助多人找到最公平的聚会地点。无论是商务会谈、朋友聚餐还是学习讨论，都能快速找到合适的场所。",
+        },
+        {
+            "question": "支持多少人一起查找？",
+            "answer": "支持 2-10 个参与者位置，系统会根据所有人的位置计算最佳中点。",
+        },
+        {
+            "question": "支持哪些城市？",
+            "answer": "目前覆盖北京、上海、广州、深圳、杭州等 350+ 城市，使用高德地图数据，持续扩展中。",
+        },
+        {
+            "question": "可以搜索哪些类型的场所？",
+            "answer": "支持咖啡馆、餐厅、图书馆、KTV、健身房、密室逃脱等多种场所类型，还可以同时搜索多种类型（如'咖啡馆+餐厅'）。",
+        },
+        {
+            "question": "如何保证推荐公平？",
+            "answer": "系统使用几何中心算法，确保每位参与者到聚会地点的距离都在合理范围内，没有人需要跑特别远。",
+        },
+        {
+            "question": "推荐结果如何排序？",
+            "answer": "基于评分、距离、用户需求的综合排序算法，优先推荐评分高、距离中心近、符合特殊需求的场所。",
+        },
+        {
+            "question": "可以输入简称吗？",
+            "answer": "支持！系统内置 60+ 大学简称映射，如'北大'会自动识别为'北京大学'。也支持输入地标名称如'国贸'、'东方明珠'等。",
+        },
+        {
+            "question": "是否免费？需要注册吗？",
+            "answer": "完全免费使用，无需注册，直接输入地址即可获得推荐结果。",
+        },
+        {
+            "question": "推荐速度如何？",
+            "answer": "AI Agent 会经历完整的5步推理流程：解析地址 → 计算中心点 → 搜索周边 → GPT-4o智能评分 → 生成推荐。单场景5-8秒，双场景8-12秒，复杂Agent模式15-30秒。",
+        },
+        {
+            "question": "和高德地图有什么区别？",
+            "answer": "高德搜索'我附近'，MeetSpot搜索'我们中间'。我们先用球面几何算出多人公平中点，再推荐那里的好店。这是高德/百度都没有的功能。",
+        },
+        {
+            "question": "AI Agent是什么意思？",
+            "answer": "MeetSpot不是简单的搜索工具，而是一个AI Agent。它有5步完整的推理链条，使用GPT-4o进行多维度评分（距离、评分、停车、环境），你可以看到AI每一步是怎么'思考'的，完全透明可解释。",
+        },
+        {
+            "question": "如何反馈问题或建议？",
+            "answer": "欢迎通过 GitHub Issues 反馈问题或建议，也可以发送邮件至 Johnrobertdestiny@gmail.com。",
+        },
+    ]
+    schema_list = _build_schema_list(
+        seo_generator.generate_schema_org("website", {"search_url": "/search"}),
+        seo_generator.generate_schema_org("organization", {}),
+        seo_generator.generate_schema_org("faq", {"faqs": faqs}),
+        seo_generator.generate_schema_org(
+            "breadcrumb",
+            {
+                "items": [
+                    {"name": "Home", "url": "/"},
+                    {"name": "FAQ", "url": "/faq"},
+                ]
+            },
+        ),
+    )
+    return templates.TemplateResponse(
+        "pages/faq.html",
+        {
+            "request": request,
+            "meta_title": meta_tags["title"],
+            "meta_description": meta_tags["description"],
+            "meta_keywords": meta_tags["keywords"],
+            "canonical_url": "https://meetspot-irq2.onrender.com/faq",
+            "schema_jsonld": schema_list,
+            "breadcrumbs": [
+                {"name": "首页", "url": "/"},
+                {"name": "常见问题", "url": "/faq"},
+            ],
+            "faqs": faqs,
+        },
+    )
+
+
+@router.api_route("/sitemap.xml", methods=["GET", "HEAD"])
+async def sitemap():
+    base_url = "https://meetspot-irq2.onrender.com"
+    today = datetime.now().strftime("%Y-%m-%d")
+    urls = [
+        {"loc": "/", "priority": "1.0", "changefreq": "daily"},
+        {"loc": "/about", "priority": "0.8", "changefreq": "monthly"},
+        {"loc": "/faq", "priority": "0.8", "changefreq": "weekly"},
+        {"loc": "/how-it-works", "priority": "0.7", "changefreq": "monthly"},
+    ]
+    city_urls = [
+        {
+            "loc": f"/meetspot/{city['slug']}",
+            "priority": "0.9",
+            "changefreq": "weekly",
+        }
+        for city in load_cities()
+    ]
+    entries = []
+    for item in urls + city_urls:
+        entries.append(
+            f"    <url>\n        <loc>{base_url}{item['loc']}</loc>\n        <lastmod>{today}</lastmod>\n        <changefreq>{item['changefreq']}</changefreq>\n        <priority>{item['priority']}</priority>\n    </url>"
+        )
+    sitemap_xml = (
+        "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
+        "<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n"
+        + "\n".join(entries)
+        + "\n</urlset>"
+    )
+    # Long cache with stale-while-revalidate to handle Render cold starts
+    # CDN can serve stale content while revalidating in background
+    return Response(
+        content=sitemap_xml,
+        media_type="application/xml",
+        headers={
+            "Cache-Control": "public, max-age=86400, stale-while-revalidate=604800",
+            "X-Robots-Tag": "noindex",  # Sitemap itself shouldn't be indexed
+        },
+    )
+
+
+@router.api_route("/robots.txt", methods=["GET", "HEAD"])
+async def robots_txt():
+    today = datetime.now().strftime("%Y-%m-%d")
+    robots = f"""# MeetSpot Robots.txt\n# Generated: {today}\n\nUser-agent: *\nAllow: /\nCrawl-delay: 1\n\nDisallow: /admin/\nDisallow: /api/internal/\nDisallow: /*.json$\n\nSitemap: https://meetspot-irq2.onrender.com/sitemap.xml\n\nUser-agent: Googlebot\nAllow: /\n\nUser-agent: Baiduspider\nAllow: /\n\nUser-agent: GPTBot\nDisallow: /\n\nUser-agent: CCBot\nDisallow: /\n"""
+    # Long cache with stale-while-revalidate to handle Render cold starts
+    return Response(
+        content=robots,
+        media_type="text/plain",
+        headers={
+            "Cache-Control": "public, max-age=86400, stale-while-revalidate=604800",
+        },
+    )