xinli/z_Project change/000/001-快速启动指南.md

# 心理测评系统 - 快速启动指南

## 🎯 您现在可以在浏览器中看到量表管理效果！

## 一、数据库准备

### 1. 执行SQL脚本（按顺序）

打开MySQL客户端，连接到您的数据库，然后按顺序执行：

```sql
-- 第1步：基础表（11张）
source sql/psy_assessment_system.sql

-- 第2步：扩展表（16张）
source sql/psy_assessment_system_extension.sql

-- 第3步：补丁（暂停功能）
source sql/psy_assessment_system_patch.sql

-- 第4步：菜单配置（必须）
source sql/psy_menu_config_fixed.sql

-- 第5步：示例数据（可选，您后期自己导入）
-- source sql/psy_scale_init_data.sql
```

**或者使用命令行**：
```bash
mysql -u root -p database_name < sql/psy_assessment_system.sql
mysql -u root -p database_name < sql/psy_assessment_system_extension.sql
mysql -u root -p database_name < sql/psy_assessment_system_patch.sql
mysql -u root -p database_name < sql/psy_menu_config_fixed.sql
```

### 2. 验证数据库
```sql
-- 检查表是否创建成功
SHOW TABLES LIKE 'psy_%';

-- 应该看到27张表（基础11张+扩展16张）

-- 检查菜单是否插入
SELECT menu_name FROM sys_menu WHERE menu_name LIKE '%心理%';

-- 应该看到"心理测评管理"
```

---

## 二、启动后端服务

### 1. 检查配置
打开 `ry-news-admin/src/main/resources/application-druid.yml`，确认数据库配置：

```yaml
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
      username: root
      password: your_password
```

### 2. 编译项目
```bash
# 在项目根目录
mvn clean install -DskipTests
```

### 3. 启动后端
```bash
# 方式一：使用Maven
cd ry-news-admin
mvn spring-boot:run

# 方式二：使用运行脚本
cd ..
./ry.bat    # Windows
# ./ry.sh  # Linux/Mac

# 方式三：直接运行JAR（先打包）
mvn clean package
java -jar ry-news-admin/target/ry-news-admin.jar
```

### 4. 验证后端
看到以下日志表示启动成功：
```
Started RuoYiApplication in X.XXX seconds
```

访问：http://localhost:8080 应该能看到登录页

---

## 三、启动前端服务

### 1. 安装依赖（首次需要）
```bash
cd ruoyi-ui
npm install
```

### 2. 启动前端
```bash
npm run dev
```

### 3. 验证前端
看到以下信息表示启动成功：
```
App running at:
- Local:   http://localhost:80/
```

---

## 四、配置权限

### 1. 登录系统
- 访问：http://localhost:80
- 用户名：`admin`
- 密码：`admin123`

### 2. 分配菜单权限
1. 点击左侧菜单：**系统管理 → 角色管理**
2. 点击"管理员"角色的"编辑"按钮
3. 在权限列表中，找到"心理测评管理"
4. 勾选"心理测评管理"及其下所有子菜单
5. 点击"确定"保存

### 3. 刷新页面
按 **F5** 刷新页面，左侧菜单会出现：
```
心理测评管理
  └─ 量表管理
```

---

## 五、访问量表管理

### 1. 点击菜单
点击：**心理测评管理 → 量表管理**

### 2. 查看效果
您应该看到：
- ✅ 量表列表页面
- ✅ 顶部有"新增"按钮
- ✅ 搜索框（名称、编码、类型、状态）
- ✅ 列表为空（还没有数据）

### 3. 测试新增
1. 点击"新增"按钮
2. 填写量表信息：
   - 量表编码：TEST_001
   - 量表名称：测试量表
   - 量表类型：选择"人格量表"
   - 题目数量：10
   - 状态：选择"正常"
3. 点击"确定"
4. 看到"新增成功"提示
5. 列表中出现刚创建的量表

---

## 六、导入您的量表数据

### 方式一：使用菜单界面（手动）
进入量表管理页面，逐个新增量表

### 方式二：使用SQL导入
参考 `sql/psy_scale_init_data.sql` 的格式，编写您自己的SQL：

```sql
-- 1. 插入量表基本信息
INSERT INTO psy_scale (...) VALUES (...);

-- 2. 插入因子
INSERT INTO psy_factor (...) VALUES (...);

-- 3. 插入题目
INSERT INTO psy_scale_item (...) VALUES (...);

-- 4. 插入选项
INSERT INTO psy_scale_option (...) VALUES (...);

-- 5. 插入计分规则
INSERT INTO psy_factor_rule (...) VALUES (...);

-- 6. 插入结果解释
INSERT INTO psy_result_interpretation (...) VALUES (...);
```

### 方式三：使用导入规范
参考 `sql/psy_scale_init_data.sql` 的示例数据格式

---

## 七、常见问题

### 1. 编译错误
```bash
# 清理缓存后重新编译
mvn clean install -U
```

### 2. 数据库连接失败
- 检查 `application-druid.yml` 配置
- 确认MySQL服务已启动
- 确认数据库已创建

### 3. 前端无法访问
```bash
# 检查端口是否被占用
netstat -ano | findstr :80  # Windows
# 修改 vue.config.js 中的端口号
```

### 4. 菜单不显示
- 确认SQL已执行 psy_menu_config_fixed.sql
- 确认角色已分配权限
- 刷新页面或重新登录

### 5. 权限不足
- 检查角色管理中的权限分配
- 确认按钮权限已勾选

---

## 八、文件说明

### 核心SQL文件
- `psy_assessment_system.sql` - 基础表（必须先执行）
- `psy_assessment_system_extension.sql` - 扩展表
- `psy_assessment_system_patch.sql` - 补丁
- `psy_menu_config_fixed.sql` - 菜单（已修复，必须）
- `psy_scale_init_data.sql` - 示例数据（可选）

### 代码文件
- 后端：`ry-news-system` 和 `ry-news-admin`
- 前端：`ruoyi-ui`

### 文档文件
- 所有开发记录在 `z_Project change` 目录下

---

**现在您可以在浏览器中访问量表管理页面了！**

访问地址：http://localhost:80/psychology/scale

🎉 **第一阶段开发完成！**