更新记录

1.0.0（2025-11-20）

星云车友俱乐部

项目介绍

星云车友俱乐部是一个专为车友打造的高端社交平台，提供路线推荐、活动组织、车友交流等功能，支持多平台部署（微信小程序、H5、APP）。

主要功能

核心功能

用户系统：注册、登录、个人资料管理、实名认证
路线推荐：精选自驾路线、路线详情、导航功能
活动组织：车友活动发布、报名、管理
车友圈：车友动态分享、评论、点赞
车辆管理：车辆信息管理、保养记录

用户中心模块

个人主页：展示用户基本信息、活动统计、路线记录
编辑资料：修改用户头像、昵称、联系方式、车辆信息
我的活动：管理用户参与的活动、查看活动状态
我的路线：管理用户的收藏路线、自定义路线
我的帖子：查看和管理用户在车友圈的动态
设置：应用相关设置、隐私设置

技术栈

前端技术

框架：uni-app (Vue.js跨平台框架)
UI组件库：vk-uview-ui
状态管理：Vuex
样式预处理：SCSS

后端技术

云开发：uniCloud (阿里云)
数据库：NoSQL数据库
用户系统：uni-id
云函数框架：vk-unicloud-router

项目结构

├── App.vue              # 应用入口文件
├── main.js              # 应用入口JS
├── pages.json           # 页面路由配置
├── manifest.json        # 应用配置文件
├── common/              # 公共资源
│   ├── css/             # 公共样式
│   └── function/        # 公共函数
├── pages/               # 页面文件
│   ├── index/           # 首页
│   ├── login/           # 登录页
│   ├── profile/         # 用户中心及子页面
│   ├── community/       # 车友圈
│   ├── activity/        # 活动相关
│   ├── route/           # 路线相关
│   ├── car/             # 车辆管理
│   ├── notification/    # 通知相关
│   ├── search/          # 搜索页面
│   ├── settings/        # 设置页面
│   ├── favorite/        # 收藏页面
│   ├── order/           # 订单管理
│   ├── help/            # 帮助中心
│   └── about/           # 关于我们
├── static/              # 静态资源
│   ├── logo.png         # 应用Logo
│   └── tabbar/          # 底部导航栏图标
├── store/               # Vuex状态管理
├── uni_modules/         # uni-app模块
│   ├── uni-config-center/# 配置中心
│   ├── uni-id/          # 用户系统
│   ├── vk-uni-pay/      # 支付模块
│   ├── vk-unicloud/     # 云开发框架
│   └── vk-uview-ui/     # UI组件库
└── uniCloud-aliyun/     # uniCloud云开发资源
    ├── cloudfunctions/  # 云函数
    └── database/        # 数据库配置

安装指南

前置条件

安装HBuilderX编辑器
注册DCloud开发者账号
创建uniCloud云服务空间

项目导入

克隆或下载项目代码
在HBuilderX中导入项目
关联uniCloud云服务空间

云开发环境配置

右键点击uniCloud目录，选择运行云服务空间初始化向导
根据提示完成初始化配置
上传common模块和router云函数

前端开发配置

main.js已配置uView UI引入

import uView from './uni_modules/vk-uview-ui';
Vue.use(uView);

App.vue已引入基础样式

<style lang="scss">
@import "./uni_modules/vk-uview-ui/index.scss";
</style>

uni.scss已引入全局变量

@import "@/uni_modules/vk-uview-ui/theme.scss";

功能页面说明

首页 (pages/index/index.vue)

应用的首页，展示推荐路线、热门活动、车友动态，包含底部导航栏。

登录页 (pages/login/login.vue)

用户登录界面，支持账号密码登录、短信验证码登录和第三方登录。

用户中心 (pages/profile/profile.vue)

用户个人中心，展示用户基本信息、活动统计、路线记录和功能入口。

车友圈 (pages/community/community.vue)

车友交流社区，展示车友动态、分享、评论和点赞功能。

活动管理 (pages/activity/activity.vue)

车友活动页面，展示活动列表、活动详情、报名功能。

路线推荐 (pages/route/index.vue)

展示推荐自驾路线，包括路线详情、导航功能。

路线详情 (pages/route/detail.vue)

展示路线详细信息，包括路线图、途经景点、注意事项等。

车辆管理 (pages/car/manage.vue)

管理用户的车辆信息，包括添加、编辑、删除车辆。

消息通知 (pages/notification/notification.vue)

展示系统通知、活动状态更新和车友互动提醒。

搜索页面 (pages/search/search.vue)

提供搜索功能，包括搜索历史、热门路线和活动搜索结果。

收藏页面 (pages/favorite/index.vue)

管理用户收藏的路线、活动和车友动态。

订单管理 (pages/order/index.vue)

管理用户的订单，查看订单状态和历史订单。

设置页面 (pages/profile/settings.vue)

应用相关设置，包括账号安全、隐私设置、消息通知设置等。

帮助中心 (pages/help/index.vue)

提供常见问题解答、使用指南和意见反馈功能。

关于我们 (pages/about/index.vue)

展示应用介绍、版本信息和联系方式。

开发说明

云函数调用方式

项目使用vk-unicloud-router框架，通过统一的云函数入口调用各业务逻辑：

vk.callFunction({
    url: 'service路径',
    data: { /* 请求参数 */ },
    success: (res) => { /* 成功回调 */ }
});

数据库操作

使用vk.baseDao API简化数据库操作：

支持增删改查基本操作
提供连表查询、分页查询等高级功能
内置权限控制和数据过滤

发布部署

微信小程序

在manifest.json中配置微信小程序信息
选择发行 -> 小程序-微信
按照提示完成发布流程

H5

选择发行 -> H5
配置相关参数后生成H5包
部署到Web服务器

APP

选择发行 -> App云端打包
配置应用信息和证书
等待打包完成并下载安装包

注意事项

开发环境和生产环境需要分别配置
敏感信息如AppID、密钥等应配置在安全的地方
云函数修改后需要重新上传才能生效
数据库 schema 修改后需要同步更新

License

Apache-2.0

平台兼容性

云端兼容性

阿里云	腾讯云	支付宝云
√	√	√

uni-app(4.36)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
√	√	√	√	√	√	√	√	√

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	快应用-华为	快应用-联盟
√	√	√	√	√	√	√	√	√	√	√

其他

多语言	暗黑模式	宽屏模式
√	×	×

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+