企迹(qiji) 政企周报管理系统 — v0.1

后端: FastAPI + SQLAlchemy 2.0 (async) + Alembic + MinIO + Casdoor + 企微
前端: Vue 3 + Vite + TypeScript + Element Plus + Pinia

功能清单:
- 8 张数据表自动建表 / Casdoor OIDC 登录 / 企微静默登录
- 双布局: 移动端(填报) + PC端(汇总管理)
- 拜访记录 CRUD + MinIO 照片直传 + 缩略图预览 + 同访人草稿
- 今日纪要 (6 分类) / 工作计划 / 小微商机 / 要客拜访 CRUD
- 客户档案: 备注/收支费用/联系人/归属分配/批量转移
- 客户导入导出 + 模板下载 + 搜索/分页/筛选
- 仪表盘: 四卡统计 + 填报进度 (拜访+纪要双维度)
- 周报详情: 五 Tab + 按人/客户筛选 + 时间轴
- 用户管理 / 客户经理 PC 端工作台
- 企微: 催办/公告/定时提醒 / 时区修正
- Docker 部署配置

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

backend/app/services/wecom.py

@@ -0,0 +1,55 @@
+import httpx
+from app.config import settings
+
+
+class WecomClient:
+    """Minimal WeChat Work API client for sending app messages."""
+
+    def __init__(self):
+        self.corp_id = settings.WECOM_CORP_ID
+        self.agent_id = settings.WECOM_AGENT_ID
+        self.secret = settings.WECOM_SECRET
+        self._access_token: str | None = None
+
+    async def _get_token(self) -> str:
+        if self._access_token:
+            return self._access_token
+        url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={self.corp_id}&corpsecret={self.secret}"
+        async with httpx.AsyncClient() as client:
+            resp = await client.get(url, timeout=10)
+            data = resp.json()
+            if data.get("errcode") == 0:
+                self._access_token = data["access_token"]
+                return self._access_token
+            raise Exception(f"Failed to get wecom token: {data}")
+
+    async def get_userinfo_by_code(self, code: str) -> dict | None:
+        """Exchange OAuth2 code for userid (used in silent login)."""
+        token = await self._get_token()
+        url = f"https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access_token={token}&code={code}"
+        async with httpx.AsyncClient() as client:
+            resp = await client.get(url, timeout=10)
+            data = resp.json()
+            if data.get("errcode") == 0:
+                return data
+            return None
+
+    async def send_text_message(self, user_ids: list[str], content: str) -> bool:
+        """Send a text app message to specified users."""
+        if not settings.WECOM_AGENT_ID:
+            return False  # Not configured, skip silently in dev
+        token = await self._get_token()
+        url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={token}"
+        body = {
+            "touser": "|".join(user_ids),
+            "msgtype": "text",
+            "agentid": int(settings.WECOM_AGENT_ID),
+            "text": {"content": content},
+        }
+        async with httpx.AsyncClient() as client:
+            resp = await client.post(url, json=body, timeout=10)
+            data = resp.json()
+            return data.get("errcode") == 0
+
+
+wecom_client = WecomClient()