chore: 重命名项目目录

前后端目录重命名:
- reading-platform-java/ → lesingle-edu-reading-platform-backend/
- reading-platform-frontend/ → lesingle-edu-reading-platform-frontend/

更新相关文件:
- 所有 shell 脚本中的目录引用
- pom.xml 和 application.yml 中的项目名称
- package.json 中的项目名称
- .claude/CLAUDE.md 中的路径引用
- README 文档中的路径引用
This commit is contained in:
En 2026-03-26 11:31:47 +08:00
parent af5b050651
commit 40589f59e7
1307 changed files with 62 additions and 7847 deletions

View File

@ -31,11 +31,11 @@ export VITE_APP_PORT=5174
# 方式二:分别启动 # 方式二:分别启动
# 后端(端口 8481 # 后端(端口 8481
export SERVER_PORT=8481 export SERVER_PORT=8481
cd reading-platform-java && mvn spring-boot:run cd lesingle-edu-reading-platform-backend && mvn spring-boot:run
# 前端(端口 5174新终端 # 前端(端口 5174新终端
export PORT=5174 export PORT=5174
cd reading-platform-frontend && npm run dev cd lesingle-edu-reading-platform-frontend && npm run dev
``` ```
### 启动服务 ### 启动服务
@ -51,7 +51,7 @@ cd reading-platform-frontend && npm run dev
./stop-all.sh ./stop-all.sh
``` ```
### 前端命令 (reading-platform-frontend/) ### 前端命令 (lesingle-edu-reading-platform-frontend/)
```bash ```bash
npm run dev # 开发服务器 npm run dev # 开发服务器
@ -61,7 +61,7 @@ npm run test:e2e # 端到端测试 (Playwright)
npm run api:update # 从 OpenAPI 生成 TypeScript 类型 npm run api:update # 从 OpenAPI 生成 TypeScript 类型
``` ```
### 后端命令 (reading-platform-java/) ### 后端命令 (lesingle-edu-reading-platform-backend/)
```bash ```bash
# 运行后端(使用 JDK 17 # 运行后端(使用 JDK 17
@ -107,7 +107,7 @@ javac -version
### 配置文件目录结构 ### 配置文件目录结构
``` ```
reading-platform-java/src/main/resources/ lesingle-edu-reading-platform-backend/src/main/resources/
├── application.yml # 主配置文件(共用配置) ├── application.yml # 主配置文件(共用配置)
├── application-dev.yml # 开发环境配置 ├── application-dev.yml # 开发环境配置
├── application-test.yml # 测试环境配置 ├── application-test.yml # 测试环境配置
@ -136,17 +136,17 @@ reading-platform-java/src/main/resources/
```bash ```bash
# Linux/Mac # Linux/Mac
export SPRING_PROFILES_ACTIVE=prod export SPRING_PROFILES_ACTIVE=prod
java -jar reading-platform.jar java -jar lesingle-edu-reading-platform-backend.jar
# Windows (Git Bash) # Windows (Git Bash)
export SPRING_PROFILES_ACTIVE=prod export SPRING_PROFILES_ACTIVE=prod
java -jar reading-platform.jar java -jar lesingle-edu-reading-platform-backend.jar
``` ```
#### 方式二:命令行参数 #### 方式二:命令行参数
```bash ```bash
java -jar reading-platform.jar --spring.profiles.active=prod java -jar lesingle-edu-reading-platform-backend.jar --spring.profiles.active=prod
``` ```
#### 方式三Maven 启动 #### 方式三Maven 启动
@ -219,7 +219,7 @@ mvn spring-boot:run -Dspring-boot.run.profiles=prod
## 核心原则 ## 核心原则
1. **后端只写 Java** - ⚠️ **所有后端开发必须基于 `reading-platform-java/` (Spring Boot),严禁使用 Node.js/NestJS** 1. **后端只写 Java** - ⚠️ **所有后端开发必须基于 `lesingle-edu-reading-platform-backend/` (Spring Boot),严禁使用 Node.js/NestJS**
2. **OpenAPI 规范驱动** - 前后端通过接口规范对齐,零沟通成本 2. **OpenAPI 规范驱动** - 前后端通过接口规范对齐,零沟通成本
3. **类型安全优先** - TypeScript 强制类型校验,早发现早修复 3. **类型安全优先** - TypeScript 强制类型校验,早发现早修复
4. **约定大于配置** - 统一代码风格和目录结构,降低认知负担 4. **约定大于配置** - 统一代码风格和目录结构,降低认知负担
@ -242,9 +242,9 @@ kindergarten_java/
│ │ ├── teacher/ # 教师端测试 │ │ ├── teacher/ # 教师端测试
│ │ └── parent/ # 家长端测试 │ │ └── parent/ # 家长端测试
│ └── design/ # 设计文档 │ └── design/ # 设计文档
├── reading-platform-frontend/ # 前端项目 (Vue 3) ├── lesingle-edu-reading-platform-frontend/ # 前端项目 (Vue 3)
├── reading-platform-java/ # 后端项目 (Spring Boot) ← 唯一后端 ├── lesingle-edu-reading-platform-backend/ # 后端项目 (Spring Boot) ← 唯一后端
├── reading-platform-backend/ # ⚠️ 已弃用 (NestJS不再维护) ├── reading-platform-backend/ # ⚠️ 已弃用 (NestJS不再维护)
├── start-all.sh # 统一启动 ├── start-all.sh # 统一启动
└── stop-all.sh # 统一停止 └── stop-all.sh # 统一停止
``` ```
@ -252,7 +252,7 @@ kindergarten_java/
### 后端目录结构Spring Boot ### 后端目录结构Spring Boot
``` ```
reading-platform-java/ lesingle-edu-reading-platform-backend/
├── src/main/java/com/reading/platform/ ├── src/main/java/com/reading/platform/
│ ├── ReadingPlatformApplication.java # 启动类 │ ├── ReadingPlatformApplication.java # 启动类
│ ├── common/ # 公共模块 │ ├── common/ # 公共模块
@ -302,7 +302,7 @@ reading-platform-java/
### 前端目录结构Vue 3 ### 前端目录结构Vue 3
``` ```
reading-platform-frontend/ lesingle-edu-reading-platform-frontend/
├── src/ ├── src/
│ ├── main.ts # 入口文件 │ ├── main.ts # 入口文件
│ ├── App.vue # 根组件 │ ├── App.vue # 根组件
@ -683,7 +683,7 @@ taskkill //F //PID <PID>
## 变更边界(必须遵守) ## 变更边界(必须遵守)
> ⚠️ **最高优先级**: 所有后端开发必须基于 `reading-platform-java/` (Spring Boot + Java 17) > ⚠️ **最高优先级**: 所有后端开发必须基于 `lesingle-edu-reading-platform-backend/` (Spring Boot + Java 17)
- **不做无关重构** - 只改与需求相关的文件 - **不做无关重构** - 只改与需求相关的文件
- **不引入新依赖** - 除非需求明确且必要 - **不引入新依赖** - 除非需求明确且必要
@ -765,18 +765,18 @@ taskkill //F //PID <PID>
|------|---------|------| |------|---------|------|
| 测试框架 | **Playwright Test** | 端到端浏览器自动化测试 | | 测试框架 | **Playwright Test** | 端到端浏览器自动化测试 |
| 浏览器 | **Chromium** | 可自动打开浏览器模拟用户操作 | | 浏览器 | **Chromium** | 可自动打开浏览器模拟用户操作 |
| 配置文件 | `reading-platform-frontend/playwright.config.ts` | Playwright 配置 | | 配置文件 | `lesingle-edu-reading-platform-frontend/playwright.config.ts` | Playwright 配置 |
| 测试文件 | `reading-platform-frontend/tests/` | E2E 测试脚本 | | 测试文件 | `lesingle-edu-reading-platform-frontend/tests/` | E2E 测试脚本 |
### 快速开始 ### 快速开始
```bash ```bash
# 1. 启动后端服务 # 1. 启动后端服务
cd reading-platform-java cd lesingle-edu-reading-platform-backend
mvn spring-boot:run mvn spring-boot:run
# 2. 启动前端服务(新终端窗口) # 2. 启动前端服务(新终端窗口)
cd reading-platform-frontend cd lesingle-edu-reading-platform-frontend
npm run dev npm run dev
# 3. 运行 E2E 测试(无头模式 - 不显示浏览器) # 3. 运行 E2E 测试(无头模式 - 不显示浏览器)
@ -823,9 +823,9 @@ npm run test:e2e:ui
| 文件/目录 | 路径 | | 文件/目录 | 路径 |
|----------|------| |----------|------|
| 前端 E2E 测试 | `reading-platform-frontend/tests/` | | 前端 E2E 测试 | `lesingle-edu-reading-platform-frontend/tests/` |
| Playwright 配置 | `reading-platform-frontend/playwright.config.ts` | | Playwright 配置 | `lesingle-edu-reading-platform-frontend/playwright.config.ts` |
| 后端测试(待创建) | `reading-platform-java/src/test/` | | 后端测试(待创建) | `lesingle-edu-reading-platform-backend/src/test/` |
| 启动脚本 | `start-all.sh` | | 启动脚本 | `start-all.sh` |
*本规范最后更新于 2026-03-18* *本规范最后更新于 2026-03-18*

