X1_Site/modify.md

## Docker 发布配置

- 新增：`site/Dockerfile` - 多阶段构建配置，基于 node:20-alpine，优化镜像体积
- 新增：`site/.dockerignore` - Docker 构建忽略文件，排除不必要的文件
- 新增：`site/docker-compose.yml` - Docker Compose 配置文件，便于本地和服务器部署
- 新增：`DOCKER.md` - Docker 发布完整指南，包含构建、运行、发布到 Docker Hub 等步骤
- 更新：`site/next.config.mjs` - 添加 `output: 'standalone'` 配置，支持独立输出模式，优化 Docker 部署
- 修复：`site/Dockerfile` - 添加复制 `data` 目录到容器，修复运行时找不到 JSON 数据文件的错误（ENOENT: no such file or directory）

## 功能更新

 - About 轮播统一比例：`BannerCarousel` 支持 `aspectClass`，在 About 页固定为 `aspect-[16/6]`，保证三张图一致大小（object-cover 填充）。
 - 轮播增强：`BannerCarousel` 新增左右切换按钮（Prev/Next），悬浮可见；保持自动轮播与指示点。
 - 导航新增：在 `mainnav.json` 与 `data/en/mainnav.json` 首位添加“公司介绍/About”，链接 `/about`。
 - 新增页面：`app/[locale]/about/page.tsx`，上方轮播（手机/家电/智能），下方“公司产品介绍”段落。
 - 新增数据：`data/about.json` 与 `data/en/about.json`。
 - 修复：横幅链接指向不存在的 `flagship`，改为现有产品 `p1`（中/英 `banners.json`）。
 - 本地化：产品详情页根据 `locale` 切换文案（未找到/返回/首页/加入购物车）。
 - 视觉优化：`ProductCard` 提升观感（白底圆角阴影、居中等比展示、标题/描述固定高度、悬浮上浮）。
 - 布局优化：`ProductGrid` 增大断点间距与列数回落，频道页头部增加标题与返回入口。
 - 修复：本地化引入后样式与布局错乱的根因（双层布局）。
   - 根级 `app/layout.tsx` 改为只渲染 `{children}`，不再包含 Header/Footer。
   - 根首页 `app/page.tsx` 改为重定向到 `/zh-CN`，所有实际页面只使用 `app/[locale]/layout.tsx` 的单一布局。
 - 多语言：取消 Next 内置 i18n 配置，统一使用 `app/[locale]/*` 路由前缀，避免与布局冲突。
 - 链接前缀：为组件增加 `basePath/locale` 支持，确保所有链接都指向带语言前缀的路径。
   - 更新 `MainNav`、`BannerCarousel`、`PromoGrid`、`ProductCard`、`ProductGrid`、`FloorSection` 接口并在页面传入 `basePath`。
 - 新增本地化路由：`app/[locale]/layout.tsx`、`app/[locale]/page.tsx`、`app/[locale]/channel/[slug]/page.tsx`、`app/[locale]/product/[id]/page.tsx`。
 - 数据按语言读取：`lib/data.ts` 增加 locale 感知，优先读取 `data/<locale>/*.json`，否则回退 `data/*.json`。
 - 英文示例数据：`data/en/{mainnav,banners,promos,products,services}.json`。
 - 语言开关：新增 `components/LangSwitch.tsx`，在 `MainNav` 右侧切换中英文（在路径前添加/切换 `/en` 或 `/zh-CN`）。
 - 新增：频道页 `app/channel/[slug]/page.tsx`（从 `data/products.json` 匹配 floor，显示横幅与产品网格），避免手机/家电等频道 404。
 - 新增：产品详情页 `app/product/[id]/page.tsx`（从数据集中查找产品，含面包屑与占位购买按钮），避免产品链接 404。
 - 新增：`app/not-found.tsx` 全局 404 友好页。
 - 新增：批量 SVG 占位图到 `site/public/`（hero/floors/products/promos/icons），并将 `data/*.json` 的图片扩展名改为 `.svg` 对应路径，确保本地即刻有图可用。
 - 修复：`site/public/products/a2.svg` 的 `xmlns` 写法错误，改为 `http://www.w3.org/2000/svg`，解决“净化器”图片不显示。
## 2025-10-30

- 新增：项目任务清单（初始化 10 项），当前进行中：建立 data/ 与类型定义。
- 新增：`site/types.ts` 类型定义（NavItem/Banner/Promo/Product/Floor/ServiceLink）。
- 新增：`site/data/` 示例数据文件（`nav.json`、`banners.json`、`products.json`）。

- 新增：基础 UI 组件 `site/components/TopBar.tsx`、`MainNav.tsx`、`Footer.tsx`；组件以 props 驱动，后续由页面注入数据。

- 变更：取消 TopBar 登录/注册入口，仅保留帮助中心链接。
- 新增：数据读取工具 `site/lib/data.ts`（从 `data/*.json` 读取）。
- 新增：首页所需组件 `BannerCarousel`、`PromoGrid`、`ProductCard`、`ProductGrid`、`FloorSection`、`ServiceLinks`。
- 新增：`app/layout.tsx`、`app/page.tsx`、`app/globals.css`，完成首页骨架接线（TopBar→MainNav→Hero→Promos→楼层→服务→Footer）。

- 新增与配置：Next.js + TypeScript + Tailwind 环境
  - 更新 `site/package.json`：添加脚本（dev/build/start）与依赖（next/react/react-dom）及 devDependencies（typescript/@types/node/@types/react/tailwindcss/postcss/autoprefixer 等）。
  - 新增 `site/tsconfig.json`：启用严格模式、ES2020、Bundler 解析、引入 Node/React 类型。
  - 新增 `site/next.config.ts`、`site/postcss.config.mjs`、`site/tailwind.config.ts`，Tailwind 扫描 `app/` `components/`。
  - 将 Next.js 配置从 `next.config.ts` 改为 `next.config.mjs`（Next 14 不支持 `.ts` 配置）。
  - 移除 TopBar：删除 `site/components/TopBar.tsx` 与 `site/data/topbar.json`，`app/layout.tsx` 不再引用；`site/lib/data.ts` 移除 `getTopbarNav`。
  - Windows 终端设 UTF-8（`chcp 65001` + `$OutputEncoding`）后执行 `yarn install` 和依赖安装以避免中文乱码。
  - 为避免 Tailwind v4 与现有配置不兼容，暂将 Tailwind 固定为 3.4.10，并将 React/Next 与类型依赖固定到兼容版本。

变更原因：为实现基于 Next.js + Tailwind 的官网首页布局，先行搭建数据与类型骨架，保证后续内容可替换。



- 新增：`PLAN.md` 实施计划与步骤（目标/范围/架构/步骤/部署/替换指南/里程碑）。