From 208e0890937cb9b56e2be86ba68ff1d5422ad85c Mon Sep 17 00:00:00 2001 From: 1234 <17752162309@163.com> Date: Tue, 23 Dec 2025 19:17:44 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=BD=9C=E4=B8=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitea/workflows/autograde.yml | 390 ++++++++++++++++++ .gitignore | 24 ++ DATABASE_CONNECTION.md | 89 ++++ FRONTEND.md | 55 +++ FRONTEND_GUIDE.md | 79 ++++ README.md | 252 +++++++++++ REPORT.md | 44 ++ REPORT_GUIDE.md | 64 +++ bin/main/application-prod.properties | 24 ++ bin/main/application-test.properties | 13 + bin/main/application.properties | 31 ++ .../com/vibevault/VibeVaultApplication.class | Bin 0 -> 712 bytes .../com/vibevault/config/SecurityConfig.class | Bin 0 -> 9297 bytes .../vibevault/controller/AuthController.class | Bin 0 -> 1929 bytes .../vibevault/controller/LoginRequest.class | Bin 0 -> 1426 bytes .../vibevault/controller/LoginResponse.class | Bin 0 -> 1424 bytes .../controller/PlaylistController.class | Bin 0 -> 4246 bytes .../controller/RegisterRequest.class | Bin 0 -> 1438 bytes .../controller/RegisterResponse.class | Bin 0 -> 1440 bytes .../com/vibevault/dto/PlaylistCreateDTO.class | Bin 0 -> 1843 bytes bin/main/com/vibevault/dto/PlaylistDTO.class | Bin 0 -> 1953 bytes .../com/vibevault/dto/SongCreateDTO.class | Bin 0 -> 2165 bytes bin/main/com/vibevault/dto/SongDTO.class | Bin 0 -> 1649 bytes .../exception/GlobalExceptionHandler.class | Bin 0 -> 4613 bytes .../exception/ResourceNotFoundException.class | Bin 0 -> 922 bytes .../exception/UnauthorizedException.class | Bin 0 -> 576 bytes bin/main/com/vibevault/model/Playlist.class | Bin 0 -> 2854 bytes bin/main/com/vibevault/model/Song.class | Bin 0 -> 2332 bytes bin/main/com/vibevault/model/User.class | Bin 0 -> 1921 bytes .../repository/PlaylistRepository.class | Bin 0 -> 433 bytes .../vibevault/repository/UserRepository.class | Bin 0 -> 421 bytes .../security/JwtAuthenticationFilter.class | Bin 0 -> 1432 bytes .../com/vibevault/security/JwtService.class | Bin 0 -> 3411 bytes .../vibevault/service/PlaylistService.class | Bin 0 -> 970 bytes .../service/PlaylistServiceImpl.class | Bin 0 -> 7388 bytes .../vibevault/DatabaseConnectionTest.class | Bin 0 -> 3575 bytes .../vibevault/PublicPlaylistServiceTest.class | Bin 0 -> 4436 bytes bin/test/com/vibevault/PublicSmokeTest.class | Bin 0 -> 4309 bytes build.gradle.kts | 55 +++ gradle.properties | 5 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43764 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 251 +++++++++++ gradlew.bat | 94 +++++ images/.gitkeep | 0 settings.gradle.kts | 2 + .../com/vibevault/VibeVaultApplication.java | 13 + .../com/vibevault/config/SecurityConfig.java | 100 +++++ .../vibevault/controller/AuthController.java | 96 +++++ .../controller/PlaylistController.java | 107 +++++ .../com/vibevault/dto/PlaylistCreateDTO.java | 11 + .../java/com/vibevault/dto/PlaylistDTO.java | 11 + .../java/com/vibevault/dto/SongCreateDTO.java | 16 + src/main/java/com/vibevault/dto/SongDTO.java | 40 ++ .../exception/GlobalExceptionHandler.java | 65 +++ .../exception/ResourceNotFoundException.java | 16 + .../exception/UnauthorizedException.java | 12 + .../java/com/vibevault/model/Playlist.java | 91 ++++ src/main/java/com/vibevault/model/Song.java | 91 ++++ src/main/java/com/vibevault/model/User.java | 82 ++++ .../repository/PlaylistRepository.java | 26 ++ .../vibevault/repository/UserRepository.java | 23 ++ .../security/JwtAuthenticationFilter.java | 94 +++++ .../com/vibevault/security/JwtService.java | 129 ++++++ .../vibevault/service/PlaylistService.java | 66 +++ .../service/PlaylistServiceImpl.java | 221 ++++++++++ .../resources/application-prod.properties | 24 ++ .../resources/application-test.properties | 13 + src/main/resources/application.properties | 31 ++ .../com/vibevault/DatabaseConnectionTest.java | 59 +++ .../vibevault/PublicPlaylistServiceTest.java | 121 ++++++ .../java/com/vibevault/PublicSmokeTest.java | 106 +++++ 72 files changed, 3143 insertions(+) create mode 100644 .gitea/workflows/autograde.yml create mode 100644 .gitignore create mode 100644 DATABASE_CONNECTION.md create mode 100644 FRONTEND.md create mode 100644 FRONTEND_GUIDE.md create mode 100644 README.md create mode 100644 REPORT.md create mode 100644 REPORT_GUIDE.md create mode 100644 bin/main/application-prod.properties create mode 100644 bin/main/application-test.properties create mode 100644 bin/main/application.properties create mode 100644 bin/main/com/vibevault/VibeVaultApplication.class create mode 100644 bin/main/com/vibevault/config/SecurityConfig.class create mode 100644 bin/main/com/vibevault/controller/AuthController.class create mode 100644 bin/main/com/vibevault/controller/LoginRequest.class create mode 100644 bin/main/com/vibevault/controller/LoginResponse.class create mode 100644 bin/main/com/vibevault/controller/PlaylistController.class create mode 100644 bin/main/com/vibevault/controller/RegisterRequest.class create mode 100644 bin/main/com/vibevault/controller/RegisterResponse.class create mode 100644 bin/main/com/vibevault/dto/PlaylistCreateDTO.class create mode 100644 bin/main/com/vibevault/dto/PlaylistDTO.class create mode 100644 bin/main/com/vibevault/dto/SongCreateDTO.class create mode 100644 bin/main/com/vibevault/dto/SongDTO.class create mode 100644 bin/main/com/vibevault/exception/GlobalExceptionHandler.class create mode 100644 bin/main/com/vibevault/exception/ResourceNotFoundException.class create mode 100644 bin/main/com/vibevault/exception/UnauthorizedException.class create mode 100644 bin/main/com/vibevault/model/Playlist.class create mode 100644 bin/main/com/vibevault/model/Song.class create mode 100644 bin/main/com/vibevault/model/User.class create mode 100644 bin/main/com/vibevault/repository/PlaylistRepository.class create mode 100644 bin/main/com/vibevault/repository/UserRepository.class create mode 100644 bin/main/com/vibevault/security/JwtAuthenticationFilter.class create mode 100644 bin/main/com/vibevault/security/JwtService.class create mode 100644 bin/main/com/vibevault/service/PlaylistService.class create mode 100644 bin/main/com/vibevault/service/PlaylistServiceImpl.class create mode 100644 bin/test/com/vibevault/DatabaseConnectionTest.class create mode 100644 bin/test/com/vibevault/PublicPlaylistServiceTest.class create mode 100644 bin/test/com/vibevault/PublicSmokeTest.class create mode 100644 build.gradle.kts create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100644 gradlew create mode 100644 gradlew.bat create mode 100644 images/.gitkeep create mode 100644 settings.gradle.kts create mode 100644 src/main/java/com/vibevault/VibeVaultApplication.java create mode 100644 src/main/java/com/vibevault/config/SecurityConfig.java create mode 100644 src/main/java/com/vibevault/controller/AuthController.java create mode 100644 src/main/java/com/vibevault/controller/PlaylistController.java create mode 100644 src/main/java/com/vibevault/dto/PlaylistCreateDTO.java create mode 100644 src/main/java/com/vibevault/dto/PlaylistDTO.java create mode 100644 src/main/java/com/vibevault/dto/SongCreateDTO.java create mode 100644 src/main/java/com/vibevault/dto/SongDTO.java create mode 100644 src/main/java/com/vibevault/exception/GlobalExceptionHandler.java create mode 100644 src/main/java/com/vibevault/exception/ResourceNotFoundException.java create mode 100644 src/main/java/com/vibevault/exception/UnauthorizedException.java create mode 100644 src/main/java/com/vibevault/model/Playlist.java create mode 100644 src/main/java/com/vibevault/model/Song.java create mode 100644 src/main/java/com/vibevault/model/User.java create mode 100644 src/main/java/com/vibevault/repository/PlaylistRepository.java create mode 100644 src/main/java/com/vibevault/repository/UserRepository.java create mode 100644 src/main/java/com/vibevault/security/JwtAuthenticationFilter.java create mode 100644 src/main/java/com/vibevault/security/JwtService.java create mode 100644 src/main/java/com/vibevault/service/PlaylistService.java create mode 100644 src/main/java/com/vibevault/service/PlaylistServiceImpl.java create mode 100644 src/main/resources/application-prod.properties create mode 100644 src/main/resources/application-test.properties create mode 100644 src/main/resources/application.properties create mode 100644 src/test/java/com/vibevault/DatabaseConnectionTest.java create mode 100644 src/test/java/com/vibevault/PublicPlaylistServiceTest.java create mode 100644 src/test/java/com/vibevault/PublicSmokeTest.java diff --git a/.gitea/workflows/autograde.yml b/.gitea/workflows/autograde.yml new file mode 100644 index 0000000..fb2ad39 --- /dev/null +++ b/.gitea/workflows/autograde.yml @@ -0,0 +1,390 @@ +name: autograde-final-vibevault + +on: + push: + branches: + - main + tags: + - 'submit' # 仍然允许标签触发 + - 'submit-*' + workflow_dispatch: + +permissions: + contents: read + pull-requests: write + +jobs: + # 检查是否应该触发 CI（仅在 commit message 包含 “完成作业” 时执行） + check-trigger: + runs-on: docker + container: + image: alpine:latest + outputs: + should_run: ${{ steps.check.outputs.trigger }} + steps: + - name: Check commit message for trigger keyword + id: check + run: | + COMMIT_MSG="${{ github.event.head_commit.message || '' }}" + echo "Commit message: $COMMIT_MSG" + if echo "$COMMIT_MSG" | grep -q "完成作业"; then + echo "trigger=true" >> $GITHUB_OUTPUT + echo "✅ Commit contains \"完成作业\"，即将执行评分" + else + echo "trigger=false" >> $GITHUB_OUTPUT + echo "⛔ 只有包含“完成作业”的提交才会执行自动评分" >&2 + fi + + grade: + needs: check-trigger + if: needs.check-trigger.outputs.should_run == 'true' + runs-on: docker + container: + image: gradle:9.0-jdk21 + options: --user root + timeout-minutes: 30 + + steps: + - name: Install dependencies (CN mirror) + run: | + set -e + # 替换 Debian/Ubuntu 源为阿里云镜像 + for f in /etc/apt/sources.list /etc/apt/sources.list.d/*.list /etc/apt/sources.list.d/*.sources; do + [ -f "$f" ] || continue + sed -i -E 's|https?://deb.debian.org|http://mirrors.aliyun.com|g' "$f" || true + sed -i -E 's|https?://security.debian.org|http://mirrors.aliyun.com/debian-security|g' "$f" || true + sed -i -E 's|https?://archive.ubuntu.com|http://mirrors.aliyun.com|g' "$f" || true + sed -i -E 's|https?://ports.ubuntu.com|http://mirrors.aliyun.com|g' "$f" || true + done + apt-get -o Acquire::Check-Valid-Until=false update -y + DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends git ca-certificates python3 python3-pip rsync \ + libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev shared-mime-info \ + fonts-noto-cjk fonts-wqy-microhei + pip3 install --break-system-packages python-dotenv requests markdown weasyprint -i https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com + # 刷新字体缓存 + fc-cache -f -v > /dev/null 2>&1 || true + rm -rf /var/lib/apt/lists/* + + - name: Configure Gradle mirror (Aliyun) + run: | + mkdir -p ~/.gradle + cat > ~/.gradle/init.gradle << 'EOF' + allprojects { + repositories { + mavenLocal() + maven { url 'https://maven.aliyun.com/repository/public' } + maven { url 'https://maven.aliyun.com/repository/spring' } + maven { url 'https://maven.aliyun.com/repository/spring-plugin' } + maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } + mavenCentral() + } + } + EOF + echo "✅ Gradle configured to use Aliyun mirror" + + - name: Checkout code + env: + GITHUB_TOKEN: ${{ github.token }} + run: | + git config --global --add safe.directory ${{ github.workspace }} + git init + # Use token for authentication (required for private repos) + REPO_URL="${{ github.server_url }}/${{ github.repository }}.git" + AUTH_URL=$(echo "$REPO_URL" | sed "s|://|://${GITHUB_TOKEN}@|") + git remote add origin "$AUTH_URL" + git fetch --depth=1 origin ${{ github.sha }} + git checkout ${{ github.sha }} + + - name: Fix permissions + run: chown -R $(whoami):$(whoami) ${{ github.workspace }} || true + + - name: Fetch hidden tests and grading scripts + working-directory: ${{ github.workspace }} + env: + EXTERNAL_GITEA_HOST: ${{ secrets.EXTERNAL_GITEA_HOST }} + run: | + set -e + + TESTS_USERNAME="${RUNNER_TESTS_USERNAME:-}" + TESTS_TOKEN="${RUNNER_TESTS_TOKEN:-}" + + if [ -z "$TESTS_TOKEN" ] || [ -z "$TESTS_USERNAME" ]; then + echo "❌ RUNNER_TESTS_USERNAME / RUNNER_TESTS_TOKEN not set!" + echo "Cannot fetch grading scripts - aborting." + exit 1 + fi + + # Resolve Gitea Host + if [ -n "$EXTERNAL_GITEA_HOST" ]; then + HOST="$EXTERNAL_GITEA_HOST" + elif [ -n "$GITEA_ROOT_URL" ]; then + HOST=$(echo "$GITEA_ROOT_URL" | sed 's|https\?://||' | sed 's|/$||') + else + HOST=$(echo "${{ github.server_url }}" | sed 's|https\?://||' | cut -d'/' -f1) + fi + + ORG=$(echo "${{ github.repository }}" | cut -d'/' -f1) + REPO_NAME=$(echo "${{ github.repository }}" | cut -d'/' -f2) + + # Extract assignment ID + if echo "$REPO_NAME" | grep -q -- '-stu_'; then + ASSIGNMENT_ID=$(echo "$REPO_NAME" | sed 's/-stu_.*//') + elif echo "$REPO_NAME" | grep -q -- '-template'; then + ASSIGNMENT_ID=$(echo "$REPO_NAME" | sed 's/-template.*//') + else + ASSIGNMENT_ID="final-vibevault" + fi + + echo "📥 Fetching tests and grading scripts from ${ORG}/${ASSIGNMENT_ID}-tests..." + + AUTH_URL="http://${TESTS_USERNAME}:${TESTS_TOKEN}@${HOST}/${ORG}/${ASSIGNMENT_ID}-tests.git" + + if ! git -c http.sslVerify=false clone --depth=1 "$AUTH_URL" _priv_tests 2>&1; then + echo "❌ Failed to clone ${ASSIGNMENT_ID}-tests repository!" + exit 1 + fi + + # ===== Copy grading scripts (from tests repo, cannot be modified by students) ===== + if [ -d "_priv_tests/autograde" ]; then + # Remove any local .autograde (prevent student tampering) + rm -rf .autograde + mkdir -p .autograde + cp _priv_tests/autograde/*.py .autograde/ + cp _priv_tests/autograde/*.sh .autograde/ 2>/dev/null || true + echo "✅ Grading scripts copied from tests repo" + else + echo "❌ No autograde directory in tests repo!" + exit 1 + fi + + # Copy Java tests + if [ -d "_priv_tests/java/src/test" ]; then + rsync -a _priv_tests/java/src/test/ src/test/ + echo "✅ Private tests copied" + fi + + # Copy test_groups.json if exists + if [ -f "_priv_tests/test_groups.json" ]; then + cp _priv_tests/test_groups.json . + echo "✅ test_groups.json copied" + fi + + # Copy LLM rubrics + if [ -d "_priv_tests/llm" ]; then + mkdir -p .llm_rubrics + cp _priv_tests/llm/*.json .llm_rubrics/ 2>/dev/null || true + echo "✅ LLM rubrics copied" + fi + + # Cleanup + rm -rf _priv_tests + + - name: Run tests + working-directory: ${{ github.workspace }} + run: | + gradle test --no-daemon || true + + # Collect all JUnit XML reports + find build/test-results/test -name "TEST-*.xml" -exec cat {} \; > all_tests.xml 2>/dev/null || true + + # Also try to get a single combined report + if [ -f build/test-results/test/TEST-*.xml ]; then + cp build/test-results/test/TEST-*.xml junit.xml 2>/dev/null || true + fi + + - name: Grade programming tests + working-directory: ${{ github.workspace }} + run: | + # Use extended grading script with group support + python3 ./.autograde/grade_grouped.py \ + --junit-dir build/test-results/test \ + --groups test_groups.json \ + --out grade.json \ + --summary summary.md + + - name: Grade REPORT.md + working-directory: ${{ github.workspace }} + run: | + # LLM env vars are injected by Runner config (LLM_API_KEY, LLM_API_URL, LLM_MODEL) + if [ -f REPORT.md ] && [ -f .llm_rubrics/rubric_report.json ]; then + python3 ./.autograde/llm_grade.py \ + --question "请评估这份后端与系统设计报告" \ + --answer REPORT.md \ + --rubric .llm_rubrics/rubric_report.json \ + --out report_grade.json \ + --summary report_summary.md + echo "✅ REPORT.md graded" + else + echo '{"total": 0, "flags": ["missing_file"]}' > report_grade.json + echo "⚠️ REPORT.md or rubric not found" + fi + + - name: Grade FRONTEND.md + working-directory: ${{ github.workspace }} + run: | + # LLM env vars are injected by Runner config (LLM_API_KEY, LLM_API_URL, LLM_MODEL) + if [ -f FRONTEND.md ] && [ -f .llm_rubrics/rubric_frontend.json ]; then + python3 ./.autograde/llm_grade.py \ + --question "请评估这份前端界面与交互设计报告" \ + --answer FRONTEND.md \ + --rubric .llm_rubrics/rubric_frontend.json \ + --out frontend_grade.json \ + --summary frontend_summary.md + echo "✅ FRONTEND.md graded" + else + echo '{"total": 0, "flags": ["missing_file"]}' > frontend_grade.json + echo "⚠️ FRONTEND.md or rubric not found" + fi + + - name: Aggregate grades + working-directory: ${{ github.workspace }} + run: | + python3 ./.autograde/aggregate_final_grade.py \ + --programming grade.json \ + --report report_grade.json \ + --frontend frontend_grade.json \ + --out final_grade.json \ + --summary final_summary.md + + - name: Generate PDF report + working-directory: ${{ github.workspace }} + env: + REPO: ${{ github.repository }} + COMMIT_SHA: ${{ github.sha }} + run: | + if [ -f final_grade.json ]; then + # 读取学生信息文件（如果存在） + STUDENT_ID="" + STUDENT_NAME="" + CLASS_NAME="" + + if [ -f .student_info.json ]; then + STUDENT_ID=$(python3 -c "import json; d=json.load(open('.student_info.json')); print(d.get('student_id',''))" 2>/dev/null || echo "") + STUDENT_NAME=$(python3 -c "import json; d=json.load(open('.student_info.json')); print(d.get('name',''))" 2>/dev/null || echo "") + CLASS_NAME=$(python3 -c "import json; d=json.load(open('.student_info.json')); print(d.get('class_name',''))" 2>/dev/null || echo "") + fi + + # 如果没有学生信息文件，从仓库名提取学号 + if [ -z "$STUDENT_ID" ]; then + STUDENT_ID=$(echo "$REPO" | sed -n 's/.*-stu[_-]\?\(st\)\?\([0-9]*\)$/\2/p') + fi + + python3 ./.autograde/generate_pdf_report.py \ + --report REPORT.md \ + --frontend FRONTEND.md \ + --grade final_grade.json \ + --images images \ + --out grade_report.pdf \ + --student-id "$STUDENT_ID" \ + --student-name "$STUDENT_NAME" \ + --class-name "$CLASS_NAME" \ + --commit-sha "$COMMIT_SHA" + fi + + - name: Upload report to student repo + if: env.RUNNER_METADATA_TOKEN != '' + working-directory: ${{ github.workspace }} + env: + TOKEN: ${{ env.RUNNER_METADATA_TOKEN }} + REPO: ${{ github.repository }} + SERVER_URL: ${{ github.server_url }} + COMMIT_SHA: ${{ github.sha }} + run: | + # 上传 PDF 或 Markdown 报告到学生仓库 + REPORT_FILE="" + if [ -f grade_report.pdf ]; then + REPORT_FILE="grade_report.pdf" + elif [ -f grade_report.md ]; then + REPORT_FILE="grade_report.md" + fi + + if [ -n "$REPORT_FILE" ]; then + # 使用内部地址 + API_URL="http://gitea:3000/api/v1" + SHORT_SHA=$(echo "$COMMIT_SHA" | cut -c1-7) + DEST_PATH="reports/grade_report_${SHORT_SHA}.${REPORT_FILE##*.}" + + # Base64 编码并保存到临时文件（避免命令行参数过长） + CONTENT=$(base64 -w 0 "$REPORT_FILE") + + # 创建请求 JSON 文件 + cat > /tmp/upload_request.json << EOF + {"message": "Add grade report for $SHORT_SHA", "content": "$CONTENT"} + EOF + + # 先尝试 POST 创建新文件 + RESULT=$(curl -s -X POST -H "Authorization: token $TOKEN" \ + -H "Content-Type: application/json" \ + "$API_URL/repos/$REPO/contents/$DEST_PATH" \ + -d @/tmp/upload_request.json) + + if echo "$RESULT" | grep -q '"content"'; then + echo "✅ Report uploaded to $DEST_PATH" + else + # POST 失败，可能文件已存在，尝试获取 SHA 并 PUT 更新 + echo "POST failed, trying PUT with SHA..." + SHA=$(curl -s -H "Authorization: token $TOKEN" \ + "$API_URL/repos/$REPO/contents/$DEST_PATH" \ + | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('sha','') if isinstance(d,dict) and 'sha' in d else '')" 2>/dev/null || echo "") + + if [ -n "$SHA" ]; then + # 创建更新请求 JSON 文件 + cat > /tmp/upload_request.json << EOF + {"message": "Update grade report for $SHORT_SHA", "content": "$CONTENT", "sha": "$SHA"} + EOF + + RESULT=$(curl -s -X PUT -H "Authorization: token $TOKEN" \ + -H "Content-Type: application/json" \ + "$API_URL/repos/$REPO/contents/$DEST_PATH" \ + -d @/tmp/upload_request.json) + + if echo "$RESULT" | grep -q '"content"'; then + echo "✅ Report updated at $DEST_PATH" + else + echo "⚠️ Failed to update report: $RESULT" + fi + else + echo "⚠️ Could not get file SHA, upload failed" + fi + fi + + # 清理临时文件 + rm -f /tmp/upload_request.json + fi + + - name: Create metadata + working-directory: ${{ github.workspace }} + env: + REPO: ${{ github.repository }} + run: | + if [ -f final_grade.json ]; then + export GRADE_TYPE=final + python3 ./.autograde/create_minimal_metadata.py > metadata.json || echo "{}" > metadata.json + fi + + - name: Upload metadata + if: env.RUNNER_METADATA_TOKEN != '' + working-directory: ${{ github.workspace }} + env: + # 使用当前组织的 course-metadata 仓库，而不是 Runner 配置中的硬编码值 + METADATA_REPO: ${{ github.repository_owner }}/course-metadata + METADATA_TOKEN: ${{ env.RUNNER_METADATA_TOKEN }} + METADATA_BRANCH: ${{ env.RUNNER_METADATA_BRANCH }} + STUDENT_REPO: ${{ github.repository }} + RUN_ID: ${{ github.run_id }} + COMMIT_SHA: ${{ github.sha }} + SERVER_URL: ${{ github.server_url }} + run: | + if [ -f metadata.json ]; then + python3 ./.autograde/upload_metadata.py \ + --metadata-file metadata.json \ + --metadata-repo "${METADATA_REPO}" \ + --branch "${METADATA_BRANCH:-main}" \ + --student-repo "${STUDENT_REPO}" \ + --run-id "${RUN_ID}" \ + --commit-sha "${COMMIT_SHA}" \ + --workflow grade \ + --server-url "${SERVER_URL}" \ + --external-host "${EXTERNAL_GITEA_HOST}" + fi + diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..99eb3b7 --- /dev/null +++ b/.gitignore @@ -0,0 +1,24 @@ +# Gradle +.gradle/ +build/ +!gradle/wrapper/gradle-wrapper.jar + +# IDE +.idea/ +*.iml +.vscode/ +*.swp + +# OS +.DS_Store +Thumbs.db + +# Application +*.log +data/ + +# Test outputs (keep for local debugging) +# junit.xml +# grade.json +# summary.md + diff --git a/DATABASE_CONNECTION.md b/DATABASE_CONNECTION.md new file mode 100644 index 0000000..35eac91 --- /dev/null +++ b/DATABASE_CONNECTION.md @@ -0,0 +1,89 @@ +# VibeVault 数据库连接配置 + +## 远程数据库连接信息 + +### 生产环境配置 +- **数据库类型**: PostgreSQL +- **主机地址**: 49.234.193.192 +- **端口**: 5432 +- **数据库名**: vibevault +- **用户名**: postgres +- **密码**: postgres + +### 配置文件说明 + +#### 1. 开发环境 (application.properties) +默认使用H2内存数据库，适合本地开发和测试： +```properties +# 开发/测试时使用 H2 内存数据库 +spring.datasource.url=jdbc:h2:mem:vibevault;DB_CLOSE_DELAY=-1 +spring.datasource.username=sa +spring.datasource.password= +spring.datasource.driver-class-name=org.h2.Driver +``` + +#### 2. 生产环境 (application-prod.properties) +使用远程PostgreSQL数据库： +```properties +# 生产环境使用 PostgreSQL 远程数据库 +spring.datasource.url=jdbc:postgresql://49.234.193.192:5432/vibevault +spring.datasource.username=postgres +spring.datasource.password=postgres +spring.datasource.driver-class-name=org.postgresql.Driver +``` + +### 环境切换 + +#### 方式1: 启动参数 +```bash +# 开发环境 (默认) +./gradlew bootRun + +# 生产环境 +./gradlew bootRun --args='--spring.profiles.active=prod' +``` + +#### 方式2: 环境变量 +```bash +# 设置环境变量 +set SPRING_PROFILES_ACTIVE=prod +./gradlew bootRun +``` + +#### 方式3: 系统属性 +```bash +# 通过系统属性 +./gradlew bootRun -Dspring.profiles.active=prod +``` + +### 数据库连接测试 + +项目包含数据库连接测试类 `DatabaseConnectionTest`，可以验证与远程数据库的连接： + +```bash +# 运行数据库连接测试 +./gradlew test --tests DatabaseConnectionTest +``` + +### 注意事项 + +1. **网络连接**: 确保可以访问远程数据库服务器 `49.234.193.192:5432` +2. **防火墙**: 检查本地防火墙设置，确保5432端口未被阻止 +3. **数据库权限**: 确保数据库用户具有必要的读写权限 +4. **连接池**: Spring Boot会自动配置Hikari连接池 + +### 故障排除 + +如果连接失败，请检查： +- 网络连接是否正常 +- 数据库服务是否正在运行 +- 用户名和密码是否正确 +- 数据库是否存在 + +### 支持的数据库操作 + +- ✅ 自动建表 (spring.jpa.hibernate.ddl-auto=update) +- ✅ 事务管理 +- ✅ 连接池 +- ✅ JPA/Hibernate支持 +- ✅ 数据库迁移 (如果需要) \ No newline at end of file diff --git a/FRONTEND.md b/FRONTEND.md new file mode 100644 index 0000000..4da1c62 --- /dev/null +++ b/FRONTEND.md @@ -0,0 +1,55 @@ +# 前端开发反思报告 + +> 请参考 `FRONTEND_GUIDE.md` 了解写作要求。建议 600–1200 字。 + +--- + +## 1. 我的界面展示 + + +![添加歌曲弹窗](images/song-add-modal.png) + +这是歌单详情页的“添加歌曲”弹窗，用于向当前歌单中新增歌曲。用户可在此填写歌曲名称、歌手（必填项）及专辑（选填项），完成后点击“添加歌曲”按钮提交。我在设计时将必填项与选填项做了标注区分，同时在弹窗底部重复放置操作按钮，避免用户滚动后需返回顶部操作。 + +![歌单详情（无歌曲）页面](images/playlist-detail-empty.png) + +这是歌单详情页面，用于展示指定歌单的基础信息和歌曲列表。用户可在此编辑歌单信息、返回歌单列表，或通过“添加歌曲”按钮向歌单中新增歌曲。我设计了空状态提示文案，当歌单无歌曲时引导用户点击按钮添加，同时将操作按钮放置在显眼位置，降低操作成本。 + +![创建歌单弹窗](images/playlist-create-modal.png) + +这是创建歌单的弹窗界面，用于生成新的音乐歌单。用户需填写歌单名称（必填）和歌单描述（选填），完成后点击“创建歌单”按钮即可生成新的歌单。我在此处设计了输入项的功能标注，明确区分必填与选填内容，同时将“创建歌单”按钮做了视觉强化，让核心操作更醒目。 + + +## 2. 我遇到的最大挑战 + + +本次开发中，最大的挑战是跨模块的数据同步问题。在实现“添加歌曲后自动更新歌单卡片的歌曲数量”功能时，我发现歌曲管理模块和歌单列表模块是独立的，添加歌曲后，歌单卡片上的“歌曲数量”不会自动更新，需要手动刷新页面才能同步。 + +起初我尝试在“添加歌曲”的按钮点击事件里，直接去修改歌单卡片的文本内容，但这种方式需要遍历DOM找到对应的歌单卡片，不仅代码繁琐，还容易因为歌单名称重复导致修改错误。接着我又尝试用全局变量存储歌单数据，但不同模块修改全局变量后，其他模块无法感知到变化，依然需要手动触发刷新。 + +最后我采用了自定义事件的方案：在歌曲管理模块添加歌曲后，触发一个自定义事件（如 songAdded ）并携带当前歌单名称；歌单列表模块监听这个事件，收到事件后更新对应歌单卡片的歌曲数量。这种方式既避免了DOM操作的繁琐，也实现了模块间的解耦。 + +这次经历让我明白：前端模块间的通信，要尽量避免直接操作DOM或共享全局变量，利用自定义事件、状态管理等方式，能让代码更易维护。 + + +## 3. 如果重新做一遍 + + + +回顾这次实现，我会优先做两方面的改进： + +第一是添加数据持久化。当前页面刷新后，创建的歌单和添加的歌曲都会丢失，重新开发时我会用 localStorage 存储歌单和歌曲数据，页面加载时从本地存储读取数据，确保用户操作不会因为刷新而丢失。 + +第二是优化代码组织。这次开发把所有JS代码写在同一个