# 银掌柜金融 - 项目总结

> 基于 `银掌柜.md` 对话记录整理，便于快速了解项目全貌。

---

## 一、项目定位

**银掌柜**是一个面向金融业务的**分销裂变 + 内容分发 + 客资获取**体系，包含：

- **微信小程序**：内容分发、产品展示、手机授权获客、分享绑定收益
- **管理后台**：客资/产品/股东管理、数据统计、分润排行榜、存客宝对接
- **后端 API**：FastAPI，支持客资、产品、分销、30 天绑定等

**核心目标**：通过内容分发与分销裂变获取客资，并与存客宝对接；股东可绑定收益（30 天机制）。

---

## 二、商业模式与套餐

| 股东级别     | 价格    | 渠道分润 | 平台分润 | 说明           |
|-------------|---------|----------|----------|----------------|
| 创业包股东   | 6,980元 | 20%      | 30%      | 可补差价升级   |
| 平台股东     | 19,800元| 20%      | 40%      | 资金业务分润   |
| 分公司股东   | 98,000元| 20%      | 50%      | 全业务线分润   |

**升级路径**：创业包 → 3 人裂变/补差价 → 平台股东 → 补差价 → 分公司股东。

---

## 三、分销与获客逻辑

- **30 天绑定**：谁发的链接，进的人就绑谁；仅一级分销，绑定有效期 30 天；持续发的人绑定一直有效。
- **获客方式**：点击「立即咨询」→ 微信一键授权/手动填写 → 提交到银掌柜 API → 可同步到存客宝（需配置 AppID/Secret）。
- **产品分享**：每个产品支持「分享赚钱」；分享链接带推荐码，好友成交自动绑定分润；分享前需登录小程序。

---

## 四、技术架构

| 端       | 技术栈           | 说明 |
|----------|------------------|------|
| 小程序   | 微信小程序（JS） | 首页、热门产品、我的、股东页；橙金/金色主题 |
| 管理后台 | Next.js 14       | 仪表盘、客资/产品/股东/数据统计、系统设置 |
| 后端 API | FastAPI          | 产品、客资、分销绑定、存客宝同步、管理端接口 |
| 数据库   | MongoDB / MySQL  | 支持迁移到腾讯云 MySQL（schema_mysql.sql + db_mysql.py） |

**设计风格**：参考招商页与银掌柜 VI，橙金渐变 + 卡片式布局；管理后台统一橙金风格。

---

## 五、项目结构（银掌柜小程序仓库）

```
银掌柜小程序/
├── miniprogram/     # 微信小程序
│   ├── pages/index/      # 首页
│   ├── pages/product/    # 产品详情（获客入口）
│   ├── pages/hot/        # 热门产品
│   ├── pages/profile/    # 我的（推广中心、股东入口）
│   └── pages/shareholder/ # 成为股东
├── admin/           # Next.js 管理后台
├── api/             # FastAPI 后端（main.py）
├── deploy/          # 部署脚本（宝塔 API、Nginx、Node 项目）
└── docs/            # 需求、架构、部署文档
```

---

## 六、管理后台功能概览

- **数据看板**：今日客资、咨询、收入等
- **客资管理**：列表、新建/编辑/详情、导入、清洗、跟进记录
- **产品管理**：列表、新建/编辑、上架下架（与小程序互通）
- **股东管理**：股东列表、详情（绑定用户+获客记录）、分润排行榜
- **数据统计**：概览、趋势、来源分布、产品热度
- **系统设置**：存客宝 AppID/Secret、小程序配置、分润配置
- **登录**：账号 `admin`，密码 `K123456`

---

## 七、部署与访问

- **域名**：`yzg.quwanzhi.com`
- **部署方式**：宝塔面板（Nginx 反向代理 + Node 项目 yzg_admin + nohup 起 API）；脚本见 `deploy/auto_full.py`、`deploy/fix_404.py`
- **访问**：管理后台 `http://yzg.quwanzhi.com`，API 通过同域名 `/api` 或直连 3080
- **小程序**：API 地址配置为 `https://yzg.quwanzhi.com`；测试号 AppID 已配置（如 wx0976665c3a3d5a7c）

---

## 八、数据与对接

- **真实数据**：对话中已生成 1015 条厦门本地客资（含 RFM）、5 名股东（卡若/叶静静/吉米语/叶倩茹/洛轩）、绑定与分润关系，用于界面真实可测。
- **存客宝**：后端集成存客宝 API（https://ckbapi.quwanzhi.com/doc/api_v1.md），客资可同步；需在后台「系统设置」配置 AppID/Secret。

---

## 九、关键文档与脚本

| 文件/目录         | 用途 |
|-------------------|------|
| 银掌柜.md         | 完整对话导出（本总结的来源） |
| deploy/auto_full.py | 全自动部署（Nginx + 服务 + 宝塔 Node 项目） |
| deploy/fix_404.py  | 仅修 404（写 Nginx + 启动服务） |
| deploy/MYSQL_MIGRATION.md | MongoDB → 腾讯云 MySQL 迁移说明 |
| api/schema_mysql.sql、api/db_mysql.py | MySQL 表结构与异步访问层 |

---

## 十、小结

银掌柜是一套「小程序 + 管理后台 + FastAPI」的金融获客与分销系统：前端以橙金主题、简洁获客与 30 天绑定为核心；后台统一风格、客资/产品/股东/统计齐全，并与存客宝对接；部署以宝塔为主（Nginx + Node 项目），无 PM2，网站可正常访问。后续可重点做：MySQL 完全切换、数据迁移、以及 HTTPS/小程序正式发布与存客宝联调。