# PROJECT OVERVIEW — inotoday-parts

## 项目定位
本项目属于 **Inotoday 子域 PoC 阶段**，目标是在  
`https://parts.jp.inotoday.com`  
部署一个 **静态 SEO 优化网站**，用于验证电子元件 SKU 数据的抓取与索引率。

所有输出文件为 **纯静态 HTML/XML**，由 **Python 构建脚本 + Hugo 模板外壳** 共同生成，最终输出至 `/public`，并通过 **Cloudflare Pages** 自动部署。

Trae 的角色是：  
> 协助生成、优化和维护项目文件结构、模板、脚本逻辑与配置，不干预线上部署。

---

## 目录结构约定

inotoday-parts/
├─ hugo/ → Hugo 模板与布局，仅负责页面外壳
├─ builder/ → Python 脚本，生成静态 SKU 页面与 sitemap
├─ public/ → Cloudflare Pages 构建输出目录
├─ specs/ → HTML 合同文件与结构说明
├─ .gitignore
├─ .cfignore
├─ PROJECT_OVERVIEW.md
├─ AI_CODING_GUIDE.md
├─ ARCHITECTURE.md
└─ README.md


---

## 核心流程
1. **数据处理阶段**  
   - 从 `chip_products` 表或 CSV 提取字段  
   - 使用 `builder/build_items.py` 生成 `/public/items/*.html`  
   - 生成 sitemap 分包与 `robots.txt`

2. **页面外壳构建**  
   - Hugo 仅渲染全局模板与首页  
   - 输出内容写入 `/public/`

3. **部署**  
   - Cloudflare Pages 从 `public/` 自动读取  
   - 不依赖数据库或 API  
   - 输出必须完全自洽（纯静态）

---

## 部署信息
| 项目 | 值 |
|------|----|
| 主域 | jp.inotoday.com |
| 子域 | parts.jp.inotoday.com |
| DNS | SiteGround（PoC） |
| 托管 | Cloudflare Pages |
| 分支 | main |
| 输出目录 | public |

---

## Trae AI 约束
- 不生成动态代码或外部 API 调用；
- 不修改 `.gitignore` / `.cfignore`；
- 输出必须兼容 Cloudflare Pages 静态环境；
- 文件操作仅限项目定义结构；
- 优先生成模板、脚本、配置文件。

---

## 阶段目标
| 阶段 | 目标 |
|------|------|
| PoC | 索引率 ≥10%，SKU 页面 ≥20,000 |
| 落地 | 完全迁移 Cloudflare DNS，部署缓存与差异化内容生成系统 |