HS Design SaaS 平台 改造项目范围

愿景与背景

HS Design 已有面向单一品牌的报价单系统，部署在 hsdesign.biz（Cloudflare Pages + D1 数据库）。本次改造目标是把这个工具变成开放给所有装修设计师使用的 SaaS 平台，每位设计师都获得：

• 独立的子域名工作区（如 designer1.hsdesign.biz）
• 可上传自家 logo、设置主题色的品牌页面
• 独立的客户与报价单数据空间
• 免费起步，付费升级（去除广告 + 解锁配额）

这次转型的战略意义：

现有系统基线

SaaS 架构总图

                                 ┌──────────────────────────┐
   设计师A 的客户访问            │      Cloudflare DNS       │
   designer-a.hsdesign.biz ───►│  *.hsdesign.biz wildcard  │
   designer-b.hsdesign.biz     │  CNAME → SaaS Pages       │
                                └──────────┬───────────────┘
                                           │
                          ┌────────────────▼─────────────────┐
                          │   Cloudflare Pages (Frontend)    │
                          │   单一 React/Vue SPA             │
                          │   读取 location.host → 解析租户   │
                          │   GET /api/tenant?host=...       │
                          └────────────────┬─────────────────┘
                                           │
                          ┌────────────────▼─────────────────┐
                          │   Worker: hsdesign-saas-api      │
                          │   ┌──────────────────────────┐   │
                          │   │ 1. 解析 Host header      │   │
                          │   │ 2. 查询 tenants 表        │   │
                          │   │ 3. 注入 tenant_id 上下文   │   │
                          │   │ 4. 验证 JWT/session       │   │
                          │   │ 5. 检查配额 + 订阅状态    │   │
                          │   └──────────────────────────┘   │
                          └─┬───────────────┬───────────────┘
                            │               │
                  ┌─────────▼──┐     ┌──────▼────────┐
                  │   D1 DB    │     │   R2 Storage  │
                  │ tenants    │     │ logos/        │
                  │ users      │     │ exports/      │
                  │ quotations │     │ tenant-1/...  │
                  │ items      │     │ tenant-2/...  │
                  │ usage      │     └───────────────┘
                  └────────────┘

关键设计决策：

子域名路由方案

# wrangler.toml — 通配符路由配置
name = "hsdesign-saas-api"
routes = [
  { pattern = "*.hsdesign.biz/*", zone_name = "hsdesign.biz" },
  { pattern = "hsdesign.biz/api/*", zone_name = "hsdesign.biz" }
]

export default {
  async fetch(req, env) {
    const url = new URL(req.url);
    const host = req.headers.get('host'); // designer-a.hsdesign.biz
    const sub = host.split('.')[0];      // designer-a

    // 保留子域：app/www/admin/api
    if (['app','www','admin','api'].includes(sub)) {
      return handleSystemRoute(req, env, sub);
    }

    // 查 tenant
    const tenant = await env.DB.prepare(
      'SELECT * FROM tenants WHERE subdomain = ? AND status = ?'
    ).bind(sub, 'active').first();

    if (!tenant) return render404();

    // 把 tenant 注入到所有下游处理器
    return handleTenantRoute(req, env, tenant);
  }
}

多租户数据隔离

强制注入 tenant_id 的关键代码模式

// ❌ 危险：直接 SQL 容易漏掉 tenant_id
db.prepare('SELECT * FROM quotations WHERE id = ?').bind(id);

// ✅ 安全：每个 query 都通过统一 helper
function scoped(db, tenantId) {
  return {
    quotations: {
      find: (id) => db.prepare(
        'SELECT * FROM quotations WHERE id=? AND tenant_id=?'
      ).bind(id, tenantId).first(),
      list: () => db.prepare(
        'SELECT * FROM quotations WHERE tenant_id=? ORDER BY created_at DESC'
      ).bind(tenantId).all(),
    }
  };
}

品牌定制系统

租户可定制的元素

动态主题注入示意

// 前端启动时
const tenant = await fetch('/api/tenant/current').then(r => r.json());

document.documentElement.style.setProperty('--primary', tenant.theme_primary);
document.documentElement.style.setProperty('--accent', tenant.theme_accent);
document.title = `${tenant.company_name} · 报价单`;

