CYS Bearing 项目整体总结（2026-09-19 早晨版）

目的：把”B2b/B2c 联系方式数据驱动”和”CYS 工具箱（shipping_rates 新表 + 客户发票系统 + 客户运营）“两条线归回同一个项目，给出完整的目标 / 状态 / 缺口 / 明天计划。 作用：明早开会 / 用户回来 / 任何接手者都能直接看。 更新规则：重大变化（部署 / DDL / 决策）时，更新对应章节 + 顶部日期。

一、项目整体目标

1.1 一句话定位

从速卖通 / Aliyun 等平台 + 多邮箱历史邮件里，把 5000+ B 端客户沉淀到自有私域；用米思米模式（标准化产品 + 一站式购买 + 多运输渠道 + 本币收款）的产品站把客户从平台迁出；用 AI-Native 地基让运营团队能主动触达客户。

1.2 业务关键数字

1.3 项目的 6 大终极目标（按重要性）

1. 客户沉淀：5000 客户 → 自有 D1 主档（ed = 1/5000，目前 customers 表 1 行）
2. 产品自动化承载：~1万 SKU 的米思米模式产品站 + DDP 配送 + 本币收款（ed = 31/10000，D1 31 行 + 陶瓷 25 SKU 待入库）
3. AI 主动获客：邮件真实性验证（POC1 启动）+ AI 写初稿（未开始）
4. GEO / SEO 优化：AI 搜索能引用（部分完成：product.html + materials/ceramic.html 有 schema.org）
5. 运营自动化：客户提交询盘 → 自动发邮件 → 自动生成 PI/PO/CI/Invoice（客户发票系统表已建，无数据）
6. 零抽成：从平台抽 5-15% → 自有渠道 0% 成本（架构已就位，等待客户迁入）

1.4 项目 4 个阶段

1.5 当前在哪个阶段

Phase 3 收尾 + Phase 4 启动前的过渡期： - ✅ Phase 3 数据层完整（D1 23 个表） - ⚠️ Phase 3 代码层：B2c（联系方式数据驱动）昨晚完成；其他模块待续 - ❌ Phase 4（客户发票 + 询盘）未启动

二、当前状态（按模块）

2.1 网站 v3 前端（Cloudflare Pages）

部署：

文件结构：

/workspace/site_final/v3/
├── index.html / catalog.html / product.html / scene.html / cart.html / invoice.html
├── checkout.html / login.html / my_account.html
├── shipping.html / payment_guide.html / privacy.html / returns.html
├── about.html / customer.html / customers.html / industries.html / industry.html
├── admin.html / admin-login.html
├── materials/ceramic.html       # 轻量材质详情页（/materials/ceramic 301 redirect）
├── css/ (15 个 CSS)
├── js/ (26 个 JS 模块)
├── functions/ (_middleware.js, sitemap.xml.js)
├── migrations/ (4 个 SQL)
├── config/ (8 个 JSON + 2 个 .bak)
├── docs/ (19 个 .md + CSV 模板)
└── _redirects / wrangler.toml / robots.txt / sitemap.xml / llms.txt

模块化原则（已实施）： - ✅ 数据驱动架构：所有客户可见数据 → D1（不是 JSON 文件） - ✅ 单文件真相原则：价格 / 银行 / 政策 / 运费 / 国家 都集中在 1 个 D1 表 - ✅ 缓存破坏：?v=20260926 强制刷新

已完成项： - ✅ Phase 1（v3 网站搭建 + 部署） - ✅ Phase 2（13 个 Worker API + D1 迁移） - ✅ B2c 批 1（D1 备份 + ALTER + UPDATE）：shipping_methods 加 icon 列 + shipping_info.metadata 删除 methods 字段 + 3 张备份表 - ✅ B2c 批 2（后端 /api/shipping-methods）：Worker NEW_ID afd68093-d4dc-4c3b-b32b-7381974bb549 - ✅ B2c 批 3（前端 5 文件改动）：policy.js + data.js + 3 HTML placeholder，Pages NEW_ID 80c61e47-3908-4b2e-991f-8730bffcc31d

2.2 Worker 后端（Cloudflare Worker cys-email）

部署：

API 端点（24 个 + B2c 新加 1 个 = 25 个）：

lib/ 模块： - banks.js / countries.js / invoice-no.js / totals.js / display-spec.js / pricing-engine.js / weight-engine.js / email-builders.mjs / generate-pdf.js

已完成项： - ✅ 13 个公共 API + Cron Trigger + email-builder + PDF 生成 - ✅ ensureSchema 自动建 customer_groups / industries / product_tags - ✅ B2c Step 6 /api/shipping-methods

2.3 D1 数据库（cys-bearing-db）

规模：23 个表（4 个用户系统 + 1 个发票系统 + 1 个运费细化 + 12 个产品业务 + 5 个辅助 + 3 张 B2c 备份）

