Full stack developer agent wri…

# 宠物寄养预约平台：Next.js + PostgreSQL 实施指南

一、技术栈选型

• 框架：Next.js 14+（App Router）+ TypeScript
• 数据库：PostgreSQL，推荐 Vercel Postgres 或 Neon（Serverless 友好）
• ORM：Prisma（自带类型安全和迁移管理）
• 支付：微信支付沙箱模式（测试用），生产切换正式接口

二、数据库设计（Prisma Schema 核心表）

```prisma

model Sitter {

id String @id @default(cuid())

name String

city String

petTypes String[] // 可寄养宠物类型

pricePerDay Int // 每日价格

rating Float @default(0)

available Boolean @default(true)

orders Order[]

}

model Order {

id String @id @default(cuid())

sitterId String

sitter Sitter @relation(fields: [sitterId], references: [id])

startDate DateTime

endDate DateTime

status String @default("PENDING") // PENDING/PAID/CANCELLED

amount Int

createdAt DateTime @default(now())

}

```

三、核心功能实现

1. 寄养师列表筛选（API + 前端）

• API：GET /api/sitters?city=北京&petType=猫&minPrice=&maxPrice=&sort=rating
• 使用 Prisma where 动态条件 + orderBy 排序
• 前端：筛选栏组件（城市下拉、宠物类型多选、价格区间滑块），配合 Server Components 首屏渲染 + 客户端筛选联动

2. 订单下单

• API：POST /api/orders，校验日期不重叠（查询已有 PAID 订单区间冲突）
• 金额 = 天数 × 单日价格，服务端计算（防前端篡改）
• 使用数据库事务：锁单 + 创建订单原子操作，防止超订

3. 微信支付沙箱测试

• 准备：注册微信支付商户号，开通沙箱环境，获取沙箱密钥
• 流程：

1. 调用沙箱验签密钥接口（/sandboxnew/pay/getsignkey）

2. 服务端下单（统一下单接口 + 沙箱专用域名 sandbox 前缀）

3. 前端调起支付（JSAPI 需先授权获取 openid；沙箱可用仿真系统模拟回调）

4. 支付回调接口验证签名后更新订单状态为 PAID

• 注意：沙箱仅支持模拟特定金额，需按官方仿真文档构造测试数据

四、部署到 Vercel

1. 代码推 GitHub，Vercel 导入仓库

2. 环境变量配置：DATABASE_URL、微信支付商户参数（用 Environment Variables 加密）

3. 执行 prisma migrate deploy 初始化线上库

4. 回调地址改为 Vercel 生产域名，验证支付回调可访问

五、注意事项