# Road trip assistant

**Repository Path**: forgetting-lines/road-trip-assistant

## Basic Information

- **Project Name**: Road trip assistant
- **Description**: road-trip-assistant
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 行野自驾出行

全国自驾旅行微信小程序，仓库同时保留原生 HTML、CSS、JavaScript 移动端原型。

## 功能

- 全国出发地与目的地设置
- 推荐路线、沿途景点和当地美食
- 动态多日日程
- 当日目的地附近加油站、充电站入口
- 地点收藏、同行好友邀请和个人中心

## 微信小程序运行

1. 安装并打开微信开发者工具。
2. 选择“导入项目”，目录选择本仓库根目录。
3. 在 `project.config.json` 中将 `touristappid` 替换为自己的小程序 AppID。
4. 开发阶段可使用测试号；正式发布前需要在微信公众平台完成主体、隐私协议和位置权限配置。

小程序源码位于 `miniprogram/`，包含：

- 全国起点和目的地选择
- 推荐路线与动态多日日程
- 沿途景点和当地美食
- 当日地点附近加油站和充电站
- 地点收藏、微信好友分享和个人中心
- 高德真实驾车方案 1/2/3，选择方案后按实际折线加载沿途景点和美食
- 微信地图精确选择起点和终点，支持最多 16 个途经点的添加、删除与排序
- 在小程序地图中绘制所选高德路线折线、起终点和途经点标记

正式接入高德数据时，需要在高德开放平台创建微信小程序应用，并在微信公众平台配置合法请求域名。Web 服务 Key 不应硬编码到小程序前端，建议通过云函数或自有后端转发。

自定义路线由后端 `/api/amap/driving` 返回最多三条高德驾车方案；用户选中方案后，小程序调用 `/api/amap/along-route`，按该方案折线采样点查询真实景点与餐饮 POI。需要在后端配置 `AMAP_KEY`，并把 `miniprogram/config.js` 的 `API_BASE` 设置为已加入微信合法域名的 HTTPS 后端地址。

## 定制后端

`server/` 是配套的 Node.js + TypeScript + Fastify + Prisma + PostgreSQL API，提供：

- 微信 `code2Session` 登录
- 行程、逐日日程和途经点存储
- 收藏与同行邀请
- 高德附近加油站、充电站代理

在 Zeabur 新建 PostgreSQL 服务和后端服务，将后端服务根目录设为 `server`，并配置：

```text
DATABASE_URL=<Zeabur PostgreSQL 连接串>
WECHAT_APPID=<微信小程序 AppID>
WECHAT_SECRET=<微信小程序 Secret>
AMAP_KEY=<高德 Web 服务 Key>
```

首次部署后在后端服务执行：

```bash
npx prisma migrate deploy
```

小程序只能访问已加入微信公众平台“服务器域名”的 HTTPS API 地址。

## Web 原型运行

直接打开 `index.html`，或使用静态服务器：

```bash
python3 -m http.server 4173
```

然后访问 `http://localhost:4173`。Web 原型入口为 `index.html`，仅用于浏览器预览，正式微信发布使用 `miniprogram/` 工程。