From a1113df50c71a6a28e5842c07dd6b7529789da05 Mon Sep 17 00:00:00 2001 From: WangDL Date: Thu, 21 May 2026 13:23:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=B2=BE=E7=AE=80=E9=95=BF=E6=9C=9F?= =?UTF-8?q?=E8=A7=84=E5=88=92=E6=96=87=E6=A1=A3=EF=BC=8C=E5=8E=BB=E9=99=A4?= =?UTF-8?q?=E6=8A=80=E6=9C=AF=E5=AE=9E=E7=8E=B0=E7=BB=86=E8=8A=82=EF=BC=8C?= =?UTF-8?q?=E4=BF=9D=E7=95=99=E6=96=B9=E5=90=91=E6=80=A7=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 技术与交付模块：去除具体技术栈/部署方案/文件路径，仅保留技术方向 - 个人开发者创业计划：去除当前技术开发状态、文档索引 - 产品与用户模块：去除具体页面清单、文档引用 - 商业化与支付模块：去除技术实现细节、文档引用 - 运营与客服：去除 API 路由/具体技术栈引用，保留服务策略 - 其余模块：去除交叉文档引用 Co-Authored-By: Claude Opus 4.7 --- 长期规划/[参考]-产品与用户模块.md | 12 - 长期规划/[参考]-技术与交付模块.md | 74 ++--- 长期规划/[设计中]-合规与公司化模块.md | 8 - 长期规划/[设计中]-数据反馈与迭代模块.md | 8 - 长期规划/[进行中]-个人开发者创业计划.md | 39 +-- 长期规划/[进行中]-商业化与支付模块.md | 10 +- .../营销与增长/[进行中]-营销与增长模块.md | 4 - 长期规划/运营与客服/[参考]-客服设计详案.md | 288 ++---------------- .../运营与客服/[进行中]-运营与客服模块.md | 36 +-- 9 files changed, 51 insertions(+), 428 deletions(-) diff --git a/长期规划/[参考]-产品与用户模块.md b/长期规划/[参考]-产品与用户模块.md index eef0296..4db6804 100644 --- a/长期规划/[参考]-产品与用户模块.md +++ b/长期规划/[参考]-产品与用户模块.md @@ -76,13 +76,6 @@ --- -## 核心页面（14 页） - -| 优先级 | 页面 | -|--------|------| -| P0 | 登录页、学习方向选择页、学习路径页、今日学习任务页、内容阅读页、主动回忆/笔记输入页、AI 分析结果页、AI 对话页、复习计划页 | -| P1 | 学习进度页、设置页、反馈页、欢迎页、语言偏好页 | - --- ## 账号体系 @@ -92,8 +85,3 @@ --- -## 相关文档 - -- [阶段路线图](../../技术设计/阶段路线图.md) -- [技术与交付模块](./[参考]-技术与交付模块.md) -- [商业化与支付模块](./[进行中]-商业化与支付模块.md) diff --git a/长期规划/[参考]-技术与交付模块.md b/长期规划/[参考]-技术与交付模块.md index 0703b95..796f6b2 100644 --- a/长期规划/[参考]-技术与交付模块.md +++ b/长期规划/[参考]-技术与交付模块.md @@ -2,76 +2,36 @@ ## 模块目标 -确定技术栈、开发流程、交付节奏和质量标准。 +确定技术方向和交付策略。 --- -## 技术选型（已决策） +## 技术方向 -| 层级 | 选型 | 说明 | -|------|------|------| -| iOS | Swift / SwiftUI | Apple 原生，MVVM + Service + Repository | -| 后端 | NestJS + TypeScript | 模块化单体架构 | -| ORM | Prisma | 类型安全，自动生成 TS 类型 | -| 数据库 | 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 | 预留 | +- **Apple-first**：优先 iOS（Swift/SwiftUI），后续扩展 iPad/Mac +- **后端**：模块化架构，按业务域拆分 +- **AI**：Provider 抽象层，按任务分级路由模型（轻任务用便宜模型，核心分析用主力模型） +- **部署**：单服务器起步，后续按需扩展 +- **官网**：静态生成，SEO 友好 --- -## 前后端协作流程 +## 交付节奏 -1. 选一个业务流程 -2. 根据流程拆接口 -3. 后端设计表结构、DTO、接口、Swagger -4. 前端根据 Swagger 写 Model / Service -5. 前端接页面 → 联调 → 发现问题 → 回头改接口/DTO/表结构 -6. 稳定后再做下一个流程 +按业务流程逐个交付，每个流程走通前后端联调后再做下一个。 --- -## iOS 多设备工程策略 +## 第一版范围 -| 设备 | 策略 | -|------|------| -| iPhone + iPad | 同一个 Xcode Project，同一个 iOS App Target | -| Mac | 单独 Mac 版本 Target | -| Watch | watchOS Target | +**做：** iOS 客户端、核心学习闭环、AI 分析、Apple IAP + +**暂不做：** 安卓、Web 学习端、复杂后台 --- -## 第一版技术范围 +## 核心原则 -**必须：** iOS 客户端、核心功能、简单后端、AI API 调用、本地数据存储、Apple IAP - -**暂不做：** 安卓客户端、微信/支付宝支付、复杂后台管理系统、Web 学习端 - ---- - -## AI 架构 - -> 详见：[AI架构设计](../../技术设计/api-server/AI架构设计.md) - -核心原则：从"业务分级工作流"开始，暂不做完全自治 Agent。后期通过用户学习画像、长期记忆和受控 Skill 系统逐步演进。 - -模型按任务分级：轻任务用便宜模型，核心分析用主力模型，复杂推理用强模型。 - ---- - -## 后端开发路线 - -> 详见：[后端开发优先级](../../技术设计/api-server/后端开发路线图.md) - -核心开发顺序：**身份权限 → 知识系统 → 学习闭环 → AI 基础设施 → 文件导入 → 商业化 → 后台 → 客服 → 学习画像 → 公开分享 → 增长归因** - ---- - -## 相关文档 - -- [阶段路线图](../../技术设计/阶段路线图.md) -- [产品与用户模块](./[参考]-产品与用户模块.md) -- [AI架构设计](../../技术设计/api-server/AI架构设计.md) -- [后端开发优先级](../../技术设计/api-server/后端开发路线图.md) +- 从"业务分级工作流"开始，暂不做完全自治 Agent +- 先验证核心闭环，再扩展平台 +- 模型路由：基础档不默认使用高价模型，高级推理作为 Pro 权益 diff --git a/长期规划/[设计中]-合规与公司化模块.md b/长期规划/[设计中]-合规与公司化模块.md index 2660f6a..2105db0 100644 --- a/长期规划/[设计中]-合规与公司化模块.md +++ b/长期规划/[设计中]-合规与公司化模块.md @@ -42,11 +42,3 @@ - 退款政策 - 免责声明 -## 相关文档 - -- [阶段路线图](../../技术设计/阶段路线图.md) -- [商业化与支付模块](./[进行中]-商业化与支付模块.md) - -## 负责人 - -[待定] \ No newline at end of file diff --git a/长期规划/[设计中]-数据反馈与迭代模块.md b/长期规划/[设计中]-数据反馈与迭代模块.md index 6b55936..34abf68 100644 --- a/长期规划/[设计中]-数据反馈与迭代模块.md +++ b/长期规划/[设计中]-数据反馈与迭代模块.md @@ -40,11 +40,3 @@ - 产品改进 - 用户通知 -## 相关文档 - -- [阶段路线图](../../技术设计/阶段路线图.md) -- [运营与客服模块](./运营与客服/[进行中]-运营与客服模块.md) - -## 负责人 - -[待定] \ No newline at end of file diff --git a/长期规划/[进行中]-个人开发者创业计划.md b/长期规划/[进行中]-个人开发者创业计划.md index db80e7b..280ba81 100644 --- a/长期规划/[进行中]-个人开发者创业计划.md +++ b/长期规划/[进行中]-个人开发者创业计划.md @@ -41,7 +41,7 @@ ├── 2. 技术与交付模块 → 技术栈、AI 架构、工程策略 ├── 3. 商业化与支付模块 → 定价、订阅、权益 ├── 4. 营销与增长模块 → 获客、内容、冷启动 -├── 5. 运营与客服模块 → Dify 客服、工单、用户运营 +├── 5. 运营与客服模块 → AI 客服、工单、用户运营 ├── 6. 数据反馈与迭代模块 → 指标、埋点、迭代 └── 7. 合规与公司化模块 → 上架合规、公司化时机 ``` @@ -62,42 +62,11 @@ | 7 | iPad / Mac 扩展 | 🔲 | | 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） 2. **准备第一个 7 天路径的内容** -3. **修复 iOS 编译问题 + Repository 接 Prisma + iOS 换 HTTPS** -4. **做 3-5 个竞品拆解** -5. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单） +3. **做 3-5 个竞品拆解** +4. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单） diff --git a/长期规划/[进行中]-商业化与支付模块.md b/长期规划/[进行中]-商业化与支付模块.md index 86bae51..8da04e9 100644 --- a/长期规划/[进行中]-商业化与支付模块.md +++ b/长期规划/[进行中]-商业化与支付模块.md @@ -52,11 +52,7 @@ ## 支付流程 -``` -用户在 iOS App 内付款 → Apple IAP 完成交易 → 后端记录用户权益 → 用户获 Pro 权益 -``` - -核心是自己的 **用户系统 + 订单系统 + 权益系统**，Apple IAP 只是第一阶段的支付通道。 +用户在 iOS App 内通过 Apple IAP 完成交易，后端记录用户权益。第一阶段仅走 Apple 支付通道。 --- @@ -83,7 +79,3 @@ --- -## 相关文档 - -- [阶段路线图](../../技术设计/阶段路线图.md) -- [合规与公司化模块](./[设计中]-合规与公司化模块.md) diff --git a/长期规划/营销与增长/[进行中]-营销与增长模块.md b/长期规划/营销与增长/[进行中]-营销与增长模块.md index 72deff9..da9a61f 100644 --- a/长期规划/营销与增长/[进行中]-营销与增长模块.md +++ b/长期规划/营销与增长/[进行中]-营销与增长模块.md @@ -75,7 +75,3 @@ AI 生成内容草稿 → 人审核修改 → 人手动发布 → AI 辅助分 --- -## 相关文档 - -- [阶段路线图](../../../技术设计/阶段路线图.md) -- [营销冷启动调研方案](./[参考]-营销冷启动调研方案.md) diff --git a/长期规划/运营与客服/[参考]-客服设计详案.md b/长期规划/运营与客服/[参考]-客服设计详案.md index 52585ea..f02774b 100644 --- a/长期规划/运营与客服/[参考]-客服设计详案.md +++ b/长期规划/运营与客服/[参考]-客服设计详案.md @@ -1,51 +1,38 @@ -对，你这个判断是对的。**你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。** +对，你这个判断是对的。你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。 -用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。尤其是这些基础问题： - -```text -怎么创建知识库？ -为什么 Apple 登录失败？ -AI 分析结果怎么看？ -会员怎么取消？ -退款怎么处理？ -安卓什么时候上？ -数据会不会丢？ -上传文件失败怎么办？ -``` +用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。 这些如果都靠你一个人回，肯定扛不住。 所以这里应该做一个： -```text +``` App 内智能客服 + 反馈工单 + 后台处理系统 ``` -而不是单纯一个“意见反馈表单”。 +而不是单纯一个"意见反馈表单"。 ## 它在知习里的定位 你可以这么定义： -```text -Dify 智能客服负责解决常见问题； +``` +AI 智能客服负责解决常见问题； 反馈系统负责收集真实问题； 后台管理系统负责处理需要人工介入的问题。 ``` -它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。核心学习 AI 还是走你自己的后端工作流。你的当前主线仍然是把 iOS App 从静态 UI 变成真实功能 App。 +它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。 ## 我建议的客服流程 -可以这样设计： - -```text -用户在 App 内点击“帮助与客服” +``` +用户在 App 内点击"帮助与客服" → 先进入智能客服 -→ Dify 根据帮助知识库自动回答 +→ AI 根据帮助知识库自动回答 → 如果解决了，结束 -→ 如果没解决，用户点击“转人工 / 提交反馈” -→ 后端创建反馈工单 +→ 如果没解决，用户点击"转人工 / 提交反馈" +→ 创建反馈工单 → 后台显示待处理问题 → 你有空再处理 ``` @@ -54,44 +41,9 @@ Dify 智能客服负责解决常见问题； ## 第一版客服应该回答什么 -第一版只回答官方固定内容： +第一版只回答官方固定内容：功能使用说明、登录问题、知识库创建、文件上传、AI 分析说明、复习计划、订阅说明、退款流程、隐私政策、用户协议、常见错误处理、联系方式。 -```text -功能使用说明 -登录问题 -知识库创建问题 -文件上传问题 -AI 分析说明 -复习计划说明 -订阅说明 -退款流程说明 -隐私政策 -用户协议 -备案信息 -常见错误处理 -联系方式 -``` - -不要让客服 Bot 去读用户私人知识库内容。 - -这点很重要。 - -客服 Bot 只应该读： - -```text -官方帮助中心知识库 -``` - -不要读： - -```text -用户上传的学习资料 -用户的主动回忆回答 -用户的私人知识库 -用户的学习分析结果 -``` - -除非以后你专门做了授权机制。 +不要让客服 Bot 去读用户私人知识库内容。客服 Bot 只应该读官方帮助中心知识库，不要读用户上传的学习资料、主动回忆回答、私人知识库、学习分析结果（除非以后专门做了授权机制）。 ## 你真正需要的是三层系统 @@ -99,202 +51,33 @@ AI 分析说明 用户问基础问题，机器人自动回。 -比如： - -```text -“怎么取消订阅？” -“怎么导入知识点？” -“为什么我的 AI 分析失败？” -``` - -机器人可以直接回答流程。 - ### 第二层：反馈 / 工单系统 -如果机器人解决不了，就创建反馈。 - -反馈字段可以有： - -```text -用户 ID -联系方式 -问题类型 -问题内容 -截图 -设备型号 -系统版本 -App 版本 -当前页面 -处理状态 -创建时间 -``` - -问题类型可以先分成： - -```text -功能问题 -登录问题 -订阅问题 -退款问题 -AI 分析问题 -上传问题 -数据问题 -建议反馈 -其他 -``` +如果机器人解决不了，就创建反馈。反馈字段包括用户 ID、联系方式、问题类型、问题内容、截图、设备型号、系统版本、App 版本、处理状态。 ### 第三层：后台处理 -你在后台看到： +你在后台看到待处理反馈、高频问题、用户对话记录、是否已解决、是否需要回复、是否需要更新帮助文档。这样你不是被动被消息轰炸，而是集中处理。 -```text -待处理反馈 -高频问题 -用户对话记录 -是否已解决 -是否需要回复 -是否需要更新帮助文档 -``` +## 哪些问题机器人可以处理 / 哪些必须转人工 -这样你不是被动被消息轰炸，而是集中处理。 +可自动处理：功能怎么用、按钮在哪里、复习计划怎么理解、AI 分析结果是什么意思、会员权益说明、取消订阅流程、退款流程说明、隐私政策说明、常见错误排查。 -## 哪些问题机器人可以处理 - -可以自动处理： - -```text -功能怎么用 -按钮在哪里 -复习计划怎么理解 -AI 分析结果是什么意思 -会员权益说明 -取消订阅流程 -退款流程说明 -隐私政策说明 -常见错误排查 -``` - -## 哪些问题必须转人工 - -这些不要让机器人自己处理： - -```text -退款争议 -账号删除 -数据丢失 -订阅权益异常 -用户投诉 -隐私问题 -内容违规问题 -支付失败但扣款 -Apple / Google 订单问题 -``` +必须转人工：退款争议、账号删除、数据丢失、订阅权益异常、用户投诉、隐私问题、内容违规、支付失败但扣款、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 内智能客服；它的价值就是替你挡住基础问题，把真正需要人工处理的问题变成后台工单，而不是让所有用户消息都直接压到你一个人身上。 ``` diff --git a/长期规划/运营与客服/[进行中]-运营与客服模块.md b/长期规划/运营与客服/[进行中]-运营与客服模块.md index 99b4a6a..d447993 100644 --- a/长期规划/运营与客服/[进行中]-运营与客服模块.md +++ b/长期规划/运营与客服/[进行中]-运营与客服模块.md @@ -8,17 +8,17 @@ ## 客服体系（已决策） -采用 **Dify 智能客服 + 反馈工单 + 后台处理** 三层架构： +采用 **智能客服 + 反馈工单 + 后台处理** 三层架构： ``` 用户在 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)