node-shop-v2

从「共享库 + 每店独立业务库」的单店商城，往多商户 SaaS 建站平台演进：店铺之间既要隔离数据，又要共用一套后台、主题与运营能力。

随之而来的是一整串问题：店铺子域名怎么路由、商户自带翻译 key 怎么接、邮件模板怎么可视化编排、误删的商品怎么恢复、开放 API 怎么鉴权。

以 NestJS + TypeScript 为主干，把架构演进、功能设计与交互原型同步沉淀成文档，先画清楚再动手。

• 单库多租户改造（行级隔离）与店铺子域名反向代理方案
• 主题引擎、组件树页面渲染与页面装修，产出 6 套商城主题原型
• 支付（PayPal）、物流承运商、汇率与内容多语言（zh-CN / zh-TW / en）
• 邮件模板草稿/发布模型与可视化编辑器，产出邮件客户端安全 HTML
• 打印客户端、订单导出模板、资源级鉴权（RBAC + resource_access）
• 商户开放 API：API Key + HMAC-SHA256，首批只读订单 / 商品 / 会员

项目的 doc/ 目录累计 360 个文件：69 篇技术文档、60 个后台原型页面、14 个蛋糕促销专题以及多套商城主题。本站从中精选 10 篇文档整理成「文章」，并挑出代表性原型做成「演示」画廊。

文档里不少方案仍处于「设计中 / 待评审」状态，文章页会如实标注，不把设计当成已上线成果。