# 完整前端项目交接说明

核对日期：2026-11-05。

## 交付的是什么

交付的是整个会员中心的独立 Nuxt 前端工程，而不是仅含登录或 SSH 页面的小样例。
“四个文件已手写重建”指第二轮的维护进度，不是压缩包中只有四个文件。

| 内容           | 数量与说明                                                                |
| -------------- | ------------------------------------------------------------------------- |
| 页面           | 52 个，路由清单见 `module-inventory.json`                                 |
| 业务组件       | 104 个                                                                    |
| 布局           | 4 套                                                                      |
| Vue 文件       | 161 个，含应用入口                                                        |
| JS/TS 应用模块 | 55 个，含接口、会话、插件、路由保护与配置                                 |
| 样式文件       | 137 个                                                                    |
| public 资源    | 285 个，含图片、字体和站点资源                                            |
| 工程文件       | npm 依赖与锁文件、Nuxt 配置、示例环境配置、检查脚本、浏览器测试和验收记录 |

完整性检查未发现丢失的本地依赖或资源：4,647 处应用模块导入、252 处 CSS 本地资源引用均可解析。
上述数目说明文件覆盖，不等于所有业务分支都已经真实后端验收。

## 与服务器当前版本的关系

经用户授权，只读检查 `/www/wwwroot/crashwork-console`，没有修改文件、重启服务或部署。
检查时 `.output` 指向 `releases/20261025-kky-traffic-display/.output`。
当前发布目录仅含 `.output` 与发布指向记录；检查了 130 个发布目录中构建目录之外、深度不超过五层的源码候选，
未找到原始 `.vue`/`.tsx`/`.jsx` 页面或 Nuxt/Vite 工程配置。没有读取根 `.env` 或导入数据库备份。

服务器与本地重建依据的校验结果：

- `server/chunks/virtual/precomputed.mjs` SHA-256 一致：`e9a8d0e2be5f7e2263961e9f128bb6e89955d42814e5a7a0c43ae85c5a6327e1`。
- 元数据列出的 735 个唯一模块资源均存在，按文件名及内容 SHA-256 聚合后的摘要一致：`08144c47f9dda33a859105d5a746898feb288dd5b0c4ffb7464cf65fd704ed29`。
- 这证明重建依据与检查时服务器的模块构建一致；不证明真实供应商接口、全部服务器文件或线上业务均已验收。

## 员工如何使用

在本工程根目录使用 Node.js 22.12+：

```sh
npm ci
cp .env.example .env
npm run dev
```

配置 `NUXT_PUBLIC_API_BASE` 为后端 origin，不附加 `/console/v1`。
留空时需要同源反向代理；`/captcha/`、`/remote-console/sessions` 及其 WebSocket 还需独立反代配置。
后端服务不会随此前端工程自动启动。不要把生产 root 密码或其他秘密填入前端公开配置。

```sh
npm run check
npm run build
npm test
```

产物在本工程 `.output/`；运行方式及 Chrome 路径配置见根 README 和 `tests/README.md`。
已有干净解压安装、构建及 21 项真实浏览器场景通过的记录，见 `validation.md` 和 `acceptance.json`。
本次服务器版本核对后再次执行源码检查、生产构建及 21 项浏览器场景，全部通过，浏览器运行错误和外网请求均为零。

## 不能混淆的边界

- 这是完整可编辑、可构建的重建工程，不是原始源码的逐字恢复。49 个页面、103 个组件和 3 个布局仍使用恢复的渲染函数，合计 155 个 Vue 文件；并非文件缺失，也不能称为全站手写模板完成。
- 原模板、完整变量名、注释和原始业务需求文档不在服务器发布包中；不承诺逆向恢复这些已丢失的信息。
- 不包含后端、数据库、远控网关服务或生产反向代理配置；验证码、OAuth、支付、财务、供应商和 VNC 仍需测试环境联调。
- 保留当前登录协议及已记录的技术债，包括依赖告警和认证页主题切换文案，见 `defect-ledger.json`。
- 不含生产环境文件、登录凭证、Git 历史、`node_modules` 和构建产物；不要把根服务器目录或历史 releases 打包发给员工。

最小交付原则：在已可构建工程上补充核对证据，不增加产品字段、依赖、配置或另一套前端实现；
路由、资源和依赖由现有清单确定，不要求员工在历史发布目录中手工挑选版本。