DusunIoT 重建版（TanStack Start + Bun + PostgreSQL）

将原 WordPress + Elementor + WooCommerce + GTranslate 站点（dusuniot.com）重构为单体应用： 前台 SSR 1:1 还原、后台 React + Ant Design 功能等价实现、PostgreSQL 关系型数据模型。

方案文档：docs/dusuniot-rebuild-tanstack-bun-pg-v2.md

技术栈

领域	选型
运行时 / 包管理	Bun 1.4+
前台 SSR / 路由	TanStack Start（Vite）+ React 19 + TS
数据库	PostgreSQL 16（Bun.sql + Drizzle ORM）
后台 UI	React + Ant Design 6（仅 SVG 图标，禁 emoji/图标字体）
后台任务	jobs 表持久化队列（scripts/jobs-worker.ts，独立进程）

快速开始

bun install
# .env 默认 DATABASE_URL=postgres://dusuniot:dusuniot@127.0.0.1:25432/dusuniot
bun run db:migrate            # 应用迁移（src/db/migrations）
bun run import:wordpress      # 全量导入 WP 备份库（需 MariaDB 容器 dusuniot-mariadb, 端口 13306）
bun run dev                   # 开发服务器 http://localhost:3311
bun run build && bun run start  # 生产构建（Nitro .output）
bun run scripts/jobs-worker.ts  # 后台任务 worker
bun test                      # 单元/集成测试

WordPress 数据迁移

• 备份源：dusuniot-full-20261029.tar.gz（站点文件 + mysqldump）。媒体已硬链接到 public/uploads。
• 导入脚本：scripts/wordpress-import/import.ts，支持 --only=step1,step2 分步重跑（步骤：reset/media/users/categories/attributes/products/contents/views/orders/flamingo/elementor/forms/menus/filters/redirects/languages/final）。
• 导入规模：148 产品（含属性/筛选映射）、674 内容（含 Elementor JSON）、53,101 询盘（Flamingo + Elementor 双源）、108 订单、8,210 媒体、493 条 301 重定向、104 语言、4 菜单 283 菜单项。
• 旧 ID 映射存 legacy_id_mappings 表；WP 旧密码（phpass $P$）保留在 users.legacy_password_hash，客户登录时透明升级 bcrypt。

与原站插件的功能等价映射

原插件	新实现
WooCommerce	products/orders/order_items/payments 关系模型 + 购物车/结账/账户（PayPal 回调位预留，幂等键 transaction_id）
Contact Form 7 + Flamingo	inquiry_forms（表单定义）+ inquiries（统一询盘表）+ 邮件任务队列
Filter Everything	filters 配置表 + product_attributes/values/map 关系型筛选（复合索引 + EXISTS 交集查询）
GTranslate	/<lang>/ 前缀路由 + UI 壳层字符串 + content/product_translations 真实发布版本（缺翻译不生成伪语言页）
Redirection	redirects 表 + 请求中间件（301/302，支持正则）
Elementor（前台）	src/components/elementor/Renderer.tsx（section/column/heading/text-editor/image/button/image-box/icon-list/tabs/toggle 等 20+ widget）
Rank Math SEO	contents/products 内置 SEO 字段 + sitemap.xml + robots.txt + hreflang
WP Rocket	设计上按 URL/语言做服务端缓存（Cloudflare/Nginx 层），登录态/购物车禁共享缓存
Dusun Flamingo Reader	后台询盘模块 + REST API（保留给 AI 线索管道）

URL 兼容（SEO 硬性要求）

• 页面 /<slug>/、文章 /<category>/<slug>/、产品 /product/<slug>/、产品分类 /collection/<slug>/（与原站 permalink 一致，trailingSlash always）。
• 493 条旧重定向规则原样生效；canonical/hreflang/sitemap 由 SEO 模块输出。

后台

/admin（默认管理员见导入输出）。模块：Dashboard / 内容 / 产品 / 订单 / 询盘 / 媒体 / 语言 / SEO 重定向 / 筛选 / 用户 / 设置。 所有接口 requireAdmin() 权限校验，敏感操作写 audit_logs。

目录结构

见方案文档第 6 节。src/server/* 按业务域拆分（auth/content→data/products→data/filters/orders→commerce/inquiries/translations/seo/jobs）。

版本

版本号以 package.json version 为准，每轮交付自增（patch/minor/major）。