
# 飞书前门落地清单 v1

## 1. 文档目的
本文件用于把“飞书前门接入设计”进一步落到可执行层面。
目标不是继续停留在方向判断，而是把下一阶段真正需要配置、需要验证、需要推进的事项整理成一份落地清单，方便后续推进飞书前门 PoC。

## 2. 当前阶段判断
当前系统已经具备：
- Runtime Portal
- 推荐下载
- 最新交付包
- 当前正式发布版本
- 历史发布版本
- HTML / PDF / PPT / ZIP 正式交付物
- single / batch / full_release 运行链路
- release_manifest / release_history / artifact_index

因此，飞书前门的第一阶段不需要重新定义产品，而是要把已有 Portal 变成业务侧真正可进入的入口。

一句话判断：
飞书前门第一阶段的目标不是“深度集成”，而是“先进入业务工作入口”。

## 3. 推荐落地形态
第一阶段建议采用：

- 飞书企业自建应用
- H5 / Web 页形式
- Runtime Portal 作为默认首页

原因：
1. 与当前 Web-native 产品形态最匹配
2. 改造成本最低
3. 上线速度最快
4. 最适合当前 PoC / 试点阶段

## 4. 飞书前门落地目标
第一阶段建议至少做到：

1. 在飞书工作台里能看到该应用
2. 点击后可直接进入 Runtime Portal
3. 桌面端首页可访问
4. 移动端首页可访问
5. 链接、信任域名、入口配置完整
6. 后续免登、通讯录、审批流留好配置位

## 5. 落地清单

### 5.1 应用层
需要明确：
- 应用名称
- 应用图标
- 应用描述
- 应用分类
- 是否为企业自建应用
- 负责人
- 可见范围

### 5.2 首页层
需要明确：
- 桌面端首页 URL
- 移动端首页 URL
- 默认首页是否直接指向 Runtime Portal
- 是否需要增加二级菜单入口
- 是否保留下载中心为二级入口

### 5.3 H5 入口层
需要明确：
- Runtime Portal 的公网或内网可访问地址
- H5 页面可访问性
- 页面在飞书内打开时的兼容性
- 移动端显示是否需要单独适配

### 5.4 域名与安全层
需要明确：
- 信任域名
- redirect URL（后续免登预留）
- 前端资源加载域名
- 文件下载地址是否可在飞书内直接打开

### 5.5 身份与组织层（后续）
需要预留：
- 免登
- 飞书 user_id 映射
- 通讯录同步
- 组织架构映射
- 角色与飞书身份绑定

### 5.6 通知与流程层（后续）
需要预留：
- 运行完成通知
- 发布完成通知
- 审计异常提醒
- 趋势变化提醒
- 审批流入口

## 6. 第一阶段建议默认首页
第一阶段建议明确：

### 6.1 Runtime Portal
作为飞书前门默认首页，原因：
- 当前产品最成熟
- 已具备运行状态、当前版本、推荐下载、历史版本、治理信息
- 最适合作为业务第一眼看到的产品首页

### 6.2 不建议第一阶段作为首页的页面
暂不建议第一阶段直接把以下页面做飞书首页：
- 复杂配置页
- 原始 artifact 列表页
- 纯历史日志页
- 深度分析明细页

原因：
这些页面更适合作为二级入口，而不是飞书前门的第一屏。

## 7. 第一阶段建议应用结构
建议飞书应用第一版按以下结构设计：

### 首页
- Runtime Portal

### 二级入口（后续可逐步加）
- 最新交付包
- 历史发布版本
- 校准会工作台（后续）
- 单人搜索页（后续）
- 历史运行页（后续）

## 8. 配置项模板（第一阶段要准备）
后续真正落地前，需要至少准备以下配置项：

- app_name
- app_description
- app_icon
- desktop_homepage_url
- mobile_homepage_url
- trusted_domains
- redirect_urls
- visibility_scope
- owner
- environment
- enable_feishu_sso (future)
- enable_directory_sync (future)
- enable_notifications (future)
- enable_approval_flow (future)

## 9. go-live 前检查项
飞书前门上线前，建议至少检查以下事项：

### 产品可用性
- Runtime Portal 可正常打开
- 推荐下载可点击
- 当前正式版本可展示
- 历史版本可展示
- 最新交付包可下载

### 飞书入口可用性
- 桌面端首页可打开
- 移动端首页可打开
- H5 页面兼容正常
- 信任域名配置正确

### 发布与治理
- latest release bundle 可用
- release_manifest_latest 可用
- release_history_latest 可用
- Portal 已显示 current_release

## 10. go-live 建议顺序
建议按以下顺序推进飞书前门：

1. 完成飞书前门落地清单
2. 准备应用配置模板
3. 明确 Runtime Portal 访问地址
4. 配置飞书自建应用
5. 配置桌面端首页与移动端首页
6. 配置信任域名
7. 小范围内部验证
8. 试点用户使用验证
9. 再考虑免登 / 通讯录 / 审批流

## 11. 第一阶段不急着做的事
当前阶段不建议一开始就重投入这些能力：

- 深度飞书 JSAPI 改造
- 复杂审批流编排
- 全量通讯录回写
- 复杂消息中心
- 多应用菜单体系
- 复杂移动端独立产品化

原因：
当前最重要的是先把 Portal 变成真正能从飞书进入的产品前门。

## 12. open_questions
当前仍需后续明确的问题包括：
1. 飞书前门是否只开放给内部核心用户
2. Runtime Portal 是否作为唯一首页
3. 桌面端首页与移动端首页是否都指向同一 URL
4. 免登是第一阶段就做，还是第二阶段再做
5. 文件下载在飞书内是否直接走 file/link，还是后续走下载 API
6. go-live 时是否需要专门的试点用户白名单

## 13. 一句话总结
飞书前门落地清单的意义，不是多写一份文档，而是让 Talent Review OS 从“有产品原型”进一步走向“能在飞书里被业务真实打开和使用”的下一阶段。

