# Demo 项目启动说明

## ✅ 配置完成

Demo 项目已配置为使用打包好的框架 JS 文件。

## 🚀 启动步骤

### 1. 确保框架文件已复制

检查文件是否存在：
```
demo-project/src/libs/admin-framework.js
```

如果不存在，在项目根目录执行：
```powershell
Copy-Item "dist\admin-framework.js" "demo-project\src\libs\admin-framework.js" -Force
```

### 2. 启动开发服务器

**方法一：使用命令行**
```bash
cd demo-project
npm run dev
```

**方法二：使用 start.bat（Windows）**
```bash
cd demo-project
start.bat
```

**方法三：使用 start.sh（Linux/Mac）**
```bash
cd demo-project
./start.sh
```

### 3. 访问应用

打开浏览器访问：
- **开发环境**：http://localhost:8080
- **测试账号**：admin / admin123

## 📝 注意事项

1. **端口占用**
   - 如果 8080 端口被占用，webpack 会自动使用其他端口
   - 查看终端输出的实际端口号

2. **首次启动**
   - 首次启动可能需要较长时间编译
   - 等待 "Compiled successfully" 消息

3. **热更新**
   - 修改代码后会自动刷新浏览器
   - 如果没有自动刷新，手动刷新页面

## 🔍 故障排查

### 问题：找不到 admin-framework.js

**错误信息**：
```
Module not found: Error: Can't resolve './libs/admin-framework.js'
```

**解决方案**：
```powershell
# 在项目根目录执行
Copy-Item "dist\admin-framework.js" "demo-project\src\libs\admin-framework.js" -Force
```

### 问题：端口被占用

**错误信息**：
```
Error: listen EADDRINUSE: address already in use :::8080
```

**解决方案**：
1. 关闭占用 8080 端口的程序
2. 或修改 `webpack.config.js` 中的端口配置

### 问题：编译错误

**解决方案**：
1. 检查 `src/main.js` 的引用路径是否正确
2. 确保 `admin-framework.js` 文件完整
3. 删除 `node_modules` 重新安装：
   ```bash
   rm -rf node_modules
   npm install
   ```

## 📚 相关文档

- `使用打包框架说明.md` - 详细使用说明
- `框架更新完成.md` - 更新记录
- `README.md` - 项目说明

## 🎯 下一步

启动成功后：
1. 使用测试账号登录
2. 测试菜单导航功能
3. 测试系统管理功能
4. 查看浏览器控制台，确保没有错误

---

**当前状态**：✅ 就绪

**框架版本**：1.0.0

**启动命令**：`npm run dev`