关于本项目

bff-ssr-render 用于理解 BFF、SSR 与 EJS 的协作方式;示例商品与横幅来自仓库 data/*.json,SSR 与 BFF 共用同一数据源。

从哪里开始

完整步骤、环境变量与路由表见 入门引导(/guide);仓库内权威说明见根目录 README.md(与引导页主旨对齐)。

功能一览

  • 入门引导/guide(站内文档)。
  • SSR:首页、商品列表/详情、表单演示、本页。
  • BFF JSON/bff/home/bff/products/bff/products/:id
  • 模板工作室/admin/templates数据源/admin/datasource。生产环境默认不挂载管理端:部署时设环境变量 TEMPLATE_STUDIO=1 可全局开启;或从顶栏进入本页(链接已带 ?template_studio=1)在浏览器内开启 7 天,随后即可使用上述地址。
  • 自检pnpm run check(模板编译 + 集成请求)。

技术要点

  • 布局:views/layouts/base.ejs + express-ejs-layouts。
  • 辅助函数:src/ejs-helpers.jsapp.locals(如 currencytruncateWords)。
  • 应用工厂 src/app.js 与进程入口 src/server.js 分离,便于测试挂载。

Docker / Railway、目录树、安全提示见 README。