用 SvelteKit 交付 AI SaaS,不必从零重做认证与计费。
生产级 SvelteKit 模板:登录、访客模式、结账、积分、文档、博客与控制台已预接,后端契约与 Nuxt 栈一致。复制模板、配置品牌,部署到 Cloudflare。
AUTH_SERVICE /auth/login /auth/me /credits/balance
PAY_SERVICE /pricing/plans /stripe/checkout /user/orders
BLOG_SERVICE /blog/list /blog/get,支持 Markdown 本地兜底内容
AI_SERVICE /ai/models /ai/chat/completions,支持用户 API Key
SUPPORT + CHECKIN /feedback /tickets /checkin/status /checkin/claim
能力
SaaS 前台第一天就需要的能力。
品牌、SEO、Analytics 同意、Dashboard 功能开关与 Service Binding 都从一份 manifest 配置,营销站、产品台与文档一起交付。
认证与会话
邮箱、访客与 OAuth 就绪的 BFF,HttpOnly Cookie 会话。
计费与积分
套餐、结账、订单、订阅与积分余额,经 pay-service 代理。
工作台
API Key、工单、签到、邀请与 AI Playground,由 feature flag 控制。
文档、博客与合规
Markdown 内容、sitemap、robots 与政策页开箱即用。
SEO 与分析
manifest 驱动 title/OG;第三方脚本仅在 consent 后加载。
Cloudflare Workers
Auth、Pay、Blog、AI、Support 等 Service Binding 对齐。
工作流
从首次访问到付费使用。
基于 Cookie 的会话
登录响应会把后端 token 保留在服务端,浏览器侧只拿到标准化后的账号数据。
支付服务结账
价格和结账请求通过 service binding 或本地 Worker fallback 代理到 node3-pay-service。
产品工作流
控制台会在当前会话下读取余额、交易、订单、订阅、API Key、支持工单和每日签到状态。
文档和博客
公开文档、博客 API、法律页面、sitemap、robots 和 llms.txt 随 SvelteKit 应用一起提供。
常见问题
分叉模板前的常见问题。
和 web-nuxt 有什么不同?
web-sveltekit 是并行的 SvelteKit 前台,共享同一套 ZShip BFF 契约。团队更偏好 Svelte 时选用本模板。
品牌和 SEO 在哪里配置?
编辑 apps/web-sveltekit/zship.app.json 中的 siteName、seo.landingTitle、seo.landingDescription、footer、analytics 与 dashboard feature flags。
Analytics 脚本何时加载?
默认永不加载。配置了 provider ID 且开启 consentBanner 后,仅在用户同意 Cookie 后才注入 GA / Plausible / Clarity。
如何隐藏 Dashboard 模块?
在 manifest 中将 dashboard.features.checkin、tickets、referral 或 enterpriseBilling 设为 false,即可隐藏入口并拦截直链。