Files
dreamweaver/docs/planning/demo-package.md

67 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DreamWeaver 求职版 Demo 包装
这份文档用于演示前 5 分钟快速准备,也可以作为面试官追问时的项目导航。
---
## 1. 一句话定位
DreamWeaver 是面向 3-8 岁亲子场景的个性化 AI 绘本与陪伴式讲述产品。它把孩子档案、故事宇宙、故事生成、绘本插图、语音缓存、阅读事件和成长记忆串成一个可恢复的阅读闭环。
---
## 2. 演示前检查
```bash
docker compose up -d --build
./scripts/demo_smoke.sh
```
需要验证语音链路时:
```bash
SMOKE_AUDIO=1 ./scripts/demo_smoke.sh
```
演示入口:
- 用户端:`http://localhost:52080`
- 本地登录:`http://localhost:52080/auth/dev/signin`
- 管理端:`http://localhost:52888`
- 后端健康:`http://localhost:52000/health`
---
## 3. 主演示路径
1. 使用本地登录进入用户端。
2. 创建普通故事,说明主内容优先可读。
3. 打开故事详情页,展示 `partial_ready`、封面补全、音频缓存状态和生成轨迹。
4. 补全封面或音频,说明资产失败不会覆盖正文。
5. 创建绘本,进入绘本阅读器。
6. 刷新页面或重新进入绘本,说明按 ID 恢复和阅读位置恢复。
7. 回到故事库,展示跨故事 Provider 运营摘要。
8. 打开孩子时间线,展示阅读事件和记忆沉淀。
---
## 4. 面试讲解锚点
- **产品判断**:求职版不追求功能越多,而是围绕亲子阅读闭环收敛。
- **AI 不确定性处理**:主内容和资产拆开,图片/音频失败不阻塞阅读。
- **Provider 产品化**:用户看到稳定能力,系统内部用 Capability / Provider / Adapter / Routing Policy 管供应链。
- **可观测性**generation job/event 让生成过程、失败恢复和 Provider 成本可解释。
- **可继续生产化**:前端已有轮询形态,后端已有任务事件模型,下一步可以迁移到 worker。
---
## 5. 失败预案
| 风险 | 现场处理 |
| --- | --- |
| TTS 网络失败 | 说明音频是可恢复资产,展示缓存状态或跳过语音 |
| 图片生成失败 | 展示 `degraded_completed` 与资源重试 |
| Docker 冷启动慢 | 演示前先跑 smoke 并保持容器运行 |
| Provider 追问过深 | 回到 Capability / Provider / Adapter / Routing Policy 四层解释 |
| 生产化追问 | 说明下一步是 worker 化、监控告警、密钥治理和 Provider analytics 扩展 |