Skip to content

KaichenCurry/columbia-carpool-miniapp

Repository files navigation

🚗 Columbia Carpool Miniapp

Stars License Platform

面向哥大留学生的拼车小程序 — Fort Lee ↔ Columbia University

English · 产品需求文档 · 设计稿


📋 目录


项目介绍

是什么

面向 哥伦比亚大学留学生 的微信拼车小程序,解决 Fort Lee, NJ ↔ Columbia University 日常通勤需求。

核心场景

哥大学生住在 Fort Lee,每日通勤经过 乔治·华盛顿大桥(GWB),单程过桥费 $23.30。通过拼车,每位乘客仅需支付 $8,车主覆盖成本,乘客省钱。

两种拼车模式

模式 说明 费用
🚗 顺风车 车主发布行程,乘客加入 $8/人
🚕 Uber 拼单 乘客组队叫 Uber,AA 分摊 实时计价

问题与解决方案

三大痛点

flowchart LR
    subgraph Pain["痛点"]
        P1["💰 费用高<br/>GWB $23.30/次"]
        P2["📱 协调效率低<br/>微信群刷屏找拼车"]
        P3["🔒 信任难建立<br/>无法核实对方身份"]
    end

    subgraph Solution["解决方案"]
        S1["💵 多人分摊<br/>每人仅需 $8"]
        S2["📋 标准化流程<br/>一键发布/加入"]
        S3["✅ 哥大认证体系<br/>身份核实有保障"]
    end

    P1 --> S1
    P2 --> S2
    P3 --> S3

    style Pain fill:#ffcccc,stroke:#ff6666
    style Solution fill:#ccffcc,stroke:#66cc66
Loading

功能预览

用户操作流程

功能预览

Step 1:首页 — 拼车广场 浏览可用行程,查看地图和今日拼车人数。

Step 2:行程详情 查看车主信息、路线时间轴、费用明细,确认后加入。

Step 3:发起拼车 填写行程信息,设置时间、人数,发布自己的拼车。

Step 4:我的行程 管理已加入的行程,查看进行中/历史的订单。

Step 5:确认加入 选择支付方式(Zelle/Venmo),完成拼车加入。


核心功能

信任体系

功能 说明 状态
哥大认证 绑定 Columbia 邮箱或学生 ID
车主评分 5 星评分系统
实名车辆 车牌号、车型信息
历史行程 显示车主接单次数

费用透明

项目 金额 说明
GWB 过桥费 $8/人 固定价格
油费补贴 已包含 不额外收费
隐藏费用 明确标注

技术架构

系统架构

flowchart TD
    subgraph Frontend["微信小程序前端"]
        F1["pages/index<br/>拼车广场"]
        F2["pages/trip-detail<br/>行程详情"]
        F3["pages/create-trip<br/>发起拼车"]
        F4["pages/my-trips<br/>我的行程"]
        F5["components/*<br/>复用组件"]
        F6["services/*<br/>API 服务"]
    end

    subgraph Cloud["微信云开发"]
        C1["createTrip<br/>创建行程"]
        C2["joinTrip<br/>加入行程"]
        C3["leaveTrip<br/>退出行程"]
        C4["getTrips<br/>获取列表"]
        C5["verifyCU<br/>哥大认证"]
        C6["其他云函数"]
    end

    subgraph Database["微信云数据库"]
        D1["users<br/>用户信息"]
        D2["trips<br/>行程数据"]
        D3["passengers<br/>乘客关系"]
    end

    Frontend --> Cloud
    Cloud --> Database

    style Frontend fill:#e3f2fd,stroke:#2196f3
    style Cloud fill:#fff8e1,stroke:#ffc107
    style Database fill:#e8f5e9,stroke:#4caf50
Loading

快速开始

环境要求

环境 版本要求
微信开发者工具 最新版本
微信 8.0+

部署步骤

# 1. 克隆项目
git clone https://github.com/KaichenCurry/columbia-carpool-miniapp.git
cd columbia-carpool-miniapp

# 2. 导入项目
# 打开微信开发者工具,选择「导入项目」

# 3. 配置云环境
# 在 miniprogram/app.js 中修改云环境 ID

# 4. 创建云数据库集合
# users, trips, passengers

项目结构

columbia-carpool-miniapp/
├── miniprogram/                    # 小程序前端
│   ├── pages/
│   │   ├── index/               # 首页(拼车广场)
│   │   ├── trip-detail/          # 行程详情
│   │   ├── create-trip/          # 发起拼车
│   │   ├── my-trips/             # 我的行程
│   │   └── join-confirm/         # 确认加入
│   ├── components/                # 复用组件
│   ├── services/                  # API 服务层
│   └── app.js                    # 应用入口
│
├── cloudfunctions/                # 云函数
│   ├── createTrip/               # 创建行程
│   ├── joinTrip/               # 加入行程
│   ├── getTrips/               # 获取行程列表
│   ├── verifyCU/               # 哥大认证
│   └── ...
│
└── docs/
    ├── screenshots/             # 功能截图
    ├── PRD.md                  # 产品需求文档
    └── docs_FIGMA.md          # 设计稿说明

项目状态

✅ 已实现

功能 状态
5 页小程序界面
拼车创建和加入流程
哥大认证体系
Mock 数据调试

⚠️ 规划中

功能 状态
AI 智能出发时间建议 ⚠️ v1.1
完整支付集成 ⚠️ 规划中
实时位置追踪 ⚠️ 规划中

未来路线图

gantt
    title 产品路线图
    dateFormat  YYYY-MM
    section v1.0
    基础拼车流程       :2026-04, 2026-04
    哥大认证体系       :2026-04, 2026-04

    section v1.1
    AI 智能出发时间建议 :2026-05, 2026-07
    自然语言创建行程   :2026-05, 2026-07

    section v1.2
    历史数据分析       :2026-08, 2026-10
    常用路线收藏       :2026-08, 2026-10

    section v2.0
    机器学习推荐模型   :2026-11, 2027-01
    GWB 实时路况       :2026-11, 2027-01
    异常检测和预警     :2026-11, 2027-01
Loading

相关文档

文档 说明
PRD.md 产品需求文档
docs_FIGMA.md 设计稿说明
UI_COMPONENTS.md UI 组件规范

参与贡献

欢迎提交 Issue 和 Pull Request!


License

MIT License


如果这个项目对你有帮助,请给它一个 ⭐!

Made by Curry Chen

About

Workflow-first campus carpool miniapp MVP for Fort Lee ↔ Columbia commuting, with a roadmap toward AI-native features

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors