4.5 KiB
完整前端项目交接说明
核对日期：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.mjsSHA-256 一致：e9a8d0e2be5f7e2263961e9f128bb6e89955d42814e5a7a0c43ae85c5a6327e1。- 元数据列出的 735 个唯一模块资源均存在，按文件名及内容 SHA-256 聚合后的摘要一致：
08144c47f9dda33a859105d5a746898feb288dd5b0c4ffb7464cf65fd704ed29。 - 这证明重建依据与检查时服务器的模块构建一致；不证明真实供应商接口、全部服务器文件或线上业务均已验收。
员工如何使用
在本工程根目录使用 Node.js 22.12+：
npm ci
cp .env.example .env
npm run dev
配置 NUXT_PUBLIC_API_BASE 为后端 origin，不附加 /console/v1。
留空时需要同源反向代理；/captcha/、/remote-console/sessions 及其 WebSocket 还需独立反代配置。
后端服务不会随此前端工程自动启动。不要把生产 root 密码或其他秘密填入前端公开配置。
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 打包发给员工。
最小交付原则：在已可构建工程上补充核对证据，不增加产品字段、依赖、配置或另一套前端实现； 路由、资源和依赖由现有清单确定，不要求员工在历史发布目录中手工挑选版本。