核心表 + 实测行数（2026-09-18 22:09 实测）：

已完成项： - ✅ Phase 2 迁移：products / faqs / categories / countries / banks / shipping - ✅ Phase 2 迁移：scenes / hot_products / type_templates / policy_texts - ✅ B2a 9 settings（support_email/phone/whatsapp + invoice_prefix_default/po/quotation/pi/ci + quote_required_above_mm） - ✅ B2 3 policy（payment_rules / home_highlights / payment_guide_intro） - ✅ 4 banks 软删 + small_packet 软删 - ✅ shipping_rates 17 列 schema + 20 行数据（独立于 shipping_methods） - ✅ customers / invoices / invoice_items / invoice_status_log schema（决策 3 + 决策 6） - ✅ customer_groups / industries / product_tags schema（Phase 3 客户运营）

未完成项： - ❌ invoices 无数据（无前端创建流程） - ❌ shipping_rates 前端未消费（handleApiShipping 已 JOIN，但 cart / invoice.js 不读它） - ❌ customers 表只有 1 行测试数据 - ❌ used_tokens = 0（admin 链接请求流程未实测）

2.4 文档体系

/workspace/site_final/v3/docs/（19 个 .md + CSV 模板）：

/workspace/（项目文档）：

三、目标还缺什么

3.1 P0（必须做，阻塞业务）

3.2 P1（应该做，影响进度）

3.3 P2（可以做，优先级低）

3.4 需要用户拍板

3.5 可以直接干（不需要拍板）

• ✅ B2b-1b-ii 8 footer 替换（明确范围）
• ✅ B2b-1b-iii about.html 卡片（明确范围）
• ✅ 21 处 JS fallback 替换（明确范围）
• ✅ D1 备份表清理（DROP 3 backup tables）
• ✅ 25 SKU 陶瓷 6200 入库（Excel 已有）
• ✅ 3 icon 填默认 emoji（air_parcel ✈️ / sea_freight 🚢 / express_dhl 🚚）
• ✅ 11 个公共 API 的健全性测试（curl + 状态码）

四、上下文衔接问题

4.1 问题描述

用户指出：之前的话题被切成”B2c 网站”和”CYS 工具箱”两条线，导致上下衔接不一致。

实际上这两条线始终是同一个项目：

CYS Bearing 项目
├── 网站层（cysbearing.com，Cloudflare Pages）
│   ├── Phase 1: v3 网站搭建（HTML/CSS/JS）
│   ├── Phase 2: 邮件系统（Worker + Resend）
│   ├── Phase 3 数据层: D1 完整迁移
│   ├── Phase 3 代码层: B2c（联系方式数据驱动）★ 昨晚完成的
│   └── Phase 4: 客户发票 + 询盘 + PDF（远期）
│
└── "CYS 工具箱"（实际就是 Phase 3 + Phase 4 数据层 + 部分代码层）
    ├── shipping_rates 新表（20 行数据）
    ├── customers / invoices / invoice_items（schema 已建，无数据）
    ├── customer_groups / industries / product_tags（已自动建表）
    ├── quote-submit.js（询盘提交 worker，未部署）
    └── ensureSchema 自动建表（Worker 启动时跑）

4.2 之前被判成”不属于当前话题”但实际同项目的内容

4.3 它们和当前主线的依赖关系

B2c（联系方式数据驱动）        ← 昨晚完成
    ↓
B2b-1b-ii / -iii / -2         ← 待执行（接续 B2c）
    ↓
模块化 + 数据驱动基础就位
    ↓
shipping_rates 消费            ← 待 cart/invoice.js 接入
customer_groups 消费            ← 待 catalog/product.html 接入
invoices 前端创建流程           ← Phase 4 启动
quote-submit Worker 部署         ← Phase 4 启动
PDF 生成用户验证                ← Phase 4 启动前确认
    ↓
客户迁入 + 业务运营

五、明天开始做什么（按优先级）

5.1 明天第一件：用户浏览器验证 B2c（4 URL）

目的：确认 B2c 部署后用户真实看到效果。

前置条件： - ✅ Pages 部署成功（NEW_ID 80c61e47-3908-4b2e-991f-8730bffcc31d） - ✅ Worker 部署成功（NEW_ID afd68093-d4dc-4c3b-b32b-7381974bb549） - ✅ 自检全通过（curl + sandbox 验证）

用户拍板：a) 接受浏览器验证 / b) 调整范围

5.2 明天第二件：B2b-1b-ii 8 footer 替换

目的：让 customer / customers / industries / industry / login / my_account / returns（page body）/ invoice（footer 主体）8 文件 footer 数据驱动。

前置条件： - ✅ B2c 模板（footer-contact div + site-settings.js script） - ✅ B2c 9 settings（support_email/phone/whatsapp）

