# 微信营销管理系统 MVP 演示

> 在本机模拟"销售本地处理系统 + 中央库管理系统"的完整闭环。
> 场景：toC 益生菌（小儿抗过敏）微信私域销售。

## 快速开始

```bash
# 一键启动
cd demo && bash run_demo.sh

# 浏览器访问
open http://127.0.0.1:8770

# 一键停止
bash stop_demo.sh
```

## 系统组成

| 组件 | 说明 |
|---|---|
| PostgreSQL 17 | 中央数据库，端口 5434，数据库名 `wxchat_sales` |
| mock_sync.py | 模拟 3 个销售设备的采集代理，生成微信数据并写入中央库 |
| analyze.py | AI 分析服务（规则引擎），客户识别 + 沟通摘要 |
| server.py | FastAPI 后端，11 个 API 接口 |
| index.html | Web 管理后台（仪表盘/销售/客户/聊天/成交） |

## 模拟场景

**产品**：益童宝儿童益生菌粉（298 元/盒，3 盒 798，6 盒 1499）

**3 名销售**：
- 张伟（华东团队）— 资深销售，成交率高
- 李娜（华东团队）— 新人，容易过早报价
- 王强（华南团队）— 中等水平，擅长跟进

**5 种对话场景**：
1. 湿疹宝宝咨询后成交
2. 过敏性鼻炎咨询后犹豫
3. 朋友推荐来咨询
4. 长期跟进后复购
5. 对比竞品后选择

## 文档

| 文档 | 说明 |
|---|---|
| `0-req.md` | 需求规格 |
| `1-design.md` | 技术设计 |
| `2-impl.md` | 实施计划（含测试计划） |
| `3-data-spec.md` | 模拟数据规格 |

## 测试

```bash
# 数据库测试
/usr/local/opt/postgresql@17/bin/psql -h db/socket -p 5434 -d wxchat_sales -f tests/test_db.sql

# 端到端测试
bash tests/test_e2e.sh
```

## 端口分配

| 服务 | 端口 |
|---|---|
| PostgreSQL | 5434 |
| Web 服务 | 8770 |

与现有系统（5433/8765）完全隔离。