Merge remote-tracking branch 'remotes/origin/dev/1.0' into zhu-kaijiie/dev-1.0

manifest.json

@@ -104,7 +104,7 @@
         },
         "router" : {
             "mode" : "history",
-            "base" : "/hwappx/common/"
+            "base" : "/hwappx/2811/"
         },
         "title" : "",
         "devServer" : {

readme.md

@@ -1,7 +1,5 @@
 # 小程序及快应用前端源码
 
-来源于外包提供的源代码，"0731xcx20微信小程序(1).zip"
-
 
 ## 项目说明
 
@@ -9,7 +7,7 @@
 
 ## 开发说明
 
-1. 源码基于Vue2版本，scss采用node-sass进行编译输出。
+ 源码基于Vue2版本，scss采用dart-sass进行编译输出。
 
 
 ## 开发调试说明
@@ -18,7 +16,7 @@
 
 应用访问等关键参数的配置来源于 `./common/js/config.js`
 
-### 小程序调试
+
 
 
 
@@ -26,151 +24,90 @@
 
 ### 小程序发布
 
-基本操作步骤：
-
-1. 使用HBuilderX打开项目
-2. 选择菜单栏 "发行" -> "小程序-微信"，进行发布构建
-3. 然后在终端进入项目根目录，执行 `npm run mp-weixin` 手动输出构建包。例如：mp-weixin-2025-10-31-1761881054836.zip（改id）
-4. 然后将mp-weixin-2025-10-31-1761881054836发给微信开发定制客户技术人员，
-5. 定制客户技术人员可以修改解压后，修改项目根目录下的site.js，进行针对客户的信息配置，然后使用微信开发者工具打开发布后的代码进行上传发布
-
-参照：`common\js\config.js` 文件内容说明：
-
-```js
-// 发行版本，配置说明
-let releaseCfg = undefined;
-try {
-    if (site) {
-        releaseCfg = {
-            baseUrl: site.baseUrl,
-            imgDomain: site.baseUrl,
-            h5Domain: site.baseUrl,
-            uniacid: site.uniacid,
-        }
-    }
-} catch (e) {}
-
-// 调试版本，配置说明
-const devCfg = {
-    // 商户ID
-    uniacid: 460, //825
-
-    //api请求地址
-    baseUrl: 'https://xcx30.5g-quickapp.com/',
-
-    // 图片域名
-    imgDomain: 'https://xcx30.5g-quickapp.com/',
-
-    // H5端域名
-    h5Domain: 'https://xcx30.5g-quickapp.com/',
-
-    // // api请求地址
-    // baseUrl: 'https://tsaas.liveplatform.cn/',
-
-    // // 图片域名
-    // imgDomain: 'https://tsaas.liveplatform.cn/',
-
-    // // H5端域名
-    // h5Domain: 'https://tsaas.liveplatform.cn/',
-
-    // api请求地址
-    // baseUrl: 'http://saas.cn/',
-
-    // // 图片域名
-    // imgDomain: 'http://saas.cn/',
-
-    // // H5端域名
-    // h5Domain: 'http://saas.cn/',
-};
-
-var config = {
-    /**
-     * 1.开发调试模式
-     * 去掉注释 ...devCfg;
-     * 注释掉 ...releaseCfg,
-     * 2.发行/发布模式，例如通过`HBuilder>发行>小程序微信`的时候，原理
-     * 然后将 `import site from "../site.js";`追加到   `unpackage\dist\build\mp-weixin\common\vendor.js` 文件内容开头部分
-     * 然后将 site.js 文件放到 `unpackage\dist\build\mp-weixin\` 目录下面
-     */
-    ...(releaseCfg ?? devCfg),
 
 
-    // 腾讯地图key 
+#### 基本操作步骤：（通用版/定制化版）
-    mpKey: 'TUHBZ-CNWKU-UHAVP-GZQ26-HNZFO-3YBF4',
+
+#### 【前置准备】
+1. 在项目根目录打开终端安装依赖“npm install”（已有依赖可跳过此步骤）。
+#### 【发布构建】
+2. 使用HBuilderX打开项目；
+3. 选择菜单栏「发行」 → 「小程序-微信」→ 「发行」，等待构建完成。（⚠️注：底部控制台弹出"请在微信小程序开发者工具中点击上传"后再执行下一步）；
+4. 打开资源管理器→项目根目录，右键选择「在终端中打开」，执行"npm run mp-weixin"命令并回车；
+
+5. 找到项目根目录 /unpackage/dist/build 下生成的 mp-weixin 压缩包
+
+💡例如：mp-weixin-2026-01-23-1769152056146.zip;同时该目录下会生成未压缩的 mp-weixin 目录。
+
+#### 【验证与重命名】
+6. 打开该目录下同时生成未压缩的 mp-weixin 目录，找到site.js文件，将文件内的uniacid值改为当前客户编号（如：2812）并保存；
+7. 打开微信开发者工具，导入「mp-weixin」目录，点击「编译」，在开发者工具控制台验证有无报错，以及能否返回对应客户的业务数据；
+
+8. 确保无误后将生成的mp-weixin的压缩包重命名，格式为：定制化-客户编号-域名-mp-weixin-当前日期-生成编号.zip。
+***（📌通用版无需重命名）***
+
+💡例如：custom-2812-xcx.aigc-quickapp.com-mp-weixin-2026-01-22-1769152056146.zip
+
+🚫压缩包命名禁止包含 / \ : * ? " < > | 等特殊字符。
+ 
+
+#### 【交付与最终发布】🔍🔍
+9. 将重命名后的文件发送给技术人员； ***（📌通用版直接将生成的 mp-weixin 压缩包直接发送给技术人员）***
+
+10. 技术人员操作：解压压缩包 → 确认site.js中的uniacid为客户编号 → 用微信开发者工具导入解压后的代码目录 → 编译验证无误后 → 上传发布。
 
-    //客服地址
-    webSocket: '{{$webSocket}}',
 
-    //本地端主动给服务器ping的时间, 0 则不开启 , 单位秒
-    pingInterval: 1500,
 
-    // 版本号 
-    version: '1.0'
-};
 
-export default config;
-```
 
 
 ### 快应用发布
-1. 使用HBuilderX打开项目
-2. 点击项目中【⚙】manifest.jion--->web配置--->运行的基础路径--->/hwappx/改编号/ 
-"h5" : {
-    "sdkConfigs" : {
-        "maps" : {
-            "qqmap" : {
-                "key" : "TUHBZ-CNWKU-UHAVP-GZQ26-HNZFO-3YBF4"
-            }
-        }
-    },
-    "router" : {
-        "mode" : "history",
-        "base" : "/hwappx/2811/"
-    },
-	
-（编号可以在.local.config.js中找到需要的编号）
 
-const localDevConfig = ({
+
-    '460': { // 制氧设备平台
+#### 基本操作（通用版/定制化版）
-        uniacid: 460,
+
-        domain: 'https://xcx30.5g-quickapp.com/',
+
-    },
+
-    '576-xcx30.5g': { // 活性石灰装备
+#### 【发布构建】
-        uniacid: 576,
+1. 使用HBuilderX打开项目；
-        domain: 'https://xcx30.5g-quickapp.com/',
+
-    },    
+2. 打开项目根目录的manifest.json文件，切换至可视化配置界面：依次点击「Web 配置」→「运行的基础配置」，修改路径中的客户编号；***（📌通用版保留原有/hwappx/common/）***
-    '2285': { // 数码喷墨墨水
+
-        uniacid: 2285,
+💡例如：/hwappx/2811/，其中2811为定制化版客户编号；
-        domain: 'https://xcx.aigc-quickapp.com/',
+
-    },
+3. 选择菜单栏「发行」 → 「自定义发行」 →「H5-xcx.aigc-quickapp.com」，先修改以下配置：
-    '2811': { // POCT检测分析平台
+网站标题：快应用
-        uniacid: 2811,
+网站域名：当前客户域名（示例：xcx.aigc-quickapp.com）
-        domain: 'https://xcx6.aigc-quickapp.com/',
+确认后点击「发行」等待构建完成。
-    },  
+
-    '2724': { // 生物菌肥
+⚠️注：底部控制台弹出“项目 lucky_shop 导出Web成功，路径为：D:\项目文件\项目根目录\unpackage\dist\build\web”后再执行下一步
-        uniacid: 2724,
+
-        domain: 'https://xcx.aigc-quickapp.com/',
+💡例如：项目 lucky_shop 导出Web成功，路径为：D:\0.项目源码\lucky_shop\unpackage\dist\build\web
-    },     
+
-    '2505': { // 煤矿钻机
+4. 按控制台提示的路径找到web目录，将该目录下所有文件手动打包成一个.zip压缩包（仅打包文件，不包含外层web目录）；
-        uniacid: 2505,
+
-        domain: 'https://xcx.aigc-quickapp.com/',
+#### 【重命名】
-    },   
+5. 按版本类型规范重命名压缩包：
-    '2777': { // 养老服务
+
-        uniacid: 2777,
+📌通用版：hwappx-common-域名-时间.zip  
-        domain: 'https://xcx.aigc-quickapp.com/',
+例如： hwappx-common-xcx.aigc-quickapp.com-2026-01-24.zip
-    },         
+
-    '1': { // 开发平台
+📌定制化：客户名称-定制化---hwappx-客户编号-域名-时间.zip  
-        uniacid: 1,
+ 例如：POCT检测分析平台-定制化---hwappx-2811-xcx.aigc-quickapp.com-2026-01-24.zip
-        domain: 'https://dev.aigc-quickapp.com',
+
-    },
+🚫压缩包命名禁止包含 / \ : * ? " < > | 等特殊字符
-    '1-test': { // 测试平台
+
-        uniacid: 1,
+#### 【交付与最终发布】🔍🔍
-        domain: 'https://test.aigc-quickapp.com',
+6. 将重命名后的压缩包发送给运维人员；
-    },
+
-})['2811']; // 选择要使用的环境配置
+7. 运维人员操作：
-3. 选择菜单栏 "发行" ->自定义发行--->H5-xcx.aigc-quickapp.com "快应用"，网站标题为"快应用"  域名为xcx.aigc-quickapp.com 进行发布构建
+
-4. 在电脑本地文件夹里找到unpackage--->dist--->build--->h5中h5-xcx.aigc-quickapp.com--->进行手动打包，例如：static.zip
+① 解压压缩包；
-（压缩包改id  公版--例如 hwappx-common-xcx.aigc-quickapp.com-2026-01-09.zip
+
-            定制化--例如 POCT检测分析平台-定制化--- hwappx-2811-xcx.aigc-quickapp.com-2026-01-09.zip）
+② 打开快应用开发者工具，导入解压后的代码目录；
-5. 然后将压缩包发给开发定制客户技术人员，
+
-6. 使用快应用开发者工具打开发布后的代码进行上传发布
+③ 验证代码无报错后，执行上传发布操作。
+
+
+
+