用户拍板：a) 接受 / b) 调整范围

5.3 明天第三件：B2b-1b-iii about.html Contact 卡片

目的：让 about.html Contact 卡 5 字段（Email/WhatsApp/Phone/WeChat/Web）数据驱动。

前置条件： - ⚠️ D1 settings 加 3 字段：support_wechat / company_web / company_web_url - ⚠️ SiteSettings 加 renderContactCard() 函数 - ⚠️ 旧文案 “rail / small_packet” 删除或改

用户拍板：a) 接受 / b) 调整

5.4 明天第四件：D1 备份表清理（可与第二/三件并行）

SQL：

DROP TABLE shipping_methods_backup_20260918;
DROP TABLE policy_texts_backup_20260918;
DROP TABLE settings_backup_20260918;

前置条件：B2c 至少稳定 1 周，确认无回滚需求

5.5 Phase 4 启动前清单（如果决定现在启动）

5.6 需要用户先拍板的事

附录 A：D1 完整现状速查

总表数: 23
总行数（含备份）: ~470
核心表:
- products: 31
- policy_texts: 8
- settings: 12
- shipping_methods: 4 (active 3)
- shipping_rates: 20
- customer_groups: 5
- industries: 9
- product_tags: 239
- customers: 1 (测试)
- invoices: 0
- invoice_items: 0
- invoice_status_log: 0
- used_tokens: 0

附录 B：部署 ID 速查

Worker cys-email:
- PRE_ID: 6175c287-50ed-49c9-96a3-6aa9881923b6 (title_en fix)
- NEW_ID: afd68093-d4dc-4c3b-b32b-7381974bb549 (Step 6 /api/shipping-methods)

Pages cysbearing:
- PRE_ID: 96c7f3a3-7b8d-4af1-8259-09a6bc45dcd6
- NEW_ID (B2c 第一次): 1d887757-c2d6-4074-85a4-1a7f70ff8007
- NEW_ID (active): 80c61e47-3908-4b2e-991f-8730bffcc31d
- Environment: Production / Branch: main

附录 C：永久规则（来自 memory 25-26 + 项目规则）

25. Cloudflare API token 可能失效。新会话第一件事 wrangler whoami 验证。
26. Token 用过即清（rm -f /tmp/.cf_token），不在 memory 写真值，用 <CF_TOKEN> 占位符。
- DDL / DML 前必查证（PRAGMA + COUNT + SELECT）
- ALTER 前确认列不存在（避免 duplicate column）
- 部署前确认 PRE_ID，部署后确认 NEW_ID
- wrangler rollback 用 PRE_ID（不是 NEW_ID）
- 修改后本地 Node 跑所有函数分支（US / 非 US / 空 / 边界）全通过再部署
- 不写编造数据写入生产环境
- 字段 / 表名 / 状态值要可扩展（用 string，不用 enum）
- 每条 wrangler 命令必须贴原始 stdout（含 Executed / results / meta）

附录 D：关键文件位置

项目主文档:
- /workspace/PROJECT_MASTER_PLAN.md (v1.10)
- /workspace/PROJECT_DERIVATION.md
- /workspace/customer_system_v1_design.md
- /workspace/site_final/v3/docs/MASTER_DOCUMENT.md (v4.0)
- /workspace/site_final/v3/docs/TECHNICAL_MANUAL.md
- /workspace/site_final/v3/docs/DECISIONS_LOG.md (决策 1-38)
- /workspace/site_final/v3/docs/ISSUES.md (14 问题)

网站代码:
- /workspace/site_final/v3/*.html (14 页面 + 4 admin)
- /workspace/site_final/v3/js/*.js (26 模块)
- /workspace/site_final/v3/css/*.css (15 模块)
- /workspace/site_final/v3/config/ (8 JSON + 2 bak)
- /workspace/site_final/v3/migrations/ (4 SQL)

Worker 代码:
- /workspace/cys-email/src/index.js (2485 行, 25 个 handler)
- /workspace/cys-email/lib/ (9 模块: banks / countries / invoice-no / totals / display-spec / pricing-engine / weight-engine / email-builders / generate-pdf)
- /workspace/cys-email/wrangler.toml (Worker config + D1 binding + Cron)
- /workspace/site_final/workers/quote-submit.js (询盘 Worker，未部署)

迁移 SQL:
- /workspace/site_final/v3/migrations/config-migration.sql (categories / countries / banks / shipping)
- /workspace/site_final/v3/migrations/extras-migration.sql (scenes / hot_products / type_templates / policy_texts)
- /workspace/site_final/v3/migrations/import_data.sql
- /workspace/site_final/v3/migrations/products-import-2026-09-11T03-02-04.sql (31 产品)

文档结束。最后更新：2026-09-19 06:30（早晨用户开题时）