01Product概述
1.1 Product定位
PWM CRM 是一款面向垂直行业外勤销售场景的 AI-Native CRM + 销售外勤Assistant。Product以"场景感知下的 GUI + LUI 融合交互 + Voice Interaction"为核心交互范式，参考 ChatGPT 双栏布局，通过Plugin-based架构扩展能力，帮助快消、医药、建材、设备、保险、农业等行业的外勤销售团队实现Client管理、拜访执行、数据洞察的全流程Smart化。
1.2 Target Users
Field Sales Reps
每天奔波于Client之间的一线销售人员，需要High效的Client管理、拜访规划和 AI 辅助工具。核心诉求：减少填表时间、提升拜访效率、获得Smart跟进建议。
销售管理者
Sales Directors、区域经理等管理人员，需要实时掌握团队业绩、Field Efficiency和Client健康度。核心诉求：数据可视化、Anomaly Alerts、团队效能分析。
企业 IT/运营
负责系统选型和部署的信息化Owner，需要安全、Scalable、易集成的 SaaS 平台。核心诉求：Data Security、权限管理、API 集成、Private Deployment。
Medium小企业主
10-200 人规模的垂直行业企业决策者，需要开箱即用、性价比High的销售管理工具。核心诉求：快速上线、操作简单、投入产出比High。
1.3 Core Value主张
- AI战略师随行：每一位外勤销售都拥有 7×24 小时在线的 AI 销售军师，自然语言即可查询数据、生成报告、获取建议。
- Field Efficiency革命：SmartRoute Planning、语音拜访纪要、AI 陈列识别，将外勤代表从繁琐的行政工作Medium解放，聚焦Client关系。
- 垂直行业深耕：不做通用 CRM，而是为快消、医药、建材等外勤密集行业提供量身定制的业务流程和数据模型。
- Plugin-basedScalable：核心平台 + Plugin Ecosystem，企业按需安装行业插件和功能插件，系统随业务成长。
02MVP Scope Definition
MVP 版本聚焦验证Core Value假设：AI 对话驱动的 CRM + 外勤管理是否能显著提升外勤销售效率。以下为明确的范围边界。
MVP 包含（In Scope）
- ✓用户注册/Sign In/团队管理（基础多租户）
- ✓AI 对话工作台（豆包风格空Status + 对话流）
- ✓Natural Language QueryClient/商机/业绩数据
- ✓CRM Client管理（列表/详情/联系人/Follow-up Records）
- ✓商机 Kanban 看板（拖拽流转）
- ✓外勤拜访（签到/路线/报告）
- ✓数据看板（销售漏斗/业绩/Field Efficiency）
- ✓插件Medium心（浏览/安装/配置，预置 6+ 插件）
- ✓系统Settings（个人资料/通知/API Key）
- ✓语音输入（语音转文字）
- ✓三语Internationalization（简Medium/繁Medium/英文）
- ✓Responsive Design（PC/平板/Mobile App）
- ✓深色/浅色主题
- ✓营销官网（7 个独立 HTML 页面 + SEO）
- ✓演示数据填充（开箱可体验）
MVP Not Included（Out of Scope）
- ✗AI Voice Broadcast（TTS）— P1 迭代
- ✗AI 图片理解/陈列识别 — P1 迭代
- ✗第三方系统深度集成（ERP/财务/OA）— P2
- ✗SSO 单点Sign In（SAML/OAuth）— P1 迭代
- ✗Private Deployment — Enterprise专属，P2
- ✗自定义插件开发 SDK — P2 迭代
- ✗Mobile App原生 App（iOS/Android）— P2，MVP 用 PWA
- ✗复杂工作流引擎（审批流/Auto化流）— P2
- ✗BI Custom Reports拖拽搭建 — P1 迭代
- ✗Client公海Auto分配规则 — P1 迭代
- ✗实时协同Edit/多人同时操作 — P2
- ✗付费支付/订阅计费系统 — 上线前接入
- ✗数据迁移工具（从其他 CRM 导入）— P1
- ✗Audit LogHigh级检索 — Enterprise，P2
03Core Features清单
按模块划分的 MVP 功能清单，标注Priority（P0 = 必须有，P1 = 应该有，P2 = 可以有）。
| 模块 | 功能点 | 描述 | Priority |
|---|---|---|---|
| 认证与团队 | 注册/Sign In | Email/手机号注册Sign In，忘记密码 | P0 |
| 团队管理 | 创建组织、邀请成员、成员列表 | P0 | |
| Role Permissions | 管理员/经理/代表三级角色，基础数据权限 | P1 | |
| AI 对话工作台 | 豆包风格空Status | 居Medium大输入框 + Recommended问题卡片 + 品牌欢迎区 | P0 |
| 对话流 | 消息气泡、AI 打字效果、流式输出 | P0 | |
| Natural Language Query | 查询Client/商机/业绩，返回 GUI 结构化结果 | P0 | |
| 语音输入 | 语音转文字，Mobile App优化 | P1 | |
| 会话历史 | 侧边栏会话列表、Search、新建对话 | P0 | |
| 场景感知建议 | 根据当前页面上下文Recommended快捷操作 | P1 | |
| CRM Client管理 | Client列表 | 表格视图、Filter、Sort、Search、批量操作 | P0 |
| Client详情 | 360° 画像、基本信息、联系人、商机、跟进时间线 | P0 | |
| 商机看板 | Kanban 视图、拖拽流转Phase、列表视图切换 | P0 | |
| Contact Management | 联系人增删改查、关联Client | P0 | |
| Follow-up Records | 记录Add、时间线展示、关联Client/商机 | P0 | |
| 销售外勤 | 拜访计划 | 今日拜访列表、时间安排、Client信息 | P0 |
| Route Planning | 多Client最优路线计算（演示版） | P1 | |
| Check-in | 位置签到、拍照上传（演示版） | P0 | |
| Visit Reports | AI 生成纪要模板、待办事项提取 | P1 | |
| 数据看板 | 销售漏斗 | 各Phase商机数量、转化率图表 | P0 |
| Performance Tracking | 目标 vs 实际、Team Ranking、趋势图 | P0 | |
| Field Efficiency | 拜访量、覆盖率、有效拜访率 | P1 | |
| 插件Medium心 | 插件列表 | 已安装/市场插件浏览 | P0 |
| 安装/卸载 | 插件一键安装启用/停用卸载 | P0 | |
| 插件配置 | 已安装插件的参数配置页面 | P1 | |
| 系统Settings | 个人资料 | 头像、Name、Contact Information、密码修改 | P0 |
| 通知Settings | 邮件/站内/推送通知开关 | P1 | |
| API Key | API 密钥生成、View、撤销 | P1 | |
| 通用能力 | Internationalization | 简Medium/繁Medium/英文三语切换 | P0 |
| 主题 | 浅色/深色/跟随系统 | P0 | |
| 响应式 | PC/平板/Mobile App自适应 | P0 |
3.1 功能统计
P0 必须有
22 项
Core Value闭环，MVP 必须交付
P1 应该有
11 项
增强体验，MVP 尽量交付
Module
9 个
覆盖认证、AI、CRM、外勤、看板等
演示数据
200+ 条
Client、联系人、商机、跟进、外勤记录
04Technical Architecture
4.1 架构总览
Client端层 / 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 / Infrastructure
云托管部署
HTTPS / TLS 1.3
CDN 静态Resources加速
日志与监控
4.2 Database表设计
| 表名 | 用途 | 核心字段 |
|---|---|---|
| users | 用户表 | id, email, phone, password_hash, name, avatar, role, org_id, locale, theme |
| organizations | 组织/租户表 | id, name, industry, size, plan, created_at |
| customers | Client表 | 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 | Follow-up Records表 | 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 | Store Inspection表 | id, visit_id, items (JSON), score, photos, status |
4.3 技术选型理由
- React 19：组件化开发、生态成熟、社区活跃，适合构建复杂的 SPA 应用；Server Components 等新特性为后续性能优化留空间。
- Tailwind CSS 4 + shadcn/ui：原子化 CSS 快速构建一致的 UI，shadcn/ui 提供可定制的High质量组件，Five Elements Color方案易于落地。
- NestJS：基于 TypeScript 的企业级 Node 框架，模块化架构清晰，依赖注入便于测试和扩展，适合全栈 SaaS 后端。
- Drizzle ORM + PostgreSQL：轻量级类型安全 ORM，SQL 优先，性能优秀；PostgreSQL Supports复杂查询和 JSON 字段，适合 CRM 数据模型。
- PWA：MVP Phase不开发原生 App，通过 PWA 实现可安装、离线缓存、推送通知，降Low开发成本同时覆盖Mobile App需求。
05Deliverables
1
营销官网 已交付
7 个独立 HTML 页面（Home/功能/行业/AI/Pricing/关于/联系）+ sitemap.xml + robots.txt，完整 SEO 元数据，Five Elements Color，Responsive Design。可直接部署到任何静态托管。
2
全栈 SaaS 系统 已交付
React 19 + NestJS + PostgreSQL 全栈应用，包含Sign In认证、AI 对话工作台、CRM Client管理、商机看板、外勤管理、数据看板、插件Medium心、系统Settings 8 大模块。
3
AI Assistant响应式优化 已交付
PC 端三栏布局（会话栏+对话区+结果面板），Mobile App单栏+抽屉Menu，输入框安全区适配，GUI 结果响应式展示，平板端过渡布局。
4
豆包风格新建对话页 已交付
空Status居Medium大输入框 + 品牌欢迎区 + 2×2 Recommended问题卡片，Send后Auto切换对话流，入场动画，Mobile App单列适配。
5
演示数据 已交付
44 Client、60 联系人、45 商机（各Phase分布）、37 Follow-up Records、30 外勤拜访、12 插件，开箱即可体验完整业务流。
6
MVP Delivery Plan文档 已交付
本文档：Product概述、Scope Definition、功能清单、Technical Architecture、Deliverable、Milestones、Acceptance Criteria、风险、路线图。
7
部署与运维指南 待补充
环境变量配置、Database迁移、构建部署步骤、监控告警配置、备份恢复方案。MVP 上线前补充。
8
用户使用手册 待补充
面向终端用户的操作指南，包含各模块功能说明、FAQ、最佳实践。MVP 上线前补充。
06Milestones与时间线
以下为 MVP 从启动到交付的Milestones规划（实际Completed，此处为复盘记录）。
第 1 周 · 需求与设计
Product定义与设计规范
- 完成Product定位、Target Users、Core Value主张定义
- 确定Five Elements Color设计体系（土/火/木/金/暖Medium性）
- 确定 GUI + LUI 融合交互范式与豆包风格对话框
- 完成 MVP Scope Definition与功能PrioritySort
- 确定技术栈：React 19 + NestJS + PostgreSQL
第 2-3 周 · 官网与基础架构
营销官网 + 全栈基础架构
- 完成 7 页营销官网（独立 HTML + SEO）
- 搭建全栈项目骨架：React 前端 + NestJS 后端 + Database
- 完成用户认证模块（注册/Sign In/JWT）
- 完成团队/组织管理基础模块
- 完成三语Internationalization框架与主题切换框架
第 4-5 周 · 核心业务模块
CRM + 外勤 + 看板Core Features
- 完成 CRM Client管理（列表/详情/联系人/Follow-up Records）
- 完成商机 Kanban 看板（拖拽流转）
- 完成外勤拜访模块（计划/签到/报告）
- 完成数据看板（销售漏斗/业绩/Field Efficiency图表）
- 完成插件Medium心（浏览/安装/配置）
- 填充演示数据（200+ 条业务数据）
第 6 周 · AI Capabilities与体验优化
AI 对话工作台 + 响应式优化
- 完成 AI 对话工作台（双栏布局、对话流、会话历史）
- 完成豆包风格新建对话空Status（大输入框+Recommended卡片）
- 完成Natural Language Query返回 GUI 结构化结果
- 完成语音输入（语音转文字）
- PC/平板/Mobile App响应式全面优化
- AI Assistant页面Mobile App抽屉Menu、安全区适配
第 7 周 · 测试与交付
全链路测试 + MVP 交付
- 全链路功能测试（认证→AI→CRM→外勤→看板→插件→Settings）
- 三语切换测试、深浅主题测试、多设备响应式测试
- 后端 API Interface测试（增删改查链路）
- 性能与加载体验优化
- 编写 MVP Delivery Plan文档（本文档）
- 正式交付 MVP 版本
07Acceptance Criteria
MVP 交付验收按以下维度逐项检查，All通过视为交付合格。
功能完整性
- 9 大模块All可访问、可操作，无空白页面
- P0 功能（22 项）All实现并可正常使用
- P1 功能（11 项）至少 80% 实现
- 核心业务流程闭环：注册→创建Client→创建商机→外勤拜访→View看板
- AI 对话可正常发起、返回结果、历史可查
用户体验
- PC 端（1920×1080）布局完整，无元素溢出或重叠
- Mobile App（375×812）可正常操作，输入框不被键盘遮挡
- 平板端（768×1024）过渡布局合理
- 页面首屏加载 ≤ 3 秒（正常网络环境）
- 所有交互有明确反馈（hover/active/loading/success/error）
- 表单有验证提示，空Status有引导文案
设计一致性
- 严格遵循Five Elements Color方案（土底/火强调/木正向/金点缀/暖Medium性文字）
- 深色/浅色模式下均有良好对比度和可读性
- 三语（简Medium/繁Medium/英文）下文案不溢出、不错位
- 组件风格统一（按钮、卡片、表单、表格、弹窗）
- 字号、间距、圆角、阴影遵循统一设计规范
数据与安全
- 演示数据完整：44 Client、60 联系人、45 商机、37 跟进、30 外勤
- 数据增删改查操作有真实持久化（刷新后数据保留）
- 用户密码加密存储（bcrypt/argon2）
- JWT Token 认证，未Sign In用户无法访问业务页面
- 多租户数据隔离，不同组织数据不可互访
- API Interface有基础参数校验和错误处理
Website & SEO
- 7 HTML pages, all independently accessible, linked between pages
- Each page has its own title, meta description, and canonical
- Open Graph / Twitter Card tags fully implemented
- JSON-LD structured data is correct
- Semantic HTML5 tags (header/nav/main/section/article/footer)
- sitemap.xml includes all pages, robots.txt configured correctly
- No local resource paths, ready for direct deployment
Delivery Docs
- MVP Delivery Plan doc (this document) is complete and accurate
- Feature list matches actual implementation
- Technical Architecture description aligns with actual code
- Acceptance Criteria are executable and verifiable
- Subsequent Iteration Roadmap is clear and actionable
08风险与依赖
8.1 Risk Register
| 风险项 | 等级 | 影响 | Mitigation |
|---|---|---|---|
| AI 对话响应质量不稳定 | High | 用户体验差，Core Value无法验证 | MVP Phase采用预设意图匹配 + 模板化回复保证稳定性，后续接入大模型优化 |
| Mobile App语音输入兼容性 | Medium | 部分浏览器/设备不Supports语音 API | 提供文字输入兜底，语音功能做能力检测，不Supports时隐藏按钮 |
| 演示数据与真实业务差距大 | Medium | 潜在Client无法感知Product价值 | 按六大行业分别设计演示数据，包含真实感的Client名称、金额、Phase分布 |
| PWA 离线能力有限 | Low | 外勤场景网络不佳时体验下降 | MVP 缓存核心页面和静态Resources，数据操作做队列重试，P1 完善离线数据同步 |
| 插件Security Risk | Medium | Third-party Plugins可能引入安全漏洞 | MVP 仅提供官方审核插件，插件运行在沙箱环境，权限最小化原则 |
| 多语言翻译质量 | Low | 繁Medium/英文文案不地道影响专业感 | 核心页面人工校对，MVP 后引入专业翻译服务 |
| Database性能瓶颈 | Low | 数据量增大后查询变慢 | 核心查询字段建索引，MVP 数据量小无压力，P2 引入缓存和读写分离 |
8.2 External Dependencies
- AI 大模型服务：AI 对话能力依赖大模型 API（MVP 可使用模拟回复 + 预设意图，上线前接入真实模型）。
- Speech Recognition服务：语音转文字依赖 Web Speech API 或第三方 ASR 服务。
- 地图服务：外勤签到和Route Planning依赖地图 API（High德/百度/Google Maps）。
- 云托管平台：应用部署依赖云服务商（阿里云/腾讯云/AWS 等）。
- 邮件服务：注册验证、通知邮件依赖第三方邮件服务（SendGrid/阿里云邮件推送等）。
- 文件存储：用户头像、拜访照片等文件依赖对象存储服务（OSS/S3）。
09后续Iteration Roadmap
MVP 交付后，按以下三个Phase持续迭代，逐步完善Product能力。
PHASE 1 · MVP 后 1-2 个月
体验增强与核心完善
- AI Voice Broadcast（TTS）
- AI 图片理解/陈列识别
- SSO 单点Sign In（企业微信/钉钉/飞书）
- BI Custom Reports拖拽搭建
- Client公海Auto分配规则
- 数据迁移工具（从其他 CRM 导入）
- AI 商机Scoring模型优化
- 推送通知（Web Push）
- 付费订阅与支付接入
PHASE 2 · MVP 后 3-6 个月
生态建设与企业能力
- 第三方系统深度集成（ERP/财务/OA）
- Private Deployment方案
- 自定义插件开发 SDK 开放
- Mobile App原生 App（iOS/Android）
- 复杂工作流引擎（审批流/Auto化）
- 实时协同Edit
- Audit LogHigh级检索
- High级权限（字段级/数据行级）
- Plugin Marketplace第三方开发者入驻
PHASE 3 · MVP 后 6-12 个月
Smart化与平台化
- AI Agent 自主执行（Auto跟进/Auto写邮件）
- 预测性销售（Win Prediction/Churn Alerts）
- 行业 AI 模型微调（医药/快消等垂直模型）
- 多模态 AI（语音+图片+文档综合理解）
- 开放平台（OAuth2.0 + 完整 API 生态）
- 行业Solutions市场
- 跨国多区域部署
- AI 销售教练（对话复盘/能力评估）
- 数据驱动的行业基准报告
10Appendix与术语
10.1 Glossary
| 术语 | 英文 | 定义 |
|---|---|---|
| MVP | Minimum Viable Product | 最小可行Product，用最少的功能验证Core Value假设的Product版本。 |
| LUI | Language User Interface | 语言用户界面，通过自然语言对话与系统交互的界面范式。 |
| GUI | Graphical User Interface | 图形用户界面，通过视觉元素（按钮/表格/图表）与系统交互。 |
| AI-Native | AI-Native | 原生 AI，Product从设计之初即以 AI 为核心能力，而非事后附加。 |
| PWA | Progressive Web App | Progressive Web App，可安装到桌面、Supports离线缓存和推送通知的 Web 应用。 |
| Kanban | Kanban Board | 看板视图，以列表示Phase、卡片表示事项的可视化管理方式。 |
| CRM | Customer Relationship Management | Client关系管理，管理企业与Client之间关系的系统和方法。 |
| SaaS | Software as a Service | 软件即服务，通过云端订阅方式提供的软件服务模式。 |
| TTS | Text-to-Speech | 文本转语音，将文字内容转换为Voice Broadcast的技术。 |
| ASR | Automatic Speech Recognition | AutoSpeech Recognition，将语音转换为文字的技术。 |
| SSO | Single Sign-On | 单点Sign In，一次认证即可访问多个系统的身份认证机制。 |
| RBAC | Role-Based Access Control | 基于角色的访问控制，通过角色分配权限的安全模型。 |
10.2 五行Color Specification
土 · 背景
#F6F0E4 主背景（暖米白）#FCF8F0 卡片背景#2E2419 深色模式背景
火 · 主强调
#C8442C 主按钮 / CTA / 关键操作
白字对比度约 4.9:1，达标
木 · 次强调
#3E7A55 成功 / 正向Status
导航激活 / 完成标记 / 增长指标
金 · 点缀
#C08A3E 标签 / 勋章 / 数据High亮
警告Status / Medium级Priority
暖Medium性 · 文字
#3E3428 深咖（标题/正文） · #6E6353 棕灰（次要文字） · #9A8E7E 浅棕（辅助文字/占位符）。在土色背景上阅读舒适，避免纯黑的生硬感。
10.3 文档Change Log
| 版本 | 日期 | 变更内容 | 编制 |
|---|---|---|---|
| v1.0 | 2026-08-29 | MVP Delivery Plan首次发布，包含完整的范围、功能、架构、Deliverable、Milestones、Acceptance Criteria、风险与路线图。 | PWM CRM Product团队 |