View File

@ -54,7 +54,7 @@ export REMOTE_USER=root
```bash ```bash
# 本地构建 # 本地构建
cd /f/LesingleProject/lesingle-kindergarten-course/kindergarten_java/reading-platform-java cd /f/LesingleProject/lesingle-kindergarten-course/kindergarten_java/lesingle-edu-reading-platform-backend
mvn clean package -DskipTests mvn clean package -DskipTests
# 上传到服务器 # 上传到服务器
@ -122,7 +122,7 @@ tail -f logs/app.log
### 4.1 本地构建 ### 4.1 本地构建
```bash ```bash
cd /f/LesingleProject/lesingle-kindergarten-course/kindergarten_java/reading-platform-frontend cd /f/LesingleProject/lesingle-kindergarten-course/kindergarten_java/lesingle-edu-reading-platform-frontend
npm run build npm run build
``` ```
@ -225,7 +225,7 @@ ps aux | grep reading-platform
```bash ```bash
# 本地重新构建并上传 # 本地重新构建并上传
cd reading-platform-frontend cd lesingle-edu-reading-platform-frontend
npm run build npm run build
scp -r dist/* root@你的 IP:/www/wwwroot/你的域名/ scp -r dist/* root@你的 IP:/www/wwwroot/你的域名/
``` ```

View File

@ -25,10 +25,10 @@
```bash ```bash
# 启动后端 # 启动后端
./reading-platform-backend/start-backend.sh ./lesingle-edu-reading-platform-backend/start-backend.sh
# 启动前端 # 启动前端
./reading-platform-frontend/start-frontend.sh ./lesingle-edu-reading-platform-frontend/start-frontend.sh
``` ```
## 🛑 停止服务 ## 🛑 停止服务
@ -63,13 +63,13 @@ lsof -ti:5173 | xargs kill -9
```bash ```bash
# 实时查看后端日志 # 实时查看后端日志
tail -f /tmp/reading-platform-backend.log tail -f /tmp/lesingle-edu-reading-platform-backend.log
# 实时查看前端日志 # 实时查看前端日志
tail -f /tmp/reading-platform-frontend.log tail -f /tmp/lesingle-edu-reading-platform-frontend.log
# 查看所有日志 # 查看所有日志
tail -f /tmp/reading-platform-*.log tail -f /tmp/lesingle-edu-reading-platform-*.log
``` ```
## 🔍 检查服务状态 ## 🔍 检查服务状态
@ -91,11 +91,11 @@ curl http://localhost:3000/api/v1/courses
/Users/retirado/ccProgram/ /Users/retirado/ccProgram/
├── start-all.sh # 统一启动脚本 ⭐ ├── start-all.sh # 统一启动脚本 ⭐
├── stop-all.sh # 统一停止脚本 ⭐ ├── stop-all.sh # 统一停止脚本 ⭐
├── reading-platform-backend/ # 后端目录 ├── lesingle-edu-reading-platform-backend/ # 后端目录
│ ├── start-backend.sh # 后端启动脚本 │ ├── start-backend.sh # 后端启动脚本
│ ├── package.json │ ├── package.json
│ └── src/ │ └── src/
└── reading-platform-frontend/ # 前端目录 └── lesingle-edu-reading-platform-frontend/ # 前端目录
├── start-frontend.sh # 前端启动脚本 ├── start-frontend.sh # 前端启动脚本
├── package.json ├── package.json
└── src/ └── src/
@ -112,8 +112,8 @@ A: 先运行 `./stop-all.sh` 停止服务,再运行 `./start-all.sh` 启动。
### Q: 服务启动失败怎么办? ### Q: 服务启动失败怎么办?
A: 查看日志文件排查问题: A: 查看日志文件排查问题:
```bash ```bash
tail -f /tmp/reading-platform-backend.log tail -f /tmp/lesingle-edu-reading-platform-backend.log
tail -f /tmp/reading-platform-frontend.log tail -f /tmp/lesingle-edu-reading-platform-frontend.log
``` ```
### Q: 如何在开发模式下启动? ### Q: 如何在开发模式下启动?

View File

@ -15,7 +15,7 @@ set -e
# 配置 # 配置
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
BACKEND_DIR="$SCRIPT_DIR/reading-platform-java" BACKEND_DIR="$SCRIPT_DIR/lesingle-edu-reading-platform-backend"
REMOTE_BASE_DIR="/www/wwwroot/reading-platform" REMOTE_BASE_DIR="/www/wwwroot/reading-platform"
# SSH 配置 # SSH 配置

View File

@ -15,7 +15,7 @@ set -e
# 配置 # 配置
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
FRONTEND_DIR="$SCRIPT_DIR/reading-platform-frontend" FRONTEND_DIR="$SCRIPT_DIR/lesingle-edu-reading-platform-frontend"
REMOTE_DIR="/www/wwwroot/reading.ycapp.cn" REMOTE_DIR="/www/wwwroot/reading.ycapp.cn"
# SSH 配置(可通过环境变量覆盖) # SSH 配置(可通过环境变量覆盖)

View File

@ -77,14 +77,14 @@ check_config() {
fi fi
# 检查本地是否有 JAR 包 # 检查本地是否有 JAR 包
JAR_FILE="reading-platform-java/target/reading-platform-1.0.0.jar" JAR_FILE="lesingle-edu-reading-platform-backend/target/reading-platform-1.0.0.jar"
if [ ! -f "$JAR_FILE" ]; then if [ ! -f "$JAR_FILE" ]; then
log_warn "未找到 JAR 包,将先执行构建..." log_warn "未找到 JAR 包,将先执行构建..."
BUILD_NEEDED=true BUILD_NEEDED=true
fi fi
# 检查前端是否有 dist # 检查前端是否有 dist
if [ ! -d "reading-platform-frontend/dist" ]; then if [ ! -d "lesingle-edu-reading-platform-frontend/dist" ]; then
log_warn "未找到前端构建文件,将先执行构建..." log_warn "未找到前端构建文件,将先执行构建..."
BUILD_FRONTEND_NEEDED=true BUILD_FRONTEND_NEEDED=true
fi fi
@ -97,7 +97,7 @@ build_backend() {
fi fi
log_step "构建后端服务..." log_step "构建后端服务..."
cd "reading-platform-java" cd "lesingle-edu-reading-platform-backend"
# 检查 JDK 版本 # 检查 JDK 版本
if command -v java &> /dev/null; then if command -v java &> /dev/null; then
@ -151,7 +151,7 @@ build_frontend() {
cd .. cd ..
if [ -d "reading-platform-frontend/dist" ]; then if [ -d "lesingle-edu-reading-platform-frontend/dist" ]; then
log_info "前端构建成功" log_info "前端构建成功"
else else
log_error "前端构建失败" log_error "前端构建失败"
@ -190,7 +190,7 @@ ENDSSH
# 上传 JAR 包 # 上传 JAR 包
log_info "上传后端 JAR 包..." log_info "上传后端 JAR 包..."
scp -o StrictHostKeyChecking=no -P "$REMOTE_PORT" \ scp -o StrictHostKeyChecking=no -P "$REMOTE_PORT" \
"reading-platform-java/target/reading-platform-1.0.0.jar" \ "lesingle-edu-reading-platform-backend/target/reading-platform-1.0.0.jar" \
"$REMOTE_USER@$REMOTE_HOST:/www/wwwroot/reading-platform/app.jar" "$REMOTE_USER@$REMOTE_HOST:/www/wwwroot/reading-platform/app.jar"
# 上传启动脚本 # 上传启动脚本
@ -299,7 +299,7 @@ upload_frontend() {
# 上传 dist 目录 # 上传 dist 目录
log_info "上传前端构建文件..." log_info "上传前端构建文件..."
scp -o StrictHostKeyChecking=no -r -P "$REMOTE_PORT" \ scp -o StrictHostKeyChecking=no -r -P "$REMOTE_PORT" \
"reading-platform-frontend/dist/" \ "lesingle-edu-reading-platform-frontend/dist/" \
"$REMOTE_USER@$REMOTE_HOST:$REMOTE_FRONTEND_DIR/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_FRONTEND_DIR/"
log_info "前端文件上传完成" log_info "前端文件上传完成"

View File

@ -15,7 +15,7 @@ Spring Boot + MyBatis-Plus backend for the Reading Platform.
## Project Structure ## Project Structure
``` ```
reading-platform-java/ lesingle-edu-reading-platform-backend/
├── pom.xml # Maven dependencies ├── pom.xml # Maven dependencies
├── src/main/java/com/reading/platform/ ├── src/main/java/com/reading/platform/
│ ├── ReadingPlatformApplication.java │ ├── ReadingPlatformApplication.java

View File

@ -6,7 +6,7 @@ echo "==========================================="
echo "开始执行数据库迁移..." echo "开始执行数据库迁移..."
echo "===========================================" echo "==========================================="
cd /Users/retirado/Program/ccProgram_0312/reading-platform-java cd /Users/retirado/Program/ccProgram_0312/lesingle-edu-reading-platform-backend
# 创建临时迁移 Java 文件 # 创建临时迁移 Java 文件
cat > /tmp/DbMigrate.java << 'EOF' cat > /tmp/DbMigrate.java << 'EOF'

View File

@ -12,10 +12,10 @@
</parent> </parent>
<groupId>com.reading</groupId> <groupId>com.reading</groupId>
<artifactId>reading-platform</artifactId> <artifactId>lesingle-edu-reading-platform-backend</artifactId>
<version>1.0.0</version> <version>1.0.0</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<name>reading-platform</name> <name>lesingle-edu-reading-platform-backend</name>
<description>Reading Platform Backend Service</description> <description>Reading Platform Backend Service</description>
<properties> <properties>

Some files were not shown because too many files have changed in this diff Show More