专为"宝妈、宝爸"群体设计的智能跨平台购物比价助手，聚合淘宝、京东、拼多多、抖音、快手、天猫超市、唯品会等主流电商平台商品信息，数秒完成"同品搜索 - 多维比较 - 最优决策"。
品牌标识：橙色徽标由「硬币（钱）+ 双层向下人字箭（比价后价格一路向下）」构成，寓意 比价省钱； 从 16px favicon 到启动图均保持清晰一致，已统一应用于 PC / H5 / 小程序三端。
- 产品文档：产品说明.md
- 技术文档：技术方案.md
- 运行/部署指南：docs/运行部署指南.md（Windows / Linux · 源码 / 容器）
- 完整测试报告：docs/test-reports/测试报告-完整版.md（业务 / 功能 / 安全 / 性能）
- 变更历史：CHANGELOG.md
- 提交规范：docs/提交规范.md
截图位于 docs/screenshots/，下表展示最新版本核心界面。
| 首页·比价榜 | 商品详情·多平台到手价 | 列表·分类筛选 |
|---|---|---|
 |
 |
 |
| 拍照比价·入口 | 拍照比价·识别中 | 拍照比价·结果 |
|---|---|---|
 |
 |
 |
| H5 首页 | 比价雷达 | 搜索结果 |
|---|---|---|
 |
 |
 |
| 端 | 技术 |
|---|---|
| 后端 | Spring Boot 3.5 / JDK 21 / Spring Data JPA / H2 (dev) |
| 前端 | Vue 3 / Vite / Vant 4 / Pinia / ECharts |
架构说明：技术方案中规划了 9 个微服务（gateway/user/product/price/smart/sync/notify/data/job）。 当前实现采用模块化单体落地——后端按 DDD 限界上下文分包（
com.baosheng.product/price/smart/sync/notify/user/decision）， 与微服务边界一一对应，可在生产阶段按包拆分为独立服务。dev 环境使用 H2 内存库实现零依赖一键启动。
db/ 目录提供 MySQL 8 建表与初始化数据脚本（uat/生产环境使用；dev 环境 H2 由代码自动建表播种，无需执行）：
mysql -u root -p
> CREATE DATABASE baosheng DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
> USE baosheng;
> SOURCE db/schema.sql; -- 13 张表（商品/报价/历史价/评价/提醒/清单/指南/投票/账号同步）
> SOURCE db/init-data.sql; -- 初始化数据：48商品/195报价/3456历史价/607评价/5指南 等init-data.sql 由 SqlExporter 从播种器自动导出（重新生成：mvn spring-boot:run -Dspring-boot.run.arguments=--baosheng.export-sql=true），并有 SqlScriptsTest 持续验证两个脚本可在全新库上完整执行。
# 后端（默认 dev 环境，端口 8080，上下文 /saas/baosheng）
cd backend
mvn spring-boot:run
# 前端（端口 5173，已配置代理到后端）
cd frontend
npm install
npm run dev打开 http://localhost:5173 即可体验。
更完整的启动方式（Windows / Linux、源码 / 容器、小程序端、排错）见 运行部署指南。
| 组件 | 版本 | 说明 |
|---|---|---|
| JDK | 21 | 后端编译/运行 |
| Maven | 3.9+ | 后端构建 |
| Node.js | 18+（推荐 20/22 LTS） | 前端构建 |
| Git | 2.x | 版本管理 |
git clone <仓库地址> sengbao-app && cd sengbao-app
cd backend && mvn spring-boot:run # 终端 A：后端
cd frontend && npm install && npm run dev # 终端 B：前端backend/ Spring Boot 3.5 / JDK 21，DDD 限界上下文分包（product/price/smart/sync/notify/user/decision）
frontend/ Vue 3 + Vite + Vant（PC/H5），组件 ProductImage/BrandLogo 等
miniprogram/ uni-app 微信小程序端（与 H5 共用网关 API 与设计令牌）
db/ MySQL 8 建表与初始化数据脚本（生产用）
docs/ 文档、产品截图、测试报告
.github/ GitHub Actions CI/CD 流水线
- 拉分支：从
main切出feat/xxx、fix/xxx或docs/xxx分支开发。 - 写代码 + 测试：后端补充
backend/src/test用例，保持mvn test全绿；改动前端确保npm run build通过。 - 本地自检：
cd backend && mvn test # 后端 53 用例 cd frontend && npm run build # 前端构建校验
- 提交：遵循 提交规范（约定式提交
type(scope): subject），并按约定更新 CHANGELOG.md。 - 发起 PR：推送分支后开 PR，CI 流水线自动跑后端测试与前端构建（见下），通过后合并。
.github/workflows/ci.yml 提供 三种触发入口：
| 触发方式 | 说明 |
|---|---|
| 自动触发 | push / pull_request 到 main、develop 时自动运行 |
| 页面手动触发 | GitHub → Actions → 选择工作流 → Run workflow（workflow_dispatch） |
| 脚本/接口触发 | 运行 scripts/trigger-ci.sh（基于 repository_dispatch，可在任意机器/定时任务中调用） |
流水线包含：后端 mvn test + 打包、前端 npm ci && npm run build、Docker 镜像构建校验。详见 流水线说明。
| 版本 | 内容 | 状态 |
|---|---|---|
| V1.0 (MVP) | 文字/语音/扫码搜索比价（淘宝/京东/拼多多）、到手价、历史价格、降价提醒 | ✅ |
| V1.5 | 服务标签体系、买家口碑聚合、家庭共享清单 | ✅ |
| V2.0 | 智选专区(KOL)、一键求决策、抖音/快手直播价 | ✅ |
| V2.5 | 复购周期提醒、商品画像 V1.0（基础标签版） | ✅ |
| V3.0 | 电商账号绑定与订单/收藏/购物车同步、完整商品画像、购买人群画像、品牌平替、语音助手"小省" | ✅ |