docs: document feishu configuration

README.md

@@ -35,3 +35,43 @@ LibreOffice 不是必需依赖，仅作为未来增强老格式文档解析的
 上传原始文件、批次工作目录和导出文件默认存储在 Django `MEDIA_ROOT` 下的
 `file_summary/users/<user_id>/<conversation_id>/` 或批次 `work_dir` 目录中。生产环境
 需要把 `MEDIA_ROOT` 挂载到持久化卷，并纳入备份或归档策略。
+
+## 飞书通知与问答预留
+
+飞书接入使用企业自建应用/智能体的消息 API。敏感信息只允许写入本地 `.env`
+或部署环境变量，不要提交真实 App Secret、tenant token、open_id 或 user_id。
+
+常用环境变量：
+
+| 变量名 | 用途 |
+| --- | --- |
+| `FEISHU_NOTIFY_ENABLED` | 是否启用真实飞书通知，未启用时只写未启用记录 |
+| `FEISHU_NOTIFY_CHANNEL` | 通知通道，首期使用 `feishu_api` |
+| `FEISHU_APP_ID` | 飞书应用 App ID |
+| `FEISHU_APP_SECRET` | 飞书应用 App Secret |
+| `FEISHU_DEFAULT_USER_OPEN_ID` | 默认个人接收人的 open_id，优先使用 |
+| `FEISHU_DEFAULT_USER_ID` | 默认个人接收人的 user_id，open_id 为空时使用 |
+| `FEISHU_DEFAULT_TARGET_NAME` | 默认接收人展示名，用于记录和页面展示 |
+| `FEISHU_TENANT_TOKEN_CACHE_SECONDS` | tenant_access_token 缓存秒数 |
+| `PUBLIC_BASE_URL` | 飞书消息中的系统入口根地址，默认 `http://127.0.0.1:8000` |
+
+自动化测试会 mock 飞书 token API 和消息 API，不请求真实飞书接口。真实发送只通过
+本地手动命令验证：
+
+```bash
+python manage.py send_test_feishu_notification --username owner
+```
+
+问答预留能力可用本地模拟命令验证：
+
+```bash
+python manage.py feishu_question_simulate --username owner "查最新法规核查"
+```
+
+集中测试建议在补齐 `.env` 后执行：
+
+```bash
+python manage.py check
+pytest tests/test_feishu_*.py
+pytest tests/test_file_summary_workflow.py tests/test_regulatory_notification.py tests/test_application_form_fill_notification.py
+```