docs: add release runbook and seed data
This commit is contained in:
26
docs/api/manual-test-checklist.md
Normal file
26
docs/api/manual-test-checklist.md
Normal 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.
|
||||
103
docs/deploy/local-runbook.md
Normal file
103
docs/deploy/local-runbook.md
Normal 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
|
||||
```
|
||||
Reference in New Issue
Block a user