关于本项目
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.js→app.locals(如currency、truncateWords)。 - 应用工厂
src/app.js与进程入口src/server.js分离,便于测试挂载。
Docker / Railway、目录树、安全提示见 README。