chore(realse): 完善发布流程

2025-12-22 09:50:12 +08:00
parent ea3e2d9ae8
commit 8ee9a95f1b
5 changed files with 377 additions and 52 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,192 @@
+# 数码喷墨墨水微信小程序项目
+
+## 项目介绍
+
+本项目是为数码喷墨墨水客户定制开发的微信小程序，用于展示和销售数码喷墨墨水产品，提供在线购物、订单管理、用户中心等功能。
+
+- **客户名称**：数码喷墨墨水
+- **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