# 项目规范

## 项目说明
教务系统前端项目，支持多产业演示数据（文旅、智能制造、能源等）。

## 🎯 数据更新核心原则

### 三大黄金法则
1. **绝对不修改样式** - 不动CSS、不动组件样式
2. **先分析后修改** - 理解数据流向（组件 → service → 配置文件）
3. **只改数据源** - 仅在data/mocks文件夹修改，保持结构和字段名不变

### 数据更新流程
1. **搜索所有引用位置** - 用Grep搜索变量名和相关字段
2. **理解数据结构** - 检查字段名差异（如`name` vs `studentName`）
3. **一次性更新所有位置** - 保持数据一致性
4. **验证完整性** - 检查所有页面和弹窗

## 📍 关键文件位置

### 数据配置文件
- `src/data/mockData.js` - 主数据源（排名、个人信息等）
- `src/data/companyJobsNew.json` - 岗位基础信息
- `src/data/joblevel.json` - 岗位头像和等级
- `src/mocks/resumeInterviewMock.js` - 简历模板数据

### 常见数据位置
- **班级排名**: `mockData.js`的`classRanking`、`ranking.topStudents`、`profileOverview.ranking.rankings`
- **个人信息**: `mockData.js`的`user`、`profile`、`profileOverview`

## ⚠️ 注意事项

1. **字段兼容性** - 同时提供`name`和`studentName`字段
2. **头像资源** - 使用完整CDN地址，列表在`网页未导入数据/头像列表.json`
3. **产业数据** - 存储在`网页未导入数据/[产业名]/`目录
4. **开发端口** - 5151（配置在`vite.config.js`）

## ✅ 提交前检查
- [ ] 无"未知"、"小明"等占位符
- [ ] 数据结构和字段名未改变
- [ ] 所有页面和弹窗数据正确
- [ ] 无CSS/组件文件修改
- [ ] JSON语法正确，控制台无错误