# 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
```