LinHelp 邻小帮
LinHelp（邻小帮）是一个社区生活服务 MVP 项目，覆盖居民端、商家/平台管理端、骑手端与后端 API。当前仓库包含一期实现所需的本地开发环境、核心业务接口、前端页面、小程序页面和测试用例。
功能范围
- 居民端微信小程序：商品浏览与下单、团购、快递代取下单、二手信息发布、公告查看、地址管理、个人中心。
- 管理后台：数据看板、商品管理、订单管理、团购管理、快递订单管理、配送调度、二手审核、公告管理。
- 骑手 H5：任务列表、任务详情、送达确认、异常上报、收入汇总。
- 后端服务：登录鉴权、租户上下文、商品/订单/团购/快递/配送/二手/公告/反馈等业务接口。
- 本地支撑：MySQL、Redis、MinIO、Flyway 数据库迁移、Knife4j 接口文档、无数据库 demo profile。
技术栈
- 后端：Java 8、Spring Boot 2.7.18、MyBatis Plus、Sa-Token、MySQL、Redis、Flyway、Knife4j、MinIO。
- 管理后台：Vue 3、TypeScript、Vite、Element Plus、Pinia、Vue Router、Vitest。
- 骑手 H5：Vue 3、TypeScript、Vite、Pinia、Vue Router、Vitest。
- 居民端小程序：微信原生小程序、WXML、WXSS、JavaScript、Jest。
- 开发依赖：Docker Desktop、Maven、Node.js 18+、微信开发者工具。
目录结构
LinHelp
├── backend/ # Spring Boot 后端服务
├── admin-web/ # 管理后台 Web
├── rider-h5/ # 骑手 H5
├── miniapp/ # 居民端微信小程序
├── deploy/ # 本地依赖编排
└── docs/ # 产品设计、实施计划、部署与测试文档
本地启动
1. 启动基础依赖
docker compose -f deploy/docker-compose.dev.yml up -d
默认依赖地址：
MySQL: localhost:3306
Redis: localhost:6379
MinIO API: http://localhost:9000
MinIO 控制台: http://localhost:9001
默认数据库和对象存储账号请查看 deploy/docker-compose.dev.yml。
2. 启动后端
cd backend
mvn spring-boot:run
服务地址：
后端 API: http://localhost:8080
Knife4j 文档: http://localhost:8080/doc.html
后端默认启用 dev profile，会连接本地 MySQL、Redis 和 MinIO，并通过 Flyway 执行 backend/src/main/resources/db/migration 下的迁移脚本。
3. 启动管理后台
cd admin-web
npm install
npm run dev
访问地址：
http://localhost:5173
开发模式下 /api 默认代理到 http://localhost:8080。如果后端使用其他端口，可以设置：
$env:VITE_API_PROXY_TARGET="http://localhost:18080"
npm run dev
4. 启动骑手 H5
cd rider-h5
npm install
npm run dev
访问地址：
http://localhost:5174
骑手 H5 与管理后台一样使用 /api 代理后端接口。
5. 打开微信小程序
使用微信开发者工具打开：
miniapp/project.config.json
小程序请求基础地址在 miniapp/miniprogram/utils/request.js 中配置。
无数据库演示模式
如果本地没有 Docker/MySQL，或 8080 端口被占用，可以启动 demo profile：
cd backend
mvn spring-boot:run "-Dspring-boot.run.profiles=demo"
演示服务地址：
http://localhost:18080
demo profile 不依赖 MySQL，会在内存中初始化商品、公告、团购、团购配送单、二手信息、商品配送任务和快递代取任务等演示数据。
演示账号：
管理员: admin / admin123
商家: merchant / merchant123
骑手: rider / rider123
居民: 本地开发小程序登录
测试与构建
后端测试：
cd backend
mvn test
管理后台：
cd admin-web
npm test
npm run build
骑手 H5：
cd rider-h5
npm test
npm run build
微信小程序：
cd miniapp
npm test
常用地址
| 应用 | 地址 |
|---|---|
| 后端 API | http://localhost:8080 |
| Demo API | http://localhost:18080 |
| Knife4j 文档 | http://localhost:8080/doc.html |
| 管理后台 | http://localhost:5173 |
| 骑手 H5 | http://localhost:5174 |
| MinIO 控制台 | http://localhost:9001 |
参考文档
docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.mddocs/superpowers/plans/2026-07-07-linxiaobang-phase-one-implementation.mddocs/api/manual-test-checklist.mddocs/deploy/local-runbook.md