苏分宝项目知识库 (RepoWiki)本目录包含苏分宝电商导购返利项目的完整知识库文档涵盖前端、后端、管理后台、API 接口、数据库设计、部署运维等全方位内容。 文档结构.qoder/repowiki/ └── zh/ ├── content/ # 文档内容 │ ├── 项目概述.md # 项目整体介绍与架构总览 │ ├── 快速开始.md # 环境搭建与快速入门指南 │ ├── 前端架构设计/ # Flutter 前端架构设计 │ │ ├── 前端架构设计.md │ │ ├── Flutter 应用架构.md │ │ ├── 核心功能模块.md │ │ ├── 状态管理机制.md │ │ ├── 路由导航系统.md │ │ └── 网络层设计.md │ ├── 后端架构设计/ # Spring Boot 后端架构设计 │ │ ├── 后端架构设计.md │ │ ├── Spring Boot 模块架构/ │ │ ├── 核心业务服务/ │ │ ├── 数据访问层设计.md │ │ ├── 安全认证机制.md │ │ ├── 第三方服务集成/ │ │ └── API 设计规范.md │ ├── 数据库设计/ # 数据库架构与数据模型 │ │ ├── 数据库架构设计.md │ │ ├── 核心数据模型/ │ │ ├── 表关系设计.md │ │ └── 数据访问层设计.md │ ├── API 接口文档/ # REST API 接口说明 │ │ ├── API 接口文档.md │ │ ├── 用户认证 API.md │ │ ├── 商品查询 API/ │ │ ├── 订单管理 API.md │ │ ├── 支付相关 API.md │ │ ├── 营销活动 API.md │ │ ├── 个人中心 API.md │ │ └── 系统配置 API.md │ ├── 管理后台系统/ # Vue.js 管理后台文档 │ │ ├── 管理后台系统.md │ │ ├── Vue.js 管理后台架构.md │ │ ├── 核心管理功能模块/ │ │ ├── 权限控制系统.md │ │ ├── UI 组件库与工具.md │ │ ├── 数据表格与表单系统.md │ │ └── API 接口集成.md │ ├── 第三方集成/ # 第三方服务集成文档 │ │ ├── 第三方集成.md │ │ ├── 支付平台集成/ │ │ ├── 电商平台集成/ │ │ └── 其他服务集成/ │ ├── 部署与运维/ # 部署与运维指南 │ │ ├── 部署与运维.md │ │ ├── 前端部署.md │ │ ├── 后端部署.md │ │ └── 运维监控.md │ ├── 测试策略/ # 测试与质量保证 │ │ ├── 测试策略.md │ │ ├── 单元测试.md │ │ ├── 集成测试.md │ │ ├── API 接口测试.md │ │ ├── 性能测试.md │ │ └── Flutter 组件测试.md │ ├── 开发规范/ # 开发规范与流程 │ │ ├── 开发规范.md │ │ ├── 代码规范.md │ │ ├── Git 工作流程.md │ │ ├── 项目结构规范.md │ │ └── 开发工具配置.md │ ├── 扩展开发/ # 扩展开发与升级指南 │ │ ├── 扩展开发.md │ │ ├── 功能扩展/ │ │ ├── 技术升级/ │ │ ├── 插件开发.md │ │ └── 架构演进.md │ └── 故障排除/ # 故障排查与调试 │ ├── 故障排除.md │ ├── 前端问题排查.md │ ├── 后端服务排查.md │ ├── 数据库问题排查.md │ ├── 第三方集成问题.md │ ├── 调试技巧与工具.md │ └── 应急响应与预案.md └── meta/ # 元数据 └── repowiki-metadata.json # 知识库元数据 文档概览1. 项目概述项目简介: 苏分宝是一套面向中国电商生态的跨平台导购与返利解决方案技术栈:前端Flutter 3.0 (Android/iOS/Web)后端Spring Boot 2.6.7管理后台Vue 2.7.16 Element UI核心能力: 商品搜索与比价、优惠券聚合、智能转链、订单与佣金管理、社交电商与分销体系2. 快速开始环境要求与安装步骤项目克隆与依赖安装环境变量配置运行与构建命令故障排查指南3. 前端架构设计 (Flutter)MVVM 架构: 视图层、模型层、视图模型层职责划分Provider 状态管理: 全局状态与局部状态协同模块化设计: 按功能域划分模块 (index/search/tao/jd/pdd/dy/vip/order/me)路由导航: 集中式路由映射与命名路由网络层: Dio 封装、统一鉴权、错误处理本地存储: SharedPreferences SQLite 策略4. 后端架构设计 (Spring Boot)模块架构:mshop-admin: 管理后台 APImshop-app: 移动端 APImshop-shop: 商城核心业务mshop-db: MyBatis-Plus 数据访问mshop-redis: Redis 缓存与消息mshop-log: 日志与审计mshop-gen: 代码生成器核心技术: MyBatis-Plus、Redis、JWT、Spring Security、Knife4j5. 数据库设计数据库架构: MySQL Redis 混合存储核心数据模型:用户域用户信息、推广关系、余额积分商品域商品信息、优惠券、转链记录订单域订单信息、绑定状态、佣金结算营销域活动信息、分销关系系统域角色权限、系统配置6. API 接口文档用户认证 API: 登录注册、JWT 令牌、权限验证商品查询 API:淘宝商品查询京东商品查询拼多多商品查询抖音商品查询唯品会商品查询通用商品搜索订单管理 API: 订单查询、订单绑定、佣金查询支付相关 API: 支付下单、支付回调、退款处理营销活动 API: 优惠券领取、活动报名、分销推广个人中心 API: 用户信息、收益明细、提现管理系统配置 API: 应用配置、版本更新、反馈建议7. 管理后台系统 (Vue.js)核心功能模块:商品管理商品上架、下架、推荐订单管理订单查询、异常处理用户管理用户信息、权限管理营销管理活动配置、优惠券发放系统配置参数设置、菜单管理权限控制: RBAC 角色权限模型UI 组件库: Element UI 自定义组件8. 第三方集成支付平台集成:支付宝集成微信支付集成银行卡支付集成支付安全机制电商平台集成:淘宝联盟 API京东联盟 API拼多多 API抖音电商 API唯品会 API饿了么美团外卖 API其他服务集成:存储服务 (OSS/COS)短信服务快递查询推送通知地图服务9. 部署与运维前端部署:Android/iOS 打包发布Web 端 Nginx 部署CDN 加速配置后端部署:Docker 容器化部署生产环境配置负载均衡配置运维监控:日志收集与分析性能监控与告警数据库监控10. 测试策略单元测试: JUnit Mockito集成测试: Spring Boot TestAPI 接口测试: Postman Swagger性能测试: JMeter GatlingFlutter 组件测试: Flutter Test11. 开发规范代码规范: 命名规范、注释规范、格式化规范Git 工作流程: 分支管理、提交规范、Code Review项目结构规范: 目录组织、文件命名开发工具配置: IDE 配置、插件推荐12. 扩展开发功能扩展:电商平台集成扩展支付方式扩展营销活动扩展报表定制扩展技术升级:Flutter 版本升级Spring Boot 版本升级数据库优化前端性能优化13. 故障排除前端问题排查: Flutter 构建问题、平台兼容性问题后端服务排查: 服务启动失败、接口异常数据库问题排查: SQL 性能、连接池问题第三方集成问题: API 调用失败、回调异常调试技巧与工具: 日志调试、断点调试、性能分析 阅读指南新手入门阅读 项目概述 了解项目整体架构按照 快速开始 搭建开发环境学习 前端架构设计 或 后端架构设计参考 [API 接口文档](./zh/content/API 接口文档/API 接口文档.md) 进行开发进阶开发深入研究 数据库设计学习 第三方集成 文档参考 扩展开发 进行功能扩展遵循 开发规范 编写代码运维部署阅读 部署与运维 文档参考 测试策略 进行测试遇到问题时查看 故障排除 相关链接项目官网: (待补充)GitHub 仓库: (待补充)开发文档: (待补充)API 测试平台: (待补充) 文档维护本文档由 RepoWiki 自动生成和维护确保文档与代码同步更新。如发现文档错误或需要补充请及时提交 Issue 或 Pull Request。 开源协议本项目文档遵循与代码相同的开源协议。具体协议内容请查看项目根目录的 LICENSE 文件。最后更新时间: 2026 年 3 月 20 日文档版本: v1.0维护团队: 苏分宝开发团队