# innermost

**Repository Path**: king4498/innermost

## Basic Information

- **Project Name**: innermost
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-15
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Innermost 智能高校心理健康系统 - 前端项目

## 项目概述

Innermost 是一个专为高校设计的智能心理健康与干预系统前端项目。该系统为高校提供心理健康评估、咨询预约、学习资源管理和危机干预等一站式解决方案。

### 主要技术栈

- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite
- **UI 框架**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router 4
- **样式**: Tailwind CSS
- **图标**: Element Plus Icons
- **代码规范**: ESLint + Prettier

### 项目架构

项目采用基于角色的模块化架构，主要分为三大用户角色：

1. **学生模块** (`/src/views/student/`)
    - 心理评估 (AssessmentView)
    - 学习资源 (LearningView)
    - 个人资料 (ProfileView)
    - 咨询预约 (AppointmentView)

2. **教师模块** (`/src/views/teacher/`)
    - 评估管理 (AssessmentManagementView)
    - 咨询管理 (ConsultationManagementView)
    - 危机干预 (CrisisInterventionView)
    - 学生管理 (StudentManagementView)

3. **管理员模块** (`/src/views/admin/`)
    - 内容管理 (ContentManageView)
    - 用户管理 (UserManageView)
    - 数据统计 (DataStatisticsView)
    - 系统设置 (SystemSettingsView)

## 构建和运行

### 环境要求

- Node.js ^20.19.0 || >=22.12.0
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 开发环境运行

```bash
npm run dev
```

### 生产环境构建

```bash
npm run build
```

### 类型检查

```bash
npm run type-check
```

### 代码检查和格式化

```bash
# 运行 ESLint 检查并自动修复
npm run lint

# 使用 Prettier 格式化代码
npm run format
```

### 预览构建结果

```bash
npm run preview
```

## 开发规范

### TypeScript 规范

- 项目使用 TypeScript 作为开发语言，所有 `.vue` 文件和 `.ts` 文件都应包含类型定义
- 使用 `defineComponent` 定义组件，并在 `setup()` 函数中使用 TypeScript 接口
- 为所有 props、data 和方法提供明确的类型注解

### 组件开发规范

- 组件文件命名采用 PascalCase，如 `ContentManageView.vue`
- 使用 Vue 3 Composition API 和 `<script setup>` 语法
- 组件应使用 TypeScript 接口定义数据结构和类型
- 使用 Element Plus 组件库和 Tailwind CSS 进行样式设计

### 样式规范

- 优先使用 Tailwind CSS 类进行样式设计
- 特殊情况下使用 scoped CSS
- 保持与 Element Plus 设计系统的一致性

### 路由规范

- 路由配置位于 `src/router/index.ts`
- 采用嵌套路由结构，基础布局为 `BasicLayout`
- 路由命名简洁明了，如 `/sassessment` 表示学生评估页面

### 文件结构规范

```
src/
├── assets/          # 静态资源
├── components/      # 通用组件
├── router/          # 路由配置
├── stores/          # Pinia 状态管理
├── type/            # TypeScript 类型定义
├── ui/              # UI 设计参考文件
└── views/           # 页面组件
    ├── admin/       # 管理员页面
    ├── student/     # 学生页面
    ├── teacher/     # 教师页面
    └── LoginView.vue # 登录页面
```

## 项目特色功能

1. **角色权限管理**: 系统根据不同用户角色（学生、教师、管理员）提供不同的功能模块和权限控制。

2. **心理评估系统**: 提供多种心理健康评估量表，支持在线测试和结果分析。

3. **咨询预约系统**: 学生可以在线预约心理咨询，教师可以管理咨询安排。

4. **数据统计分析**: 管理员可以查看系统使用情况、用户行为和心理健康数据分析。

5. **内容管理系统**: 管理员可以管理心理健康知识、文章、视频和音频等教育资源。

## 开发工具推荐

- **IDE**: VSCode + Volar 插件（禁用 Vetur）
- **版本控制**: Git
- **包管理**: npm

## 注意事项

- 项目使用 Vue 3 的 `<script setup>` 语法，确保开发环境支持最新 Vue 3 特性
- TypeScript 配置已优化处理 `.vue` 文件的类型导入
- 开发时请遵循 ESLint 和 Prettier 的代码规范
- 使用 Element Plus 组件时，请参考官方文档确保正确使用

## 项目维护

- 定期更新依赖包：`npm update`
- 定期运行类型检查：`npm run type-check`
- 提交代码前运行代码检查：`npm run lint`