1.7

backend/app/routers/climates.py

@@ -0,0 +1,38 @@
+"""聊天气候路由"""
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.dependencies import get_db, get_current_user
+from app.models.user import User
+from app.services.climate_service import ClimateService
+
+router = APIRouter()
+
+
+@router.get("/{conversation_id}")
+async def get_climate(
+    conversation_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取/计算会话气候"""
+    service = ClimateService(db)
+    try:
+        return await service.compute(conversation_id, user.id)
+    except ValueError as e:
+        raise HTTPException(status_code=403, detail=str(e))
+
+
+@router.get("/{conversation_id}/calendar")
+async def get_calendar(
+    conversation_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取 30 天气候日历"""
+    service = ClimateService(db)
+    try:
+        return await service.get_calendar(conversation_id, user.id)
+    except ValueError as e:
+        raise HTTPException(status_code=403, detail=str(e))

backend/app/routers/echoes.py

@@ -0,0 +1,40 @@
+"""念念回音路由"""
+
+from fastapi import APIRouter, Depends, HTTPException
+from pydantic import BaseModel, Field
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.dependencies import get_db, get_current_user
+from app.models.user import User
+from app.services.echo_service import EchoService
+
+router = APIRouter()
+
+
+class EchoCreate(BaseModel):
+    to_user_id: str
+    message: str | None = Field(None, max_length=50)
+
+
+@router.post("/")
+async def send_echo(
+    req: EchoCreate,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """发送一片回音叶"""
+    service = EchoService(db)
+    try:
+        return await service.send_echo(user.id, req.to_user_id, req.message)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.get("/")
+async def list_echoes(
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取回音列表"""
+    service = EchoService(db)
+    return await service.get_echoes(user.id)

backend/app/routers/flash.py

@@ -0,0 +1,68 @@
+"""萤火虫时刻路由"""
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.dependencies import get_db, get_current_user
+from app.models.user import User
+from app.services.flash_service import FlashService
+
+router = APIRouter()
+
+
+@router.get("/active")
+async def get_active(
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取当前萤火虫事件。若没有，随机概率尝试触发一个（让功能可被体验到）"""
+    service = FlashService(db)
+    event = await service.get_active_event()
+    if event:
+        return {"event": event}
+    # 概率触发：每次请求 ~4% 概率尝试生成（受单日 1 次限制），让萤火虫保持稀有
+    import hashlib
+    seed = hashlib.md5(f"{user.id}:{__import__('datetime').datetime.utcnow().strftime('%H%M')}".encode()).hexdigest()
+    if int(seed[:2], 16) < 10:  # ~4%
+        spawned = await service.try_spawn()
+        if spawned:
+            return {"event": spawned}
+    return {"event": None}
+
+
+@router.post("/{event_id}/click")
+async def click(
+    event_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """集气点击"""
+    service = FlashService(db)
+    try:
+        return await service.click(user.id, event_id)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.post("/{event_id}/claim")
+async def claim(
+    event_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """领取限定纪念叶"""
+    service = FlashService(db)
+    try:
+        return await service.claim_reward(user.id, event_id)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.get("/album")
+async def get_album(
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """我的萤火虫图鉴"""
+    service = FlashService(db)
+    return await service.get_my_album(user.id)

backend/app/routers/leaves.py

@@ -44,3 +44,13 @@ async def get_collection(
     """获取叶子收藏"""
     service = LeafService(db)
     return await service.get_collection(user.id)
+
+
+@router.get("/grove")
+async def get_grove(
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """情绪共鸣林：好友圈今日心情叶聚合"""
+    service = LeafService(db)
+    return await service.get_grove(user.id)

backend/app/routers/sync.py

@@ -0,0 +1,58 @@
+"""默契种子路由"""
+
+from fastapi import APIRouter, Depends, HTTPException
+from pydantic import BaseModel, Field
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.dependencies import get_db, get_current_user
+from app.models.user import User
+from app.services.sync_service import SyncService
+
+router = APIRouter()
+
+
+class AnswerSubmit(BaseModel):
+    question_id: str
+    friend_id: str
+    answer: str = Field(..., min_length=1, max_length=500)
+
+
+@router.get("/question")
+async def get_today_question(
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取今日默契题"""
+    service = SyncService(db)
+    try:
+        return await service.get_today_question()
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.post("/answer")
+async def submit_answer(
+    req: AnswerSubmit,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """提交答案"""
+    service = SyncService(db)
+    try:
+        return await service.submit_answer(user.id, req.question_id, req.friend_id, req.answer)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.get("/{seed_id}")
+async def get_seed(
+    seed_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """查看默契种子结果"""
+    service = SyncService(db)
+    try:
+        return await service.get_seed(user.id, seed_id)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))

backend/app/routers/trees.py

@@ -43,3 +43,14 @@ async def water_tree(
         return await service.water(user.id, friend_id)
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
+
+
+@router.get("/{friend_id}/heartbeat")
+async def get_heartbeat(
+    friend_id: str,
+    user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """获取心跳同步数据"""
+    service = TreeService(db)
+    return await service.get_heartbeat(user.id, friend_id)