# 实践1527

**Repository Path**: lang-yejia/practice-1527

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-19
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 项目介绍
elm-v2 项目是一个包含后端代码的软件工程实践项目，涵盖认证相关代码、业务接口代码及业务对象代码。需补充后端各层代码以通过测试，前端部分基于 Vue 实现，通过代理与后端交互。
环境要求

## 通用依赖
    JDK: 版本 >= 17（推荐 21，项目测试环境为 JDK 21）
    Maven: 用于后端项目构建（已集成于项目构建流程）
    Node.js: 用于前端项目运行及 Apifox CLI 安装（推荐 v14+，可从 nodejs.org 下载）

## 后端部署步骤
1. 环境检查
    确认 JDK 版本符合要求：java -version  # 输出应包含 "17.0." 或更高版本
2. 项目构建
    1.克隆或下载项目代码至本地目录
    2.进入项目根目录（包含 pom.xml 的目录）
    3.执行 Maven 构建命令：mvn package
    构建成功后，会在 target 目录下生成可执行 JAR 包 myapp-1.0.jar
3. 启动后端服务
    1.构建完成后，执行以下命令启动服务：
    Windows:
    java -jar target\myapp-1.0.jar
    2.服务启动成功后，默认监听端口为 8080
    3.或使用 IDE 直接运行（推荐开发者）
        如果使用 IDE（如 IntelliJ IDEA、Eclipse、VS Code 等），可直接通过 IDE 启动项目，无需手动输入命令：
        找到主启动类项目的主启动类通常命名为 MyApplication.java（根据提供的代码，路径为 elmv2.0/src/main/java/cn/edu/tju/MyApplication.java），类上有 @SpringBootApplication 注解（代码中未直接显示，但 Spring Boot 项目必有此注解）。
        运行主类
        在 IDE 中打开该类，右键点击代码编辑区，选择 「Run MyApplication」 或 「启动 MyApplication」（不同 IDE 选项名称略有差异）。
启      动成功后，控制台会输出日志，显示服务监听端口（默认 8080），与命令行启动效果一致。
## 前端部署步骤
1. 环境检查
    确认 Node.js 已安装：
 cmd: 
    node -v  # 输出应包含 "v14." 或更高版本
    npm -v   # 验证 npm 可用
2. 安装依赖
    1.进入前端目录 elmclient：
     cd elmv2.0/elmclient
    2.npm install
    #若网络不畅，可先安装 cnpm 再使用 cnpm 安装
    #npm install -g cnpm
    #cnpm install
3. 启动前端服务
    1.执行启动命令：
    cmd:   npm run serve
    2.服务启动成功后，默认监听端口为 8081，通过 http://localhost:8081 访问前端页面
    3.前端已配置代理，所有 /api 前缀的请求会自动转发至后端 http://localhost:8080
# 常见问题
    1.端口冲突：若 8080（后端）或 8081（前端）端口被占用，可修改配置：
        后端：启动时指定端口 java -jar target/myapp-1.0.jar --server.port=8082
        前端：修改 elmclient/vue.config.js 中 devServer.port 字段
    2.数据库连接失败：切换数据库时确保目标数据库已创建，且账号密码正确
    3.前端请求跨域：前端已配置代理，无需额外处理；若自定义部署，确保后端开启 CORS 支持
# 项目结构说明
    后端代码：包含认证模块、业务接口、数据模型等，需补充各层实现代码
    前端代码：elmclient 目录，基于 Vue 框架，实现用户界面与交互逻辑
    数据库：默认内置 H2，支持切换至 PostgreSQL/MySQL，ORM 默认使用 Spring JPA（可替换为 MyBatis）