服务概览
本平台部署了以下服务，统一通过 ai.jiuqi.top 域名提供访问（全站 HTTPS）：
AI 设计平台
AI辅助设计需求管理，支持文档生成和图片生成
钉钉管理助手
组织架构同步、考勤数据管理、审批记录查询
钉钉开放 API
对外开放接口文档，支持人员/考勤/审批数据同步
巨量引擎数据服务
巨量引擎广告数据同步与ROI分析，支持抖音数据管道
npmmirror CDN 代理
npm 镜像源反向代理，加速前端依赖安装
千川电商分析
千川广告数据同步与分析，每日凌晨2点自动执行
AI 设计平台
功能说明
- 提交设计需求，AI 自动生成设计需求文档
- AI 辅助生成设计图片（支持文生图和图生图）
- 需求状态全流程追踪（草稿 → 确认 → 生成中 → 完成）
- 管理后台：用户管理、需求管理、存储管理、下拉选项配置
使用方式
注意事项
⚠️ 限九起内部在职员工使用。图片生成每条需求最多支持 3 次重新生成。单张图片生成约需 1-3 分钟，请耐心等待。
钉钉管理助手
功能说明
- 组织架构 部门和员工信息同步（含花名册24个字段：身份证、学历、银行卡等）
- 考勤管理 考勤打卡明细、日统计、月度报表，异常详情格式化输出
- 审批同步 请假、加班等审批记录自动同步
- 离职管理 离职员工信息同步，支持Excel批量导入更新
- 实时订阅 钉钉事件回调（审批变更、员工变动等）
- 伙伴云同步 自动同步合同信息至伙伴云表格，含花名册和排名榜单增量更新
使用方式
示例：
2026年05月考勤
异常汇总：
1、迟到2次(共5分钟)
2、上班缺卡1次
异常明细：
1、2026-05-14 迟到 09:02打卡
2、2026-05-20 迟到 09:03打卡
钉钉开放 API
功能说明
为外部系统提供钉钉数据同步和查询接口，支持 API Key 认证。
接口列表
| 类别 | 接口 | 说明 |
|---|
| 同步接口 | POST /api/dingtalk/sync/all | 全量同步（人员+部门+考勤） |
POST /api/dingtalk/employees/sync | 同步全部员工信息 |
POST /api/dingtalk/attendance/monthly/sync | 同步月度考勤数据 |
POST /api/dingtalk/dimission/sync | 同步离职员工信息 |
| 查询接口 | GET /api/dingtalk/employees | 查询员工列表 |
GET /api/dingtalk/attendance/monthly | 查询月度考勤数据 |
GET /api/dingtalk/attendance/monthly/export | 导出月度考勤 Excel |
认证方式
请求示例：
Authorization: Bearer <API_KEY>
完整接口文档请访问
API 文档页面
巨量引擎数据服务
功能说明
巨量引擎（Ocean Engine）广告数据同步与分析服务，集成千川和抖音广告数据管道。
核心功能
- 千川广告 千川广告数据自动同步与分析
- 抖音数据 抖音数据分析管道，支持 CPS 来源分析
- ROI 分析 广告投放ROI计算与多维度报表
- OAuth认证 OAuth 2.0 授权流程管理
定时任务
| 任务 | 执行时间 | 说明 |
|---|
| 千川数据同步 | 每天 02:00 | 自动拉取千川广告数据，日志输出至 /var/log/qianchuan_cron.log |
| 巨量引擎 Pipeline | 每天 02:00 | 巨量引擎数据管道，日志输出至 /data/design-platform/logs/ocean_daily.log |
相关配置
- Nginx 站点配置：
/www/server/panel/vhost/nginx/ai_jiuqi_top.conf
- 同步脚本：
/www/wwwroot/ecom_analytics/scripts/sync_qianchuan.py
- 巨量引擎管道：
/data/design-platform/ocean_pipeline.py
- 抖音数据管道：
/data/design-platform/douyin_pipeline.py
npmmirror CDN 代理
功能说明
通过 Nginx 反向代理 registry.npmmirror.com，为内部开发环境提供加速的 npm 包下载服务。
使用方式
⚠️ 仅供内部开发使用，请勿对外公开。
定时任务
平台通过 Cron 定时任务实现数据自动同步，任务汇总如下：
| 时间 | 任务 | 说明 |
|---|
| 每天 00:00 | 数据库备份 | MySQL 数据库自动备份，脚本 /data/design-platform/scripts/backup_db.sh |
| 每天 01:00 | 钉钉数据同步 | 同步在职/离职员工及合同信息到伙伴云，日志 /data/design-platform/dingtalk_sync.log |
| 每天 02:00 | 千川数据同步 | 拉取千川广告数据，日志 /var/log/qianchuan_cron.log |
| 每天 02:00 | 巨量引擎 Pipeline | 巨量引擎广告数据管道处理，日志 /data/design-platform/logs/ocean_daily.log |
| 每天 03:00 | 伙伴云增量同步 | 伙伴云表格增量同步（花名册+排名榜单），日志 /data/design-platform/daily_sync_v2.log |
| 每天 08:00 | 同步健康检查 | 检查各同步任务运行状态，日志 /data/design-platform/sync_health_check.log |
注意：所有定时任务均基于服务器本地 Cron 执行，如需调整请联系管理员。
系统架构
| 项目 | 信息 |
|---|
| 服务器 | 腾讯云轻量应用服务器 |
| 操作系统 | OpenCloudOS 9.4 |
| 配置 | 4核 CPU (AMD EPYC 7K83) / 7.4GB RAM / 180GB SSD |
| Web 服务器 | Nginx 1.26.3（反向代理 + SSL 终端 + gzip 压缩） |
| 应用框架 | Flask + Gunicorn（主服务：4 Worker，gevent，端口 5002） |
| Python 版本 | Python 3.11.6 |
| 域名 | ai.jiuqi.top（Let's Encrypt SSL 证书） |
| 数据库 | MySQL（远程内网部署） |
| 面板 | 宝塔面板（端口 8888） |
| SSL 协议 | TLSv1.2 / TLSv1.3 |
| 上传限制 | client_max_body_size 200M（server块） |
URL 路径结构
| 路径 | 功能 |
|---|
/ | 首页（重定向至 /pic/） |
/login/ | 统一登录页 |
/pic/* | AI 设计平台 |
/dingtalk/* | 钉钉管理助手 |
/api/dingtalk/* | 钉钉开放 API（需认证） |
/ocean/* | 巨量引擎数据服务 |
/npmmirror/* | npmmirror CDN 代理 |
/doc/ | 本使用文档（静态页面） |
监听端口
| 端口 | 服务 | 说明 |
|---|
| 80 | Nginx | HTTP（API请求直接代理，其他重定向至 HTTPS） |
| 443 | Nginx | HTTPS（主服务端口，含gzip压缩和缓存策略） |
| 5000 | Gunicorn（旧） | AI设计平台旧服务实例（仅监听 127.0.0.1，保留兼容） |
| 5002 | Gunicorn（主） | Flask 主应用（仅监听 127.0.0.1，gevent worker-class，300s timeout） |
| 8888 | 宝塔面板 | 服务器管理面板 |
更新日志
| 日期 | 更新内容 |
|---|
| 2026-08-01 | 例行检查并更新文档。核实所有服务运行状态：Nginx 1.26.3运行正常，Gunicorn 5000/5002端口双实例运行，Docker运行中。核实定时任务6项均正常配置。核实系统配置：OpenCloudOS 9.4、Python 3.11.6、AMD EPYC 7K83、7.4GB RAM、180GB SSD（使用26%）。所有文档描述与实际状态一致，更新文档时间戳。 |
| 2026-07-25 | 大幅更新文档。新增巨量引擎数据服务说明。新增定时任务汇总卡片（6个Cron任务）。修正监听端口信息（移除未启用的888/8881，新增5000旧服务端口）。新增 /ocean/* 路径。补充伙伴云同步功能说明。更新应用框架描述（gevent worker-class、300s timeout）。补充CPU型号信息。合并千川服务至巨量引擎卡片。更新文档更新时间。 |
| 2026-06-01 | 同步更新文档。新增 npmmirror CDN 代理和千川电商分析服务说明。补充系统架构信息（Python版本、SSL协议、上传限制、监听端口）。更新 URL 路径结构。 |
| 2026-05-31 | 全面更新文档。新增钉钉管理助手和开放API说明。更新系统架构和URL路径结构。移除已下线服务。 |
| 2026-05-22 | 初始文档创建 |