# codeBuddy **Repository Path**: chw91/code-buddy ## Basic Information - **Project Name**: codeBuddy - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-26 - **Last Updated**: 2026-03-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 商户视频小程序 一个功能完整的微信小程序，包含商品展示、视频播放、会员系统、积分商城、推广返利等核心功能。 ## 🎯 项目概述 本项目是一个商户视频小程序，集成了电商、视频、会员、推广等多种业务场景，适合商家进行产品展示、视频营销和用户管理。 ### 核心功能 - **商品管理**：商品列表、详情、搜索、收藏 - **视频展示**：视频列表、详情、播放、进度管理 - **购物车**：添加商品、管理数量、结算 - **订单系统**：订单创建、支付、查询、退款 - **会员系统**：会员等级、购买、权益管理 - **积分体系**：积分获取、签到、兑换 - **推广返利**：推广员、团队管理、佣金结算 - **优惠券**：领取、使用、管理 - **课程系统**：课程购买、学习、进度追踪 - **地址管理**：收货地址增删改查 - **帮助中心**：帮助文档、FAQ、反馈 ## 📁 项目结构 ``` codeBuddy/ ├── cloudfunctions/ # 云函数目录 │ ├── login/ # 登录云函数 │ ├── user/ # 用户云函数 │ ├── product/ # 商品云函数 │ ├── cart/ # 购物车云函数 │ ├── order/ # 订单云函数 │ ├── pay/ # 支付云函数 │ ├── video/ # 视频云函数 │ └── course/ # 课程云函数 ├── database/ # 数据库设计文档 ├── miniprogram/ # 小程序前端代码 │ ├── api/ # API 接口封装 │ │ ├── user.js │ │ ├── product.js │ │ ├── video.js │ │ ├── cart.js │ │ ├── order.js │ │ ├── pay.js │ │ ├── favorite.js │ │ ├── address.js │ │ ├── help.js │ │ ├── promoter.js │ │ ├── coupon.js │ │ ├── course.js │ │ └── points.js │ ├── components/ # 公共组件 │ │ ├── loading/ │ │ ├── empty/ │ │ ├── card/ │ │ ├── badge/ │ │ ├── button/ │ │ ├── tag/ │ │ ├── price/ │ │ ├── image-uploader/ │ │ ├── nav-bar/ │ │ ├── tabbar/ │ │ └── auth/ │ ├── images/ # 图片资源 │ ├── pages/ # 页面文件 │ │ ├── login/ # 登录注册 │ │ ├── home/ # 首页 │ │ ├── products/ # 商品列表 │ │ ├── videos/ # 视频列表 │ │ ├── cart/ # 购物车 │ │ ├── profile/ # 个人中心 │ │ ├── member/ # 会员中心 │ │ ├── points/ # 积分中心 │ │ ├── promoter/ # 推广中心 │ │ └── ... # 其他页面 │ ├── utils/ # 工具函数 │ │ ├── util.js │ │ ├── config.js │ │ ├── storage.js │ │ ├── validator.js │ │ └── date.js │ ├── app.js # 小程序入口 │ ├── app.json # 小程序配置 │ ├── app.wxss # 全局样式 │ └── project.config.json # 项目配置 ├── 产品设计方案-商户视频小程序.md ├── 核心业务流程设计.md ├── 技术规格说明书.md ├── 数据库结构设计.md ├── 页面线框图设计.md ├── 项目问题修复报告-最终版.md ├── 启动指南.md └── README.md # 本文件 ``` ## 🚀 快速开始 ### 环境要求 - Node.js 14+ - 微信开发者工具 - 微信小程序账号（可选，开发阶段可使用测试号） ### 安装依赖 ```bash npm install ``` ### 项目配置 1. **复制项目配置** 打开微信开发者工具，导入 `miniprogram` 目录。 2. **配置 AppID** - 开发阶段：使用测试号 - 正式发布：使用已注册的小程序 AppID 3. **配置云开发（可选）** 如需使用云函数功能： - 开通微信云开发 - 创建环境 - 复制环境 ID 到 `miniprogram/utils/config.js` ### 运行项目 1. 打开微信开发者工具 2. 导入项目目录：`d:/book/codeBuddy/miniprogram` 3. 点击"编译"按钮 4. 在模拟器中查看效果 ## 📚 详细文档 - [启动指南](./启动指南.md) - 详细的项目启动和使用说明 - [项目问题修复报告-最终版](./项目问题修复报告-最终版.md) - 问题修复记录 - [数据库设计](./database/README.md) - 数据库结构说明 - [产品设计方案](./产品设计方案-商户视频小程序.md) - 产品功能设计 - [核心业务流程设计](./核心业务流程设计.md) - 业务流程说明 - [技术规格说明书](./技术规格说明书.md) - 技术实现规范 - [页面线框图设计](./页面线框图设计.md) - 页面设计规范 ## ✅ 项目状态 ### 已完成 - ✅ 所有配置文件完整 - ✅ 所有 API 接口封装完成 - ✅ 所有页面文件创建完成 - ✅ 所有公共组件实现完成 - ✅ 工具函数库完整 - ✅ 基础图标资源已创建（占位符） - ✅ npm 依赖安装完成 ### 待完成 - ⏳ 云函数实现（8个云函数目录已创建，待实现逻辑） - ⏳ 数据库初始化 - ⏳ 真实图标资源替换 - ⏳ 支付功能集成 - ⏳ 测试和优化 ## 🔧 开发规范 ### 代码风格 - 使用 ES6+ 语法 - 缩进：2 空格 - 使用 const/let 替代 var - 函数添加 JSDoc 注释 ### 文件命名 - 页面文件：小写字母 + 连字符 - 组件文件：小写字母 + 连字符 - API 文件：小写字母 + 连字符 - 工具文件：小写字母 + 连字符 ### Git 提交规范 ``` feat: 新功能 fix: 修复 bug docs: 文档更新 style: 代码格式调整 refactor: 代码重构 test: 测试相关 chore: 构建/工具链 ``` ## 🛠️ 技术栈 ### 前端 - 微信小程序原生框架 - WXML (微信标记语言) - WXSS (微信样式表) - JavaScript ES6+ ### 后端 - 微信云开发（云函数） - 云数据库（MongoDB） - 云存储（图片/视频） ### 支付 - 微信支付 - 余额支付 ## 📊 功能模块 ### 1. 用户模块 - 微信登录 - 用户信息管理 - 会员等级管理 ### 2. 商品模块 - 商品列表 - 商品详情 - 商品搜索 - 商品收藏 ### 3. 视频模块 - 视频列表 - 视频详情 - 视频播放 - 观看进度 ### 4. 购物车模块 - 添加商品 - 修改数量 - 删除商品 - 购物车结算 ### 5. 订单模块 - 创建订单 - 订单支付 - 订单查询 - 订单退款 ### 6. 会员模块 - 会员购买 - 会员权益 - 会员等级 ### 7. 积分模块 - 积分获取 - 积分兑换 - 签到奖励 ### 8. 推广模块 - 推广员申请 - 推广海报 - 团队管理 - 佣金结算 ### 9. 优惠券模块 - 领取优惠券 - 使用优惠券 - 优惠券管理 ### 10. 课程模块 - 课程购买 - 课程学习 - 学习进度 - 课程笔记 ## 🧪 测试 ### 运行验证脚本 ```bash # 检查页面文件完整性 node check-pages.js # 检查项目完整性 node 项目验证脚本.js ``` ### 手动测试 1. 在微信开发者工具中编译项目 2. 测试各个页面跳转 3. 测试核心功能流程 4. 检查控制台错误信息 ## 📞 支持与反馈 - 问题反馈：查看控制台错误信息 - 文档参考：查看项目根目录下的文档 - 技术支持：参考[微信小程序开发文档](https://developers.weixin.qq.com/miniprogram/dev/framework/) ## 📄 许可证 本项目仅供学习和参考使用。 ## 🙏 致谢 感谢所有为本项目贡献的开发者。 --- **开始开发**：查看 [启动指南](./启动指南.md) **项目状态**：所有基础文件完整，可以直接在微信开发者工具中运行！