ShopTNT BBC 8.0 项目概览
ShopTNT BBC 8.0 采用前后端分离架构。浏览器端和移动端通过 API 使用业务能力，API 再连接数据库、缓存、消息、搜索和任务调度等基础设施。
本页说明系统各层的依赖方向。PC UI 运行时结构见前端架构，静态部署方式见部署 PC 前端；后端服务、端口和中间件配置以当前项目的后端部署资料为准。
UI
BBC 8.0 的 UI 分为两个独立代码范围：
| 范围 | 组成 | 说明 |
|---|---|---|
| PC UI workspace | 买家 PC 端、商家管理端、平台管理端 | Vue 3 + TypeScript + Vite，多应用 pnpm workspace |
| 移动端工程 | H5、微信小程序、App 等 | 独立仓库和构建流程，不包含在 PC UI workspace 中 |
PC UI workspace 中的三个 Web 应用分别位于 apps/pc、apps/seller 和 apps/admin。页面装修是 packages/decor 提供的共享能力，由平台端、商家端和买家 PC 端按职责加载，不再作为第四个独立 Web 应用启动。
API
前端按职责访问 Base、Buyer、Seller 和 Admin API。单体网关部署可以为四类请求配置同一个网关地址，拆分部署也可以为每类 API 分别配置地址。
前端文档只描述 API 地址和浏览器请求链路，不定义后端服务内部结构。后端模块、数据库和业务规则应以后端 8.0 源码及对应开发文档为准。
基础设施
API 运行依赖数据库、缓存、消息、搜索和任务调度等基础设施。基础设施必须先于 API 就绪，UI 则必须在可访问的 API 和正确的站点域名配置完成后再进行联调和发布。
推荐按以下顺序搭建完整环境：
- 准备基础设施。
- 配置并启动 API。
- 配置、构建和发布 UI。
- 验证登录、菜单权限、上传、搜索、支付回调等跨系统链路。
本机首次启动 PC UI 请阅读前端开发环境搭建；正式服务器部署请阅读部署 PC 前端。
版本边界
本版文档以 BBC 8.0 为目标。不能把 7.x 文档中的旧目录、旧配置文件、旧包管理器或旧构建命令直接套用到 8.0；具体对应关系集中列在前端开发概览中。
源码中存在页面也不代表当前角色或环境一定可见：平台端和商家端菜单以后端 current 菜单接口为准，部分功能还受构建时功能开关控制。