# 前后台整合方案

- 英文简称：BDIP
- 英文全称：Building Data & Information Platform 
- 中文全称：建筑数据与信息平台
- 中文简称：建数

## `bdip` 目录结构

```
bdip/
├── apps/
│   ├── admin/                        # 网站管理后台 ← 迁移自 bmstrae - v2
│   │   ├── docs/                     # 【后台专属】PRD(按模块)/dict/report/ui/change-log，原样保留
│   │   ├── public/
│   │   ├── src/
│   │   │   ├── components/  contexts/  data/  hooks/  pages/  styles/  types/  utils/
│   │   │   ├── App.tsx  main.tsx  index.css
│   │   ├── index.html
│   │   ├── package.json              # name: @bms/admin
│   │   ├── tsconfig.json             # 加 @bms/shared 别名
│   │   ├── vite.config.ts
│   │   ├── .skills/                  # 后台技能指令（原样保留）
│   │   └── .env.example
│   │
│   └── web/                          # 前台门户 ← 迁移自 binfo-trae
│       ├── docs/                     # 【前台专属】PRD(按栏目)/ui/axure/collection，原样保留
│       ├── infodata/                 # 采集脚本与原始数据（保留）
│       ├── public/
│       │   ├── data/                 # 构建前由 scripts 同步（文章中心+采集产物）
│       │   ├── _redirects            # SPA History 回退
│       │   └── .nojekyll
│       ├── src/
│       │   ├── assets/{images,fonts,styles}
│       │   ├── components/{common,business}
│       │   ├── config/  hooks/  layouts/  router/  service/  store/  types/  utils/
│       │   ├── pages/
│       │   │   ├── home/                                   # 首页
│       │   │   ├── recruit/                                # 招聘（对 B011_求职招聘）
│       │   │   ├── article/                                # 资讯（对 B004_资讯管理/文章中心）
│       │   │   ├── data-center/                            # 数据（对 B006_数据管理）
│       │   │   ├── industry-navigation/                    # 服务/导航
│       │   │   ├── policies-regulations/  qualification-standards/  qualification-abnormalities/  administrative-license/
│       │   │   ├── industry-reports/  submission/  search/
│       │   │   ├── auth/{Login,Register}.tsx
│       │   │   ├── user-center/                            # 个人中心
│       │   │   ├── enterprise-center/                      # 企业中心
│       │   │   ├── intermediary-center/                    # 服务商中心
│       │   │   └── messages/
│       │   ├── App.tsx  main.tsx
│       ├── index.html
│       ├── package.json              # name: @bms/web
│       ├── tsconfig.json             # 加 @bms/shared 别名
│       ├── vite.config.ts
│       └── .skills/
│
│   └── home/                         # 项目导航引导页（纯静态，无构建）
│       ├── index.html                # 挂载在 /，指向 /web/、/admin/、/docs/
│       └── style.css
│
├── packages/
│   └── shared/                       # 【跨端共享】零依赖纯 TS 源码
│       ├── src/
│       │   ├── types/                # article.ts user.ts enterprise.ts personnel.ts project.ts dict.ts
│       │   ├── dict/                 # 唯一字典源（地区/资质/枚举/职称/荣誉…，来自 admin/src/data）
│       │   ├── article-center/       # 文章中心共享契约
│       │   │   ├── taxonomy.ts       # 栏目/分类树（资讯、政策法规、招聘、数据、服务）
│       │   │   ├── types.ts          # Article{ id,title,categoryId,channels,status,publishAt,… }
│       │   │   ├── visibility.ts     # 端可见性：channels 含 'web' 才在前台展示
│       │   │   ├── query.ts          # 列表/详情/搜索 入参出参契约
│       │   │   └── index.ts
│       │   └── index.ts
│       ├── package.json              # name: @bms/shared
│       └── tsconfig.json
│
├── data/                             # 【唯一数据产物源】
│   ├── article-center/               # 文章 JSON（一份，含 channels 字段）
│   ├── dict/                         # 字典导出的 JSON
│   └── collected/                    # 采集原始产物（abnormalities/administrative/policy/standards）
│
├── scripts/                          # 全局脚本
│   ├── sync-dict.mjs                 # shared/dict → data/dict
│   ├── sync-data.mjs                 # data/ → apps/*/public/data
│   ├── dev.mjs                       # 单端口 8090 开发网关（Vite dev server + HMR）
│   └── serve.mjs                     # 单端口静态服务（前台/后台/文档）
│
├── docs/                             # 【全局】架构说明、文章中心规范、部署说明
├── package.json                      # workspaces 根 + 编排脚本
├── .npmrc
├── .gitignore
└── README.md


```
## 部署访问：单端口 8090

