更新记录

1.0.0（2025-09-25）

星云酒店预订

项目介绍

星云酒店预订是一个基于uni-app和uniCloud开发的酒店预订平台，参考华住会的功能设计，提供酒店搜索、预订、订单管理、会员服务等功能，支持多平台部署（微信小程序、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/           # 登录页
│   ├── register/        # 注册页
│   ├── userCenter/      # 用户中心
│   ├── hotelDetail/     # 酒店详情
│   ├── hotelList/       # 酒店列表
│   ├── booking/         # 预订相关
│   ├── orderList/       # 订单列表
│   ├── orderDetail/     # 订单详情
│   ├── payment/         # 支付页面
│   ├── search/          # 搜索相关
│   ├── reviews/         # 评价管理
│   ├── writeReview/     # 写评价
│   ├── favorites/       # 收藏列表
│   ├── history/         # 浏览历史
│   ├── coupons/         # 优惠券
│   ├── points/          # 积分系统
│   ├── settings/        # 设置页面
│   ├── userInfo/        # 用户信息
│   ├── security/        # 账号安全
│   ├── realNameAuth/    # 实名认证
│   ├── addressList/     # 地址管理
│   ├── changePassword/  # 修改密码
│   ├── forgotPassword/  # 忘记密码
│   ├── smsLogin/        # 短信登录
│   ├── privacy/         # 隐私政策
│   ├── service/         # 服务条款
│   ├── privacySettings/ # 隐私设置
│   ├── deviceManagement/ # 设备管理
│   ├── thirdPartyAuth/  # 第三方授权
│   ├── customerService/ # 客服中心
│   ├── about/           # 关于我们
│   └── webView/         # 网页视图
├── static/              # 静态资源
│   ├── logo.png         # 应用Logo
│   └── tabbar/          # 底部导航栏图标
├── store/               # Vuex状态管理
├── uni_modules/         # uni-app模块
│   ├── uni-id/          # 用户系统
│   ├── 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/register/register.vue)

用户注册界面，支持手机号注册，包含验证码验证。

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

用户个人中心，展示用户信息、会员等级和订单统计，包含订单、收藏、设置等子页面。

酒店详情 (pages/hotelDetail/hotelDetail.vue)

展示酒店详细信息，包括房型、价格、设施、评价等，支持立即预订。

酒店列表 (pages/hotelList/hotelList.vue)

按条件搜索展示酒店列表，支持筛选和排序。

订单管理 (pages/orderList/orderList.vue)

展示用户订单列表，支持订单详情查看、取消、退款等操作。

订单详情 (pages/orderDetail/orderDetail.vue)

展示订单详细信息，包括酒店信息、入住信息、支付信息等。

预订页面 (pages/booking/booking.vue)

酒店预订页面，选择房型、入住日期、填写订单信息。

支付页面 (pages/payment/payment.vue)

订单支付页面，支持多种支付方式。

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

酒店搜索页面，支持关键词搜索、热门搜索、搜索历史等功能。

评价管理 (pages/reviews/reviews.vue)

用户评价管理页面，展示已发布的评价和评价详情。

写评价 (pages/writeReview/writeReview.vue)

用户撰写评价页面，支持文字、图片评价。

收藏列表 (pages/favorites/favorites.vue)

用户收藏的酒店列表。

浏览历史 (pages/history/history.vue)

用户浏览过的酒店历史记录。

优惠券 (pages/coupons/coupons.vue)

用户优惠券列表，展示可用和已过期优惠券。

积分系统 (pages/points/points.vue)

用户积分管理页面，展示积分明细和积分兑换。

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

应用设置页面，包含账号设置、通用设置、其他设置等。

用户信息 (pages/userInfo/userInfo.vue)

用户个人信息编辑页面。

账号安全 (pages/security/security.vue)

账号安全管理页面，包含密码修改、安全验证等。

实名认证 (pages/realNameAuth/realNameAuth.vue)

用户实名认证页面，支持身份证认证和人脸识别。

地址管理 (pages/addressList/addressList.vue)

用户地址管理页面，支持添加、编辑、删除地址。

修改密码 (pages/changePassword/changePassword.vue)

用户修改密码页面。

忘记密码 (pages/forgotPassword/forgotPassword.vue)

用户忘记密码找回页面。

短信登录 (pages/smsLogin/smsLogin.vue)

用户短信验证码登录页面。

隐私政策 (pages/privacy/privacy.vue)

应用隐私政策页面。

服务条款 (pages/service/service.vue)

应用服务条款页面。

隐私设置 (pages/privacySettings/privacySettings.vue)

用户隐私设置页面，管理个人信息授权。

设备管理 (pages/deviceManagement/deviceManagement.vue)

用户登录设备管理页面。

第三方授权 (pages/thirdPartyAuth/thirdPartyAuth.vue)

第三方应用授权管理页面。

客服中心 (pages/customerService/customerService.vue)

客服中心页面，提供在线客服和常见问题。

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

应用介绍页面，包含版本信息和联系方式。

网页视图 (pages/webView/webView.vue)

网页视图页面，用于加载外部网页内容。

开发说明

云函数调用方式

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

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

数据库操作

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

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

发布部署

微信小程序

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

H5

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

APP

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

注意事项

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

更新日志

2025.06.18: 更新项目结构，完善页面功能说明
2025.06.18: 添加安全与隐私模块功能说明
2025.06.18: 优化API调用方式，统一使用vk实例
2025.08.31: 项目从星云社区转型为星云酒店预订平台
2025.08.31: 完成酒店预订功能框架设计
2025.08.31: 实现用户系统和会员功能
2025.08.31: 添加酒店搜索和预订功能

License

MIT

平台兼容性

云端兼容性

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

uni-app(4.36)

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

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

其他

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

云函数类插件通用教程

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