gxwebsoft
71c23cebfb
- 新增 pages/brochure/index 页面实现原生品牌画册展示功能 - 在首页 index.tsx 中添加 BrochureEntry 入口组件并调整布局位置 - 新增首页画册入口样式文件 BrochureEntry.scss 和组件逻辑 BrochureEntry.tsx - 配置画册页面导航栏标题和样式，设置页面配置文件 index.config.ts - 实现画册页面完整的品牌展示、核心优势、服务承诺、案例方向等功能模块 - 集成 CMS 配置读取，支持动态品牌名称、电话、地址等信息展示 - 添加分享功能、拨打电话、复制地址等交互操作 - 更新文档记录画册功能开发过程和接入方案说明
68 lines
3.5 KiB
Markdown
68 lines
3.5 KiB
Markdown
# 项目长期记忆
|
||
|
||
## 项目概述
|
||
- 微信小程序项目，使用 Taro + React + NutUI + TailwindCSS + SCSS
|
||
- 项目名：南南佐顿门窗（门窗定制安装业务）
|
||
- 品牌：网宿软件
|
||
|
||
## 技术栈
|
||
- 框架：Taro (微信小程序)
|
||
- UI：NutUI React Taro
|
||
- 样式：TailwindCSS + SCSS
|
||
- 语言：TypeScript
|
||
|
||
## 关键路径
|
||
- 首页入口：`src/pages/index/index.tsx`
|
||
- 画册页：`src/pages/brochure/index.tsx`（当前为原生品牌画册展示页）
|
||
- 分销商页面：`src/dealer/index.tsx`
|
||
- 用户钱包：`src/user/wallet/wallet.tsx`
|
||
- 客户管理：`src/dealer/customer/index`
|
||
- 邀请码：`src/dealer/qrcode/index`
|
||
- 导航工具：`src/utils/common.ts` (navTo函数)
|
||
|
||
## 首页结构 (2026-04-02 更新)
|
||
- Header (吸顶搜索栏)
|
||
- Menu (导航菜单，hidden)
|
||
- Banner (轮播广告)
|
||
- Grid (功能菜单)
|
||
- NoticeBar (公告栏)
|
||
- **BrochureEntry** (品牌画册入口卡片 — 位于公告栏下方)
|
||
- BestSellers (热销商品)
|
||
- **TrustSection** (品牌信任区 - 3列水平布局)
|
||
- 品质保障：10年质保，德国进口五金
|
||
- 专业团队：15年安装经验，持证上岗
|
||
- 客户好评：5000+家庭选择，98%满意度
|
||
- ~~CaseShowcase~~ (已注释隐藏，待有真实素材后再恢复)
|
||
- **ContactSection** (联系方式 - 2x2网格布局)
|
||
- 客服热线、在线咨询、门店地址、关注我们
|
||
|
||
## 图标使用注意事项
|
||
- NutUI图标库中不存在的图标：
|
||
- `Right` → 使用 `ArrowRight`
|
||
- `MapPin` → 使用 `Location`
|
||
- `Wechat` → 使用 `Share`
|
||
- `Users` → 使用 `People`
|
||
- 所有图标必须从 `@nutui/icons-react-taro` 导入
|
||
- 构建前需验证图标名称是否在可用导出列表中
|
||
|
||
## 字体大小规范
|
||
- 微信小程序使用 TailwindCSS 文本类，不使用固定像素值
|
||
- 主标题：`text-lg font-semibold text-gray-800`
|
||
- 副标题：`text-sm text-gray-500`
|
||
- 项目标题：`text-base font-semibold text-gray-800`
|
||
- 项目描述：`text-xs text-gray-500`
|
||
- 小文本：`text-xs text-gray-500`
|
||
|
||
## 画册页正式版 (2026-04-01)
|
||
- 首页已实际挂载 `src/pages/index/BrochureEntry.tsx` 入口，位置在 Banner 下方。
|
||
- `src/pages/brochure/index.tsx` 当前为原生正式版结构：主营方案、核心优势、升级关键词、服务承诺、案例方向、服务流程、预约咨询信息。
|
||
- 画册页优先读取 `configWebsiteField` 返回的 `siteName`、`tel`、`address`、`workDay` 作为品牌与联系信息；无配置时使用兜底文案。
|
||
- 当前页面提供“拨打热线 / 复制地址 / 返回首页”三类转化操作，后续可继续接真实案例图、门店定位与预约表单。
|
||
|
||
## 外部 H5/画册接入约定 (2026-04-01)
|
||
- 小程序首页如需承载外部画册、易企秀、云展网等 H5，优先采用独立 `web-view` 页面承载，再从首页增加入口卡片或 banner 跳转。
|
||
- 该方案的前提是目标域名可在小程序后台配置为业务域名，且满足 HTTPS、备案等微信限制。
|
||
- 外部 `web-view` 页面应提供失败兜底界面（如重新加载、返回首页、管理员配置提示），不要只保留 toast 提示。
|
||
- 当前 `book.yunzhan365.com` 无法配合放置微信业务域名校验文件，因此不能作为小程序正式业务域名接入。
|
||
- 如果目标链接是第三方不可控域名，无法完成业务域名配置，则改为将内容转成图片、PDF 切图或原生页面在小程序内展示，不依赖直接外链打开；若仍想保留在线翻页体验，需迁移到自有可验证域名承载。
|