公司内部 AI 协作 MVP 后端

本仓库用于实现第一版公司内部 AI 协作最小闭环：

老板一句话
-> AI 草稿
-> 人工确认
-> 创建事项或定时提醒
-> 飞书通知
-> 接收人反馈
-> 页面看到结果和失败记录

第一版不是完整任务系统、AI 工作台、复杂看板或全自动 Agent。所有关键动作都必须经过人工确认，AI 只生成可确认草稿。

技术栈

层级	约定
后端	Python Django + Django REST Framework
ORM	Django ORM + Django Migrations
数据库	PostgreSQL 18.x，作为唯一数据源；业务表、AI 对话记忆、上下文快照和日志都落同一套 PostgreSQL
AI 对话记忆	PostgreSQL 表 + `jsonb`，保存老板秘书会话、消息、BotContext 和模型调用快照
定时任务	Django management command + 独立 scheduler 进程
后台管理	Django Admin
AI 接入	阿里百炼 API，后端封装薄 `ai_client`
飞书	飞书身份登录、机器人私聊、个人消息、交互卡片和回调
部署	Docker Compose + Nginx + Gunicorn

当前施工基线

后端框架使用 Django==5.2.15 + djangorestframework==3.17.1。
Docker / 部署环境固定 Python 3.12.13；本地开发允许 Python 3.11 或 3.12，提交前必须在 Python 3.12.13 上跑完整测试。
后端开发先采用 mock-first：单元测试和最小闭环测试不得访问真实百炼、真实飞书或公网回调。
定时提醒 scheduler 独立于 Gunicorn worker，同一环境同一应用库同时只能运行一个 scheduler 进程。
老板 AI 秘书统一走 POST /api/secretary/handle-message，AI 只生成草稿、追问或回复，不直接创建任务、提醒或通知。

文档入口

开发前先读：

AGENTS.md
当前相关 docs/specs/*.md
docs/plans/active/01_老板一句话闭环实施计划.md

涉及接口、字段、状态时，再读：

docs/contracts/API接口约定.md
docs/contracts/数据对象约定.md
docs/contracts/状态流转约定.md
docs/contracts/安全权限日志约定.md

提交或 Review 前读：

docs/checklists/AI生成代码检查清单.md
docs/checklists/后端Review清单.md
本次新增或修改的 tests

本地启动

当前仓库还处在后端文档和施工计划阶段，Django 项目骨架尚未创建。代码落地后，本节应补充：

Python 虚拟环境创建方式。
依赖安装命令。
.env 示例和环境变量说明。
数据库迁移命令。
本地启动命令。
测试命令。

环境变量边界

这些值必须放在环境变量或服务器安全配置中，不能提交到仓库：

阿里百炼 API Key。
飞书 App ID。
飞书 App Secret。
飞书回调验签密钥。
数据库账号密码。
OAuth code/state 和一次性操作 token 明文。

普通日志中不得打印 API Key、App Secret、飞书 token、OAuth code/state、一次性操作 token、回调验签密钥、完整手机号或完整邮箱。

第一版不做

第一版不做 AI 工作台、技能市场、文件上传、多模态处理、会议纪要、日报、文档摘要、复杂反馈看板、复杂 BI、成本驾驶舱、完整工作流、完整项目管理、多级子任务、甘特图、复杂审批流、复杂组织架构、cron 表达式、日历系统、自动操作交易系统、自动操作历史数据库、自动读取员工本地文件、手机端网页完整适配，也不把飞书机器人开放为程经理或普通员工通用派活入口。