快速开始

安装

安装 Bun 并克隆模板,然后运行:

bun install
bun run init
bun run db:push
bun run rbac:init
bun run dev

db:push 仅用于全新的开发数据库。初始化不会复制旧用户、订单和密钥。通过注册页面创建用户后,再单独分配管理角色。

环境配置

初始化写入 .env.development 并生成新的签名与加密密钥。通过 VITE_APP_MODULE_* 独立启用功能,没有 Full/Lite 模式选择。修改本地环境变量后重启开发服务;公开的构建时开关需要重新构建。

项目结构

  • src/routes:TanStack 文件路由与薄 HTTP 入口。
  • src/blocks:业务页面区块。
  • src/components:共享 UI 组件。
  • src/modules:业务服务。
  • src/core:认证、外部服务、存储与数据库基础设施。
  • src/content:本地博客、文档与可选首页内容。
  • messages:Paraglide 扁平语言文件。

开发配置

/config 只编辑白名单内的公开设置。服务商密钥通过服务端环境变量或后台加密设置提供。