不可定制（明确划线）

• 报价单模板版式 — 平台统一控制，便于批量升级
• 表单字段结构 — 保证数据一致性，未来 AI 可分析
• 导出 PDF 排版 — 全平台同一设计语言
• 底部水印（免费版）— "Powered by HS Design" + 平台 logo

数据库设计

新增核心表

-- 租户主表
CREATE TABLE tenants (
  id TEXT PRIMARY KEY,                -- ULID
  subdomain TEXT UNIQUE NOT NULL,       -- e.g. "designer-a"
  company_name TEXT NOT NULL,
  owner_email TEXT NOT NULL,
  theme_primary TEXT DEFAULT '#d4af37',
  theme_accent TEXT DEFAULT '#0a0a0a',
  logo_url TEXT,
  contact_phone TEXT,
  contact_address TEXT,
  plan TEXT DEFAULT 'free',           -- free | pro
  status TEXT DEFAULT 'active',        -- active | suspended | trial
  trial_ends_at DATETIME,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
CREATE UNIQUE INDEX idx_tenants_subdomain ON tenants(subdomain);

-- 用户表（设计师 + 团队成员，未来支持多人协作）
CREATE TABLE users (
  id TEXT PRIMARY KEY,
  tenant_id TEXT NOT NULL,
  email TEXT NOT NULL,
  password_hash TEXT,
  role TEXT DEFAULT 'owner',           -- owner | member
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (tenant_id) REFERENCES tenants(id)
);
CREATE UNIQUE INDEX idx_users_email ON users(tenant_id, email);

-- 订阅记录
CREATE TABLE subscriptions (
  id TEXT PRIMARY KEY,
  tenant_id TEXT NOT NULL,
  plan TEXT NOT NULL,                  -- pro_monthly | pro_yearly
  status TEXT NOT NULL,                -- active | canceled | past_due
  current_period_start DATETIME,
  current_period_end DATETIME,
  provider TEXT,                        -- stripe | iPay88 | manual
  provider_subscription_id TEXT,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 用量配额（按月统计）
CREATE TABLE usage_monthly (
  tenant_id TEXT NOT NULL,
  year_month TEXT NOT NULL,             -- '2026-05'
  quotations_count INTEGER DEFAULT 0,
  pdf_exports_count INTEGER DEFAULT 0,
  storage_bytes INTEGER DEFAULT 0,
  PRIMARY KEY (tenant_id, year_month)
);

-- 报价单（改造现有表，新增 tenant_id）
ALTER TABLE quotations ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'legacy';
CREATE INDEX idx_quotations_tenant ON quotations(tenant_id, created_at DESC);

ALTER TABLE quotation_items ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'legacy';
CREATE INDEX idx_items_tenant ON quotation_items(tenant_id);

-- 客户表（设计师管理自己的客户）
CREATE TABLE customers (
  id TEXT PRIMARY KEY,
  tenant_id TEXT NOT NULL,
  name TEXT NOT NULL,
  phone TEXT,
  email TEXT,
  address TEXT,
  notes TEXT,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
CREATE INDEX idx_customers_tenant ON customers(tenant_id);

迁移现有数据

把 HS Design 自己的报价数据迁移为一个特殊租户：

INSERT INTO tenants (id, subdomain, company_name, owner_email, plan)
VALUES ('tnt_hsdesign', 'hs', 'HS Design', 'admin@hsdesign.biz', 'pro');

UPDATE quotations SET tenant_id = 'tnt_hsdesign' WHERE tenant_id = 'legacy';
UPDATE quotation_items SET tenant_id = 'tnt_hsdesign' WHERE tenant_id = 'legacy';

之后 HS Design 自己用 hs.hsdesign.biz 访问，与平台其他租户使用同一系统 — 这是吃自己的狗粮，最有效的质量保证手段。

定价与商业模式

定价依据

• RM 49/月 对马来西亚装修设计师属于"几顿饭钱"，决策门槛低；同时高于 Notion (RM 35) 这类工具，体现专业属性。
• 年付折扣 17%（RM 490 vs 588）— 提升留存，降低月度流失风险。
• 100 份免费配额 可让大部分中小设计师"长期免费但顺便挂广告"，是流量基础。一名活跃设计师月均 30–60 份报价，100 份额对真实使用者基本够用 → 留下中尾流量挂广告。

支付通道

Google Ads / AdSense 集成方案

广告位规划（仅 Free 用户可见）

收入预估（保守）

马来西亚 AdSense 单价较低，但装修家居类目相对高价值。粗略估算：

• RPM（每千次展示收入）：RM 4–12
• 假设 1000 个免费设计师，月均每人产生 200 个页面浏览 → 200,000 PV/月
• 预估月广告收入：RM 800 – RM 2,400

这个数字告诉我们：广告不是主要收入来源，而是"免费用户的兜底变现 + 转化付费的微推动力"（用户嫌广告烦 → 升级）。

实现要点

// 只对 Free 用户加载 AdSense
function AdSlot({ slotId }) {
  const { tenant } = useTenant();
  if (tenant.plan !== 'free') return null;

  return (
    <ins className="adsbygoogle"
         data-ad-client="ca-pub-XXXXXXXX"
         data-ad-slot={slotId}
         data-ad-format="auto" />
  );
}

红线

用户获客策略

这是这个项目的核心问题。下面按预期 ROI 从高到低排列：

1. SEO 长尾关键词 MVP 必做

装修设计师与他们的客户在 Google 搜什么？我们要排进首页：

• "装修报价单 模板 马来西亚" / "renovation quotation template Malaysia"
• "装修预算计算" / "kitchen cabinet quotation"
• "室内设计师 报价 系统" / "interior designer software"
• "装修 报价单 PDF 模板 免费"

策略：在主域名 hsdesign.biz/blog/ 持续产出"如何写装修报价单"、"装修单价参考表 2026"、"客户砍价应对话术" 等长文。每篇文末引导"用 HS Design 一键生成专业报价单 — 免费"。

资源投入：2–3 篇/周，6 个月可见明显效果。可用 AI 协助初稿，设计师本人审校（保真实性）。

2. 案例展示墙（病毒效应） MVP 必做

每个免费用户生成的报价单（在他们同意的情况下）会有"由 HS Design 制作"的水印 + 链接。当客户收到 PDF：

• 客户被精美排版打动 → 点击水印 → 进入平台 → 推荐给自己的设计师朋友
• 客户自己想做装修对比 → 注册成"业主版"（v2 拓展）
• 设计师之间互相看到同行用的工具 → 自然口碑

这是每一份导出的 PDF 都是一个广告位的原理。Calendly、Notion、Typeform 都是这么做大的。

3. 设计师社群渗透 MVP 必做

• Facebook 群组："马来西亚室内设计师交流"、"装修业主分享"等群，定期分享干货+工具截图
• 小红书 / Xiaohongshu：马来西亚华人装修博主聚集地，发"我用了一个免费工具做报价，客户当场签单"类型内容
• Reddit r/malaysia / r/InteriorDesign：低频但精准
• LinkedIn：对接连锁装修公司的设计主管，做 B 端转化

4. 推荐返佣 v1.5

每位设计师推荐一位同行付费成功 → 自己下个月免费。规则简单透明：

• 用户专属推荐链接：hsdesign.biz/?ref=designer-a
• 被推荐人付费 → 推荐人获得 1 个月免费（最多累积 12 个月）
• 双向激励：被推荐人首月 50% 折扣

5. 内容合作 / KOL v1.5

• 找马来西亚装修类 YouTube / 小红书 KOL（5–50K 粉丝）合作软广 / 测评
• 给装修博客提供"专属推广码 + 30% 首年返佣"
• 赞助装修类播客单集

6. 直接 Google Ads 投放（付费搜索）v1.5+

购买 "装修报价软件"、"renovation quote tool" 这类词的搜索广告。预算控制在 RM 500–1500/月 起步，盯紧 CAC（获客成本）：

• 目标：CAC < 3 个月 LTV（即 < RM 147）
• 转化路径：广告 → 落地页 → 注册免费 → 14 天后促销升级

7. B2B 合作 / 装修材料商 v2+

与马来西亚装修材料供应商（厨柜、瓷砖、灯饰）合作 — 把他们的产品库内置到报价单系统里：

• 设计师选材料 = 直接生成报价行 → 减轻设计师工作量 = 强力卖点
• 材料商按订单付佣金给平台
• 同时建立护城河，竞品难复制此供应链关系

技术栈选型

不选的方案与原因

• Next.js：SSR 在 Cloudflare 上有限制；SaaS 工作区是登录后内容，SPA 足够。
• Supabase：方便但与 Cloudflare 生态隔离；如果换库，迁移到 Neon 更顺手。
• Auth0 / Clerk：每月数百 RM，给马来西亚价位的 SaaS 太贵。Lucia 自建 1 周搞定。
• 独立 PDF 服务：每月成本高且慢；用 HTML 渲染足够 95% 场景。

报价单模板系统

用户已明确：模板标准化，租户不可改。这是好决策。具体落地：

模板类型（首期 3 套，覆盖主流场景）

租户能控制的部分

• 选用哪个模板（每张报价单独立选择）
• 填什么内容（项目条目、单价、备注）
• 头部 logo + 配色（来自租户设置）
• 底部公司信息 + 签名（来自租户设置）

租户不能控制的部分

• 排版结构 / 字段位置
• 字体（除主题色外）
• 单位与计算方式（统一 RM、面积单位 sq.ft）

模板存储与升级

-- 模板表（平台运营，租户只读）
CREATE TABLE templates (
  id TEXT PRIMARY KEY,
  name TEXT,
  description TEXT,
  schema_json TEXT,    -- 字段定义（JSON）
  layout_html TEXT,    -- 渲染模板（HTML+占位符）
  version INTEGER,
  is_active INTEGER DEFAULT 1
);

未来要升级模板时，新增 version，老报价单仍用老模板渲染（避免破坏历史数据）。

开发时间表

MVP 范围定义

未来路线图

v2：项目管理模块 月 4–6

一个装修项目从签约到交付通常 2–6 个月，涉及大量文件、阶段、沟通。把项目作为顶层实体，报价单、施工图、文档、付款记录、客户沟通都挂在项目下。

商业价值：项目管理把"用户从临时工具用户变成长期用户"，付费转化率会显著提升。

v3：AI 装修问答助手 月 7–9

训练一个针对马来西亚装修场景的助手，回答设计师与业主的问题：

• "吉隆坡 1500 sq ft 公寓的厨柜大概多少钱？"
• "乳胶漆和墙纸的优缺点比较"
• "这份报价里 RM 8000 做电工合理吗？" — 基于平台数据回答
• "客户说要砍价 20%，怎么回应？"

训练数据来源（独家护城河）

• 平台累积的真实报价数据（脱敏后）
• Reddit / Lowyat / 小红书的装修讨论
• 马来西亚装修材料商的产品库 + 价格
• 合作专家（资深设计师、QS）的问答

技术方案

• 初期：用 OpenAI/Anthropic API + RAG（向量检索）
• 中期：基于 Llama / Qwen 微调一个领域模型
• 部署：Cloudflare Workers AI 或 Modal serverless GPU

商业模式

• Pro 用户每月 200 次免费
• 超出按量计费（RM 0.50/次）或升级 Pro+ 套餐
• "AI 报价审查" — 上传报价单让 AI 找出问题、优化建议（核心增值功能）

v4 之后的可能性

• 业主端入口（C 端）：业主上传需求 → 平台匹配 3 位设计师投标 → 抽佣
• 装修材料市场：平台内嵌商城，材料商挂货，设计师下单抽佣
• 设计师培训 / 认证体系：付费课程、平台徽章
• 装修保险 / 担保交易：为业主提供工程款托管

风险与缓解

用户核心问题答复

建议的下一步行动

1. 本周：评审本文档，确认范围、定价（RM 49 是否合适）、配额（100 份是否合适）。
2. 下周：注册必要服务（Stripe Sandbox、AdSense、Resend、Sentry）、设计 logo + 营销主页 wireframe。
3. 第 1–6 周：按上方时间表执行。
4. 第 6 周末：邀请 10 位设计师内测，启动获客 plan。
5. 每月 1 号：复盘 KPI（注册数、付费转化、月活、广告收入），调整策略。

需要你尽快决定的事