113 lines
5.2 KiB
Markdown
113 lines
5.2 KiB
Markdown
# 银掌柜金融 - 项目总结
|
||
|
||
> 基于 `银掌柜.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/小程序正式发布与存客宝联调。
|