# 宠物上门小程序

**Repository Path**: findluo/pet-doorstep-mini-program

## Basic Information

- **Project Name**: 宠物上门小程序
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宠爱小程序配套项目

这个项目由三部分组成：

- `miniprogram/`：微信小程序端，已经从本地写死数据改为调用后端接口。
- `express/`：Express + MySQL 后端接口，固定运行在 `5050` 端口。
- `admin/`：Vite + Vue3 + Element Plus 后台管理端。

## 本地启动后端

```bash
cd express
npm install
npm run dev
```

后端地址：

```text
http://127.0.0.1:5050/api
```

后端启动时会自动连接 MySQL，并在 `pet` 数据库中创建缺失的数据表。表为空时会自动写入初始数据。

默认数据库配置在 `express/.env`：

```text
DB_HOST=127.0.0.1
DB_PORT=3305
DB_USER=root
DB_PASSWORD=1102
DB_NAME=pet
```

## 本地启动后台管理端

```bash
cd admin
npm install
npm run dev
```

后台管理端默认运行在 `http://127.0.0.1:5051`，并连接 `http://127.0.0.1:5050/api`，可以管理订单、宠物、地址、服务类型、套餐、附加服务、宠物师类型、偏好和用户资料。

本地首次启动后端时会在数据库 `admin_users` 表为空时自动创建管理员账号：
```text
ADMIN_DEFAULT_USERNAME=admin
ADMIN_DEFAULT_PASSWORD=Admin@123456
```

生产环境请在 Docker Compose 的 `.env` 中设置 `ADMIN_DEFAULT_USERNAME`、`ADMIN_DEFAULT_PASSWORD` 和 `ADMIN_DEFAULT_DISPLAY_NAME`，其中 `ADMIN_DEFAULT_PASSWORD` 为必填。密码会以哈希形式写入数据库，不会明文保存。

## Docker / Dockge 部署

项目根目录的 `compose.yaml` 已包含完整上线配置：

- `mysql`：MySQL 8.4，数据卷为 `mysql-data`。
- `api`：Express 后端，映射 `5050:5050`。
- `admin`：Nginx 托管后台静态文件，并反向代理 `/api`，映射 `5051:80`。

服务器使用 Dockge 管理时，将项目放在 `/opt/stacks/pet`，在 `.env` 中配置数据库密码和管理员初始密码，然后在 Dockge 中启动栈即可。

## 打开小程序

用微信开发者工具导入 `miniprogram/` 目录。小程序本机调试时接口地址使用：

```text
http://127.0.0.1:5050/api
```

如果真机调试，需要把 `miniprogram/utils/api.js` 中的 `BASE_URL` 改成电脑局域网 IP，并在微信开发者工具中开启“不校验合法域名”。

## 主要接口

- `GET /api/bootstrap`：小程序初始化数据。
- `GET /api/statistics`：后台首页统计。
- `GET /api/orders`：订单列表。
- `POST /api/orders`：提交订单。
- `PUT /api/orders/:id/status`：修改订单状态。
- `GET /api/services`：预约页服务配置。
- `GET/POST/PUT/DELETE /api/pets`：宠物资料管理。
- `GET/POST/PUT/DELETE /api/addresses`：上门地址管理。