对外**只提供 8090 一个端口**，前台门户、管理后台与文档都靠路径前缀区分，不再提供多端口入口。

| 路径 | 生产/预览（`npm run serve`） | 开发预览（`npm run dev`） |
| --- | --- | --- |
| `/` | `apps/home` | 同左（静态导航页，三份内容的入口） |
| `/web/` | `apps/web/dist` | `apps/web` dev server（HMR） |
| `/web/docs/` | `apps/web/dist/docs` | `apps/web/docs`（磁盘直读） |
| `/admin/` | `apps/admin/dist` | `apps/admin` dev server（HMR） |
| `/admin/docs/` | `apps/admin/dist/docs` | `apps/admin/docs`（磁盘直读） |
| `/docs/` | `docs/` | 同左（磁盘直读） |

> 开发模式下 `scripts/dev.mjs` 内部还会拉起两个 Vite dev server，其端口在启动时向系统申请空闲
> 端口，**不是对外访问入口**，无需也不应直接访问。

### 开发预览：8090（Vite dev server + HMR，改代码保存即自动刷新）

`npm run dev`（单端口 8090，唯一地址预览三端、带 HMR）

```bash
npm run dev
```

该命令由 `scripts/dev.mjs` 做统一入口：内部拉起 `apps/admin` 与 `apps/web` 两个 Vite dev server
（分别以 `--base=/admin/`、`--base=/web/` 启动，端口由脚本自动分配），再把 `/admin/*`、`/web/*`
按前缀反代到对应 dev server，并转发 HMR 的 WebSocket upgrade——因此**在 8090 上直接改页面代码，
保存后浏览器自动热更新**，无需切到其他端口，也无需手动刷新。

补充说明：

- 两份文档在 dev 态由网关直接从磁盘读（Vite 只在 `build` 时才把 `docs` 复制进产物），改文档保存后刷新即可见。
- 网关端口可改：`node scripts/dev.mjs 9000`，或 `PORT=9000 node scripts/dev.mjs`。
- 本模式服务的是**源码（含 HMR）**；要看生产产物用下面的 `npm run serve`。

### 生产/预览：8090（静态产物）

生产/预览同样只用 8090 一个端口，由 `scripts/serve.mjs` 按路径前缀分发：

| 路径 | 实际目录 | 说明 |
| --- | --- | --- |
| `/` | `apps/home` | 项目导航引导页（纯静态，零构建；三份内容的入口） |
| `/web/` | `apps/web/dist` | 前台门户（多页 MPA；未命中回落 `index.html`） |
| `/admin/` | `apps/admin/dist` | 管理后台（SPA，hash 路由；未命中回落 `index.html`） |
| `/docs/` | `docs/` | 根目录项目文档（无 `index.html` 的目录自动生成目录列表） |

`/` 是兜底挂载（前缀 `/`，在 `MOUNTS` 中放最后），其余未命中任何前缀的路径也会落到
`apps/home`，`apps/home` 内没有对应文件时返回 404。

```bash
npm run build     # 产出 apps/web/dist 与 apps/admin/dist
npm run serve     # 固定 8090；也可 node scripts/serve.mjs 9000 / PORT=9000
```

关键点：`apps/admin`、`apps/web` 构建时分别使用 `base: '/admin/'`、`base: '/web/'`，
因此两份产物分别引用 `/admin/assets/…`、`/web/assets/…`，不再互相冲突。

前台产物挂在子路径下，运行时需要用 `import.meta.env.BASE_URL` 拼资源与跳转地址：
`apps/web/src/constants.ts` 导出的 `BASE_URL` / `BASENAME` 分别用于
请求 `public` 资源（如 `${BASE_URL}data/policy.json`）与各个 `BrowserRouter` 的 `basename`。

两份门户自带的文档随各自产物一起构建，访问路径分别为 `/web/docs/`（前台）与
`/admin/docs/`（管理门户）；项目全局文档在 `/docs/`。



