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 交付方案首次發布，包含完整的范圍、功能、架构、交付物、裡程碑、验收标准、風險与路线圖。 | 品應用 產品團隊 |