docs: 精简长期规划文档，去除技术实现细节，保留方向性内容
- 技术与交付模块：去除具体技术栈/部署方案/文件路径，仅保留技术方向 - 个人开发者创业计划：去除当前技术开发状态、文档索引 - 产品与用户模块：去除具体页面清单、文档引用 - 商业化与支付模块：去除技术实现细节、文档引用 - 运营与客服：去除 API 路由/具体技术栈引用，保留服务策略 - 其余模块：去除交叉文档引用 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
587f5e7ace
commit
a1113df50c
@ -76,13 +76,6 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 核心页面（14 页）
|
|
||||||
|
|
||||||
| 优先级 | 页面 |
|
|
||||||
|--------|------|
|
|
||||||
| P0 | 登录页、学习方向选择页、学习路径页、今日学习任务页、内容阅读页、主动回忆/笔记输入页、AI 分析结果页、AI 对话页、复习计划页 |
|
|
||||||
| P1 | 学习进度页、设置页、反馈页、欢迎页、语言偏好页 |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 账号体系
|
## 账号体系
|
||||||
@ -92,8 +85,3 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
|
||||||
- [技术与交付模块](./[参考]-技术与交付模块.md)
|
|
||||||
- [商业化与支付模块](./[进行中]-商业化与支付模块.md)
|
|
||||||
|
|||||||
@ -2,76 +2,36 @@
|
|||||||
|
|
||||||
## 模块目标
|
## 模块目标
|
||||||
|
|
||||||
确定技术栈、开发流程、交付节奏和质量标准。
|
确定技术方向和交付策略。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 技术选型（已决策）
|
## 技术方向
|
||||||
|
|
||||||
| 层级 | 选型 | 说明 |
|
- **Apple-first**：优先 iOS（Swift/SwiftUI），后续扩展 iPad/Mac
|
||||||
|------|------|------|
|
- **后端**：模块化架构，按业务域拆分
|
||||||
| iOS | Swift / SwiftUI | Apple 原生，MVVM + Service + Repository |
|
- **AI**：Provider 抽象层，按任务分级路由模型（轻任务用便宜模型，核心分析用主力模型）
|
||||||
| 后端 | NestJS + TypeScript | 模块化单体架构 |
|
- **部署**：单服务器起步，后续按需扩展
|
||||||
| ORM | Prisma | 类型安全，自动生成 TS 类型 |
|
- **官网**：静态生成，SEO 友好
|
||||||
| 数据库 | MySQL | 服务器已部署 |
|
|
||||||
| 缓存/队列 | Redis + BullMQ | 缓存 + 队列 + 限流 + 临时状态 |
|
|
||||||
| AI | Provider 抽象 + Mock + 真实模型 | MiniMax / DeepSeek / OpenAI 等可替换 |
|
|
||||||
| 部署 | Docker Compose + Nginx | 4核4G 轻量云，域名 api.longde.cloud |
|
|
||||||
| 官网 | Astro | SEO 友好，静态生成 |
|
|
||||||
| 后台管理 | Vite + React + Ant Design + ProComponents + TanStack Query | 预留 |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 前后端协作流程
|
## 交付节奏
|
||||||
|
|
||||||
1. 选一个业务流程
|
按业务流程逐个交付，每个流程走通前后端联调后再做下一个。
|
||||||
2. 根据流程拆接口
|
|
||||||
3. 后端设计表结构、DTO、接口、Swagger
|
|
||||||
4. 前端根据 Swagger 写 Model / Service
|
|
||||||
5. 前端接页面 → 联调 → 发现问题 → 回头改接口/DTO/表结构
|
|
||||||
6. 稳定后再做下一个流程
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## iOS 多设备工程策略
|
## 第一版范围
|
||||||
|
|
||||||
| 设备 | 策略 |
|
**做：** iOS 客户端、核心学习闭环、AI 分析、Apple IAP
|
||||||
|------|------|
|
|
||||||
| iPhone + iPad | 同一个 Xcode Project，同一个 iOS App Target |
|
**暂不做：** 安卓、Web 学习端、复杂后台
|
||||||
| Mac | 单独 Mac 版本 Target |
|
|
||||||
| Watch | watchOS Target |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 第一版技术范围
|
## 核心原则
|
||||||
|
|
||||||
**必须：** iOS 客户端、核心功能、简单后端、AI API 调用、本地数据存储、Apple IAP
|
- 从"业务分级工作流"开始，暂不做完全自治 Agent
|
||||||
|
- 先验证核心闭环，再扩展平台
|
||||||
**暂不做：** 安卓客户端、微信/支付宝支付、复杂后台管理系统、Web 学习端
|
- 模型路由：基础档不默认使用高价模型，高级推理作为 Pro 权益
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## AI 架构
|
|
||||||
|
|
||||||
> 详见：[AI架构设计](../../技术设计/api-server/AI架构设计.md)
|
|
||||||
|
|
||||||
核心原则：从"业务分级工作流"开始，暂不做完全自治 Agent。后期通过用户学习画像、长期记忆和受控 Skill 系统逐步演进。
|
|
||||||
|
|
||||||
模型按任务分级：轻任务用便宜模型，核心分析用主力模型，复杂推理用强模型。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 后端开发路线
|
|
||||||
|
|
||||||
> 详见：[后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
|
|
||||||
|
|
||||||
核心开发顺序：**身份权限 → 知识系统 → 学习闭环 → AI 基础设施 → 文件导入 → 商业化 → 后台 → 客服 → 学习画像 → 公开分享 → 增长归因**
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
|
||||||
- [产品与用户模块](./[参考]-产品与用户模块.md)
|
|
||||||
- [AI架构设计](../../技术设计/api-server/AI架构设计.md)
|
|
||||||
- [后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
|
|
||||||
|
|||||||
@ -42,11 +42,3 @@
|
|||||||
- 退款政策
|
- 退款政策
|
||||||
- 免责声明
|
- 免责声明
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
|
||||||
- [商业化与支付模块](./[进行中]-商业化与支付模块.md)
|
|
||||||
|
|
||||||
## 负责人
|
|
||||||
|
|
||||||
[待定]
|
|
||||||
@ -40,11 +40,3 @@
|
|||||||
- 产品改进
|
- 产品改进
|
||||||
- 用户通知
|
- 用户通知
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
|
||||||
- [运营与客服模块](./运营与客服/[进行中]-运营与客服模块.md)
|
|
||||||
|
|
||||||
## 负责人
|
|
||||||
|
|
||||||
[待定]
|
|
||||||
@ -41,7 +41,7 @@
|
|||||||
├── 2. 技术与交付模块 → 技术栈、AI 架构、工程策略
|
├── 2. 技术与交付模块 → 技术栈、AI 架构、工程策略
|
||||||
├── 3. 商业化与支付模块 → 定价、订阅、权益
|
├── 3. 商业化与支付模块 → 定价、订阅、权益
|
||||||
├── 4. 营销与增长模块 → 获客、内容、冷启动
|
├── 4. 营销与增长模块 → 获客、内容、冷启动
|
||||||
├── 5. 运营与客服模块 → Dify 客服、工单、用户运营
|
├── 5. 运营与客服模块 → AI 客服、工单、用户运营
|
||||||
├── 6. 数据反馈与迭代模块 → 指标、埋点、迭代
|
├── 6. 数据反馈与迭代模块 → 指标、埋点、迭代
|
||||||
└── 7. 合规与公司化模块 → 上架合规、公司化时机
|
└── 7. 合规与公司化模块 → 上架合规、公司化时机
|
||||||
```
|
```
|
||||||
@ -62,42 +62,11 @@
|
|||||||
| 7 | iPad / Mac 扩展 | 🔲 |
|
| 7 | iPad / Mac 扩展 | 🔲 |
|
||||||
| 8 | 公司化与安卓扩展 | 🔲 |
|
| 8 | 公司化与安卓扩展 | 🔲 |
|
||||||
|
|
||||||
> 详见：[阶段路线图](../技术设计/阶段路线图.md)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 五、当前状态
|
## 五、下一步行动
|
||||||
|
|
||||||
| 模块 | 进度 | 关键缺口 |
|
|
||||||
|------|------|----------|
|
|
||||||
| iOS App | 21 页面 UI 完成 | NavigationLink 编译问题、API Service 未接通、MVVM 未分层 |
|
|
||||||
| 后端 API | 13 模块骨架 | Repository 未接 MySQL、BullMQ 未接 Redis、AI 走 Mock |
|
|
||||||
| 官网 | 基础页面上线 | Waitlist/Support 表单未接后端、品牌名不统一、CSS 变量缺失 |
|
|
||||||
| 数据库 | MySQL + Redis 已部署 | 代码未走 Prisma |
|
|
||||||
| 方向验证 | 3 个候选方向 | 未打分选定，未准备知识库内容 |
|
|
||||||
|
|
||||||
> 详见：[潜在问题清单](../技术设计/潜在问题清单.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 六、各模块文档索引
|
|
||||||
|
|
||||||
| 模块 | 主文档 | 子文档 |
|
|
||||||
|------|--------|--------|
|
|
||||||
| 1. 产品与用户 | [产品与用户模块](./[参考]-产品与用户模块.md) | [产品方向深度评估](./[参考]-产品方向深度评估.md) |
|
|
||||||
| 2. 技术与交付 | [技术与交付模块](./[参考]-技术与交付模块.md) | [AI架构设计](../技术设计/api-server/AI架构设计.md) / [后端开发优先级](../技术设计/api-server/后端开发路线图.md) |
|
|
||||||
| 3. 商业化与支付 | [商业化与支付模块](./[进行中]-商业化与支付模块.md) | — |
|
|
||||||
| 4. 营销与增长 | [营销与增长模块](./营销与增长/[进行中]-营销与增长模块.md) | [营销冷启动调研方案](./营销与增长/[参考]-营销冷启动调研方案.md) / [冷启动与增长深度调研](./营销与增长/[参考]-冷启动与增长深度调研.md) |
|
|
||||||
| 5. 运营与客服 | [运营与客服模块](./运营与客服/[进行中]-运营与客服模块.md) | [客服设计详案](./运营与客服/[参考]-客服设计详案.md) |
|
|
||||||
| 6. 数据反馈与迭代 | [数据反馈与迭代模块](./[设计中]-数据反馈与迭代模块.md) | — |
|
|
||||||
| 7. 合规与公司化 | [合规与公司化模块](./[设计中]-合规与公司化模块.md) | — |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 七、下一步行动
|
|
||||||
|
|
||||||
1. **选定垂直知识库方向**（3 候选 → 打分 → 选 1）
|
1. **选定垂直知识库方向**（3 候选 → 打分 → 选 1）
|
||||||
2. **准备第一个 7 天路径的内容**
|
2. **准备第一个 7 天路径的内容**
|
||||||
3. **修复 iOS 编译问题 + Repository 接 Prisma + iOS 换 HTTPS**
|
3. **做 3-5 个竞品拆解**
|
||||||
4. **做 3-5 个竞品拆解**
|
4. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单）
|
||||||
5. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单）
|
|
||||||
|
|||||||
@ -52,11 +52,7 @@
|
|||||||
|
|
||||||
## 支付流程
|
## 支付流程
|
||||||
|
|
||||||
```
|
用户在 iOS App 内通过 Apple IAP 完成交易，后端记录用户权益。第一阶段仅走 Apple 支付通道。
|
||||||
用户在 iOS App 内付款 → Apple IAP 完成交易 → 后端记录用户权益 → 用户获 Pro 权益
|
|
||||||
```
|
|
||||||
|
|
||||||
核心是自己的 **用户系统 + 订单系统 + 权益系统**，Apple IAP 只是第一阶段的支付通道。
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -83,7 +79,3 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../技术设计/阶段路线图.md)
|
|
||||||
- [合规与公司化模块](./[设计中]-合规与公司化模块.md)
|
|
||||||
|
|||||||
@ -75,7 +75,3 @@ AI 生成内容草稿 → 人审核修改 → 人手动发布 → AI 辅助分
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../../技术设计/阶段路线图.md)
|
|
||||||
- [营销冷启动调研方案](./[参考]-营销冷启动调研方案.md)
|
|
||||||
|
|||||||
@ -1,51 +1,38 @@
|
|||||||
对，你这个判断是对的。**你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。**
|
对，你这个判断是对的。你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。
|
||||||
|
|
||||||
用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。尤其是这些基础问题：
|
用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。
|
||||||
|
|
||||||
```text
|
|
||||||
怎么创建知识库？
|
|
||||||
为什么 Apple 登录失败？
|
|
||||||
AI 分析结果怎么看？
|
|
||||||
会员怎么取消？
|
|
||||||
退款怎么处理？
|
|
||||||
安卓什么时候上？
|
|
||||||
数据会不会丢？
|
|
||||||
上传文件失败怎么办？
|
|
||||||
```
|
|
||||||
|
|
||||||
这些如果都靠你一个人回，肯定扛不住。
|
这些如果都靠你一个人回，肯定扛不住。
|
||||||
|
|
||||||
所以这里应该做一个：
|
所以这里应该做一个：
|
||||||
|
|
||||||
```text
|
```
|
||||||
App 内智能客服 + 反馈工单 + 后台处理系统
|
App 内智能客服 + 反馈工单 + 后台处理系统
|
||||||
```
|
```
|
||||||
|
|
||||||
而不是单纯一个“意见反馈表单”。
|
而不是单纯一个"意见反馈表单"。
|
||||||
|
|
||||||
## 它在知习里的定位
|
## 它在知习里的定位
|
||||||
|
|
||||||
你可以这么定义：
|
你可以这么定义：
|
||||||
|
|
||||||
```text
|
```
|
||||||
Dify 智能客服负责解决常见问题；
|
AI 智能客服负责解决常见问题；
|
||||||
反馈系统负责收集真实问题；
|
反馈系统负责收集真实问题；
|
||||||
后台管理系统负责处理需要人工介入的问题。
|
后台管理系统负责处理需要人工介入的问题。
|
||||||
```
|
```
|
||||||
|
|
||||||
它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。核心学习 AI 还是走你自己的后端工作流。你的当前主线仍然是把 iOS App 从静态 UI 变成真实功能 App。
|
它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。
|
||||||
|
|
||||||
## 我建议的客服流程
|
## 我建议的客服流程
|
||||||
|
|
||||||
可以这样设计：
|
```
|
||||||
|
用户在 App 内点击"帮助与客服"
|
||||||
```text
|
|
||||||
用户在 App 内点击“帮助与客服”
|
|
||||||
→ 先进入智能客服
|
→ 先进入智能客服
|
||||||
→ Dify 根据帮助知识库自动回答
|
→ AI 根据帮助知识库自动回答
|
||||||
→ 如果解决了，结束
|
→ 如果解决了，结束
|
||||||
→ 如果没解决，用户点击“转人工 / 提交反馈”
|
→ 如果没解决，用户点击"转人工 / 提交反馈"
|
||||||
→ 后端创建反馈工单
|
→ 创建反馈工单
|
||||||
→ 后台显示待处理问题
|
→ 后台显示待处理问题
|
||||||
→ 你有空再处理
|
→ 你有空再处理
|
||||||
```
|
```
|
||||||
@ -54,44 +41,9 @@ Dify 智能客服负责解决常见问题；
|
|||||||
|
|
||||||
## 第一版客服应该回答什么
|
## 第一版客服应该回答什么
|
||||||
|
|
||||||
第一版只回答官方固定内容：
|
第一版只回答官方固定内容：功能使用说明、登录问题、知识库创建、文件上传、AI 分析说明、复习计划、订阅说明、退款流程、隐私政策、用户协议、常见错误处理、联系方式。
|
||||||
|
|
||||||
```text
|
不要让客服 Bot 去读用户私人知识库内容。客服 Bot 只应该读官方帮助中心知识库，不要读用户上传的学习资料、主动回忆回答、私人知识库、学习分析结果（除非以后专门做了授权机制）。
|
||||||
功能使用说明
|
|
||||||
登录问题
|
|
||||||
知识库创建问题
|
|
||||||
文件上传问题
|
|
||||||
AI 分析说明
|
|
||||||
复习计划说明
|
|
||||||
订阅说明
|
|
||||||
退款流程说明
|
|
||||||
隐私政策
|
|
||||||
用户协议
|
|
||||||
备案信息
|
|
||||||
常见错误处理
|
|
||||||
联系方式
|
|
||||||
```
|
|
||||||
|
|
||||||
不要让客服 Bot 去读用户私人知识库内容。
|
|
||||||
|
|
||||||
这点很重要。
|
|
||||||
|
|
||||||
客服 Bot 只应该读：
|
|
||||||
|
|
||||||
```text
|
|
||||||
官方帮助中心知识库
|
|
||||||
```
|
|
||||||
|
|
||||||
不要读：
|
|
||||||
|
|
||||||
```text
|
|
||||||
用户上传的学习资料
|
|
||||||
用户的主动回忆回答
|
|
||||||
用户的私人知识库
|
|
||||||
用户的学习分析结果
|
|
||||||
```
|
|
||||||
|
|
||||||
除非以后你专门做了授权机制。
|
|
||||||
|
|
||||||
## 你真正需要的是三层系统
|
## 你真正需要的是三层系统
|
||||||
|
|
||||||
@ -99,202 +51,33 @@ AI 分析说明
|
|||||||
|
|
||||||
用户问基础问题，机器人自动回。
|
用户问基础问题，机器人自动回。
|
||||||
|
|
||||||
比如：
|
|
||||||
|
|
||||||
```text
|
|
||||||
“怎么取消订阅？”
|
|
||||||
“怎么导入知识点？”
|
|
||||||
“为什么我的 AI 分析失败？”
|
|
||||||
```
|
|
||||||
|
|
||||||
机器人可以直接回答流程。
|
|
||||||
|
|
||||||
### 第二层：反馈 / 工单系统
|
### 第二层：反馈 / 工单系统
|
||||||
|
|
||||||
如果机器人解决不了，就创建反馈。
|
如果机器人解决不了，就创建反馈。反馈字段包括用户 ID、联系方式、问题类型、问题内容、截图、设备型号、系统版本、App 版本、处理状态。
|
||||||
|
|
||||||
反馈字段可以有：
|
|
||||||
|
|
||||||
```text
|
|
||||||
用户 ID
|
|
||||||
联系方式
|
|
||||||
问题类型
|
|
||||||
问题内容
|
|
||||||
截图
|
|
||||||
设备型号
|
|
||||||
系统版本
|
|
||||||
App 版本
|
|
||||||
当前页面
|
|
||||||
处理状态
|
|
||||||
创建时间
|
|
||||||
```
|
|
||||||
|
|
||||||
问题类型可以先分成：
|
|
||||||
|
|
||||||
```text
|
|
||||||
功能问题
|
|
||||||
登录问题
|
|
||||||
订阅问题
|
|
||||||
退款问题
|
|
||||||
AI 分析问题
|
|
||||||
上传问题
|
|
||||||
数据问题
|
|
||||||
建议反馈
|
|
||||||
其他
|
|
||||||
```
|
|
||||||
|
|
||||||
### 第三层：后台处理
|
### 第三层：后台处理
|
||||||
|
|
||||||
你在后台看到：
|
你在后台看到待处理反馈、高频问题、用户对话记录、是否已解决、是否需要回复、是否需要更新帮助文档。这样你不是被动被消息轰炸，而是集中处理。
|
||||||
|
|
||||||
```text
|
## 哪些问题机器人可以处理 / 哪些必须转人工
|
||||||
待处理反馈
|
|
||||||
高频问题
|
|
||||||
用户对话记录
|
|
||||||
是否已解决
|
|
||||||
是否需要回复
|
|
||||||
是否需要更新帮助文档
|
|
||||||
```
|
|
||||||
|
|
||||||
这样你不是被动被消息轰炸，而是集中处理。
|
可自动处理：功能怎么用、按钮在哪里、复习计划怎么理解、AI 分析结果是什么意思、会员权益说明、取消订阅流程、退款流程说明、隐私政策说明、常见错误排查。
|
||||||
|
|
||||||
## 哪些问题机器人可以处理
|
必须转人工：退款争议、账号删除、数据丢失、订阅权益异常、用户投诉、隐私问题、内容违规、支付失败但扣款、Apple/Google 订单问题。
|
||||||
|
|
||||||
可以自动处理：
|
|
||||||
|
|
||||||
```text
|
|
||||||
功能怎么用
|
|
||||||
按钮在哪里
|
|
||||||
复习计划怎么理解
|
|
||||||
AI 分析结果是什么意思
|
|
||||||
会员权益说明
|
|
||||||
取消订阅流程
|
|
||||||
退款流程说明
|
|
||||||
隐私政策说明
|
|
||||||
常见错误排查
|
|
||||||
```
|
|
||||||
|
|
||||||
## 哪些问题必须转人工
|
|
||||||
|
|
||||||
这些不要让机器人自己处理：
|
|
||||||
|
|
||||||
```text
|
|
||||||
退款争议
|
|
||||||
账号删除
|
|
||||||
数据丢失
|
|
||||||
订阅权益异常
|
|
||||||
用户投诉
|
|
||||||
隐私问题
|
|
||||||
内容违规问题
|
|
||||||
支付失败但扣款
|
|
||||||
Apple / Google 订单问题
|
|
||||||
```
|
|
||||||
|
|
||||||
机器人可以先收集信息，然后创建工单。
|
机器人可以先收集信息，然后创建工单。
|
||||||
|
|
||||||
比如：
|
|
||||||
|
|
||||||
```text
|
|
||||||
这个问题可能需要人工处理。我已经帮你记录反馈，请补充你的订阅平台、订单时间和问题截图。
|
|
||||||
```
|
|
||||||
|
|
||||||
## 技术上怎么接
|
|
||||||
|
|
||||||
推荐结构是：
|
|
||||||
|
|
||||||
```text
|
|
||||||
iOS App
|
|
||||||
→ 你的 NestJS 后端
|
|
||||||
→ Dify API
|
|
||||||
→ Dify 知识库
|
|
||||||
```
|
|
||||||
|
|
||||||
不要让 iOS 直接调用 Dify。
|
|
||||||
|
|
||||||
原因是：
|
|
||||||
|
|
||||||
```text
|
|
||||||
Dify API Key 不能暴露在客户端
|
|
||||||
客服会话需要绑定 userId
|
|
||||||
问题记录要进你的数据库
|
|
||||||
后续要接后台工单
|
|
||||||
要做限流和审计
|
|
||||||
```
|
|
||||||
|
|
||||||
后端接口可以先设计成：
|
|
||||||
|
|
||||||
```text
|
|
||||||
POST /api/support/chat
|
|
||||||
POST /api/support/feedback
|
|
||||||
GET /api/support/conversations
|
|
||||||
GET /api/support/feedbacks/my
|
|
||||||
```
|
|
||||||
|
|
||||||
后台接口：
|
|
||||||
|
|
||||||
```text
|
|
||||||
GET /api/admin/support/tickets
|
|
||||||
GET /api/admin/support/tickets/:id
|
|
||||||
PATCH /api/admin/support/tickets/:id
|
|
||||||
POST /api/admin/support/tickets/:id/reply
|
|
||||||
```
|
|
||||||
|
|
||||||
## 第一版页面建议
|
## 第一版页面建议
|
||||||
|
|
||||||
App 里做 3 个页面就够：
|
App 里做 3 个页面：帮助与客服页、智能客服聊天页、提交反馈页。"我的"页面里放入口：帮助与客服、问题反馈、隐私政策、用户协议、关于知习。
|
||||||
|
|
||||||
```text
|
后台第一版加：反馈列表、反馈详情、客服会话记录、问题分类统计。
|
||||||
帮助与客服页
|
|
||||||
智能客服聊天页
|
|
||||||
提交反馈页
|
|
||||||
```
|
|
||||||
|
|
||||||
“我的”页面里放入口：
|
|
||||||
|
|
||||||
```text
|
|
||||||
帮助与客服
|
|
||||||
问题反馈
|
|
||||||
隐私政策
|
|
||||||
用户协议
|
|
||||||
关于知习
|
|
||||||
```
|
|
||||||
|
|
||||||
后台第一版加：
|
|
||||||
|
|
||||||
```text
|
|
||||||
反馈列表
|
|
||||||
反馈详情
|
|
||||||
客服会话记录
|
|
||||||
问题分类统计
|
|
||||||
```
|
|
||||||
|
|
||||||
## Dify 知识库你可以先准备这些文档
|
|
||||||
|
|
||||||
```text
|
|
||||||
知习是什么
|
|
||||||
如何创建知识库
|
|
||||||
如何添加知识点
|
|
||||||
如何开始主动回忆
|
|
||||||
AI 分析结果怎么看
|
|
||||||
待巩固项是什么
|
|
||||||
复习计划是什么
|
|
||||||
如何修改个人资料
|
|
||||||
如何取消订阅
|
|
||||||
如何申请退款
|
|
||||||
Apple 登录失败怎么办
|
|
||||||
上传文件失败怎么办
|
|
||||||
数据安全说明
|
|
||||||
隐私政策摘要
|
|
||||||
联系客服方式
|
|
||||||
```
|
|
||||||
|
|
||||||
这些文档以后也可以直接变成 App 内帮助中心内容。
|
|
||||||
|
|
||||||
## 最重要的一点
|
## 最重要的一点
|
||||||
|
|
||||||
智能客服不是为了“假装有人回复”，而是为了：
|
智能客服不是为了"假装有人回复"，而是为了：
|
||||||
|
|
||||||
```text
|
```
|
||||||
基础问题自动解决
|
基础问题自动解决
|
||||||
复杂问题收集完整信息
|
复杂问题收集完整信息
|
||||||
你只处理真正需要人工判断的问题
|
你只处理真正需要人工判断的问题
|
||||||
@ -302,7 +85,7 @@ Apple 登录失败怎么办
|
|||||||
|
|
||||||
你一个人做产品，合理的客服策略应该是：
|
你一个人做产品，合理的客服策略应该是：
|
||||||
|
|
||||||
```text
|
```
|
||||||
机器人先答
|
机器人先答
|
||||||
答不了再建工单
|
答不了再建工单
|
||||||
你集中处理高价值问题
|
你集中处理高价值问题
|
||||||
@ -311,29 +94,8 @@ Apple 登录失败怎么办
|
|||||||
|
|
||||||
这样系统会越来越省你的时间。
|
这样系统会越来越省你的时间。
|
||||||
|
|
||||||
## 我的建议
|
|
||||||
|
|
||||||
你现在可以把它加入规划，而且我建议尽早预留后端模块：
|
|
||||||
|
|
||||||
```text
|
|
||||||
support
|
|
||||||
feedback
|
|
||||||
support_tickets
|
|
||||||
support_conversations
|
|
||||||
admin_support
|
|
||||||
```
|
|
||||||
|
|
||||||
但第一版不要做复杂在线客服。先做：
|
|
||||||
|
|
||||||
```text
|
|
||||||
Dify FAQ 客服
|
|
||||||
+ App 内反馈
|
|
||||||
+ 后台工单列表
|
|
||||||
+ 人工状态处理
|
|
||||||
```
|
|
||||||
|
|
||||||
一句话总结：
|
一句话总结：
|
||||||
|
|
||||||
```text
|
```
|
||||||
你确实应该做 App 内智能客服；它的价值就是替你挡住基础问题，把真正需要人工处理的问题变成后台工单，而不是让所有用户消息都直接压到你一个人身上。
|
你确实应该做 App 内智能客服；它的价值就是替你挡住基础问题，把真正需要人工处理的问题变成后台工单，而不是让所有用户消息都直接压到你一个人身上。
|
||||||
```
|
```
|
||||||
|
|||||||
@ -8,17 +8,17 @@
|
|||||||
|
|
||||||
## 客服体系（已决策）
|
## 客服体系（已决策）
|
||||||
|
|
||||||
采用 **Dify 智能客服 + 反馈工单 + 后台处理** 三层架构：
|
采用 **智能客服 + 反馈工单 + 后台处理** 三层架构：
|
||||||
|
|
||||||
```
|
```
|
||||||
用户在 App 内点击"帮助与客服"
|
用户在 App 内点击"帮助与客服"
|
||||||
→ Dify 根据帮助知识库自动回答 FAQ
|
→ AI 客服根据帮助知识库自动回答 FAQ
|
||||||
→ 解决了 → 结束
|
→ 解决了 → 结束
|
||||||
→ 未解决 → 用户点"转人工 / 提交反馈"
|
→ 未解决 → 用户点"转人工 / 提交反馈"
|
||||||
→ 后端创建工单 → 后台显示 → 你有空再处理
|
→ 创建工单 → 后台显示 → 人工处理
|
||||||
```
|
```
|
||||||
|
|
||||||
Dify 只读官方帮助知识库，不读用户私人数据（学习资料、回忆回答、私人知识库、分析结果）。
|
AI 客服只读官方帮助知识库，不读用户私人数据（学习资料、回忆回答、私人知识库、分析结果）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -56,36 +56,8 @@ Dify 只读官方帮助知识库，不读用户私人数据（学习资料、回
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 技术架构
|
|
||||||
|
|
||||||
```
|
|
||||||
iOS App → NestJS 后端 → Dify API → Dify 知识库
|
|
||||||
```
|
|
||||||
|
|
||||||
后端接口：
|
|
||||||
- `POST /api/support/chat`
|
|
||||||
- `POST /api/support/feedback`
|
|
||||||
- `GET /api/support/conversations`
|
|
||||||
- `GET /api/support/feedbacks/my`
|
|
||||||
|
|
||||||
后台接口：
|
|
||||||
- `GET /api/admin/support/tickets`
|
|
||||||
- `GET /api/admin/support/tickets/:id`
|
|
||||||
- `PATCH /api/admin/support/tickets/:id`
|
|
||||||
- `POST /api/admin/support/tickets/:id/reply`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 用户运营
|
## 用户运营
|
||||||
|
|
||||||
- 新用户引导、激活策略、留存计划
|
- 新用户引导、激活策略、留存计划
|
||||||
- 内测用户群管理
|
- 内测用户群管理
|
||||||
- 知识库内容更新和质量把控
|
- 知识库内容更新和质量把控
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 相关文档
|
|
||||||
|
|
||||||
- [阶段路线图](../../../技术设计/阶段路线图.md)
|
|
||||||
- [数据反馈与迭代模块](../[设计中]-数据反馈与迭代模块.md)
|
|
||||||
- [客服设计详案](./[参考]-客服设计详案.md)
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user