MVP-FS 飞书管理员操作手册

1.1 双管理员职责矩阵

1.2 角色对照表（按 PJM §3.1 RACI）

2.1 创建多维表格文件

1. 登录飞书 → 工作台 → 多维表格

   用企业账号登录（不用个人账号），点击「+ 新建多维表格」

2. 命名文件：WEAVELY-MVP

   统一命名，全员识别；文件放在「WEAVELY 项目」共享空间下

3. 创建 6 张数据表（在同一文件内）

   按 §2.2 清单逐一「+ 添加数据表」，命名用中英文对照便于识别

4. 设置文件协作者

   右上角「分享」→ 添加 6 个角色协作者（详见第 5 章）

2.2 6 张数据表清单（MVP-FS §2.2.1）

3.1 CPT-Lite 40 字段配置要点

3.2 必须配枚举值的字段（防止自由文本污染数据）

3.3 QSV-Lite 报价公式字段（TL 主配）

公式字段引用其他字段时，飞书会自动提示；封顶价 cap_price 来自 SCL-Lite，必须先建 SCL-Lite 再配公式。

4.1 视图配置（每张表至少 3 个视图）

4.2 仪表盘配置（4 个核心看板）

5.1 权限矩阵（MVP-FS §2.3）

5.2 师傅行级权限配置（关键隐私控制）

1. CPT-Lite 表 → 权限设置 → 高级权限

   开启「按行权限」，否则师傅会看到全部订单

2. 添加规则：师傅角色 → 仅可见 assigned_worker_id = 当前用户

   飞书支持「当前用户」动态匹配，无需为每个师傅单独配

3. 字段级例外：L6 字段可编辑

   worker_depart_time/arrive_time/complete_time/actual_work_hours/site_photos_url 等 7 个字段勾选「可编辑」

4. 测试：用师傅账号登录验证

   确保只能看到自己的单、能填 L6、不能改其他字段

6.1 规则 1：新订单提醒（L1 → 通知 OL）

1. CPT-Lite 表 → 自动化 → 新建规则

   触发条件：新增记录

2. 触发条件：current_stage = L1

   仅在 L1 阶段触发，避免后续阶段重复通知

3. 动作：发送飞书消息给 OL（成文）

   消息模板：「🆕 新订单 {order_id} | 客户 {customer_name} | 来源 {lead_source} | 请 2h 内联系」

6.2 规则 2：阶段变更提醒（流转 → 通知干系人）

1. 触发条件：current_stage 字段被修改

   飞书支持「字段变更」触发

2. 动作：按阶段发不同通知

   L3→通知 OL（去报价）；L4→通知师傅（接单）；L5→通知客户（配送）；L6→通知 OL（师傅出发）；L8→通知 OL（去回访）

3. 通知模板（OL 维护）

   每个阶段一条模板，存在飞书云文档「自动化模板」里，OL 负责文案更新

6.3 规则 3：超时提醒（L2 超 2h 未联系 → 提醒）

1. 触发条件：current_stage = L2 且 lead_time + 2h < now()

   飞书支持「定时检查」触发，每 30 分钟扫一次

2. 动作：发消息给 OL + 标记订单

   消息：「⚠️ 订单 {order_id} 超 2h 未联系客户，请立即处理」

3. 扩展：L3 超 24h 未确认报价 → 提醒

   同样逻辑，超时阈值 24h，避免报价流失

7.1 AI 听写助手 4 种接入方式（MVP-FS §2.4）

7.2 日常运维节奏（每日/每周/每月）

7.3 数据质量监控 5 指标（MVP-FS §8.3）

8.1 周报生成 6 步流程（scripts/README §5.4）

1. 周一~周四：一线在飞书多维表录入

   OL 监控填写及时率，超时提醒

2. 周五 17:30：OL 导出 CSV → export/

   文件名建议：CPT-week-32.csv（周数）

3. 周五 18:00：TL 跑数据检查

   python scripts/mvp-data-checker.py export\CPT-week-32.csv

4. 周五 18:10：TL 跑周报生成

   python scripts/mvp-weekly-report.py --cpt export\CPT-week-32.csv --qsv export\QSV-week-32.csv

5. 周五 18:30：听写润色周报

   把脚本生成的 Markdown 初稿丢给听写，让它润色 + 补洞察

6. 周五 19:00：OL/BO 确认 → 飞书群发

   事实性数据 OL/BO 确认无误后发群 + 邮件全体

