多多多宝后台管理系统功能清单

后台管理系统功能模块和页面设计
生成时间：2025-10-09
技术方案：若依框架二次开发
目标：为运营人员提供完整的管理功能

📌 更新日志

v2.0 (2025-10-09)

✅ 技术方案调整：从Django Admin更新为若依框架二次开发
✅ 技术栈更新：SpringBoot + Vue3 + Element Plus + MyBatis
✅ 开发规范更新：采用若依框架代码规范和开发流程
✅ 增加代码生成器使用指南：快速开发CRUD功能
✅ 增加若依框架常用功能示例：日志、缓存、权限等
✅ 优化开发步骤：明确准备阶段、核心功能、扩展功能、优化完善
✅ 增加快速开发检查清单：规范开发流程

v1.0 (2025-10-09)

初始版本，基于Django Admin技术方案

系统概述

后台管理系统目标

用户管理：管理所有注册用户，查看用户详情，处理违规账号
订单管理：查看和管理淘宝客订单，监控订单同步状态
财务管理：处理提现申请，查看资金流水，财务对账
代理管理：审核代理申请，管理城市代理
内容管理：管理轮播图、活动、问题等内容
数据统计：查看平台运营数据和报表

技术实现方案

采用方案：若依框架二次开发（推荐，已确定）✅

框架介绍：

若依（RuoYi）是一套基于 SpringBoot + Vue3 的前后端分离权限管理系统
- 后端：SpringBoot 2.x + MyBatis + Shiro/Spring Security
- 前端：Vue 3 + Element Plus
- 已集成：代码生成器、权限管理、定时任务、操作日志等

技术栈明细：

java

后端技术：
- SpringBoot 2.x          // 核心框架
- MyBatis + MyBatis-Plus  // ORM框架
- Spring Security         // 权限认证
- JWT                     // Token验证
- Druid                   // 数据库连接池
- Redis                   // 缓存
- Quartz                  // 定时任务（订单同步）
- POI/EasyExcel          // Excel导入导出
- FastDFS/OSS            // 文件存储

javascript

前端技术：
- Vue 3                   // 渐进式框架
- Element Plus           // UI组件库
- Vite                   // 构建工具
- Axios                  // HTTP请求
- ECharts                // 图表统计
- Pinia                  // 状态管理

核心优势：

✅ 开箱即用
- 完善的权限管理（角色、菜单、按钮级别）
- 内置代码生成器，快速生成CRUD代码
- 自带操作日志、登录日志记录
- 完整的字典管理、参数配置

✅ 二开便捷
- 清晰的项目结构，易于理解
- 详细的代码注释和文档
- 模块化设计，便于扩展
- 支持多数据源

✅ 生产就绪
- 经过大量项目验证
- 性能优化完善
- 安全机制健全
- 社区活跃，问题易解决

项目结构：

duoduo_server/          # 后端项目（Java）
├── ruoyi-admin/       # 管理后台模块
├── ruoyi-common/      # 通用工具模块
├── ruoyi-framework/   # 框架核心模块
├── ruoyi-generator/   # 代码生成模块
├── ruoyi-quartz/      # 定时任务模块
└── ruoyi-system/      # 系统模块（新增多多客业务）

duoduo_ui/             # 后台前端项目（Vue3）
├── src/
│   ├── api/          # 接口定义
│   ├── views/        # 页面视图
│   ├── components/   # 公共组件
│   └── router/       # 路由配置

开发方式：

1. 使用代码生成器
   - 设计数据库表
   - 配置生成参数
   - 一键生成前后端代码
   - 微调业务逻辑

2. 自定义开发
   - Controller：处理HTTP请求
   - Service：业务逻辑层
   - Mapper：数据访问层
   - 前端：Vue组件 + API调用

备选方案：从零开发（不推荐）

如果有特殊需求，也可考虑：
- Spring Boot + Vue 3 从零搭建
- Django + Vue Admin

缺点：
- 开发周期长（需3-6个月）
- 需要自行实现权限、日志等基础功能
- 维护成本高
- 安全性需要自行保障

权限角色设计

角色定义

角色	权限范围	说明
超级管理员	全部权限	系统最高权限，可管理其他管理员
运营管理员	用户管理、内容管理、代理审核	负责日常运营工作
财务管理员	财务管理、提现审核、报表查看	负责财务相关工作
客服人员	用户查询、订单查询、问题管理	负责客户服务

权限表设计

sql

-- 管理员表（扩展版）
CREATE TABLE `pdd_admin` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL COMMENT '用户名',
  `password` varchar(255) NOT NULL COMMENT '密码（bcrypt加密）',
  `real_name` varchar(50) DEFAULT NULL COMMENT '真实姓名',
  `role` tinyint(4) DEFAULT 0 COMMENT '角色：0=超级管理员/1=运营/2=财务/3=客服',
  `status` tinyint(4) DEFAULT 0 COMMENT '状态：0=正常/1=禁用',
  `last_login_time` datetime DEFAULT NULL COMMENT '最后登录时间',
  `last_login_ip` varchar(50) DEFAULT NULL COMMENT '最后登录IP',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员表';

