192 lines
5.5 KiB
Markdown
192 lines
5.5 KiB
Markdown
# 数码喷墨墨水微信小程序项目
|
||
|
||
## 项目介绍
|
||
|
||
本项目是为数码喷墨墨水客户定制开发的微信小程序，用于展示和销售数码喷墨墨水产品，提供在线购物、订单管理、用户中心等功能。
|
||
|
||
- **客户名称**：数码喷墨墨水
|
||
- **uniacid**：2285
|
||
- **后台网站地址**：https://xcx.aigc-quickapp.com
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
├── app.js # 小程序入口文件
|
||
├── app.json # 小程序全局配置
|
||
├── app.wxss # 小程序全局样式
|
||
├── common/ # 公共文件目录
|
||
│ ├── main.js # 主入口文件
|
||
│ ├── main.wxss # 主样式文件
|
||
│ ├── runtime.js # 运行时文件
|
||
│ └── vendor.js # 第三方依赖文件
|
||
├── components/ # 自定义组件目录
|
||
│ ├── common-payment/ # 公共支付组件
|
||
│ ├── diy-components/ # DIY组件
|
||
│ ├── hover-nav/ # 悬浮导航组件
|
||
│ ├── loading-cover/ # 加载遮罩组件
|
||
│ ├── mescroll/ # 滚动加载组件
|
||
│ ├── ns-adv/ # 广告组件
|
||
│ ├── ns-contact/ # 联系组件
|
||
│ ├── ns-copyright/ # 版权组件
|
||
│ ├── ns-empty/ # 空状态组件
|
||
│ ├── ns-form/ # 表单组件
|
||
│ ├── ns-goods-action/# 商品操作组件
|
||
│ ├── ns-goods-sku/ # 商品SKU组件
|
||
│ ├── ns-loading/ # 加载组件
|
||
│ ├── ns-login/ # 登录组件
|
||
│ ├── ns-navbar/ # 导航栏组件
|
||
│ ├── ns-new-gift/ # 新手礼品组件
|
||
│ ├── ns-newform/ # 新表单组件
|
||
│ ├── ns-payment/ # 支付组件
|
||
│ ├── ns-select-time/ # 时间选择组件
|
||
│ ├── ns-switch/ # 开关组件
|
||
│ ├── payment/ # 支付相关组件
|
||
│ ├── pick-regions/ # 地区选择组件
|
||
│ ├── register-reward/# 注册奖励组件
|
||
│ └── toTop/ # 返回顶部组件
|
||
├── pages/ # 页面目录
|
||
│ ├── contact/ # 联系我们页面
|
||
│ ├── goods/ # 商品相关页面
|
||
│ ├── index/ # 首页
|
||
│ ├── member/ # 会员中心
|
||
│ └── order/ # 订单相关页面
|
||
├── pages_promotion/ # 促销活动页面
|
||
├── pages_tool/ # 工具页面
|
||
├── project.config.json # 微信开发者工具配置
|
||
├── site.js # 站点配置文件
|
||
├── static/ # 静态资源目录
|
||
│ └── img/ # 图片资源
|
||
└── uni_modules/ # uni_modules模块
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
- **开发框架**：微信小程序原生开发
|
||
- **组件库**：自定义组件 + uni_modules
|
||
- **数据请求**：微信小程序原生API
|
||
- **状态管理**：小程序全局状态
|
||
|
||
## 安装和运行
|
||
|
||
### 环境要求
|
||
|
||
- 微信开发者工具
|
||
- Node.js (可选，用于依赖管理)
|
||
|
||
### 安装步骤
|
||
|
||
1. 克隆或下载项目到本地
|
||
2. 打开微信开发者工具
|
||
3. 导入项目目录
|
||
4. 配置appid（如果需要）
|
||
5. 点击编译运行
|
||
|
||
## 项目配置
|
||
|
||
### 站点配置
|
||
|
||
在`site.js`文件中配置站点信息：
|
||
|
||
```javascript
|
||
module.exports={
|
||
baseUrl: "https://xcx.aigc-quickapp.com", // 后台接口地址
|
||
uniacid: 2285 // 站点ID
|
||
};
|
||
```
|
||
|
||
### 全局配置
|
||
|
||
在`app.json`文件中配置小程序的全局设置，包括页面路径、窗口样式、tabBar等。
|
||
|
||
## 主要功能模块
|
||
|
||
### 首页
|
||
- 轮播图展示
|
||
- 商品分类导航
|
||
- 热门商品推荐
|
||
- 促销活动展示
|
||
|
||
### 商品模块
|
||
- 商品列表展示
|
||
- 商品详情查看
|
||
- 商品SKU选择
|
||
- 商品搜索功能
|
||
|
||
### 购物车
|
||
- 商品添加/删除
|
||
- 商品数量调整
|
||
- 购物车结算
|
||
|
||
### 订单模块
|
||
- 订单生成
|
||
- 订单列表
|
||
- 订单详情
|
||
- 订单支付
|
||
- 订单售后
|
||
|
||
### 会员中心
|
||
- 用户信息管理
|
||
- 收货地址管理
|
||
- 优惠券管理
|
||
- 积分管理
|
||
- 充值功能
|
||
|
||
### 联系我们
|
||
- 联系方式展示
|
||
- 在线客服
|
||
|
||
## 开发注意事项
|
||
|
||
1. 所有接口请求需通过`baseUrl`配置的后台地址
|
||
2. 组件使用需遵循微信小程序组件规范
|
||
3. 页面跳转需使用微信小程序导航API
|
||
4. 数据缓存需使用微信小程序存储API
|
||
5. 开发过程中需注意小程序的尺寸限制和性能优化
|
||
|
||
## 部署说明
|
||
|
||
1. 在微信开发者工具中点击"上传"
|
||
2. 填写版本号和更新日志
|
||
3. 登录微信公众平台
|
||
4. 进入版本管理
|
||
5. 提交审核
|
||
6. 审核通过后发布上线
|
||
|
||
## 项目发布
|
||
|
||
### 使用 release.js 脚本发布
|
||
|
||
1. 确保已安装 Node.js 环境
|
||
2. 在项目根目录执行以下命令：
|
||
```bash
|
||
node release.js
|
||
```
|
||
|
||
### 生成文件说明
|
||
|
||
- **输出目录**：项目根目录下的 `dist/` 文件夹
|
||
- **主要文件**：
|
||
- 压缩后的小程序源代码文件
|
||
- 按日期命名的 ZIP 压缩包（格式：`数码喷墨墨水-定制化-YYYY-MM-DD-mp-weixin.zip`）
|
||
|
||
### 交付给发布人员的文件格式
|
||
|
||
- 交付文件：`dist/` 目录下生成的 ZIP 压缩包
|
||
- 文件命名：`数码喷墨墨水-定制化-YYYY-MM-DD-mp-weixin.zip`（YYYY-MM-DD 为当前日期）
|
||
- 交付内容：包含完整的小程序源代码，已进行 WXML 压缩优化
|
||
|
||
发布人员可直接使用此 ZIP 压缩包进行小程序上线发布操作。
|
||
|
||
## 维护和更新
|
||
|
||
- 定期检查后台接口变化
|
||
- 及时更新小程序版本
|
||
- 修复用户反馈的问题
|
||
- 优化用户体验
|
||
|
||
## 联系方式
|
||
|
||
如有问题或建议，请联系技术支持：
|
||
- 后台管理地址：https://xcx.aigc-quickapp.com
|
||
- 客户名称：数码喷墨墨水
|
||
- uniacid：2285 |