docs: add release runbook and seed data

This commit is contained in:
王鹏
2026-07-07 16:49:47 +08:00
parent 9ad43005c4
commit c2e46efdd9
4 changed files with 240 additions and 0 deletions

View File

@@ -0,0 +1,26 @@
# Manual Test Checklist
Use this checklist after starting the backend, admin web, rider H5, and opening the miniapp in WeChat DevTools.
- [ ] Admin can log in with `admin / admin123`.
- [ ] Admin can create and publish a notice.
- [ ] Miniapp can list published notices.
- [ ] Admin can create product and SKU stock.
- [ ] Miniapp can submit goods order.
- [ ] Admin can confirm goods order and mark prepared.
- [ ] Admin can assign delivery order to rider.
- [ ] Rider can log in with `rider / rider123`.
- [ ] Rider can start delivery and upload delivered photo.
- [ ] Miniapp can confirm goods order completion.
- [ ] Miniapp can submit express pickup order.
- [ ] Admin can confirm express order and assign rider.
- [ ] Rider can mark express order delivered.
- [ ] Miniapp can submit group buy order before cutoff.
- [ ] Admin can review secondhand listing.
- [ ] Public secondhand list only shows approved listings.
Notes:
- Resident miniapp login uses `/api/auth/dev-miniapp-login` in local mode.
- Current payment flow is offline payment status tracking; WeChat Pay is reserved for a later integration.
- The backend service layer is still in-memory for this MVP. The SQL seed is kept ready for the persistence milestone.

View File

@@ -0,0 +1,103 @@
# Local Runbook
## Prerequisites
- JDK 8
- Maven
- Node.js 18+
- Docker Desktop, for MySQL, Redis, and MinIO
- WeChat DevTools, for native miniapp compile and preview
## Start Dependencies
```powershell
docker compose -f deploy/docker-compose.dev.yml up -d
```
Expected dependency URLs:
```text
MySQL: localhost:3306
Redis: localhost:6379
MinIO API: http://localhost:9000
MinIO console: http://localhost:9001
```
## Start Backend
```powershell
cd backend
mvn spring-boot:run
```
Expected local URLs:
```text
Backend API: http://localhost:8080
Knife4j docs: http://localhost:8080/doc.html
```
Demo accounts:
```text
Admin: admin / admin123
Merchant: merchant / merchant123
Rider: rider / rider123
Resident: dev miniapp login
```
## Start Admin Web
```powershell
cd admin-web
npm install
npm run dev
```
URL:
```text
http://localhost:5173
```
## Start Rider H5
```powershell
cd rider-h5
npm install
npm run dev
```
URL:
```text
http://localhost:5174
```
## Open Miniapp
Use WeChat DevTools to open:
```text
miniapp/project.config.json
```
The miniapp request base URL is configured in `miniapp/miniprogram/utils/request.js`.
## Verification Commands
```powershell
cd backend
mvn test
cd ..\admin-web
npm test
npm run build
cd ..\miniapp
npm test
cd ..\rider-h5
npm test
npm run build
```