01产品概述
1.1 产品定位
品应用 是一款面向垂直行业外勤销售场景的 AI-Native CRM + 销售外勤助手。产品以"场景感知下的 GUI + LUI 融合交互 + 语音交互"为核心交互范式，参考 ChatGPT 双栏布局，通过插件化架构扩展能力，帮助快消、医药、建材、设备、保险、农业等行业的外勤销售团队实现客户管理、拜访执行、数据洞察的全流程智能化。
1.2 目标用户
外勤销售代表
每天奔波于客户之间的一线销售人员，需要高效的客户管理、拜访规划和 AI 辅助工具。核心诉求：减少填表时间、提升拜访效率、获得智能跟进建议。
销售管理者
销售总监、区域经理等管理人员，需要实时掌握团队业绩、外勤效率和客户健康度。核心诉求：数据可视化、异常预警、团队效能分析。
企业 IT/运营
负责系统选型和部署的信息化负责人，需要安全、可扩展、易集成的 SaaS 平台。核心诉求：数据安全、权限管理、API 集成、私有化部署。
中小企业主
10-200 人规模的垂直行业企业决策者，需要开箱即用、性价比高的销售管理工具。核心诉求：快速上线、操作简单、投入产出比高。
1.3 核心价值主张
- AI战略师随行：每一位外勤销售都拥有 7×24 小时在线的 AI 销售军师，自然语言即可查询数据、生成报告、获取建议。
- 外勤效率革命：智能路线规划、语音拜访纪要、AI 陈列识别，将外勤代表从繁琐的行政工作中解放，聚焦客户关系。
- 垂直行业深耕：不做通用 CRM，而是为快消、医药、建材等外勤密集行业提供量身定制的业务流程和数据模型。
- 插件化可扩展：核心平台 + 插件生态，企业按需安装行业插件和功能插件，系统随业务成长。
02MVP 范围界定
MVP 版本聚焦验证核心价值假设：AI 对话驱动的 CRM + 外勤管理是否能显著提升外勤销售效率。以下为明确的范围边界。
MVP 包含（In Scope）
- ✓用户注册/登录/团队管理（基础多租户）
- ✓AI 对话工作台（豆包风格空状态 + 对话流）
- ✓自然语言查询客户/商机/业绩数据
- ✓CRM 客户管理（列表/详情/联系人/跟进记录）
- ✓商机 Kanban 看板（拖拽流转）
- ✓外勤拜访（签到/路线/报告）
- ✓数据看板（销售漏斗/业绩/外勤效率）
- ✓插件中心（浏览/安装/配置，预置 6+ 插件）
- ✓系统设置（个人资料/通知/API Key）
- ✓语音输入（语音转文字）
- ✓三语国际化（简中/繁中/英文）
- ✓响应式设计（PC/平板/移动端）
- ✓深色/浅色主题
- ✓营销官网（7 个独立 HTML 页面 + SEO）
- ✓演示数据填充（开箱可体验）
MVP 不包含（Out of Scope）
- ✗AI 语音播报（TTS）— P1 迭代
- ✗AI 图片理解/陈列识别 — P1 迭代
- ✗第三方系统深度集成（ERP/财务/OA）— P2
- ✗SSO 单点登录（SAML/OAuth）— P1 迭代
- ✗私有化部署 — 企业版专属，P2
- ✗自定义插件开发 SDK — P2 迭代
- ✗移动端原生 App（iOS/Android）— P2，MVP 用 PWA
- ✗复杂工作流引擎（审批流/自动化流）— P2
- ✗BI 自定义报表拖拽搭建 — P1 迭代
- ✗客户公海自动分配规则 — P1 迭代
- ✗实时协同编辑/多人同时操作 — P2
- ✗付费支付/订阅计费系统 — 上线前接入
- ✗数据迁移工具（从其他 CRM 导入）— P1
- ✗审计日志高级检索 — 企业版，P2
03核心功能清单
按模块划分的 MVP 功能清单，标注优先级（P0 = 必须有，P1 = 应该有，P2 = 可以有）。
| 模块 | 功能点 | 描述 | 优先级 |
|---|---|---|---|
| 认证与团队 | 注册/登录 | 邮箱/手机号注册登录，忘记密码 | P0 |
| 团队管理 | 创建组织、邀请成员、成员列表 | P0 | |
| 角色权限 | 管理员/经理/代表三级角色，基础数据权限 | P1 | |
| AI 对话工作台 | 豆包风格空状态 | 居中大输入框 + 推荐问题卡片 + 品牌欢迎区 | P0 |
| 对话流 | 消息气泡、AI 打字效果、流式输出 | P0 | |
| 自然语言查询 | 查询客户/商机/业绩，返回 GUI 结构化结果 | P0 | |
| 语音输入 | 语音转文字，移动端优化 | P1 | |
| 会话历史 | 侧边栏会话列表、搜索、新建对话 | P0 | |
| 场景感知建议 | 根据当前页面上下文推荐快捷操作 | P1 | |
| CRM 客户管理 | 客户列表 | 表格视图、筛选、排序、搜索、批量操作 | P0 |
| 客户详情 | 360° 画像、基本信息、联系人、商机、跟进时间线 | P0 | |
| 商机看板 | Kanban 视图、拖拽流转阶段、列表视图切换 | P0 | |
| 联系人管理 | 联系人增删改查、关联客户 | P0 | |
| 跟进记录 | 记录新增、时间线展示、关联客户/商机 | P0 | |
| 销售外勤 | 拜访计划 | 今日拜访列表、时间安排、客户信息 | P0 |
| 路线规划 | 多客户最优路线计算（演示版） | P1 | |
| 签到打卡 | 位置签到、拍照上传（演示版） | P0 | |
| 拜访报告 | AI 生成纪要模板、待办事项提取 | P1 | |
| 数据看板 | 销售漏斗 | 各阶段商机数量、转化率图表 | P0 |
| 业绩追踪 | 目标 vs 实际、团队排行、趋势图 | P0 | |
| 外勤效率 | 拜访量、覆盖率、有效拜访率 | P1 | |
| 插件中心 | 插件列表 | 已安装/市场插件浏览 | P0 |
| 安装/卸载 | 插件一键安装启用/停用卸载 | P0 | |
| 插件配置 | 已安装插件的参数配置页面 | P1 | |
| 系统设置 | 个人资料 | 头像、姓名、联系方式、密码修改 | P0 |
| 通知设置 | 邮件/站内/推送通知开关 | P1 | |
| API Key | API 密钥生成、查看、撤销 | P1 | |
| 通用能力 | 国际化 | 简中/繁中/英文三语切换 | P0 |
| 主题 | 浅色/深色/跟随系统 | P0 | |
| 响应式 | PC/平板/移动端自适应 | P0 |
3.1 功能统计
P0 必须有
22 项
核心价值闭环，MVP 必须交付
P1 应该有
11 项
增强体验，MVP 尽量交付
功能模块
9 个
覆盖认证、AI、CRM、外勤、看板等
演示数据
200+ 条
客户、联系人、商机、跟进、外勤记录
04技术架构
4.1 架构总览
客户端层 / Client
React 19
Tailwind CSS 4
shadcn/ui
React Router
PWA (Service Worker)
i18n (三语)
↕
后端服务层 / Backend
NestJS
RESTful API
JWT 认证
AI 对话服务
插件管理服务
文件上传服务
↕
数据层 / Data
Drizzle ORM
PostgreSQL
11 张业务表
演示数据种子
↕
基础设施 / Infrastructure
云托管部署
HTTPS / TLS 1.3
CDN 静态资源加速
日志与监控
4.2 数据库表设计
| 表名 | 用途 | 核心字段 |
|---|---|---|
| users | 用户表 | id, email, phone, password_hash, name, avatar, role, org_id, locale, theme |
| organizations | 组织/租户表 | id, name, industry, size, plan, created_at |
| customers | 客户表 | id, org_id, name, industry, size, address, geo, owner_id, stage, score, source |
| contacts | 联系人表 | id, customer_id, name, title, phone, email, is_primary |
| opportunities | 商机表 | id, customer_id, title, amount, stage, probability, expected_close, owner_id |
| follow_ups | 跟进记录表 | id, customer_id, opportunity_id, type, content, next_action, created_by |
| field_visits | 外勤拜访表 | id, customer_id, user_id, planned_time, checkin_time, location, photos, status, report |
| conversations | AI 对话表 | id, user_id, title, created_at, updated_at |
| messages | 消息表 | id, conversation_id, role (user/assistant), content, gui_payload, created_at |
| plugins | 插件表 | id, name, description, icon, category, version, is_installed, config, status |
| store_inspections | 门店巡检表 | id, visit_id, items (JSON), score, photos, status |
4.3 技术选型理由
- React 19：组件化开发、生态成熟、社区活跃，适合构建复杂的 SPA 应用；Server Components 等新特性为后续性能优化留空间。
- Tailwind CSS 4 + shadcn/ui：原子化 CSS 快速构建一致的 UI，shadcn/ui 提供可定制的高质量组件，五行配色方案易于落地。
- NestJS：基于 TypeScript 的企业级 Node 框架，模块化架构清晰，依赖注入便于测试和扩展，适合全栈 SaaS 后端。
- Drizzle ORM + PostgreSQL：轻量级类型安全 ORM，SQL 优先，性能优秀；PostgreSQL 支持复杂查询和 JSON 字段，适合 CRM 数据模型。
- PWA：MVP 阶段不开发原生 App，通过 PWA 实现可安装、离线缓存、推送通知，降低开发成本同时覆盖移动端需求。
05交付物清单
1
营销官网 已交付
7 个独立 HTML 页面（首页/功能/行业/AI/定价/关于/联系）+ sitemap.xml + robots.txt，完整 SEO 元数据，五行配色，响应式设计。可直接部署到任何静态托管。
2
全栈 SaaS 系统 已交付
React 19 + NestJS + PostgreSQL 全栈应用，包含登录认证、AI 对话工作台、CRM 客户管理、商机看板、外勤管理、数据看板、插件中心、系统设置 8 大模块。
3
AI 助手响应式优化 已交付
PC 端三栏布局（会话栏+对话区+结果面板），移动端单栏+抽屉菜单，输入框安全区适配，GUI 结果响应式展示，平板端过渡布局。
4
豆包风格新建对话页 已交付
空状态居中大输入框 + 品牌欢迎区 + 2×2 推荐问题卡片，发送后自动切换对话流，入场动画，移动端单列适配。
5
演示数据 已交付
44 客户、60 联系人、45 商机（各阶段分布）、37 跟进记录、30 外勤拜访、12 插件，开箱即可体验完整业务流。
6
MVP 交付方案文档 已交付
本文档：产品概述、范围界定、功能清单、技术架构、交付物、里程碑、验收标准、风险、路线图。
7
部署与运维指南 待补充
环境变量配置、数据库迁移、构建部署步骤、监控告警配置、备份恢复方案。MVP 上线前补充。
8
用户使用手册 待补充
面向终端用户的操作指南，包含各模块功能说明、常见问题、最佳实践。MVP 上线前补充。
06里程碑与时间线
以下为 MVP 从启动到交付的里程碑规划（实际已完成，此处为复盘记录）。
第 1 周 · 需求与设计
产品定义与设计规范
- 完成产品定位、目标用户、核心价值主张定义
- 确定五行配色设计体系（土/火/木/金/暖中性）
- 确定 GUI + LUI 融合交互范式与豆包风格对话框
- 完成 MVP 范围界定与功能优先级排序
- 确定技术栈：React 19 + NestJS + PostgreSQL
第 2-3 周 · 官网与基础架构
营销官网 + 全栈基础架构
- 完成 7 页营销官网（独立 HTML + SEO）
- 搭建全栈项目骨架：React 前端 + NestJS 后端 + 数据库
- 完成用户认证模块（注册/登录/JWT）
- 完成团队/组织管理基础模块
- 完成三语国际化框架与主题切换框架
第 4-5 周 · 核心业务模块
CRM + 外勤 + 看板核心功能
- 完成 CRM 客户管理（列表/详情/联系人/跟进记录）
- 完成商机 Kanban 看板（拖拽流转）
- 完成外勤拜访模块（计划/签到/报告）
- 完成数据看板（销售漏斗/业绩/外勤效率图表）
- 完成插件中心（浏览/安装/配置）
- 填充演示数据（200+ 条业务数据）
第 6 周 · AI 能力与体验优化
AI 对话工作台 + 响应式优化
- 完成 AI 对话工作台（双栏布局、对话流、会话历史）
- 完成豆包风格新建对话空状态（大输入框+推荐卡片）
- 完成自然语言查询返回 GUI 结构化结果
- 完成语音输入（语音转文字）
- PC/平板/移动端响应式全面优化
- AI 助手页面移动端抽屉菜单、安全区适配
第 7 周 · 测试与交付
全链路测试 + MVP 交付
- 全链路功能测试（认证→AI→CRM→外勤→看板→插件→设置）
- 三语切换测试、深浅主题测试、多设备响应式测试
- 后端 API 接口测试（增删改查链路）
- 性能与加载体验优化
- 编写 MVP 交付方案文档（本文档）
- 正式交付 MVP 版本
07验收标准
MVP 交付验收按以下维度逐项检查，全部通过视为交付合格。
功能完整性
- 9 大模块全部可访问、可操作，无空白页面
- P0 功能（22 项）全部实现并可正常使用
- P1 功能（11 项）至少 80% 实现
- 核心业务流程闭环：注册→创建客户→创建商机→外勤拜访→查看看板
- AI 对话可正常发起、返回结果、历史可查
用户体验
- PC 端（1920×1080）布局完整，无元素溢出或重叠
- 移动端（375×812）可正常操作，输入框不被键盘遮挡
- 平板端（768×1024）过渡布局合理
- 页面首屏加载 ≤ 3 秒（正常网络环境）
- 所有交互有明确反馈（hover/active/loading/success/error）
- 表单有验证提示，空状态有引导文案
设计一致性
- 严格遵循五行配色方案（土底/火强调/木正向/金点缀/暖中性文字）
- 深色/浅色模式下均有良好对比度和可读性
- 三语（简中/繁中/英文）下文案不溢出、不错位
- 组件风格统一（按钮、卡片、表单、表格、弹窗）
- 字号、间距、圆角、阴影遵循统一设计规范
数据与安全
- 演示数据完整：44 客户、60 联系人、45 商机、37 跟进、30 外勤
- 数据增删改查操作有真实持久化（刷新后数据保留）
- 用户密码加密存储（bcrypt/argon2）
- JWT Token 认证，未登录用户无法访问业务页面
- 多租户数据隔离，不同组织数据不可互访
- API 接口有基础参数校验和错误处理
官网与 SEO
- 7 个 HTML 页面全部可独立访问，页面间链接互通
- 每页有独立 title、meta description、canonical
- Open Graph / Twitter Card 标签完整
- JSON-LD 结构化数据正确
- 语义化 HTML5 标签（header/nav/main/section/article/footer）
- sitemap.xml 包含全部页面，robots.txt 配置正确
- 无本地路径资源引用，可直接部署
交付文档
- MVP 交付方案文档（本文档）完整、准确
- 功能清单与实际实现一致
- 技术架构描述与实际代码一致
- 验收标准可执行、可验证
- 后续迭代路线图清晰、可落地
08风险与依赖
8.1 风险登记
| 风险项 | 等级 | 影响 | 应对措施 |
|---|---|---|---|
| AI 对话响应质量不稳定 | 高 | 用户体验差，核心价值无法验证 | MVP 阶段采用预设意图匹配 + 模板化回复保证稳定性，后续接入大模型优化 |
| 移动端语音输入兼容性 | 中 | 部分浏览器/设备不支持语音 API | 提供文字输入兜底，语音功能做能力检测，不支持时隐藏按钮 |
| 演示数据与真实业务差距大 | 中 | 潜在客户无法感知产品价值 | 按六大行业分别设计演示数据，包含真实感的客户名称、金额、阶段分布 |
| PWA 离线能力有限 | 低 | 外勤场景网络不佳时体验下降 | MVP 缓存核心页面和静态资源，数据操作做队列重试，P1 完善离线数据同步 |
| 插件安全风险 | 中 | 第三方插件可能引入安全漏洞 | MVP 仅提供官方审核插件，插件运行在沙箱环境，权限最小化原则 |
| 多语言翻译质量 | 低 | 繁中/英文文案不地道影响专业感 | 核心页面人工校对，MVP 后引入专业翻译服务 |
| 数据库性能瓶颈 | 低 | 数据量增大后查询变慢 | 核心查询字段建索引，MVP 数据量小无压力，P2 引入缓存和读写分离 |
8.2 外部依赖
- AI 大模型服务：AI 对话能力依赖大模型 API（MVP 可使用模拟回复 + 预设意图，上线前接入真实模型）。
- 语音识别服务：语音转文字依赖 Web Speech API 或第三方 ASR 服务。
- 地图服务：外勤签到和路线规划依赖地图 API（高德/百度/Google Maps）。
- 云托管平台：应用部署依赖云服务商（阿里云/腾讯云/AWS 等）。
- 邮件服务：注册验证、通知邮件依赖第三方邮件服务（SendGrid/阿里云邮件推送等）。
- 文件存储：用户头像、拜访照片等文件依赖对象存储服务（OSS/S3）。
09后续迭代路线图
MVP 交付后，按以下三个阶段持续迭代，逐步完善产品能力。
PHASE 1 · MVP 后 1-2 个月
体验增强与核心完善
- AI 语音播报（TTS）
- AI 图片理解/陈列识别
- SSO 单点登录（企业微信/钉钉/飞书）
- BI 自定义报表拖拽搭建
- 客户公海自动分配规则
- 数据迁移工具（从其他 CRM 导入）
- AI 商机评分模型优化
- 推送通知（Web Push）
- 付费订阅与支付接入
PHASE 2 · MVP 后 3-6 个月
生态建设与企业能力
- 第三方系统深度集成（ERP/财务/OA）
- 私有化部署方案
- 自定义插件开发 SDK 开放
- 移动端原生 App（iOS/Android）
- 复杂工作流引擎（审批流/自动化）
- 实时协同编辑
- 审计日志高级检索
- 高级权限（字段级/数据行级）
- 插件市场第三方开发者入驻
PHASE 3 · MVP 后 6-12 个月
智能化与平台化
- AI Agent 自主执行（自动跟进/自动写邮件）
- 预测性销售（赢单预测/流失预警）
- 行业 AI 模型微调（医药/快消等垂直模型）
- 多模态 AI（语音+图片+文档综合理解）
- 开放平台（OAuth2.0 + 完整 API 生态）
- 行业解决方案市场
- 跨国多区域部署
- AI 销售教练（对话复盘/能力评估）
- 数据驱动的行业基准报告
10附录与术语
10.1 术语表
| 术语 | 英文 | 定义 |
|---|---|---|
| MVP | Minimum Viable Product | 最小可行产品，用最少的功能验证核心价值假设的产品版本。 |
| LUI | Language User Interface | 语言用户界面，通过自然语言对话与系统交互的界面范式。 |
| GUI | Graphical User Interface | 图形用户界面，通过视觉元素（按钮/表格/图表）与系统交互。 |
| AI-Native | AI-Native | 原生 AI，产品从设计之初即以 AI 为核心能力，而非事后附加。 |
| PWA | Progressive Web App | 渐进式网页应用，可安装到桌面、支持离线缓存和推送通知的 Web 应用。 |
| Kanban | Kanban Board | 看板视图，以列表示阶段、卡片表示事项的可视化管理方式。 |
| CRM | Customer Relationship Management | 客户关系管理，管理企业与客户之间关系的系统和方法。 |
| SaaS | Software as a Service | 软件即服务，通过云端订阅方式提供的软件服务模式。 |
| TTS | Text-to-Speech | 文本转语音，将文字内容转换为语音播报的技术。 |
| ASR | Automatic Speech Recognition | 自动语音识别，将语音转换为文字的技术。 |
| SSO | Single Sign-On | 单点登录，一次认证即可访问多个系统的身份认证机制。 |
| RBAC | Role-Based Access Control | 基于角色的访问控制，通过角色分配权限的安全模型。 |
10.2 五行配色规范
土 · 背景
#F6F0E4 主背景（暖米白）#FCF8F0 卡片背景#2E2419 深色模式背景
火 · 主强调
#C8442C 主按钮 / CTA / 关键操作
白字对比度约 4.9:1，达标
木 · 次强调
#3E7A55 成功 / 正向状态
导航激活 / 完成标记 / 增长指标
金 · 点缀
#C08A3E 标签 / 勋章 / 数据高亮
警告状态 / 中级优先级
暖中性 · 文字
#3E3428 深咖（标题/正文） · #6E6353 棕灰（次要文字） · #9A8E7E 浅棕（辅助文字/占位符）。在土色背景上阅读舒适，避免纯黑的生硬感。
10.3 文档变更记录
| 版本 | 日期 | 变更内容 | 编制 |
|---|---|---|---|
| v1.0 | 2026-08-29 | MVP 交付方案首次发布，包含完整的范围、功能、架构、交付物、里程碑、验收标准、风险与路线图。 | 品应用 产品团队 |