# Ziin 客户接入清单 v1

适用对象：首次接入智引的宿主软件实施方、产品经理、后端负责人、运维负责人。

## 1. 基础信息

- 软件名称
- 软件类型：ERP / WMS / CRM / OA / 其他
- 部署模式：单租户 / 多租户
- 目标接入端：Web / PC / 小程序 / App / 第三方智能体
- 对接负责人

## 2. 宿主身份与权限

客户需提供：

- 用户标识字段定义
- 租户标识字段定义
- 角色字段定义
- 权限码字段定义
- Token 或 Session 鉴权方式说明
- 当前页面上下文获取方式

验收要求：

- 能拿到 `userId`
- 能拿到 `tenantId`
- 能拿到 `roleCodes`
- 能拿到 `permissionCodes`
- 能拿到 `route / pageTitle / selectedMenu`

## 3. 菜单与权限映射

客户需填写模板：

- `ziin-menu-mapping-template.csv`
- `ziin-permission-mapping-template.csv`

验收要求：

- 核心业务模块至少完成 1 个模块映射
- 关键菜单都能映射到标准 `moduleCode`
- 核心按钮权限都能映射到标准 `permissionCodes`

## 4. 知识资料准备

客户需提供：

- 操作手册 PDF / Word
- FAQ 文档
- 常见报错清单
- 审批失败 / 业务失败场景说明
- 专有业务术语表

客户需填写模板：

- `ziin-knowledge-import-template.csv`

验收要求：

- 至少完成 20 条核心知识导入
- 至少包含 5 条错误排查知识
- 至少包含 1 份主流程操作手册

## 5. 数据库与环境

客户需确认：

- 使用 MySQL 8 还是 PostgreSQL
- 是否单独数据库 / 单独 schema
- 是否允许执行标准 SQL
- 是否允许后续执行 migration 脚本

验收要求：

- 已执行 `v1` 建库脚本
- 已执行 `seed v1` 或完成正式知识导入
- 预留后续 `migration` 执行流程

## 6. 接口联调

联调接口：

- `POST /api/ziin/query`
- `POST /api/ziin/feedback`
- `GET /api/ziin/schema`
- `POST /api/ziin/sync`
- `GET /api/ziin/health`

验收要求：

- `query` 能根据权限返回结构化答案
- `feedback` 能成功回写
- `sync` 能导入菜单 / 权限 / 知识
- `health` 正常返回

## 7. 前端或智能体接入

可选接入形态：

- Web 悬浮助手
- App / 小程序问答入口
- 宿主已有 AI 转调智引

验收要求：

- 至少打通一种用户入口
- 至少验证 3 个真实业务问题

## 8. 上线前检查

- 是否完成权限边界验证
- 是否完成敏感信息排查
- 是否完成核心知识抽检
- 是否完成 10 条以上真实问答测试
- 是否确认反馈闭环有人处理

## 9. 上线后观察项

- 问答命中率
- 用户反馈 useful / not_useful 比例
- 高频未解决问题
- 高误答知识条目
- 新增知识回流速度