Ui修改
This commit is contained in:
+9
-15
@@ -42,7 +42,7 @@ DMP编码: JHA-214 # 无则留空
|
||||
|
||||
备注:
|
||||
- `package.json` 中 `name` 为 `landpage`,仓库/目录名为 `91dj-landpage-client`。
|
||||
- 业务 `appId` 为 **204**(见 `src/views/land/index.vue`),埋点 `appId` 为 **JHA-204**(见 `public/index.html` 与 `src/utils/eventTracker.js`)。
|
||||
- 下载接口 `appId` 为 **5**(见 `src/api/btn.js`),已无埋点。
|
||||
- 接口路径前缀为 **`/plm`**,开发环境由 `vue.config.js` 代理;选线候选域名见各环境 `.env.*` 中的 `VUE_APP_BASE_HOSTS`(JSON 数组),勿将含密钥、内网地址的未脱敏内容对外发布。
|
||||
---
|
||||
|
||||
@@ -60,14 +60,13 @@ DMP编码: JHA-214 # 无则留空
|
||||
| 特定 PC URL | `tips.vue` |
|
||||
| 接口失败选线 | `selectLinePopup.vue` |
|
||||
|
||||
子组件通过 props 接收 `os`、`configs`、`switchData` 等,通过 `$emit` 向上传递 `getApkInfo`、`recordClick` 等事件。
|
||||
子组件通过 props 接收 `os`、`switchData` 等,通过 `$emit` 向上传递 `getApkInfo` 事件。
|
||||
|
||||
**启动流程(`land/index.vue`):**
|
||||
|
||||
1. 解析 URL 查询参数(`dc`、`ch`、`pc` 等)并写入 sessionStorage。
|
||||
2. 调用 `getTemplate`(`/plm/okn/ijb/nuS0EDXSczKgf3Xh`)拉取按钮/下载配置(`switchData`、`configs`、各平台下载链接)。
|
||||
3. 上报落地页展示埋点 `landingPageView`(`eventTracker.js` → `window.tracker` / LandingSDK)。
|
||||
4. 用户点击下载时:`recordClick` 上报点击并调用 `getApkInfo`;`handleGetApkInfo` 根据终端类型跳转 iOS/Android 下载链接。
|
||||
2. 获取外网 IP 后调用 `bottonlist`(`https://blsp01.com/api/stat/version/bottonlist`)拉取按钮开关(`switchData`,不含下载地址)。
|
||||
3. 用户点击下载时 `handleGetApkInfo`:iOS 轻量版调 `h5/config` 下载描述文件;iOS 商店版(`iosStore`)与 Android 调 `bottonclick` 拿 `data.link` 跳转,后端同时记录点击。
|
||||
5. 接口失败时弹出 **选线弹窗**,用户选择后切换 `axios.defaults.baseURL` 并重试。
|
||||
|
||||
**技术栈要点:**
|
||||
@@ -76,7 +75,6 @@ DMP编码: JHA-214 # 无则留空
|
||||
- 样式:**Sass/SCSS**(`node-sass` + `sass-loader`),`element-variables.scss` 定制 Element 主题。
|
||||
- 适配:**lib-flexible** + **postcss-plugin-px2rem**(`rootValue: 37.5`,设计稿基准 375px);带 **`pcm`** 选择器前缀的样式不转 rem(PC 端)。
|
||||
- 网络:**axios** 封装于 `src/utils/request.js`,默认 `baseURL: '/'`,业务码 `200` 视为成功。
|
||||
- 埋点:`public/index.html` 异步加载 **`/sdk/landing-sdk-v1.1.1.js`**(LandingSDK),`src/utils/eventTracker.js` 封装 `landing_page_view` / `landing_page_click` 事件及设备信息解析。
|
||||
- 其他:**qrcode** 生成 PC 扫码图、**vue-clipboard2** 复制渠道参数、**moment**、**swiper**、**vue-analytics**(UA-165940626-2)、**register-service-worker**(PWA 配置于 `vue.config.js`)。
|
||||
|
||||
**Node 版本:** 仓库 `README.md` 建议使用 **12.18.1**。
|
||||
@@ -104,7 +102,6 @@ DMP编码: JHA-214 # 无则留空
|
||||
91pron-landpage-client/
|
||||
├── public/
|
||||
│ ├── index.html # 入口 HTML,含 LandingSDK 与 SEO meta
|
||||
│ └── sdk/landing-sdk-v1.1.1.js
|
||||
├── src/
|
||||
│ ├── main.js # 入口:Router、Vuex、Vant、Element、Analytics 等
|
||||
│ ├── App.vue
|
||||
@@ -115,8 +112,8 @@ DMP编码: JHA-214 # 无则留空
|
||||
│ ├── views/land/
|
||||
│ │ ├── index.vue # 落地页主入口:设备判断、选线、下载逻辑
|
||||
│ │ └── components/ # mobile1 / mobile2 / pc / pc2 / tips / selectLinePopup
|
||||
│ ├── api/ # getApkInfo、getTemplate、getIp、getCustomerServiceUrl
|
||||
│ ├── utils/ # request、eventTracker、userAgent 等
|
||||
│ ├── api/ # btn(下载接口)、getIp
|
||||
│ ├── utils/ # request、traceId、userAgent 等
|
||||
│ ├── plugins/ # flexible、element、scale_no
|
||||
│ └── assets/ # 样式、各模板图片(mobile1/mobile2/pc/pc2)
|
||||
├── vue.config.js
|
||||
@@ -128,8 +125,8 @@ DMP编码: JHA-214 # 无则留空
|
||||
|
||||
**接口与选线:**
|
||||
|
||||
- 业务接口统一走 **`/plm/okn/ijb/...`** 路径(见 `src/api/`),由网关或 devServer 反代。
|
||||
- **`VUE_APP_BASE_HOSTS`**:各环境 `.env.*` 中为 **JSON 数组字符串**,供选线弹窗展示候选 API 域名;用户选择后写入 `axios.defaults.baseURL` 并重试 `getTemplate`。
|
||||
- 下载接口直连 **`https://blsp01.com/api/stat/version`**(见 `src/api/btn.js`,接口已开 CORS)。
|
||||
- **`VUE_APP_BASE_HOSTS`**:各环境 `.env.*` 中为 **JSON 数组字符串**,供选线弹窗展示候选 API 域名;用户选择后写入 `axios.defaults.baseURL` 并重试 `bottonlist`。
|
||||
- 生产部署需由 **Nginx / 网关** 将 **`/plm`** 转发至实际业务后端;History 模式需配置 **单页回退**(`try_files` → `index.html`)。
|
||||
|
||||
---
|
||||
@@ -140,7 +137,6 @@ DMP编码: JHA-214 # 无则留空
|
||||
|
||||
- **业务 API**:`/plm` 路径下的配置与下载上报接口;静态部署时需保证 **`/plm` 反代** 与 HTTPS 证书策略一致。
|
||||
- **选线域名**:`VUE_APP_BASE_HOSTS` 中的候选域名需可达,否则用户只能通过选线弹窗手动切换。
|
||||
- **LandingSDK**:`public/sdk/landing-sdk-v1.1.1.js`,用于埋点上报(`window.tracker` / `LandingSDK.init`)。
|
||||
- **静态资源托管**:`npm run build` 产物在 **`dist/`**,由 CDN 或 Web 服务器提供。
|
||||
- **第三方**:Google Analytics(`UA-165940626-2`)、可选外网 IP 查询(`api.ipify.org`,`getIp` 中,当前主流程未启用)。
|
||||
|
||||
@@ -173,8 +169,7 @@ DMP编码: JHA-214 # 无则留空
|
||||
# 4. 风险说明
|
||||
|
||||
- **强依赖网关反代**:生产若 `/plm` 代理错误,**配置拉取与下载上报将不可用**;History 模式服务器配置错误会导致 **深链 404**。
|
||||
- **选线失败**:`getTemplate` 请求失败时弹出选线弹窗;若所有候选域名不可用,用户可能无法获取下载配置。
|
||||
- **埋点依赖 SDK**:`LandingSDK` 未加载完成前,`window.tracker` 使用队列缓冲;SDK 加载失败会导致埋点丢失。
|
||||
- **选线失败**:`bottonlist` 请求失败时弹出选线弹窗;若所有候选域名不可用,用户可能无法获取下载配置。
|
||||
- **渠道参数**:下载与剪贴板逻辑依赖 URL 参数(`dc`、`ch`、`pc`、`tid` 等),参数缺失或格式不符可能影响跳转与统计。
|
||||
- **配置敏感信息**:`.env`、选线域名、部署脚本中的主机信息 **勿提交到公开仓库**;供应链上锁定 `package-lock.json` 并定期审计依赖。
|
||||
|
||||
@@ -191,6 +186,5 @@ DMP编码: JHA-214 # 无则留空
|
||||
- 落地页主逻辑集中在 **`src/views/land/index.vue`**;新增模板时参考 `mobile1` / `mobile2` / `pc` 组件模式,并在 `index.vue` 中注册与切换。
|
||||
- 子组件规范见 **`.cursor/rules/vue-component.mdc`**;样式与 px2rem 见 **`.cursor/rules/scss-styling.mdc`**。
|
||||
- 接口封装在 **`src/api/`**;HTTP 请求统一走 **`src/utils/request.js`**。
|
||||
- 埋点上报使用 **`src/utils/eventTracker.js`** 的 `landingPageView` / `landingPageClick`,勿绕过 SDK 直接上报。
|
||||
- Figma 转落地页工作流见 **`.cursor/skills/figma-to-landpage/SKILL.md`**。
|
||||
- **请勿将含密钥、生产内网地址的 `.env` 或未脱敏部署脚本提交至对外可见仓库**;YAML 头部元数据若与真实组织不一致,请在内部系统中核对后修改。
|
||||
|
||||
Reference in New Issue
Block a user