-- 操作日志表（新增）
CREATE TABLE `pdd_admin_log` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `admin_id` int(11) NOT NULL COMMENT '管理员ID',
  `admin_name` varchar(50) NOT NULL COMMENT '管理员名称',
  `action` varchar(100) NOT NULL COMMENT '操作类型',
  `content` text COMMENT '操作内容',
  `ip` varchar(50) DEFAULT NULL COMMENT '操作IP',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '操作时间',
  PRIMARY KEY (`id`),
  KEY `idx_admin_id` (`admin_id`),
  KEY `idx_create_time` (`create_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员操作日志';

功能模块清单

1. 登录与认证模块

1.1 管理员登录

功能描述：管理员账号密码登录

页面路径：/admin/login

功能点：

用户名+密码登录
记住密码功能
验证码验证（防止暴力破解）
登录日志记录

接口：

POST /admin/auth/login
{
  "username": "admin",
  "password": "******",
  "captcha": "1234"
}

1.2 修改密码

页面路径：/admin/profile/password

功能点：

修改当前管理员密码
旧密码验证
密码强度校验

2. 首页仪表盘

2.1 数据概览

页面路径：/admin/dashboard

展示内容：

用户统计
- 总用户数
- 今日新增用户
- 本月新增用户
- 活跃用户数
订单统计
- 总订单数
- 今日订单数
- 本月订单数
- 订单总金额
收益统计
- 总佣金金额
- 已结算金额
- 待结算金额
- 今日收益
提现统计
- 待审核提现
- 今日提现金额
- 本月提现金额

2.2 数据图表

用户增长趋势图（折线图）
订单量趋势图（柱状图）
收益分布图（饼图）
代理分布地图

2.3 待办事项

待审核提现申请（红点提醒）
待审核代理申请（红点提醒）
待处理物料申请
系统通知

接口：

GET /admin/dashboard/statistics
返回所有统计数据

GET /admin/dashboard/charts?type=user_growth&start_date=2024-01-01&end_date=2024-01-31
返回图表数据

3. 用户管理模块

3.1 用户列表

页面路径：/admin/users

功能点：

用户列表展示（分页）
搜索功能
- 按手机号搜索
- 按昵称搜索
- 按邀请码搜索
- 按用户ID搜索
筛选功能
- 按用户等级筛选（普通/合伙人/高级总监/市代理）
- 按注册时间筛选
- 按账号状态筛选（正常/禁用）
排序功能
- 按注册时间排序
- 按累计收益排序
- 按团队人数排序

列表字段：

字段	说明
用户ID	id
头像	avatar
昵称	nickname
手机号	username（脱敏显示：188****0000）
邀请码	invitation_code
用户等级	level_id（显示文本）
累计收益	从pdd_money统计
团队人数	从pdd_user统计
注册时间	reg_time
状态	status（正常/禁用）
操作	查看详情/编辑/禁用/启用

接口：

GET /admin/users?page=1&page_size=20&keyword=&level_id=&status=&sort_by=reg_time&sort_order=desc

3.2 用户详情

页面路径：/admin/users/{id}

展示内容：

基本信息

用户ID、头像、昵称、手机号
邀请码、推广位ID（relation_id）
用户等级、注册时间、最后登录时间
支付宝账号、真实姓名
所在城市

团队信息

邀请人信息
直属下级数量
团队总人数
团队层级结构（树形展示）

收益信息

累计收益
可用余额
冻结金额
已提现金额
收益明细（列表，可查看）

订单信息

订单总数
订单总金额
订单列表（最近10条，可查看更多）

操作记录

登录记录
提现记录
晋升记录

操作按钮：

编辑用户信息
修改用户等级
禁用/启用账号
查看团队详情
查看收益明细
查看订单列表

接口：

GET /admin/users/{id}
返回用户完整信息

GET /admin/users/{id}/team
返回团队信息

GET /admin/users/{id}/income
返回收益信息

GET /admin/users/{id}/orders
返回订单列表

3.3 编辑用户

功能点：

修改昵称
修改手机号
修改支付宝账号
修改真实姓名
修改用户等级
修改账号状态

接口：

PUT /admin/users/{id}
{
  "nickname": "新昵称",
  "level_id": 2,
  "status": 0
}

3.4 批量操作

功能点：

批量禁用/启用
批量导出用户数据

4. 订单管理模块

4.1 订单列表

页面路径：/admin/orders

功能点：

订单列表展示（分页）
搜索功能
- 按订单号搜索
- 按用户ID搜索
- 按商品名称搜索
筛选功能
- 按订单状态筛选（已付款/已结算/失效/成功）
- 按下单时间筛选
- 按结算时间筛选
排序功能
- 按下单时间排序
- 按订单金额排序
- 按佣金金额排序

列表字段：

字段	说明
订单ID	id
淘宝订单号	trade_id
商品图片	pict_url
商品标题	item_title（截断显示）
用户昵称	关联用户表
订单金额	pay_price
佣金	commission
推广者收益	pub_share_pre_fee
订单状态	tk_status
下单时间	create_time
结算时间	earning_time
操作	查看详情

接口：

GET /admin/orders?page=1&page_size=20&keyword=&status=&start_time=&end_time=

4.2 订单详情

页面路径：/admin/orders/{id}

展示内容：

订单基本信息（订单号、商品信息、金额等）
用户信息（推广者信息）
佣金分成明细（推广者、上级、上上级、代理）
订单状态流转记录
关联的资金流水记录

接口：

GET /admin/orders/{id}
返回订单详细信息

GET /admin/orders/{id}/commission_detail
返回佣金分成明细

4.3 订单同步管理

页面路径：/admin/orders/sync

功能点：

手动触发订单同步
查看同步日志
同步状态监控
异常订单处理

接口：

POST /admin/orders/sync
手动触发订单同步

GET /admin/orders/sync_logs
查看同步日志

5. 财务管理模块

5.1 提现管理

5.1.1 提现申请列表

页面路径：/admin/withdraw

功能点：

提现申请列表（分页）
按状态筛选（待审核/已通过/已拒绝）
按申请时间筛选
搜索用户

列表字段：

字段	说明
提现ID	id
系统订单号	order_id
用户昵称	关联用户表
手机号	脱敏显示
提现金额	money
实际到账	realmoney
微信昵称	user_account
申请时间	submit_time
状态	status（待审核/成功/失败）
操作	查看详情/审核

接口：

GET /admin/withdraw?page=1&page_size=20&status=0

5.1.2 提现审核

页面路径：/admin/withdraw/{id}/review

功能点：

查看提现详情
审核操作
- 通过：调用微信企业付款到零钱API，实时到账
- 拒绝：填写拒绝原因，退回余额
查看用户余额
查看用户提现历史
查看用户微信信息（openid、昵称）

审核流程：

查看用户信息和余额
核实用户微信openid是否存在
点击通过审核
系统自动调用微信企业付款到零钱API
转账成功：更新状态为成功，记录微信付款单号
转账失败：更新状态为失败，记录失败原因，退回余额

微信企业付款说明：

付款方式：企业付款到零钱
到账时间：实时到账（秒到）
手续费：无手续费
单笔限额：最低1元，最高2万元
需要条件：用户已完成微信授权登录

接口：

POST /admin/withdraw/{id}/approve
通过审核

POST /admin/withdraw/{id}/reject
{
  "reason": "拒绝原因"
}
拒绝审核

5.1.3 提现记录

页面路径：/admin/withdraw/records

功能点：

查看所有提现记录
导出提现数据
统计提现总额

5.2 资金流水

5.2.1 流水列表

页面路径：/admin/money

功能点：

资金流水列表（分页）
按资金类型筛选（拉新/佣金/提成/补贴/维权/取现）
按用户搜索
按订单号搜索
按时间筛选

列表字段：

字段	说明
流水ID	id
用户昵称	关联用户表
资金类型	money_type
关联订单	order_num
金额	count（正数收入/负数支出）
状态	status（预估/已结算）
创建时间	create_time
结算时间	settle_time

接口：

GET /admin/money?page=1&page_size=20&money_type=&user_id=&start_time=&end_time=

5.2.2 财务报表

页面路径：/admin/reports/finance

功能点：

日报表：每日收益、支出统计
月报表：每月收益、支出统计
年报表：每年收益、支出统计
资金流向分析
导出报表

报表内容：

总收益
总支出
佣金收入
提成支出
提现支出
平台利润

接口：

GET /admin/reports/finance?type=day&start_date=2024-01-01&end_date=2024-01-31

6. 代理管理模块

6.1 代理申请管理

6.1.1 申请列表

页面路径：/admin/apply

功能点：

代理申请列表（分页）
按状态筛选（待审核/已通过/已拒绝）
按申请时间筛选
搜索用户

列表字段：

字段	说明
申请ID	id
用户昵称	关联用户表
手机号	phone
团队名称	team
申请城市	city_name
是否有公司	has_company
公司名称	company
申请时间	create_time
状态	status
操作	查看详情/审核

接口：

GET /admin/apply?page=1&page_size=20&status=0

6.1.2 申请审核

页面路径：/admin/apply/{id}/review

功能点：

查看申请详情
- 申请人基本信息
- 团队信息
- 公司信息（如有）
- 联系方式
- 申请城市
查看用户数据
- 累计收益
- 团队人数
- 订单数量
审核操作
- 通过：选择代理城市、设置用户等级
- 拒绝：填写拒绝原因

审核流程：

查看申请资料
核实用户数据
检查城市是否已被占用
通过审核
更新用户等级为"市代理"
在pdd_city表中添加代理记录

接口：

POST /admin/apply/{id}/approve
{
  "city_code": 371600
}
通过审核

POST /admin/apply/{id}/reject
{
  "reason": "拒绝原因"
}
拒绝审核

6.2 城市代理管理

6.2.1 代理列表

页面路径：/admin/agents

功能点：

城市代理列表
按省份筛选
按代理级别筛选（市/县/镇）
搜索城市名称

列表字段：

字段	说明
城市名称	city_name
城市编码	city_code
代理级别	city_level
代理人	关联用户表
代理区域用户数	统计
代理区域订单数	统计
代理收益	统计
开通时间	create_time
操作	查看详情/编辑/删除

接口：

GET /admin/agents?page=1&page_size=20&city_level=3

6.2.2 代理详情

页面路径：/admin/agents/{id}

展示内容：

代理基本信息
代理人信息
区域数据统计
- 区域用户数
- 活跃用户数
- 订单总数
- 订单总金额
- 代理总收益
区域用户列表
区域订单列表

6.3 晋升管理

6.3.1 晋升规则设置

页面路径：/admin/upgrade/rules

功能点：

查看晋升规则
编辑晋升条件
- 合伙人条件（累计佣金）
- 高级总监条件（累计佣金）
晋升规则历史记录

接口：

GET /admin/upgrade/rules
查看规则

PUT /admin/upgrade/rules/{id}
{
  "money": 100.00
}
更新规则

6.3.2 晋升记录

页面路径：/admin/upgrade/records

功能点：

查看所有晋升记录
按用户搜索
按晋升等级筛选
按晋升时间筛选

列表字段：

字段	说明
用户昵称	关联用户表
晋升前等级	计算
晋升后等级	level_id
考核金额	money
30天预估收益	pre_fee
晋升时间	upgrade_time

7. 内容管理模块

7.1 轮播图管理

7.1.1 轮播图列表

页面路径：/admin/banners

功能点：

轮播图列表
添加轮播图
编辑轮播图
删除轮播图
拖拽排序

列表字段：

字段	说明
ID	id
图片预览	pic（缩略图）
标题	title
跳转链接	url
排序	sort_order
状态	status（显示/隐藏）
操作	编辑/删除

接口：

GET /admin/banners
查看列表

POST /admin/banners
添加

PUT /admin/banners/{id}
编辑

DELETE /admin/banners/{id}
删除

PUT /admin/banners/sort
批量更新排序

7.1.2 添加/编辑轮播图

表单字段：

标题（必填）
图片上传（必填，尺寸建议：750*300）
跳转链接（选填）
状态（显示/隐藏）

7.2 活动管理

7.2.1 活动列表

页面路径：/admin/activities

功能点：

活动入口列表
编辑活动
启用/禁用活动

列表字段：

字段	说明
活动名称	title
图标	pic
背景图	hpic
活动类型	sid
状态	status
操作	编辑

7.3 热搜词管理

7.3.1 热搜词列表

页面路径：/admin/hotwords

功能点：

热搜词列表
添加热搜词
删除热搜词
排序

列表字段：

字段	说明
热搜词	word
排序	sort_order
创建时间	create_time
操作	删除

接口：

GET /admin/hotwords
POST /admin/hotwords
DELETE /admin/hotwords/{id}

7.4 问题管理

7.4.1 问题分类

页面路径：/admin/questions/categories

功能点：

分类列表
添加分类
编辑分类
删除分类

接口：

GET /admin/questions/categories
POST /admin/questions/categories
PUT /admin/questions/categories/{id}
DELETE /admin/questions/categories/{id}

7.4.2 问题列表

页面路径：/admin/questions

功能点：

问题列表
按分类筛选
添加问题
编辑问题
删除问题

列表字段：

字段	说明
问题标题	title
分类	sort_name
创建时间	create_time
操作	编辑/删除/查看

接口：

GET /admin/questions?page=1&sort_id=
POST /admin/questions
PUT /admin/questions/{id}
DELETE /admin/questions/{id}

7.4.3 添加/编辑问题

表单字段：

问题标题（必填）
问题分类（必填）
答案内容（必填，富文本编辑器）

8. 物料管理模块

8.1 物料活动管理

8.1.1 活动列表

页面路径：/admin/materials

功能点：

物料活动列表
添加活动
编辑活动
删除活动

列表字段：

字段	说明
活动名称	mat_name
开始时间	mat_start_time
结束时间	mat_end_time
状态	status（进行中/已结束）
商品数量	统计
申请数量	统计
操作	编辑/删除/管理商品

接口：

GET /admin/materials
POST /admin/materials
PUT /admin/materials/{id}
DELETE /admin/materials/{id}

8.1.2 添加/编辑活动

表单字段：

活动名称（必填）
开始时间（必填）
结束时间（必填）
状态（启用/禁用）

8.2 物料商品管理

8.2.1 商品列表

页面路径：/admin/materials/{mat_id}/goods

功能点：

物料商品列表
添加商品
编辑商品
删除商品

列表字段：

字段	说明
商品图片	goods_pic
商品名称	goods_name
所需积分	goods_price（积分）
操作	编辑/删除

接口：

GET /admin/materials/{mat_id}/goods
POST /admin/materials/{mat_id}/goods
PUT /admin/materials/goods/{id}
DELETE /admin/materials/goods/{id}

8.3 物料申请管理

8.3.1 申请列表

页面路径：/admin/material_orders

功能点：

物料申请列表
按状态筛选
审核申请
发货

列表字段：

字段	说明
订单号	系统生成
用户昵称	关联用户表
申请物料	商品列表
收件人	name
联系电话	phone
收件地址	address
申请时间	create_time
状态	status（待审核/已发货）
操作	查看详情/发货

接口：

GET /admin/material_orders?page=1&status=
POST /admin/material_orders/{id}/ship
{
  "express_company": "顺丰",
  "express_no": "SF123456789"
}

9. 统计分析模块

9.1 用户统计

页面路径：/admin/statistics/users

统计内容：

用户增长趋势图
用户等级分布
用户地域分布
活跃用户统计

接口：

GET /admin/statistics/users?type=growth&start_date=&end_date=

9.2 订单统计

页面路径：/admin/statistics/orders

统计内容：

订单量趋势图
订单金额趋势图
商品分类销量排行
用户购买力分析

接口：

GET /admin/statistics/orders?type=trend&start_date=&end_date=

9.3 收益统计

页面路径：/admin/statistics/income

统计内容：

收益趋势图
收益类型分布
用户收益排行
代理收益排行

接口：

GET /admin/statistics/income?type=trend&start_date=&end_date=

9.4 代理统计

页面路径：/admin/statistics/agents

统计内容：

代理数量统计
代理业绩排行
区域覆盖情况
代理收益统计

10. 系统管理模块

10.1 管理员管理

10.1.1 管理员列表

页面路径：/admin/admins

功能点：

管理员列表
添加管理员
编辑管理员
禁用/启用管理员
删除管理员

列表字段：

字段	说明
用户名	username
真实姓名	real_name
角色	role
状态	status
最后登录时间	last_login_time
最后登录IP	last_login_ip
操作	编辑/禁用/删除

接口：

GET /admin/admins
POST /admin/admins
PUT /admin/admins/{id}
DELETE /admin/admins/{id}

注意：仅超级管理员可访问此模块

10.1.2 添加/编辑管理员

表单字段：

用户名（必填，唯一）
密码（添加时必填，编辑时选填）
真实姓名（必填）
角色（必填）
状态（正常/禁用）

10.2 操作日志

页面路径：/admin/logs

功能点：

操作日志列表
按管理员筛选
按操作类型筛选
按时间筛选
搜索操作内容

列表字段：

字段	说明
管理员	admin_name
操作类型	action
操作内容	content
IP地址	ip
操作时间	create_time

接口：

GET /admin/logs?page=1&admin_id=&action=&start_time=&end_time=

10.3 系统配置

页面路径：/admin/settings

功能点：

平台基本信息配置
多多客API配置
短信服务配置
微信企业付款配置（企业付款到零钱）
提现规则配置

配置项：

json

{
  "platform_name": "多多多宝",
  "pdd_client_id": "45dff93629e04f148c4e2c7a744b517b",
  "pdd_client_secret": "969db70623039d1820b1b63ae198cc84d3b6fefa",
  "withdraw_min_amount": 1,
  "withdraw_fee_rate": 0,
  "commission_rate": {
    "self": 0.6,
    "parent": 0.2,
    "grandparent": 0.1,
    "agent": 0.1
  }
}

页面设计说明

布局结构

┌─────────────────────────────────────┐
│           顶部导航栏                  │
│  Logo  |  通知  |  管理员信息  |  退出  │
├────────┬────────────────────────────┤
│        │                            │
│  左侧  │        主要内容区           │
│  菜单  │                            │
│        │                            │
│        │                            │
│        │                            │
│        │                            │
└────────┴────────────────────────────┘

左侧菜单结构

📊 首页
   └─ 数据概览

👥 用户管理
   ├─ 用户列表
   └─ 用户详情

📦 订单管理
   ├─ 订单列表
   ├─ 订单详情
   └─ 订单同步

💰 财务管理
   ├─ 提现管理
   ├─ 资金流水
   └─ 财务报表

🏢 代理管理
   ├─ 申请审核
   ├─ 城市代理
   └─ 晋升管理

📝 内容管理
   ├─ 轮播图
   ├─ 活动管理
   ├─ 热搜词
   └─ 问题管理

📦 物料管理
   ├─ 物料活动
   ├─ 物料商品
   └─ 物料申请

📈 统计分析
   ├─ 用户统计
   ├─ 订单统计
   ├─ 收益统计
   └─ 代理统计

⚙️ 系统管理
   ├─ 管理员管理
   ├─ 操作日志
   └─ 系统配置

页面通用组件

搜索栏：支持关键词搜索，高级搜索
筛选器：多条件筛选
数据表格：分页、排序、操作按钮
表单：统一样式，表单验证
弹窗：确认操作、查看详情
消息提示：成功/失败/警告提示

开发建议

1. 技术选型

采用方案：若依框架 + 二次开发✅

后端技术栈：

java

- SpringBoot 2.5.x         // 核心框架
- MyBatis 3.5.x           // ORM框架
- Spring Security 5.x     // 安全框架
- JWT                     // 认证方案
- Druid 1.2.x            // 数据库连接池
- Redis                   // 缓存中间件
- Quartz                  // 定时任务调度
- Swagger                 // API文档
- EasyExcel              // Excel处理
- FastJson                // JSON处理

前端技术栈：

javascript

- Vue 3.x                 // 前端框架
- Element Plus           // UI组件库
- Vite 2.x               // 构建工具
- Axios                   // HTTP客户端
- Pinia                   // 状态管理
- Vue Router 4.x         // 路由管理
- ECharts 5.x            // 图表库

开发工具：

- IntelliJ IDEA / Eclipse  // Java开发
- VS Code                  // 前端开发
- Navicat / DBeaver       // 数据库管理
- Redis Desktop Manager    // Redis管理
- Postman / Apifox        // API测试

2. 开发步骤

准备阶段：环境搭建（1-2天）

[ ] 配置开发环境（JDK、Maven、Node.js、MySQL、Redis）
[ ] 导入若依框架项目
[ ] 配置数据库连接
[ ] 启动后端服务（ruoyi-admin）
[ ] 启动前端项目（duoduo_ui）
[ ] 验证框架基础功能

第一阶段：核心功能（2-3周）

[ ] 使用代码生成器生成多多客业务表的CRUD代码
[ ] 用户管理模块（列表、详情、编辑、团队查询）
[ ] 订单管理模块（列表、详情、订单同步定时任务）
[ ] 提现审核模块（列表、审核、微信企业付款集成）
[ ] 资金流水模块（列表、统计）
[ ] 仪表盘数据统计（基础）

第二阶段：扩展功能（2-3周）

[ ] 代理管理模块（申请审核、城市代理、晋升规则）
[ ] 内容管理模块（轮播图、活动、热搜词、问题）
[ ] 物料管理模块（物料活动、商品、申请审核）
[ ] 菜单权限配置（配置各模块菜单和按钮权限）
[ ] 角色管理（运营、财务、客服角色配置）

第三阶段：优化完善（1-2周）

[ ] ECharts图表统计（用户增长、订单趋势、收益分析）
[ ] 数据导出功能（用户、订单、财务报表）
[ ] 多多客API对接优化（订单同步、佣金计算）
[ ] 性能优化（查询优化、缓存策略）
[ ] 接口文档完善（Swagger）
[ ] 测试与修复

3. 开发规范

若依框架代码规范：

后端规范：

java

// 1. Controller层
@RestController
@RequestMapping("/system/user")
public class PddUserController extends BaseController {
    @Autowired
    private IPddUserService pddUserService;
    
    @GetMapping("/list")
    public TableDataInfo list(PddUser pddUser) {
        startPage();
        List<PddUser> list = pddUserService.selectPddUserList(pddUser);
        return getDataTable(list);
    }
}

// 2. Service层
public interface IPddUserService {
    List<PddUser> selectPddUserList(PddUser pddUser);
    PddUser selectPddUserById(Long id);
    int insertPddUser(PddUser pddUser);
    int updatePddUser(PddUser pddUser);
    int deletePddUserByIds(Long[] ids);
}

// 3. Mapper层
public interface PddUserMapper {
    List<PddUser> selectPddUserList(PddUser pddUser);
    PddUser selectPddUserById(Long id);
    // ...
}

前端规范：

javascript

// 1. API定义 (src/api/system/user.js)
import request from '@/utils/request'

export function listUser(query) {
  return request({
    url: '/system/user/list',
    method: 'get',
    params: query
  })
}

// 2. 页面组件 (src/views/system/user/index.vue)
<template>
  <div class="app-container">
    <el-form :model="queryParams" ref="queryForm">
      <!-- 搜索表单 -->
    </el-form>
    <el-table :data="userList">
      <!-- 表格列 -->
    </el-table>
    <pagination :total="total" />
  </div>
</template>

若依框架响应格式：

json

// 成功响应
{
  "msg": "操作成功",
  "code": 200,
  "data": {}
}

// 分页响应
{
  "msg": "查询成功",
  "code": 200,
  "rows": [],
  "total": 100
}

// 错误响应
{
  "msg": "操作失败",
  "code": 500
}

URL命名规范：

GET    /system/user/list        - 查询用户列表
GET    /system/user/{id}        - 查询用户详情
POST   /system/user             - 新增用户
PUT    /system/user             - 修改用户
DELETE /system/user/{ids}       - 删除用户（支持批量）
GET    /system/user/export      - 导出用户
POST   /system/user/importData  - 导入用户

4. 安全建议

若依框架安全机制：

JWT Token认证（所有接口自动验证）
Spring Security权限控制（菜单、按钮、接口三级权限）
操作日志自动记录（使用@Log注解）
XSS防护、SQL注入防护（框架内置）
密码加密存储（BCrypt）
防重复提交（使用@RepeatSubmit注解）
数据权限控制（支持部门、个人数据权限）

额外安全措施：

敏感操作二次确认（前端弹窗）
重要操作短信/邮件通知
登录失败次数限制（Redis）
定期备份数据库
生产环境使用HTTPS协议
Redis设置密码
关闭Swagger文档（生产环境）

5. 性能优化

若依框架优化方案：

分页查询（PageHelper插件）
Redis缓存（Spring Cache）
数据库连接池（Druid监控）
慢SQL监控（Druid + MyBatis日志）
异步任务（@Async注解）

业务优化建议：

订单列表查询添加索引（trade_id、user_id、create_time）
用户列表查询添加索引（username、invitation_code）
统计数据使用Redis缓存（5分钟过期）
大数据量导出使用EasyExcel异步导出
图表数据预加载（定时任务）
团队关系树使用缓存
订单同步使用分页批量处理

附录

A. 若依框架代码生成器使用指南

使用代码生成器快速开发功能：

数据库表设计

sql

-- 确保表结构符合规范，建议字段：
CREATE TABLE `pdd_xxx` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
  `xxx` varchar(50) DEFAULT NULL COMMENT 'xxx',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='xxx表';

配置生成参数

登录后台：http://localhost:8080
进入【系统工具】-【代码生成】
点击【导入】，选择表
点击【编辑】，配置生成信息：
- 基本信息：作者、包路径、模块名、业务名
- 字段信息：显示类型、查询方式、必填等
- 生成信息：生成模板（单表/树表/主子表）

生成代码

点击【生成代码】，下载zip包
解压后包含：
- Java代码：Controller、Service、Mapper、Domain
- XML文件：MyBatis映射文件
- Vue代码：index.vue（列表页面）
- SQL文件：菜单SQL
将代码复制到对应目录
执行菜单SQL
刷新页面即可看到新功能

B. 若依框架常用功能示例

1. 添加操作日志

java

@Log(title = "用户管理", businessType = BusinessType.UPDATE)
@PutMapping
public AjaxResult edit(@RequestBody PddUser user) {
    return toAjax(pddUserService.updatePddUser(user));
}

2. 防重复提交

java

@RepeatSubmit
@PostMapping
public AjaxResult add(@RequestBody PddUser user) {
    return toAjax(pddUserService.insertPddUser(user));
}

3. 数据权限控制

java

@DataScope(deptAlias = "d", userAlias = "u")
public List<PddUser> selectPddUserList(PddUser pddUser) {
    return pddUserMapper.selectPddUserList(pddUser);
}

4. Redis缓存使用

java

@Cacheable(cacheNames = "user", key = "#id")
public PddUser selectPddUserById(Long id) {
    return pddUserMapper.selectPddUserById(id);
}

5. 异步任务

java

@Async
public void syncOrders() {
    // 订单同步逻辑
}

C. 参考资料

若依框架官方资源：

若依官网：http://ruoyi.vip
若依文档：http://doc.ruoyi.vip
若依Gitee：https://gitee.com/y_project/RuoYi-Vue
若依视频教程：https://www.bilibili.com/video/BV1vL4y1s7UU

前端相关：

Vue 3文档：https://cn.vuejs.org
Element Plus：https://element-plus.org/zh-CN/
ECharts：https://echarts.apache.org/zh/index.html
Vite：https://cn.vitejs.dev

后端相关：

SpringBoot文档：https://spring.io/projects/spring-boot
MyBatis文档：https://mybatis.org/mybatis-3/zh/index.html
Spring Security：https://spring.io/projects/spring-security

D. 快速开发检查清单

开发新功能前检查：

[ ] 数据库表是否已创建
[ ] 表结构是否符合若依规范（包含create_by等字段）
[ ] 是否已配置好代码生成参数
[ ] 菜单SQL是否已执行
[ ] 是否已配置菜单权限

代码提交前检查：

[ ] 代码是否符合若依规范
[ ] 是否添加了@Log注解
[ ] 是否添加了必要的参数校验
[ ] 是否处理了异常情况
[ ] 是否添加了接口文档注释
[ ] 前端是否有loading提示
[ ] 是否测试了增删改查功能

文档版本：v2.0
更新时间：2025-10-09
技术方案：若依框架二次开发
维护人：AI Assistant

多多多宝后台管理系统功能清单 ​

📌 更新日志 ​

v2.0 (2025-10-09) ​

v1.0 (2025-10-09) ​

📋 目录 ​

系统概述 ​

后台管理系统目标 ​

技术实现方案 ​

采用方案：若依框架二次开发（推荐，已确定）✅ ​

备选方案：从零开发（不推荐） ​

权限角色设计 ​

角色定义 ​

权限表设计 ​

功能模块清单 ​

1. 登录与认证模块 ​

1.1 管理员登录 ​

1.2 修改密码 ​

2. 首页仪表盘 ​

2.1 数据概览 ​

2.2 数据图表 ​

2.3 待办事项 ​

3. 用户管理模块 ​

3.1 用户列表 ​

3.2 用户详情 ​

3.3 编辑用户 ​

3.4 批量操作 ​

4. 订单管理模块 ​

4.1 订单列表 ​

4.2 订单详情 ​

4.3 订单同步管理 ​

5. 财务管理模块 ​

5.1 提现管理 ​

5.1.1 提现申请列表 ​

5.1.2 提现审核 ​

5.1.3 提现记录 ​

5.2 资金流水 ​

5.2.1 流水列表 ​

5.2.2 财务报表 ​

6. 代理管理模块 ​

6.1 代理申请管理 ​

6.1.1 申请列表 ​

6.1.2 申请审核 ​

6.2 城市代理管理 ​

6.2.1 代理列表 ​

6.2.2 代理详情 ​

6.3 晋升管理 ​

6.3.1 晋升规则设置 ​

6.3.2 晋升记录 ​

7. 内容管理模块 ​

7.1 轮播图管理 ​

7.1.1 轮播图列表 ​

7.1.2 添加/编辑轮播图 ​

7.2 活动管理 ​

7.2.1 活动列表 ​

7.3 热搜词管理 ​

7.3.1 热搜词列表 ​

7.4 问题管理 ​

7.4.1 问题分类 ​

7.4.2 问题列表 ​

7.4.3 添加/编辑问题 ​

8. 物料管理模块 ​

8.1 物料活动管理 ​

8.1.1 活动列表 ​

8.1.2 添加/编辑活动 ​

8.2 物料商品管理 ​

8.2.1 商品列表 ​

8.3 物料申请管理 ​

8.3.1 申请列表 ​

9. 统计分析模块 ​

9.1 用户统计 ​

9.2 订单统计 ​

9.3 收益统计 ​

9.4 代理统计 ​

10. 系统管理模块 ​

10.1 管理员管理 ​

10.1.1 管理员列表 ​

10.1.2 添加/编辑管理员 ​

10.2 操作日志 ​

10.3 系统配置 ​

页面设计说明 ​

多多多宝后台管理系统功能清单

📌 更新日志

v2.0 (2025-10-09)

v1.0 (2025-10-09)

📋 目录

系统概述

后台管理系统目标

技术实现方案

采用方案：若依框架二次开发（推荐，已确定）✅

备选方案：从零开发（不推荐）

权限角色设计

角色定义

权限表设计

功能模块清单

1. 登录与认证模块

1.1 管理员登录

1.2 修改密码

2. 首页仪表盘

2.1 数据概览

2.2 数据图表

2.3 待办事项

3. 用户管理模块

3.1 用户列表

3.2 用户详情

3.3 编辑用户

3.4 批量操作

4. 订单管理模块

4.1 订单列表

4.2 订单详情

4.3 订单同步管理

5. 财务管理模块

5.1 提现管理

5.1.1 提现申请列表

5.1.2 提现审核

5.1.3 提现记录

5.2 资金流水

5.2.1 流水列表

5.2.2 财务报表

6. 代理管理模块

6.1 代理申请管理

6.1.1 申请列表

6.1.2 申请审核

6.2 城市代理管理

6.2.1 代理列表

6.2.2 代理详情

6.3 晋升管理

6.3.1 晋升规则设置

6.3.2 晋升记录

7. 内容管理模块

7.1 轮播图管理

7.1.1 轮播图列表

7.1.2 添加/编辑轮播图

7.2 活动管理

7.2.1 活动列表

7.3 热搜词管理

7.3.1 热搜词列表

7.4 问题管理

7.4.1 问题分类

7.4.2 问题列表

7.4.3 添加/编辑问题

8. 物料管理模块

8.1 物料活动管理

8.1.1 活动列表

8.1.2 添加/编辑活动

8.2 物料商品管理

8.2.1 商品列表

8.3 物料申请管理

8.3.1 申请列表

9. 统计分析模块

9.1 用户统计

9.2 订单统计

9.3 收益统计

9.4 代理统计

10. 系统管理模块

10.1 管理员管理

10.1.1 管理员列表

10.1.2 添加/编辑管理员

10.2 操作日志

10.3 系统配置

页面设计说明