福与田 OA — 服务器项目概况

本文件位于服务器根目录 /README.md，供 Cursor / AI 快速建立上下文。
网页版：https://svc.fuyut.com/ · 微信找阿牛可发一次性链接。

① 项目简介

福与田餐饮集团内部管理系统，覆盖移动端（微信小程序）和 Web 端（PC 管理后台），配套 AI 自动化助理（阿牛）。

项目 值
品牌主色 #155DFC（企服蓝）
小程序 AppID wx4d178c6212334cb5
国内服务器 118.195.184.158，SSH 别名 oa
新加坡服务器 43.156.186.80，SSH 别名 singapore（代理出口，见下）

② 服务器与域名

国内服务器（118.195.184.158）— 主要业务

域名 / 路径 用途 端口 systemd
fuyut.com 生产 OA Web + API，/var/www/oa-prod/ 8000 oa-api
test.fuyut.com 测试 OA，/var/www/oa-test/ 8001 oa-api-test
svc.fuyut.com/ 项目概况（本页） — nginx
svc.fuyut.com/sms/ 短信验证码网关 8101 fuyut-sms-gateway
svc.fuyut.com/wecom/ 企业微信网关 8102 fuyut-wecom-gateway
（内部） 微信关键词监听 — fuyut-wecom-cmd-watcher

数据库：MySQL，生产库 oa_prod，测试库 oa；Redis：生产 db=0，测试 db=1。

企业微信（WeCom）— 考勤与消息 ✅ 已接通

网关 wecom-gateway（8102），代码 /var/www/fuyut-services/services/wecom-gateway/，凭据在服务器 .env（不进 Git）。

配置项 值 / 说明
corpid ww3b837f879354ad1a
AgentId 1000008（应用消息推送）
Secret WECOM_CHECKIN_SECRET / WECOM_MSG_SECRET，见 wecom-gateway/.env
本地缓存 /var/www/fuyut-services/data/wecom-gateway.db
鄢千皓（老板） userid YanJun
可见成员 约 89 人（GET /wecom/contacts/users）

wecom-gateway 接口（Header: X-Internal-Key）

路径 方法 说明
/wecom/contacts/users GET 批量成员 userid + 姓名
/wecom/checkin/pull POST 拉打卡；all_users: true 全员分批
/wecom/checkin/cached GET 查本地缓存
/wecom/message/send POST 企业微信应用消息
/wecom/context/token POST 一次性概况链接
/wecom/context/{token} GET 概况页（一次性）
svc.fuyut.com/ GET 概况页（固定公开）
/wecom/health GET 健康检查

项目概况入口

企业微信后台要求：应用可见范围全公司；打卡 API 授权；可信 IP 118.195.184.158。

新加坡服务器（43.156.186.80）— 代理出口

SOCKS5 代理，供国内 AI 访问国际 API（Cursor Agent、Exa 搜索等）。

③ OA 系统架构

层次 技术栈 说明
移动端 原生微信小程序 + TDesign X-Mini-Token，Redis session
Web 端 Vue 3 + Vite Session Cookie
后端 FastAPI + MySQL + Redis oa-test 开发 → deploy 到 oa-prod
辅助服务 FastAPI + SQLite svc.fuyut.com，单实例

主要 API（/api/ 前缀）：auth、daily-report、datacenter、metrics、employees、finance、anomaly 等；内部接口见 oa-test/README.md。

内部接口认证：X-Internal-Key（完整值在服务器 .env）。

④ OpenClaw AI 助理体系

实例 名称 职责
main 阿牛 🐂 主力助理，OA 通知/验证码/编程委托
friend 阿马 辅助通知
gungun 滚滚 🐼 只读查询
cursor-agent Cursor Agent 服务器编程任务

Workspace：~/.openclaw/workspace/（SOUL.md、USER.md、TOOLS.md、MEMORY.md 等）。

⑤ 运营数据抓取（Playwright）

平台 Session 文件 内容
美团 POS storage_state.json 营收、订单、赠菜/退菜原因
开店宝/ecom ecom_storage_state.json 评价、评分
抖音 douyin_storage_state.json 抖音运营
闪购/美团外卖 各门店独立 外卖订单、异常单

Session 路径：/var/www/oa-prod/files/meituan_pos/
验证码：svc.fuyut.com/sms/
Cookie 刷新：POST /api/internal/cookie-refresh 或阿牛「登录 XXX」。

异常单：堂食仅客诉（词表 anomaly_dine_keywords.json）；外卖仅商家有责。详见 oa-test/README.md → 异常单划定规则。

⑥ 代码仓库与目录

仓库 / 目录 路径 说明
OA 开发 /var/www/oa-test/ Git 主工作区，改完 deploy
OA 生产 /var/www/oa-prod/ 禁止直接改源码
辅助服务 /var/www/fuyut-services/ sms / wecom 网关
小程序 ~/repos/oa-miniprogram.git 本地 D:\mini\oa-miniprogram
本概况 /README.md 服务器根目录，Cursor 工作区名 server

Cursor 打开方式：File → Open Workspace from File → 选 /server.code-workspace（文件夹显示名为 server，根路径为 /）。

部署：bash /var/www/oa-test/deploy.sh

⑦ 开发约定

约定 说明
小程序请求 统一 utils/request.js
水印相机 统一 utils/camera.js
环境 develop/trial → test.fuyut.com，release → fuyut.com
辅助服务 放 fuyut-services，不写 OA 库
OA 后端变更 oa-test 改 → commit → deploy
Cursor 任务 默认 composer-2.5，commit 等鄢总确认

最后更新：2026-06-29 · 概况页与根目录 README 统一 · 堂食异常词条 v5（上错菜=客诉）