为元宝分享红包从业者（个人、小团队、中介）提供的"手动录入-简易管理-高效分发-基础对账"轻量化工具

本系统聚焦"轻量化、可快速上线"，规避复杂的平台API对接，适配个人及3-5人小团队的手动操作场景，解决核心生意痛点。

• 目标用户: 做元宝红包代发/代收、中介倒手赚差价的个人及小团队
• 核心需求: 简化订单管理、提升群分发效率、清晰对账
• 技术约束: 无第三方平台API对接，全部手动操作适配

• 手机号+验证码登录/注册
• 密码修改/找回功能

• 元宝账号录入（支持批量导入/导出）
• 活动规则提醒（可手动编辑）
  • 每日领取上限3个
  • 3轮提现时间
  • 万元小马卡提现规则

• 订单手动录入（客户信息、红包类型、数量、金额等）
• 订单状态管理（待处理、已分发、已完成、已退款）
• 订单查询/筛选（按状态、日期、客户）
• 订单导入/导出（Excel格式）

• 供需信息录入（需求方/供给方）
• 供需匹配状态标注
• 差价手动核算（自动计算收益）

• 手动录入/批量导入群聊信息
• 群分类标注（高活跃群、客源群）

• 链接手动录入、分类存储
• 链接有效期管理

• 分发记录手动登记
• 状态标记（已分发/未分发）

• 收益手动录入
• 到账状态标记
• 多维度对账（按日期、类型、客户）

• 提现信息手动录入
• 到账状态管理

• 客户信息管理（姓名、联系方式、类型、需求备注）
• 客户标签（高频单、大额需求）
• 合作次数统计
• 客户导入/导出

• 框架: Spring Boot 3.1.5
• 数据库: MySQL 8.0+
• 缓存: Redis 7.0+
• ORM: MyBatis 3.5+
• 安全: JWT + Spring Security
• API文档: SpringDoc OpenAPI (Swagger)

• 框架: Vue 3.4+ (Composition API)
• UI组件: Element Plus 2.6+
• 构建工具: Vite 5.1+
• 状态管理: Pinia 2.1+
• 路由: Vue Router 4.3+
• 语言: TypeScript 5.4+

yb-red-mvp/
├── yb-red-mvp-backend/          # Spring Boot 后端
│   ├── src/main/java/com/cnb/ybredmvp/
│   │   ├── controller/          # 控制器层
│   │   ├── service/             # 服务层
│   │   ├── mapper/              # 数据访问层
│   │   ├── entity/              # 实体类
│   │   ├── dto/                 # 数据传输对象
│   │   ├── config/              # 配置类
│   │   └── util/                # 工具类
│   ├── src/main/resources/
│   │   ├── mapper/              # MyBatis XML 映射
│   │   └── application.yml      # 配置文件
│   ├── pom.xml                  # Maven 配置
│   └── Dockerfile               # 后端镜像构建
│
├── yb-red-mvp-frontend/         # Vue 3 前端
│   ├── src/
│   │   ├── api/                 # API 请求
│   │   ├── components/          # 公共组件
│   │   ├── views/               # 页面视图
│   │   ├── router/              # 路由配置
│   │   ├── stores/              # Pinia 状态管理
│   │   └── utils/               # 工具函数
│   ├── package.json             # npm 配置
│   ├── vite.config.ts           # Vite 配置
│   └── Dockerfile               # 前端镜像构建
│
├── docker-compose.yml           # 本地开发环境
├── schema.sql                   # 数据库初始化脚本
└── README.md                    # 项目文档

• JDK 17+
• Node.js 20+
• MySQL 8.0+
• Redis 7.0+

git clone https://github.com/your-org/yb-red-mvp.git
cd yb-red-mvp

mysql -h 192.168.5.66 -uroot -prootpassword < schema.sql

cd yb-red-mvp-backend
mvn spring-boot:run

后端服务将在 http://localhost:8088/api 启动

