# Ziin 新客户 2 天接入流程 v1

目标：在 2 天内完成一个宿主系统的最小可用接入。

## Day 1 上午：环境和标准数据

1. 确认使用 MySQL 8 或 PostgreSQL
2. 执行标准建库脚本
3. 下载并填写菜单映射、权限映射、知识导入模板
4. 确认宿主系统如何提供 `userId / tenantId / permissionCodes / route`

产出：

- 数据库已初始化
- 3 份模板已开始填写
- 宿主上下文字段来源已确认

## Day 1 下午：打通后端联调

1. 用 `schema` 看清请求响应协议
2. 后端或 adapter 按标准构造 `query` 请求
3. 联调 `health`
4. 联调 `query`
5. 联调 `feedback`

最低通过标准：

- 能从宿主系统传入真实权限
- `query` 能返回 `answer / steps / warnings / sources`
- `feedback` 能成功记录

## Day 2 上午：导入知识和映射

1. 导入第一批知识
2. 同步菜单映射和权限映射
3. 校验一个核心模块的典型问题

推荐先打通的典型问题：

- 这个模块是干嘛的
- 怎么做某个单据
- 为什么提交失败
- 为什么没有权限

最低通过标准：

- 至少 1 个模块可回答
- 至少 20 条知识导入完成
- 至少 3 条错误排查知识可命中

## Day 2 下午：接入口和验收

1. 接入 Web 悬浮助手或宿主智能体转调
2. 让业务方验证 10 条真实问题
3. 记录命中不准的问题并回补知识
4. 确认上线后的反馈处理人

最低通过标准：

- 至少 1 个正式入口可用
- 至少 10 条真实问题完成测试
- useful / not_useful 反馈链路可用

## 建议角色分工

- 产品经理：确认模块范围、术语和问题清单
- 后端负责人：对接权限上下文和 query 接口
- 前端负责人：接 Web / App / 小程序入口
- 实施负责人：整理菜单、权限、知识资料
- 运维负责人：执行 SQL、部署和健康检查

## 典型风险

- 客户给不出清晰权限码
- 文档质量太差，知识无法直接导入
- 页面上下文拿不到，导致命中率下降
- 业务方希望“一上来全模块都可用”

## 控制办法

- 先做 1 个模块试点，不要全量铺开
- 先做文本 + 权限 + 步骤 + 排障，不要一期追求全模态
- 先建立反馈闭环，再谈“越用越聪明”