feat(api): GET /api/moments 朋友圈列表(desc分页+账号头部)

对齐云客员工聊天窗口朋友圈tab:帖子 create_time desc 分页 +
wechat_account 头部(昵称/头像/别名);员工不存在不404(header全None
前端兜底)。头像提取抽共享 helper account_avatar 放 organization.py,
accounts 列表与 moments 头部复用。

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

yunke-server/app/api/routers/moments.py

@@ -0,0 +1,85 @@
+"""GET /api/moments — 员工朋友圈帖子列表(create_time desc)+账号头部。全本地。
+
+对齐云客员工聊天窗口「朋友圈」tab:顶部账号资料卡(昵称/头像/别名)+
+帖子流(新→旧)。读镜像 ``moments_post`` 表(WeChat-only,所属员工由
+``wechat_id`` 标识),头部信息查 ``wechat_account``。
+
+员工微信号不存在时不 404——返回 ``header`` 全 ``None`` + 空 ``items``,
+前端资料卡自行兜底(云客侧同一员工必定有账号行,本地镜像可能滞后)。
+"""
+from __future__ import annotations
+
+from typing import Annotated
+
+import sqlalchemy as sa
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import get_session
+from app.api.routers.organization import account_avatar
+from app.api.schemas import MomentsHeaderOut, MomentsListOut, MomentsPostOut
+from app.db.models import MomentsPost, WechatAccount
+
+router = APIRouter(prefix="/api", tags=["moments"])
+
+SessionDep = Annotated[AsyncSession, Depends(get_session)]
+PageParam = Annotated[int, Query(ge=1)]
+PageSizeParam = Annotated[int, Query(ge=1, le=100)]
+
+
+@router.get("/moments")
+async def list_moments(
+    session: SessionDep,
+    wechat_id: Annotated[str, Query(min_length=1)],
+    page: PageParam = 1,
+    page_size: PageSizeParam = 20,
+) -> MomentsListOut:
+    """员工朋友圈帖子列表(``create_time`` desc,分页)+ 账号头部。
+
+    排序 ``nullslast(create_time desc)`` + ``id`` 稳定断尾(MySQL 下 compat
+    补丁剥掉 NULLS LAST,但 DESC 语义本就把 NULL 排后,等价——项目已有验证)。
+    """
+    account = (
+        await session.execute(
+            sa.select(
+                WechatAccount.nick_name,
+                WechatAccount.alias,
+                WechatAccount.raw_json,
+            ).where(WechatAccount.wx_id == wechat_id)
+        )
+    ).first()
+    header = MomentsHeaderOut(
+        nickname=account.nick_name if account else None,
+        avatar=account_avatar(account.raw_json) if account else None,
+        alias=account.alias if account else None,
+    )
+
+    total = (
+        await session.execute(
+            sa.select(sa.func.count())
+            .select_from(MomentsPost)
+            .where(MomentsPost.wechat_id == wechat_id)
+        )
+    ).scalar_one()
+
+    rows = (
+        await session.execute(
+            sa.select(MomentsPost)
+            .where(MomentsPost.wechat_id == wechat_id)
+            .order_by(
+                sa.nullslast(MomentsPost.create_time.desc()),
+                MomentsPost.id.asc(),
+            )
+            .offset((page - 1) * page_size)
+            .limit(page_size)
+        )
+    ).scalars().all()
+
+    return MomentsListOut(
+        wechat_id=wechat_id,
+        header=header,
+        total=total,
+        page=page,
+        page_size=page_size,
+        items=[MomentsPostOut.model_validate(r) for r in rows],
+    )

yunke-server/app/api/routers/organization.py

@@ -35,6 +35,16 @@ PageParam = Annotated[int, Query(ge=1)]
 PageSizeParam = Annotated[int, Query(ge=1, le=100)]
 
 
+def account_avatar(raw_json: dict | None) -> str | None:
+    """从账号原始记录提取头像 URL(共享 helper,2026-08-25)。
+
+    WeChat ``wxUser/list`` 记录携带 ``headImageUrl``;WA ``businessSalesList``
+    记录无该键 → ``None``。accounts 列表与 moments 头部等多处复用,
+    避免同键提取散落各处。
+    """
+    return (raw_json or {}).get("headImageUrl")
+
+
 @router.get("/departments")
 async def list_departments(session: SessionDep) -> list[DepartmentOut]:
     """Return every department ordered by ``path`` (nulls last).
@@ -177,7 +187,7 @@ async def list_accounts(
             is_on_job=row.is_on_job,
             # 头像从原始记录提取(对齐云客员工聊天窗口左侧头像,2026-08-25):
             # WeChat headImageUrl;WA 原始记录无该键 -> None
-            avatar=(row.raw_json or {}).get("headImageUrl"),
+            avatar=account_avatar(row.raw_json),
             raw_json=row.raw_json,
         )
         for row in rows