```
feat: 添加公司AI管理平台基础架构 添加了完整的FastAPI后端项目结构,包括: - 环境配置文件(.env.example)和项目说明文档(README.md、AGENTS.md) - Dockerfile用于容器化部署 - 核心基础设施:配置管理、数据库连接、调度器、安全认证 - 模块化设计:AI代理、审批流程、审计日志、业务台账等功能模块 - 支持多数据库连接(主库和遗留系统只读库) - AI适配器支持OpenClaw、Hermes、OpenAI兼容接口 - 飞书集成、报表生成、风险监控等企业级功能 - 完整的依赖管理和测试指南 ```
This commit is contained in:
84
docs/feishu_integration.md
Normal file
84
docs/feishu_integration.md
Normal file
@@ -0,0 +1,84 @@
|
||||
# 飞书接入说明
|
||||
|
||||
## 飞书应用权限
|
||||
|
||||
建议先申请最小权限:
|
||||
|
||||
- 发送消息
|
||||
- 读取群信息
|
||||
- 接收消息事件
|
||||
- 卡片消息
|
||||
|
||||
后续再逐步增加:
|
||||
|
||||
- 多维表格
|
||||
- 审批
|
||||
- 文档/Wiki
|
||||
- 任务
|
||||
- 日历
|
||||
|
||||
## 配置项
|
||||
|
||||
```text
|
||||
FEISHU_APP_ID=
|
||||
FEISHU_APP_SECRET=
|
||||
FEISHU_VERIFICATION_TOKEN=
|
||||
FEISHU_DEFAULT_CHAT_ID=
|
||||
```
|
||||
|
||||
## 推送文本
|
||||
|
||||
```text
|
||||
POST /api/v1/integrations/feishu/send-text
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"receive_id": "oc_xxx",
|
||||
"receive_id_type": "chat_id",
|
||||
"text": "项目日报测试"
|
||||
}
|
||||
```
|
||||
|
||||
## 推送卡片
|
||||
|
||||
```text
|
||||
POST /api/v1/integrations/feishu/send-card
|
||||
```
|
||||
|
||||
## Webhook
|
||||
|
||||
```text
|
||||
POST /api/v1/integrations/feishu/webhook
|
||||
```
|
||||
|
||||
当前 Webhook 已支持 challenge 验证和事件审计。后续可在这里接入:
|
||||
|
||||
- 飞书群聊问答
|
||||
- 审批回调
|
||||
- 卡片按钮回调
|
||||
- 任务状态同步
|
||||
|
||||
## 消息命令
|
||||
|
||||
Webhook 已支持基础命令路由:
|
||||
|
||||
```text
|
||||
日报 / 晨报 -> 每日经营晨报
|
||||
周报 / 项目周报 -> 项目周报
|
||||
风险 / 预警 -> 风险摘要
|
||||
问 xxx / AI xxx -> AI 问答
|
||||
```
|
||||
|
||||
本地预览:
|
||||
|
||||
```text
|
||||
POST /api/v1/integrations/feishu/commands/preview
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"text": "日报",
|
||||
"auto_reply": false
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user