8.2 表单迭代 4 条治理规则（MVP-FS §5.4 + §8.2）

8.3 字段缺口记录机制

9.1 常见问题 FAQ（11 问）

9.2 Day 1-2 上线 Checklist（OL+TL 共同验收）

A.1 DT 可自动化操作清单（30 项）

A.2 DT 三阶段实施路径

Step 1 · 登录飞书开发者后台

Step 2 · 创建企业自建应用

⚠️ 重要：应用类型选择「企业自建应用」（不要选「商店应用」「小程序」「网页应用」）。填完后点击「确定创建」。

Step 3 · 获取 App ID + App Secret（保存到本地记事本，不要发群）

1. 创建成功后，在应用列表点击刚创建的应用，进入应用详情页
2. 左侧菜单点击「凭证与基础信息」
3. 「应用凭证」区块找到 2 个值，复制粘贴到本地记事本临时保存：
   • App ID：格式 cli_xxxxxxxxxxxxxxxxx（20 位左右，cli_ 开头）
   • App Secret：格式 32 位随机字母数字混合（点击「查看」按钮后才能复制）

Step 4 · 添加「机器人」应用能力

1. 左侧菜单点击「添加应用能力」
2. 在「按能力添加」页签，找到「机器人」卡片，点击「添加」
3. （可选）如需网页应用入口，可同时添加「网页应用」能力（阶段 1 不需要，可不加）

Step 5 · 进入「权限管理」页面

1. 应用详情页左侧菜单点击「开发配置」→「权限管理」
2. 点击右上角「开通权限」按钮，弹出权限选择面板
3. 推荐使用「批量导入（JSON）」方式（右上角按钮），比勾选快 10 倍，见下方 Step 6

Step 6 · 批量导入权限 JSON（推荐）

点击「批量导入」，将下方 JSON 完整复制粘贴进去，确认后即可自动勾选全部所需权限：

{
  "scopes": {
    "tenant": [
      "bitable:app",
      "bitable:app:readonly",
      "bitable:table",
      "bitable:field",
      "bitable:record",
      "bitable:view",
      "document:readonly",
      "drive:drive",
      "im:message:send_as_bot",
      "im:chat:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.user_id:readonly",
      "contact:contact:readonly_as_app"
    ],
    "user": []
  }
}

Step 7 · 权限清单（按阶段分组，便于核对）

Step 8 · 创建版本

1. 左侧菜单点击「版本管理与发布」→ 「创建版本」
2. 填写版本信息：

   字段	填写值
   版本号	1.0.0
   更新说明	MVP-FS 阶段 1 初始化：多维表格建表权限 + IM 发消息权限 + 通讯录读取权限
   可见范围	「全部成员」或指定「管理员部门」（建议先「全部成员」，后续再收紧）

3. 点击「保存」，确认无误后点击「申请线上发布」

Step 9 · 管理员审批（需 OL 或飞书企业管理员操作）

1. 提交发布申请后，飞书企业管理员（通常为「洪哥」或飞书超级管理员）会收到飞书应用审核通知
2. 管理员点击「查看详情」→ 确认权限列表无异常 → 点击「同意」
3. 审批通过后，应用状态变为「已上线」，权限立即生效

Step 10 · （重要）为应用授予目标多维表格的文档级权限

1. 打开多维表格 → 右上角「…」菜单 → 「更多」→「添加文档应用」
2. 搜索「WEAVELY-MVP-AUTOBOT」→ 选择「可管理」权限级别 → 确认添加

Step 11 · 验证凭据有效性 + 回到脚本

常见问题 FAQ（附录 B 专属）

• Q1：发版被驳回？ 检查权限是否含高敏感（如通讯录写入 contact:contact），或联系管理员在飞书管理后台将本应用加入「免审白名单」。
• Q2：App Secret 忘存了？ 回到「凭证与基础信息」→ 点击 App Secret 右侧「查看/重置」。重置后旧 Secret 立即失效，需同步更新 .env 并重启所有脚本。
• Q3：API 返回 99991663 App not enabled？ 应用未发布（Step 9 未完成审批），或可见范围不包含调用者所在部门。
• Q4：调用 bitable API 返回 403 Permission denied？ 90% 原因是未做 Step 10「添加文档应用」——Scope ≠ 文档协作者权限，两者都要有。