# 家政预约小程序 **Repository Path**: itcode-itcode/itcode_jiazheng_wxapp ## Basic Information - **Project Name**: 家政预约小程序 - **Description**: 家政预约小程序 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-19 - **Last Updated**: 2026-01-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 家政预约小程序 # 一、项目概述 本项目是一款基于微信云开发与微信小程序技术栈构建的家政预约小程序，旨在搭建用户与家政服务人员之间的高效对接桥梁，解决传统家政服务预约流程繁琐、信息不透明、沟通成本高的痛点。通过小程序的轻量化、便捷性优势，结合微信云开发的无服务器架构特性，实现家政服务的在线浏览、预约下单、订单管理、服务评价等全流程功能，为用户提供便捷、可靠的家政服务体验，同时帮助家政服务人员高效管理订单，提升服务效率。 项目无需搭建独立服务器，依托微信云开发的云数据库、云存储、云函数等核心能力，快速实现数据存储、业务逻辑处理和资源管理，降低项目开发与运维成本，适合快速迭代与推广。 # 二、核心功能 ## 2.1 用户端功能 - **用户注册登录**：基于微信小程序快捷登录能力，实现一键授权登录，自动获取用户微信昵称、头像等基础信息，无需手动填写，简化登录流程。 - **服务浏览**：展示各类家政服务分类（如日常保洁、深度清洁、家电清洗、保姆月嫂等），支持按服务类型、价格、评分等条件筛选，服务详情页展示服务介绍、价格、服务时长、服务人员信息、用户评价等内容。 - **在线预约**：用户选择服务后，可选择服务时间、服务地址，填写服务需求备注，提交预约订单，支持在线支付（集成微信支付）。 - **订单管理**：展示用户所有订单列表，按订单状态（待支付、待服务、服务中、已完成、已取消）分类查看，支持订单详情查看、订单取消、服务确认完成等操作。 - **服务评价**：服务完成后，用户可对服务人员的服务态度、服务质量进行评分，并填写评价内容，评价信息实时展示在对应服务详情页，为其他用户提供参考。 - **个人中心**：展示用户个人信息，支持修改昵称、联系方式、常用地址等，查看我的收藏、评价记录、帮助中心等。 ## 2.2 服务人员端功能 - **身份认证**：服务人员需提交个人身份信息、家政服务资质证明等材料，经平台审核通过后，方可入驻提供服务。 - **订单接收与处理**：接收用户预约订单通知，可选择接单或拒单（需填写拒单理由），接单后可查看订单详情，联系用户确认服务细节。 - **服务进度管理**：支持更新服务进度（如已出发、服务中、已完成），实时同步给用户，让用户及时了解服务状态。 - **收入统计**：展示个人服务订单收入明细、总收入统计，支持查看历史收入记录。 - **个人中心**：展示个人认证信息、服务评分、服务记录，支持修改个人信息、服务范围、服务时间等。 ## 2.3 管理员端功能（云开发控制台/小程序后台） - **用户管理**：查看所有用户列表，管理用户状态，可禁用违规用户账号。 - **服务人员管理**：审核服务人员入驻申请，查看服务人员资质信息，管理服务人员状态（启用/禁用）。 - **服务管理**：发布、编辑、删除家政服务项目，设置服务分类、价格、服务标准等信息。 - **订单管理**：查看所有订单列表，按订单状态、时间、用户等条件筛选，可处理订单纠纷、取消异常订单。 - **数据统计**：统计平台订单量、交易额、活跃用户数、热门服务类型等数据，生成数据报表，为运营决策提供支持。 - **系统设置**：设置平台基础参数（如服务佣金比例、退款规则、消息模板等），管理平台公告、帮助中心内容。 # 三、技术栈选型 ## 3.1 前端技术 - 框架：微信小程序原生开发框架（WXML + WXSS + JavaScript/TypeScript） - UI组件库：WeUI 或 Vant Weapp（轻量、适配小程序，提升开发效率） - 状态管理：小程序内置数据绑定 + 全局变量（简单场景）或 MobX 小程序适配版（复杂场景） - API调用：微信小程序官方API（登录、支付、地理位置、消息通知等） ## 3.2 后端技术 - 核心服务：微信云开发（CloudBase） - 云数据库：MongoDB 兼容版，存储用户数据、服务数据、订单数据、评价数据等 - 云存储：存储服务人员资质图片、服务场景图片、用户头像等静态资源 - 云函数：处理复杂业务逻辑（如订单创建、支付回调、消息推送、数据统计等），实现前后端分离 - 云托管：可选，用于部署需要自定义运行环境的后端服务（如复杂数据处理、第三方API集成） - 支付集成：微信支付 API（实现订单在线支付功能） - 消息通知：微信小程序模板消息/订阅消息（订单状态变更、服务提醒、评价提醒等） ## 3.3 开发/运维工具 - 开发工具：微信开发者工具（集成代码编辑、调试、预览、上传功能） - 版本控制：Git（Gitee 托管代码） - 云开发控制台：管理云数据库、云存储、云函数，查看运行日志、监控资源使用情况 # 四、系统设计 ## 4.1 整体架构设计 本项目采用“前端小程序 + 后端微信云开发”的架构模式，无需传统服务器部署，架构简洁清晰，具体分层如下： 1. **表现层**：微信小程序前端，负责用户交互、页面展示，通过小程序API与云开发服务进行通信。 2. **业务逻辑层**：微信云函数，处理核心业务逻辑（如订单校验、支付处理、消息推送、数据统计等），隔离前端与数据层，提升系统安全性与可维护性。 3. **数据层**：微信云数据库，存储各类业务数据；云存储，存储静态资源，提供高可用、可扩展的数据存储服务。 4. **第三方服务层**：集成微信支付、微信登录、订阅消息等第三方服务，扩展系统功能。 ## 4.2 数据库设计（核心集合） 基于微信云开发的云数据库（MongoDB），设计以下核心集合（Collection）： ## 4.4 云函数设计（核心） 1. **login（登录云函数）**：处理用户微信快捷登录，获取openid，查询或创建用户信息，返回用户信息给前端。 2. **createOrder（创建订单云函数）**：校验用户信息、服务信息，生成订单编号，创建订单记录，返回订单信息。 3. **payCallback（支付回调云函数）**：接收微信支付回调通知，验证回调签名，更新订单支付状态，推送支付成功消息。 4. **updateOrderStatus（更新订单状态云函数）**：处理订单状态变更（如接单、服务中、完成、取消），同步更新相关数据，推送状态变更消息。 5. **submitComment（提交评价云函数）**：保存用户评价信息，更新服务人员的平均评分与订单数，推送评价提醒消息给服务人员。 6. **getStatistics（数据统计云函数）**：统计平台订单量、交易额、活跃用户数等数据，返回给管理员端。 # 五、部署与运行说明 ## 5.1 前置条件 1. 注册微信小程序账号，完成小程序实名认证，获取小程序AppID（需非个人主体账号，用于集成支付等功能）。 2. 开通微信云开发服务：进入微信开发者工具，创建小程序项目，开启云开发，创建云环境（记录环境ID）。 3. 安装微信开发者工具（最新版本）。 ## 5.2 项目部署步骤 1. 克隆代码：从Gitee仓库克隆项目代码到本地。 2. 配置项目： - 打开微信开发者工具，导入项目，填写项目名称、项目目录，输入小程序AppID。 - 在项目根目录的app.js中，配置云环境ID：wx.cloud.init({ env: '你的云环境ID' }) 3. 初始化云数据库： - 进入云开发控制台，创建核心集合（users、serviceWorkers、services、orders、comments、systemConfig）。 - 在systemConfig集合中添加基础配置（如服务佣金比例、退款规则等）。 4. 部署云函数： - 在微信开发者工具中，右键云函数目录，选择“上传并部署”，将所有云函数部署到云开发环境。 5. 上传静态资源：将服务封面图、详情图等静态资源上传到云存储，并更新services集合中的图片URL。 6. 预览与调试：在微信开发者工具中预览项目，调试功能是否正常，修复问题。 7. 发布上线： - 在微信开发者工具中，点击“上传”，将项目上传到微信小程序后台。 - 进入微信小程序后台，提交审核，审核通过后发布上线。 ## 5.3 运行环境 - 前端：微信小程序（支持iOS、Android系统微信客户端） - 后端：微信云开发（无需服务器，依托微信云服务） # 六、项目优势 1. **技术优势**：基于微信云开发，无需搭建服务器，开发周期短、运维成本低，快速实现产品落地；小程序原生开发，体验流畅，适配各类微信客户端。 2. **用户体验优势**：轻量化设计，无需下载安装，微信内即可使用；快捷登录、在线预约、在线支付，流程简化，操作便捷；服务信息透明，评价体系完善，提升用户信任度。 3. **运营优势**：支持多角色管理（用户、服务人员、管理员），运营效率高；数据统计功能完善，助力运营决策；可通过微信生态进行推广（朋友圈、微信群、公众号联动），获客成本低。 # 七、后续迭代计划 1. 新增服务人员定位功能，用户可查看服务人员实时位置。 2. 优化推荐算法，根据用户历史订单、浏览记录推荐个性化服务。 3. 增加优惠券、积分体系，提升用户粘性与复购率。 4. 扩展服务类型，新增家政用品商城，实现“服务+商品”一体化运营。 5. 增加多语言支持，适配更多用户群体。 # 联系方式 如有技术问题或合作需求，可通过以下方式联系： - 公众号:程序源代码 - 微信：itcoder