Initial commit: CRM AI Demo bridge + KB knowledge base + infrastructure

- Bridge server with LLM agent tool-use (search_kb, search_products, search_orders, search_inventory, escalate_human)
- pgvector RAG knowledge base (95 FAQ chunks)
- Auto opportunity creation in Twenty CRM
- Auto follow-up task workflow
- Chatwoot AgentBot integration (HMAC, webhook)
- Docker compose infrastructure (PG18, Redis 8.8, node24-alpine)
- Configuration templates (example files) - real secrets excluded via .gitignore

customer-service-kb/README.md

@@ -0,0 +1,54 @@
+# Yehwang 客服知识库 (Customer Service Knowledge Base)
+
+面向 **Chatwoot + ai-bridge + Twenty** AI 客服系统的知识库。内容为英文（客户群体为欧洲 B2B 零售商/店主，官方 FAQ 原文亦为英文），AI 在回复时按客户语言翻译即可。
+
+## 内容来源（均为权威来源，非编造）
+
+每个 md 文件都在 frontmatter 的 `source_url` 字段、以及正文标题下的「📎 来源 / Source」行里标注了**确切来源地址**，可点击核对/更新。汇总：
+
+| 来源地址 | 对应文件 |
+|---|---|
+| https://www.yehwang.com/about-us.html | 00-about |
+| https://www.yehwang.com/register.html | 00-about, 01-registration |
+| https://www.yehwang.com/order.html | 02-ordering, 09-membership |
+| https://www.yehwang.com/pre-order.html | 03-pre-order |
+| https://www.yehwang.com/payment.html | 04-payment |
+| https://www.yehwang.com/shipment.html | 05-shipping |
+| https://www.yehwang.com/returns.html | 06-returns |
+| https://www.yehwang.com/factory-direct.html | 07-factory-direct |
+| https://www.yehwang.com/other-questions-1987986538 | 01-registration, 10-products |
+| https://www.yehwang.com/membership-307802756 | 09-membership |
+| https://dropshipping.yehwang.com/ · /about-us · /faq/{register,order,payment,shipment,returns} | 08-dropshipping |
+| 数仓表 `wa_dim.dim_product_full` / `wa_dim.dim_user_full`（快照 2026-06-25） | 00-about, 09-membership, 10-products |
+| 内部文档 `公司介绍.md.txt`（业务背景） | 00-about |
+
+> 官网 FAQ 答案为 JS 折叠加载，用 Playwright 渲染后抓取；原始抓取数据存档于 `_source/`。
+
+## 文件结构（一主题一文件，问答块切分，适配 RAG）
+
+- `index.md` — 导航
+- `00-about-yehwang.md` — 公司是谁、卖什么、两种履约模式
+- `01-registration-account.md` — 注册 / 账号 / 找店 / 图片授权
+- `02-ordering.md` — 下单 / 起订 €30 / 数量折扣 / 改单取消 / 优惠码
+- `03-pre-order.md` — 预购规则
+- `04-payment-vat-invoice.md` — 支付方式 / VAT / 发票
+- `05-shipping-delivery.md` — PostNL/DHL 物流 / 运费 / 时效 / Brexit
+- `06-returns-refunds.md` — 退换货 / 缺件 / 残次 / 定制品
+- `07-factory-direct.md` — 工厂直发（中国直发全球）
+- `08-dropshipping.md` — 一件代发（Shopify 接入）
+- `09-membership-rewards.md` — 会员等级 / 阶梯量折扣 / 奖励
+- `10-products-and-jewelry-care.md` — 品类盘 / 价格带 / 材质 / 珠宝护理
+
+## 给 ai-bridge 的接入建议
+
+1. **切块**：每个 `### Q:` 问答块作为一个 chunk（已天然分段）。frontmatter 里的 `keywords` 可并入 embedding 文本提升召回。
+2. **向量化**：数仓 `.env.local` 已含 `DASHSCOPE_API_KEY`（`text-embedding-v3`，多语言），可直接复用，对欧洲多语种问法召回友好。
+3. **system prompt 约束**：要求 AI 仅依据知识库作答；涉及金额/时效/政策时引用具体条款；无法回答时转人工（`helpdesk@yehwang.com` / `service@yehwang.com`）。
+4. **联系方式**：自营/网站业务 `helpdesk@yehwang.com`、电话 `+31 318 668 171`；工厂直发 `service@yehwang.com`。
+
+## 维护
+
+- 政策类内容随官网 FAQ 变化需同步；商品/等级类数据可定期从数仓刷新（脚本见 `scratchpad` 或重跑聚合）。
+- 标 `⚠️ 待核对` 的条目为需业务确认后补全的细节（如各国运费表、各国 VAT 税率表）。
+
+_最后更新：2026-06-25_