LinHelp/README.md

# LinHelp

LinHelp is the phase-one implementation workspace for "Lin Xiao Bang", a community life service MVP.

## Stack

- Backend: Java 8, Spring Boot 2.7.18, MyBatis Plus, Sa-Token, MySQL, Redis, Flyway, Knife4j, MinIO
- Admin web: Vue 3, TypeScript, Vite, Element Plus
- Resident miniapp: WeChat native mini program, WXML, WXSS, JavaScript
- Rider H5: Vue 3, TypeScript, Vite

## Local Runtime

```powershell
docker compose -f deploy/docker-compose.dev.yml up -d
cd backend
mvn test
```

## Applications

- Backend API: `http://localhost:8080`
- Knife4j docs: `http://localhost:8080/doc.html`
- Admin web: `http://localhost:5173`
- Rider H5: `http://localhost:5174`
- Resident miniapp: open `miniapp/project.config.json` in WeChat DevTools

No-database demo backend:

```powershell
cd backend
mvn spring-boot:run "-Dspring-boot.run.profiles=demo"
```

Demo profile URL: `http://localhost:18080`

Demo accounts:

- Admin: `admin / admin123`
- Merchant: `merchant / merchant123`
- Rider: `rider / rider123`
- Resident: local dev miniapp login

Project docs:

- `docs/superpowers/specs/2026-07-07-linxiaobang-prd-design.md`
- `docs/superpowers/plans/2026-07-07-linxiaobang-phase-one-implementation.md`
- `docs/api/manual-test-checklist.md`
- `docs/deploy/local-runbook.md`