Files

卡若 a50e79c028 银掌柜金融全案：五行文档体系、材料、投融资、落地推进等

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-13 18:16:02 +08:00

5.2 KiB

Raw Blame History

银掌柜金融 - 项目总结

基于 银掌柜.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/小程序正式发布与存客宝联调。

5.2 KiB Raw Blame History Unescape Escape