cd yb-red-mvp-frontend
npm install
npm run dev

前端服务将在 http://localhost:3000 启动

• 前端页面: http://localhost:3000
• 后端API: http://localhost:8088/api
• Swagger文档: http://localhost:8088/api/swagger-ui.html

1. 输入手机号（如：13800138000）
2. 输入图片验证码（点击图片可刷新）
3. 点击"登录/注册"
4. 首次登录将自动注册账号

docker-compose up

# 构建后端镜像
cd yb-red-mvp-backend
docker build -t yb-red-mvp-backend .

# 构建前端镜像
cd yb-red-mvp-frontend
docker build -t yb-red-mvp-frontend .

接口	方法	描述
/api/captcha	GET	获取图形验证码
/api/auth/login	POST	登录/注册（自动注册）
/api/auth/user-info	GET	获取用户信息

接口	方法	描述
/api/orders	GET	获取订单列表
/api/orders	POST	创建订单
/api/orders/{id}	PUT	更新订单
/api/orders/{id}	DELETE	删除订单

接口	方法	描述
/api/yuanbao-accounts	GET	获取账号列表
/api/yuanbao-accounts	POST	创建账号
/api/yuanbao-accounts/{id}	PUT	更新账号
/api/yuanbao-accounts/{id}	DELETE	删除账号

• 供需信息: /api/supply-demand
• 中介匹配: /api/intermediary-matches
• 社群管理: /api/communities
• 红包链接: /api/red-packet-links
• 分发记录: /api/distribution-records
• 收益记录: /api/revenue-records
• 提现记录: /api/withdraw-records
• 客户管理: /api/customers
• 活动规则: /api/activity-rules

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/yb_red_mvp
    username: root
    password: rootpassword
  data:
    redis:
      host: localhost
      port: 6379
      password: password

server:
  port: 8088
  servlet:
    context-path: /api

jwt:
  secret: your-secret-key
  expiration: 604800000 # 7天

server: {
  port: 3000,
  proxy: {
    '/api': {
      target: 'http://localhost:8088',
      changeOrigin: true
    }
  }
}

1. 后端:

   • 创建 Entity 实体类
   • 创建 Mapper 接口和 XML
   • 创建 Service 服务类
   • 创建 Controller 控制器
   • 添加权限验证

2. 前端:

   • 在 src/api/ 添加 API 请求
   • 在 src/views/ 创建页面组件
   • 在 src/router/ 添加路由
   • 在菜单中添加入口

• Java: 遵循阿里巴巴 Java 开发手册
• Vue: 遵循 Vue 3 风格指南
• TypeScript: 使用 strict 模式

问题: 验证码图片无法显示

解决:

• 检查后端服务是否正常启动
• 检查 Redis 连接是否正常
• 点击验证码图片可刷新

问题: 提示"验证码错误"或"验证码已过期"

解决:

• 验证码有效期为5分钟，过期需重新获取
• 验证码不区分大小写
• 登录失败后验证码会自动刷新

问题: Access denied for user 'root'@'xxx'

解决: 检查 application.yml 中的数据库密码配置

问题: Unable to connect to Redis

解决: 确认 Redis 服务已启动，检查配置中的 host 和 port

问题: API 请求被 CORS 阻止

解决: 已配置 Vite 代理和后端 CORS，检查 proxy 配置

• 无第三方平台API对接（闲鱼、微信、元宝官方）
• 无自动分发功能
• 无复杂团队协作
• 无复杂数据可视化

• 迭代1: 简易团队协作、自动生成对账报表
• 迭代2: 对接核心平台API
• 迭代3: 截流素材库、批量分发工具

欢迎提交 Issue 和 Pull Request！

MIT License

• 项目地址: https://github.com/your-org/yb-red-mvp
• 问题反馈: https://github.com/your-org/yb-red-mvp/issues

---

注意: 本系统仅供学习交流使用，请遵守相关平台规则和法律法规。