71 lines
4.5 KiB
Markdown
71 lines
4.5 KiB
Markdown
# 完整前端项目交接说明
|
||
|
||
核对日期：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 打包发给员工。
|
||
|
||
最小交付原则：在已可构建工程上补充核对证据，不增加产品字段、依赖、配置或另一套前端实现；
|
||
路由、资源和依赖由现有清单确定，不要求员工在历史发布目录中手工挑选版本。
|