# 项目长期记忆

## 项目概述
- 微信小程序项目，使用 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 切图或原生页面在小程序内展示，不依赖直接外链打开；若仍想保留在线翻页体验，需迁移到自有可验证域名承载。