## 1. 工作区基线与依赖

- [x] 1.1 记录 Git 差异和未跟踪 `assets/` 基线，确保迁移不覆盖现有用户改动。
- [x] 1.2 在 `package.json` 增加 Vite 7.x、`dev`、`build`、`preview` 命令和 Node 版本要求，并更新锁文件。
- [x] 1.3 在 `.gitignore` 忽略 `dist/`，执行 `npm ci` 验证锁文件可重复安装。

## 2. Vite 入口与静态资源

- [x] 2.1 新增 `vite.config.js`，配置 `/assets/` 前缀、开发 `5173`、预览 `4173`、严格端口和 `/api` 到本机 `8888` 的代理。
- [x] 2.2 将页面壳迁入根 `index.html`，只加载 Vite 入口，并保留 `assets/index.html` 不修改。
- [x] 2.3 将页面实际使用的 Logo 和五个导航图标复制到 `public/img/`，保持文件名并验证资源路径。

## 3. 兼容启动与 API 迁移

- [x] 3.1 新增 `src/main.js`，导入框架并写入所需 `window` 全局对象，按既定顺序加载旧模块、检查全局能力并显式启动页面。
- [x] 3.2 为本次新增或修改的每个方法、对象方法、箭头函数和业务回调添加新手注释，写明代码作用、关联文件和调用链或数据流。
- [x] 3.3 改造 `src/router/index.js` 与 `app-v2.js`，移除 `DOMContentLoaded` 自动启动依赖并加入一次性初始化保护。
- [x] 3.4 仅将企微和手机号卡 API 客户端根地址改为相对 `/api/...`，保留其余请求与响应逻辑。

## 4. 文档与自动验证

- [x] 4.1 新增 README 本地启动说明，明确 `5173`、`4173`、`8888`、`/api` 代理及旧 Python 前端入口弃用状态。
- [x] 4.2 执行 `npm run build`，确认 `dist/` 成功生成。
- [x] 4.3 执行 `npm run preview`，检查 `4173/assets/` 的路由、样式、图片和框架资源无 404。

## 5. 本地联调与清理

- [x] 5.1 启动本地后端和 Vite 开发服务，验证五个 Hash 路由可切换并在刷新后保持。
- [x] 5.2 检查 Console 与 Network，确认无缺失全局对象、重复挂载、旧静态资源或 `node_modules/` 请求，且 API 使用 `/api/...`。
- [ ] 5.3 创建、编辑并按返回 ID 删除一条 `VITE-SMOKE-` 手机号卡；若清理失败，记录 ID、原因和人工清理步骤。
