第一次提交

LICENSE

@@ -1,33 +0,0 @@
-GCC RUNTIME LIBRARY EXCEPTION
-
-Version 3.1, 31 March 2009
-
-General information: http://www.gnu.org/licenses/gcc-exception.html
-Copyright (C) 2009 Free Software Foundation, Inc. <http://fsf.org/>
-
-Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
-This GCC Runtime Library Exception ("Exception") is an additional permission under section 7 of the GNU General Public License, version 3 ("GPLv3"). It applies to a given file (the "Runtime Library") that bears a notice placed by the copyright holder of the file stating that the file is governed by GPLv3 along with this Exception.
-
-When you use GCC to compile a program, GCC may combine portions of certain GCC header files and runtime libraries with the compiled program. The purpose of this Exception is to allow compilation of non-GPL (including proprietary) programs to use, in this way, the header files and runtime libraries covered by this Exception.
-
-0. Definitions.
-
-A file is an "Independent Module" if it either requires the Runtime Library for execution after a Compilation Process, or makes use of an interface provided by the Runtime Library, but is not otherwise based on the Runtime Library.
-
-"GCC" means a version of the GNU Compiler Collection, with or without modifications, governed by version 3 (or a specified later version) of the GNU General Public License (GPL) with the option of using any subsequent versions published by the FSF.
-
-"GPL-compatible Software" is software whose conditions of propagation, modification and use would permit combination with GCC in accord with the license of GCC.
-
-"Target Code" refers to output from any compiler for a real or virtual target processor architecture, in executable form or suitable for input to an assembler, loader, linker and/or execution phase. Notwithstanding that, Target Code does not include data in any format that is used as a compiler intermediate representation, or used for producing a compiler intermediate representation.
-
-The "Compilation Process" transforms code entirely represented in non-intermediate languages designed for human-written code, and/or in Java Virtual Machine byte code, into Target Code. Thus, for example, use of source code generators and preprocessors need not be considered part of the Compilation Process, since the Compilation Process can be understood as starting with the output of the generators or preprocessors.
-
-A Compilation Process is "Eligible" if it is done using GCC, alone or with other GPL-compatible software, or if it is done without using any work based on GCC. For example, using non-GPL-compatible Software to optimize any GCC intermediate representations would not qualify as an Eligible Compilation Process.
-
-1. Grant of Additional Permission.
-
-You have permission to propagate a work of Target Code formed by combining the Runtime Library with Independent Modules, even if such propagation would otherwise violate the terms of GPLv3, provided that all Target Code was generated by Eligible Compilation Processes. You may then convey such a combination under terms of your choice, consistent with the licensing of the Independent Modules.
-
-2. No Weakening of GCC Copyleft.
-
-The availability of this Exception does not imply any general presumption that third-party software is unaffected by the copyleft requirements of the license of GCC.

README.md

@@ -1,2 +0,0 @@
-# tutoring_software
-

src/.github/workflows/build.yml

@@ -0,0 +1,22 @@
+name: Build
+on:
+  push:
+    branches:
+      - study_analysis
+  pull_request:
+    types: [opened, synchronize, reopened]
+jobs:
+  sonarqube:
+    name: SonarQube
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Shallow clones should be disabled for a better relevancy of analysis
+      # The analysis requires to retrieve dependencies and build successfully
+      - name: Build
+        run: <mark><commands_to_build_your_project></mark>
+      - name: SonarQube Scan
+        uses: SonarSource/sonarqube-scan-action@v6
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

src/.gitignore

@@ -0,0 +1,53 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+.vscode/
+.VSCodeCounter/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+/coverage/
+/lib/data/user_data.json
+*.g.dart
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+#linux server
+/backend/spring.log
+/backend/nohup.out

src/.metadata

@@ -0,0 +1,45 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "a402d9a4376add5bc2d6b1e33e53edaae58c07f8"
+  channel: "stable"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: android
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: ios
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: linux
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: macos
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: web
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+    - platform: windows
+      create_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+      base_revision: a402d9a4376add5bc2d6b1e33e53edaae58c07f8
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

src/README.md

@@ -0,0 +1,78 @@
+# 辅导软件 - Tutoring Software
+
+## 系统简介
+
+这是一款基于Flutter开发的跨平台家教服务软件，旨在连接学生、家长和教师，提供便捷的辅导服务匹配和学习管理功能。
+
+### 主要功能特点
+
+- **多角色支持**：支持学生/家长和教师两种角色，满足不同用户需求
+- **丰富的科目覆盖**：涵盖小学、初中、高中各学科，以及兴趣爱好、专业技能等多种辅导类别
+- **精准筛选**：根据科目、评分、评价数量等条件筛选合适的教师
+- **学习分析**：提供学习进度和成绩分析功能
+- **实时聊天**：支持师生之间的即时沟通
+- **教师评价**：学生可以对教师进行评价和评分
+- **个人中心**：管理个人信息、学习记录和辅导关系
+
+### 技术架构
+
+- **前端框架**：Flutter 3.35.6
+- **前端语言**:  Dart3.9.2
+- **后端语言**：Java17
+- **后端框架**：Springboot 
+- **状态管理**：MobX
+- **路由管理**：Flutter Modular
+- **本地存储**：Hive
+- **远程存储**：PostgreSQL 
+- **UI组件**：Material Design + GetWidget
+- **多平台支持**：Android、iOS、Web、Windows、macOS、Linux
+
+## 环境配置
+
+### 开发环境要求
+
+- **Flutter SDK**：3.35.6
+- **Dart SDK**：3.9.2 或更高版本
+- **IDE推荐**：
+  - Android Studio (推荐，集成Flutter插件)
+  - Visual Studio Code (配合Flutter插件)
+- **移动设备/模拟器**：
+  - Android设备/Android模拟器 (API 21+)
+  - iOS设备/iOS模拟器 (iOS 11+)
+
+### 安装步骤
+
+1. **克隆项目**
+
+```bash
+git clone https://gitee.com/JiaErC/tutoring-software.git
+cd tutoring-software
+```
+
+2. **运行项目**
+-**flutter前端安装相关的依赖**
+```bash
+flutter pub get
+# 首次运行的时候需要做的事情
+dart run build_runner build # 或者dart run build_runner watch
+```
+
+- **springboot后端的运行方式**
+```bash
+mvn spring-boot:run 
+```
+
+- **查找可以运行的设备**-
+```bash
+flutter devices
+```
+
+- Android模拟器/设备:
+```bash
+flutter run -d android
+```
+
+- Windows版本:
+```bash
+flutter run -d windows
+```

src/analysis_options.yaml

@@ -0,0 +1,28 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  # The lint rules applied to this project can be customized in the
+  # section below to disable rules from the `package:flutter_lints/flutter.yaml`
+  # included above or to enable additional rules. A list of all available lints
+  # and their documentation is published at https://dart.dev/lints.
+  #
+  # Instead of disabling a lint rule for the entire project in the
+  # section below, it can also be suppressed for a single line of code
+  # or a specific dart file by using the `// ignore: name_of_lint` and
+  # `// ignore_for_file: name_of_lint` syntax on the line or in the file
+  # producing the lint.
+  rules:
+    # avoid_print: false  # Uncomment to disable the `avoid_print` rule
+    # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

src/android/.gitignore

@@ -0,0 +1,14 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+.cxx/
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/to/reference-keystore
+key.properties
+**/*.keystore
+**/*.jks

src/android/app/build.gradle.kts

@@ -0,0 +1,49 @@
+plugins {
+    id("com.android.application")
+    id("kotlin-android")
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id("dev.flutter.flutter-gradle-plugin")
+}
+
+android {
+    namespace = "com.example.tutoring_software"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_11.toString()
+    }
+
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId = "com.example.tutoring_software"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
+        minSdk = flutter.minSdkVersion
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+        // 添加以下配置以支持64位架构
+        ndk {
+            abiFilters += "arm64-v8a"
+            abiFilters += "x86_64"
+        }
+    }
+
+    buildTypes {
+        release {
+            // TODO: Add your own signing config for the release build.
+            // Signing with the debug keys for now, so `flutter run --release` works.
+            signingConfig = signingConfigs.getByName("debug")
+        }
+    }
+}
+
+flutter {
+    source = "../.."
+}

src/android/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>

src/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,52 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- 添加这一行网络权限 -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    
+    <!-- 可选：允许检查网络状态 -->
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    
+    <application
+        android:label="软件工程家教软件"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher"
+        android:networkSecurityConfig="@xml/network_security_config">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:taskAffinity=""
+            android:theme="@style/LaunchTheme"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
+            android:hardwareAccelerated="true"
+            android:windowSoftInputMode="adjustResize">
+            <!-- Specifies an Android theme to apply to this Activity as soon as
+                 the Android process has started. This theme is visible to the user
+                 while the Flutter UI initializes. After that, this theme continues
+                 to determine the Window background behind the Flutter UI. -->
+            <meta-data
+              android:name="io.flutter.embedding.android.NormalTheme"
+              android:resource="@style/NormalTheme"
+              />
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <!-- Don't delete the meta-data below.
+             This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
+        <meta-data
+            android:name="flutterEmbedding"
+            android:value="2" />
+    </application>
+    <!-- Required to query activities that can process text, see:
+         https://developer.android.com/training/package-visibility and
+         https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
+
+         In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
+    <queries>
+        <intent>
+            <action android:name="android.intent.action.PROCESS_TEXT"/>
+            <data android:mimeType="text/plain"/>
+        </intent>
+    </queries>
+</manifest>

src/android/app/src/main/java/com/example/tutoring_software/MainActivity.java

@@ -0,0 +1,6 @@
+package com.example.tutoring_software;
+
+import io.flutter.embedding.android.FlutterActivity;
+
+public class MainActivity extends FlutterActivity {
+}

src/android/app/src/main/res/drawable-v21/launch_background.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Modify this file to customize your launch splash screen -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:drawable="?android:colorBackground" />
+
+    <!-- You can insert your own image assets here -->
+    <!-- <item>
+        <bitmap
+            android:gravity="center"
+            android:src="@mipmap/launch_image" />
+    </item> -->
+</layer-list>

src/android/app/src/main/res/drawable/launch_background.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Modify this file to customize your launch splash screen -->
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:drawable="@android:color/white" />
+
+    <!-- You can insert your own image assets here -->
+    <!-- <item>
+        <bitmap
+            android:gravity="center"
+            android:src="@mipmap/launch_image" />
+    </item> -->
+</layer-list>

src/android/app/src/main/res/values-night/styles.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
+    <style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
+        <!-- Show a splash screen on the activity. Automatically removed when
+             the Flutter engine draws its first frame -->
+        <item name="android:windowBackground">@drawable/launch_background</item>
+    </style>
+    <!-- Theme applied to the Android Window as soon as the process has started.
+         This theme determines the color of the Android Window while your
+         Flutter UI initializes, as well as behind your Flutter UI while its
+         running.
+
+         This Theme is only used starting with V2 of Flutter's Android embedding. -->
+    <style name="NormalTheme" parent="@android:style/Theme.Black.NoTitleBar">
+        <item name="android:windowBackground">?android:colorBackground</item>
+    </style>
+</resources>

src/android/app/src/main/res/values/styles.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
+    <style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
+        <!-- Show a splash screen on the activity. Automatically removed when
+             the Flutter engine draws its first frame -->
+        <item name="android:windowBackground">@drawable/launch_background</item>
+    </style>
+    <!-- Theme applied to the Android Window as soon as the process has started.
+         This theme determines the color of the Android Window while your
+         Flutter UI initializes, as well as behind your Flutter UI while its
+         running.
+
+         This Theme is only used starting with V2 of Flutter's Android embedding. -->
+    <style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
+        <item name="android:windowBackground">?android:colorBackground</item>
+    </style>
+</resources>

src/android/app/src/main/res/xml/network_security_config.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<network-security-config>
+    <domain-config cleartextTrafficPermitted="true">
+        <!-- 允许访问阿里云服务器 -->
+        <domain includeSubdomains="true">8.140.222.2</domain>
+        <!-- 可选：允许访问本地开发服务器 -->
+        <domain includeSubdomains="true">127.0.0.1</domain>
+        <domain includeSubdomains="true">10.0.2.2</domain> <!-- Android模拟器访问本地主机 -->
+        <domain includeSubdomains="true">192.168.18.128</domain> <!-- 虚拟机IP -->
+    </domain-config>
+    <base-config cleartextTrafficPermitted="false" />
+</network-security-config>

src/android/app/src/profile/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>

src/android/build.gradle.kts

@@ -0,0 +1,25 @@
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url=uri("https://maven.aliyun.com/repository/public/") }
+    }
+}
+
+val newBuildDir: Directory =
+    rootProject.layout.buildDirectory
+        .dir("../../build")
+        .get()
+rootProject.layout.buildDirectory.value(newBuildDir)
+
+subprojects {
+    val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name)
+    project.layout.buildDirectory.value(newSubprojectBuildDir)
+}
+subprojects {
+    project.evaluationDependsOn(":app")
+}
+
+tasks.register<Delete>("clean") {
+    delete(rootProject.layout.buildDirectory)
+}

src/android/gradle.properties

@@ -0,0 +1,3 @@
+org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError
+android.useAndroidX=true
+android.enableJetifier=true

src/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-all.zip

src/android/settings.gradle.kts

@@ -0,0 +1,26 @@
+pluginManagement {
+    val flutterSdkPath =
+        run {
+            val properties = java.util.Properties()
+            file("local.properties").inputStream().use { properties.load(it) }
+            val flutterSdkPath = properties.getProperty("flutter.sdk")
+            require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
+            flutterSdkPath
+        }
+
+    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
+
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+plugins {
+    id("dev.flutter.flutter-plugin-loader") version "1.0.0"
+    id("com.android.application") version "8.9.1" apply false
+    id("org.jetbrains.kotlin.android") version "2.1.0" apply false
+}
+
+include(":app")

src/backend/.gitattributes

@@ -0,0 +1,2 @@
+/mvnw text eol=lf
+*.cmd text eol=crlf

src/backend/.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

src/backend/.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,3 @@
+wrapperVersion=3.3.4
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip

src/backend/mvnw

@@ -0,0 +1,295 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.3.4
+#
+# Optional ENV vars
+# -----------------
+#   JAVA_HOME - location of a JDK home dir, required when download maven via java source
+#   MVNW_REPOURL - repo url base for downloading maven distribution
+#   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+#   MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
+# ----------------------------------------------------------------------------
+
+set -euf
+[ "${MVNW_VERBOSE-}" != debug ] || set -x
+
+# OS specific support.
+native_path() { printf %s\\n "$1"; }
+case "$(uname)" in
+CYGWIN* | MINGW*)
+  [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
+  native_path() { cygpath --path --windows "$1"; }
+  ;;
+esac
+
+# set JAVACMD and JAVACCMD
+set_java_home() {
+  # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
+  if [ -n "${JAVA_HOME-}" ]; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ]; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+      JAVACCMD="$JAVA_HOME/jre/sh/javac"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+      JAVACCMD="$JAVA_HOME/bin/javac"
+
+      if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
+        echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
+        echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
+        return 1
+      fi
+    fi
+  else
+    JAVACMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v java
+    )" || :
+    JAVACCMD="$(
+      'set' +e
+      'unset' -f command 2>/dev/null
+      'command' -v javac
+    )" || :
+
+    if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
+      echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
+      return 1
+    fi
+  fi
+}
+
+# hash string like Java String::hashCode
+hash_string() {
+  str="${1:-}" h=0
+  while [ -n "$str" ]; do
+    char="${str%"${str#?}"}"
+    h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
+    str="${str#?}"
+  done
+  printf %x\\n $h
+}
+
+verbose() { :; }
+[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
+
+die() {
+  printf %s\\n "$1" >&2
+  exit 1
+}
+
+trim() {
+  # MWRAPPER-139:
+  #   Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
+  #   Needed for removing poorly interpreted newline sequences when running in more
+  #   exotic environments such as mingw bash on Windows.
+  printf "%s" "${1}" | tr -d '[:space:]'
+}
+
+scriptDir="$(dirname "$0")"
+scriptName="$(basename "$0")"
+
+# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
+while IFS="=" read -r key value; do
+  case "${key-}" in
+  distributionUrl) distributionUrl=$(trim "${value-}") ;;
+  distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
+  esac
+done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
+[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+
+case "${distributionUrl##*/}" in
+maven-mvnd-*bin.*)
+  MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
+  case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
+  *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
+  :Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
+  :Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
+  :Linux*x86_64*) distributionPlatform=linux-amd64 ;;
+  *)
+    echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
+    distributionPlatform=linux-amd64
+    ;;
+  esac
+  distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
+  ;;
+maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
+*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
+esac
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
+distributionUrlName="${distributionUrl##*/}"
+distributionUrlNameMain="${distributionUrlName%.*}"
+distributionUrlNameMain="${distributionUrlNameMain%-bin}"
+MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
+MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
+
+exec_maven() {
+  unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
+  exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
+}
+
+if [ -d "$MAVEN_HOME" ]; then
+  verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  exec_maven "$@"
+fi
+
+case "${distributionUrl-}" in
+*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
+*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
+esac
+
+# prepare tmp dir
+if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
+  clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
+  trap clean HUP INT TERM EXIT
+else
+  die "cannot create temp dir"
+fi
+
+mkdir -p -- "${MAVEN_HOME%/*}"
+
+# Download and Install Apache Maven
+verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+verbose "Downloading from: $distributionUrl"
+verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+# select .zip or .tar.gz
+if ! command -v unzip >/dev/null; then
+  distributionUrl="${distributionUrl%.zip}.tar.gz"
+  distributionUrlName="${distributionUrl##*/}"
+fi
+
+# verbose opt
+__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
+[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
+
+# normalize http auth
+case "${MVNW_PASSWORD:+has-password}" in
+'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
+esac
+
+if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
+  verbose "Found wget ... using wget"
+  wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
+elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
+  verbose "Found curl ... using curl"
+  curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
+elif set_java_home; then
+  verbose "Falling back to use Java to download"
+  javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
+  targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
+  cat >"$javaSource" <<-END
+	public class Downloader extends java.net.Authenticator
+	{
+	  protected java.net.PasswordAuthentication getPasswordAuthentication()
+	  {
+	    return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
+	  }
+	  public static void main( String[] args ) throws Exception
+	  {
+	    setDefault( new Downloader() );
+	    java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
+	  }
+	}
+	END
+  # For Cygwin/MinGW, switch paths to Windows format before running javac and java
+  verbose " - Compiling Downloader.java ..."
+  "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
+  verbose " - Running Downloader.java ..."
+  "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
+fi
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+if [ -n "${distributionSha256Sum-}" ]; then
+  distributionSha256Result=false
+  if [ "$MVN_CMD" = mvnd.sh ]; then
+    echo "Checksum validation is not supported for maven-mvnd." >&2
+    echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  elif command -v sha256sum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  elif command -v shasum >/dev/null; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
+      distributionSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
+    echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  fi
+  if [ $distributionSha256Result = false ]; then
+    echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
+    echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
+    exit 1
+  fi
+fi
+
+# unzip and move
+if command -v unzip >/dev/null; then
+  unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
+else
+  tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
+fi
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+actualDistributionDir=""
+
+# First try the expected directory name (for regular distributions)
+if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
+  if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
+    actualDistributionDir="$distributionUrlNameMain"
+  fi
+fi
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if [ -z "$actualDistributionDir" ]; then
+  # enable globbing to iterate over items
+  set +f
+  for dir in "$TMP_DOWNLOAD_DIR"/*; do
+    if [ -d "$dir" ]; then
+      if [ -f "$dir/bin/$MVN_CMD" ]; then
+        actualDistributionDir="$(basename "$dir")"
+        break
+      fi
+    fi
+  done
+  set -f
+fi
+
+if [ -z "$actualDistributionDir" ]; then
+  verbose "Contents of $TMP_DOWNLOAD_DIR:"
+  verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
+  die "Could not find Maven distribution directory in extracted archive"
+fi
+
+verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
+mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
+
+clean || :
+exec_maven "$@"

src/backend/mvnw.cmd

@@ -0,0 +1,189 @@
+<# : batch portion
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Apache Maven Wrapper startup batch script, version 3.3.4
+@REM
+@REM Optional ENV vars
+@REM   MVNW_REPOURL - repo url base for downloading maven distribution
+@REM   MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
+@REM   MVNW_VERBOSE - true: enable verbose log; others: silence the output
+@REM ----------------------------------------------------------------------------
+
+@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0)
+@SET __MVNW_CMD__=
+@SET __MVNW_ERROR__=
+@SET __MVNW_PSMODULEP_SAVE=%PSModulePath%
+@SET PSModulePath=
+@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @(
+  IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B)
+)
+@SET PSModulePath=%__MVNW_PSMODULEP_SAVE%
+@SET __MVNW_PSMODULEP_SAVE=
+@SET __MVNW_ARG0_NAME__=
+@SET MVNW_USERNAME=
+@SET MVNW_PASSWORD=
+@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*)
+@echo Cannot start maven from wrapper >&2 && exit /b 1
+@GOTO :EOF
+: end batch / begin powershell #>
+
+$ErrorActionPreference = "Stop"
+if ($env:MVNW_VERBOSE -eq "true") {
+  $VerbosePreference = "Continue"
+}
+
+# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties
+$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl
+if (!$distributionUrl) {
+  Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
+}
+
+switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
+  "maven-mvnd-*" {
+    $USE_MVND = $true
+    $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip"
+    $MVN_CMD = "mvnd.cmd"
+    break
+  }
+  default {
+    $USE_MVND = $false
+    $MVN_CMD = $script -replace '^mvnw','mvn'
+    break
+  }
+}
+
+# apply MVNW_REPOURL and calculate MAVEN_HOME
+# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
+if ($env:MVNW_REPOURL) {
+  $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" }
+  $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')"
+}
+$distributionUrlName = $distributionUrl -replace '^.*/',''
+$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
+
+$MAVEN_M2_PATH = "$HOME/.m2"
+if ($env:MAVEN_USER_HOME) {
+  $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME"
+}
+
+if (-not (Test-Path -Path $MAVEN_M2_PATH)) {
+    New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null
+}
+
+$MAVEN_WRAPPER_DISTS = $null
+if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) {
+  $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists"
+} else {
+  $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists"
+}
+
+$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain"
+$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
+$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
+
+if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
+  Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME"
+  Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
+  exit $?
+}
+
+if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) {
+  Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl"
+}
+
+# prepare tmp dir
+$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile
+$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir"
+$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null
+trap {
+  if ($TMP_DOWNLOAD_DIR.Exists) {
+    try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+    catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+  }
+}
+
+New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null
+
+# Download and Install Apache Maven
+Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
+Write-Verbose "Downloading from: $distributionUrl"
+Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
+
+$webclient = New-Object System.Net.WebClient
+if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) {
+  $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD)
+}
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null
+
+# If specified, validate the SHA-256 sum of the Maven distribution zip file
+$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum
+if ($distributionSha256Sum) {
+  if ($USE_MVND) {
+    Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties."
+  }
+  Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash
+  if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) {
+    Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property."
+  }
+}
+
+# unzip and move
+Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+$actualDistributionDir = ""
+
+# First try the expected directory name (for regular distributions)
+$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain"
+$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD"
+if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) {
+  $actualDistributionDir = $distributionUrlNameMain
+}
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if (!$actualDistributionDir) {
+  Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object {
+    $testPath = Join-Path $_.FullName "bin/$MVN_CMD"
+    if (Test-Path -Path $testPath -PathType Leaf) {
+      $actualDistributionDir = $_.Name
+    }
+  }
+}
+
+if (!$actualDistributionDir) {
+  Write-Error "Could not find Maven distribution directory in extracted archive"
+}
+
+Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null
+try {
+  Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
+} catch {
+  if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) {
+    Write-Error "fail to move MAVEN_HOME"
+  }
+} finally {
+  try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
+  catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
+}
+
+Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"

src/backend/pom.xml

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>3.5.7</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>com.tutoring-software</groupId>
+	<artifactId>backend</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>backend</name>
+	<description>家教软件的后端</description>
+	<url/>
+	<licenses>
+		<license/>
+	</licenses>
+	<developers>
+		<developer/>
+	</developers>
+	<scm>
+		<connection/>
+		<developerConnection/>
+		<tag/>
+		<url/>
+	</scm>
+	<properties>
+		<java.version>17</java.version>
+	</properties>
+	<dependencies>
+		<dependency>
+			<groupId>org.postgresql</groupId>
+			<artifactId>postgresql</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+		<dependency>
+			<groupId>com.baomidou</groupId>
+			<artifactId>mybatis-plus-spring-boot3-starter</artifactId>
+			<version>3.5.7</version>
+		</dependency>
+<!--		<dependency>-->
+<!--			<groupId>org.springframework.boot</groupId>-->
+<!--			<artifactId>spring-boot-starter-security</artifactId>-->
+<!--		</dependency>-->
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-validation</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-devtools</artifactId>
+			<scope>runtime</scope>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.security</groupId>
+			<artifactId>spring-security-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<!-- 添加 Apache Commons Lang 依赖 -->
+		<dependency>
+			<groupId>org.apache.commons</groupId>
+			<artifactId>commons-lang3</artifactId>
+			<version>3.18.0</version>
+		</dependency>
+		<!-- 添加 SLF4J 日志依赖 -->
+		<dependency>
+			<groupId>org.slf4j</groupId>
+			<artifactId>slf4j-api</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>ch.qos.logback</groupId>
+			<artifactId>logback-classic</artifactId>
+			<scope>runtime</scope>
+		</dependency>
+
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

src/backend/src/main/java/com/tutoring_software/backend/BackendApplication.java

@@ -0,0 +1,15 @@
+package com.tutoring_software.backend;
+
+import org.mybatis.spring.annotation.MapperScan;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+@MapperScan("com.tutoring_software.backend.uid_management.mapper")
+public class BackendApplication {
+
+	public static void main(String[] args) {
+		SpringApplication.run(BackendApplication.class, args);
+	}
+
+}

src/backend/src/main/java/com/tutoring_software/backend/CorsConfig.java

@@ -0,0 +1,31 @@
+package com.tutoring_software.backend;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+import org.springframework.web.filter.CorsFilter;
+
+@Configuration
+public class CorsConfig {
+
+    @Bean
+    public CorsFilter corsFilter() {
+        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+        CorsConfiguration config = new CorsConfiguration();
+        // 允许所有来源
+        config.addAllowedOriginPattern("*");
+        // 允许所有请求头
+        config.addAllowedHeader("*");
+        // 允许所有HTTP方法
+        config.addAllowedMethod("*");
+        // 允许携带凭证（如cookie）
+        config.setAllowCredentials(true);
+        // 设置预检请求的有效期（秒）
+        config.setMaxAge(3600L);
+
+        // 应用配置到所有路径
+        source.registerCorsConfiguration("/**", config);
+        return new CorsFilter(source);
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/HelloWorldController.java

@@ -0,0 +1,82 @@
+package com.tutoring_software.backend;
+
+import com.tutoring_software.backend.uid_management.service.PhoneNumberUidService;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class HelloWorldController {
+
+    @Autowired
+    private PhoneNumberUidService phoneNumberUidService;
+
+    private static final Logger logger = LoggerFactory.getLogger(HelloWorldController.class);
+
+    @GetMapping("/hello")
+    public String helloWorld() {
+        String phoneNumber = "133124448678";
+        Long uid = 12336633L;
+        try {
+            boolean success = phoneNumberUidService.savePhoneNumberUid(phoneNumber, uid);
+            if (success) {
+                return "保存成功: 电话号码" + phoneNumber + " 与 UID " + uid + " 已关联";
+            } else {
+                return "保存失败，请重试";
+            }
+        } catch (Exception e) {
+            logger.error("保存电话号码与UID映射关系时发生错误", e);
+            return "保存时发生错误: " + e.getMessage();
+        }
+    }
+//
+//    /**
+//     * 存储电话号码和UID的映射关系
+//     * 调用示例: POST /hello/save-phone-uid?phoneNumber=13812345678&uid=123456
+//     */
+//    @PostMapping("/hello/save-phone-uid")
+//    public String savePhoneNumberUid(@RequestParam String phoneNumber, @RequestParam Long uid) {
+//        try {
+//            boolean success = phoneNumberUidService.savePhoneNumberUid(phoneNumber, uid);
+//            if (success) {
+//                return "保存成功: 电话号码" + phoneNumber + " 与 UID " + uid + " 已关联";
+//            } else {
+//                return "保存失败，请重试";
+//            }
+//        } catch (Exception e) {
+//            return "保存时发生错误: " + e.getMessage();
+//        }
+//    }
+//
+//    /**
+//     * 根据电话号码查询对应的UID
+//     * 调用示例: GET /hello/get-uid-by-phone?phoneNumber=13812345678
+//     */
+//    @GetMapping("/hello/get-uid-by-phone")
+//    public String getUidByPhoneNumber(@RequestParam String phoneNumber) {
+//        try {
+//            return phoneNumberUidService.getByPhoneNumber(phoneNumber) != null
+//                    ? "查询结果: 电话号码" + phoneNumber + " 对应的UID是 " + phoneNumberUidService.getByPhoneNumber(phoneNumber).getUid()
+//                    : "未找到该电话号码对应的UID";
+//        } catch (Exception e) {
+//            return "查询时发生错误: " + e.getMessage();
+//        }
+//    }
+//
+//    /**
+//     * 根据UID查询对应的电话号码
+//     * 调用示例: GET /hello/get-phone-by-uid?uid=123456
+//     */
+//    @GetMapping("/hello/get-phone-by-uid")
+//    public String getPhoneByUid(@RequestParam Long uid) {
+//        try {
+//            return phoneNumberUidService.getByUid(uid) != null
+//                    ? "查询结果: UID " + uid + " 对应的电话号码是 " + phoneNumberUidService.getByUid(uid).getPhoneNumber()
+//                    : "未找到该UID对应的电话号码";
+//        } catch (Exception e) {
+//            return "查询时发生错误: " + e.getMessage();
+//        }
+//    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/BitsAllocator.java

@@ -0,0 +1,92 @@
+package com.tutoring_software.backend.uid_generate;
+
+/*这个类的基本信息
+* 用途：用于分配和管理64位UID的各个组成部分呢
+* 位分配策略：符号位(1位)->时间戳->工作节点ID->序列号
+* */
+
+import org.apache.commons.lang3.builder.ToStringBuilder;
+import org.apache.commons.lang3.builder.ToStringStyle;
+import org.springframework.util.Assert;
+
+public class BitsAllocator {
+
+    //总位数，固定为64位
+    public static final int TOTAL_BITS = 1<<6;
+
+    //符号位数，1位。时间戳位数，工作节点ID位数，序列号位数(这三个都由构造函数传入)
+    private int signBits = 1;
+    private final int timestampBits;
+    private final int workerIdBits;
+    private final int sequenceBits;
+
+    //最大值计算，最大时间戳值，最大工作节点ID值，最大序列号值
+    private final long maxDeltaSeconds;
+    private final long maxWorkerId;
+    private final long maxSequence;
+
+    //位移计算，时间戳左移位数，工作节点ID左移位数
+    private final int timestampShift;
+    private final int workerIdShift;
+
+    //构造函数
+    public BitsAllocator(int timestampBits, int workerIdBits, int sequenceBits) {
+        // 验证总位数必须等于64位
+        int allocateTotalBits = signBits + timestampBits + workerIdBits + sequenceBits;
+        Assert.isTrue(allocateTotalBits == TOTAL_BITS, "allocate not enough 64 bits");
+
+        // 初始化各部分位数
+        this.timestampBits = timestampBits;
+        this.workerIdBits = workerIdBits;
+        this.sequenceBits = sequenceBits;
+
+        // 计算各部分最大值
+        this.maxDeltaSeconds = ~(-1L << timestampBits);
+        this.maxWorkerId = ~(-1L << workerIdBits);
+        this.maxSequence = ~(-1L << sequenceBits);
+
+        // i初始化位移量
+        this.timestampShift = workerIdBits + sequenceBits;
+        this.workerIdShift = sequenceBits;
+    }
+
+    //将时间戳、工作节点、序列号组合成64位UID
+    public long allocate(long deltaSeconds, long workerId, long sequence) {
+        return (deltaSeconds << timestampShift) | (workerId << workerIdShift) | sequence;
+    }
+
+    //getter方法
+    public int getSignBits() {
+        return signBits;
+    }
+    public int getTimestampBits() {
+        return timestampBits;
+    }
+    public int getWorkerIdBits() {
+        return workerIdBits;
+    }
+    public int getSequenceBits() {
+        return sequenceBits;
+    }
+    public long getMaxDeltaSeconds() {
+        return maxDeltaSeconds;
+    }
+    public long getMaxWorkerId() {
+        return maxWorkerId;
+    }
+    public long getMaxSequence() {
+        return maxSequence;
+    }
+    public int getTimestampShift() {
+        return timestampShift;
+    }
+    public int getWorkerIdShift() {
+        return workerIdShift;
+    }
+
+    //重写toString方法()
+    @Override
+    public String toString() {
+        return ToStringBuilder.reflectionToString(this, ToStringStyle.SHORT_PREFIX_STYLE);
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/UidController.java

@@ -0,0 +1,82 @@
+package com.tutoring_software.backend.uid_generate;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import com.tutoring_software.backend.uid_generate.UidGenerator;
+import com.tutoring_software.backend.uid_generate.exception.UidGenerateException;
+
+@RestController
+@RequestMapping("/api/uid")
+public class UidController {
+    private static final Logger LOGGER = LoggerFactory.getLogger(UidController.class);
+
+    @Autowired
+    private UidGenerator uidGenerator;
+
+    /**
+     * 生成一个唯一的UID
+     */
+    @GetMapping("/generate")
+    public Result<Long> generateUid() {
+        try {
+            long uid = uidGenerator.getUID();
+            LOGGER.info("Generated UID: {}", uid);
+            return Result.success(uid);
+        } catch (UidGenerateException e) {
+            LOGGER.error("Failed to generate UID", e);
+            return Result.error("Failed to generate UID: " + e.getMessage());
+        }
+    }
+
+    /**
+     * 解析UID
+     */
+    @GetMapping("/parse")
+    public Result<String> parseUid(Long uid) {
+        if (uid == null) {
+            return Result.error("UID cannot be null");
+        }
+
+        try {
+            String parsed = uidGenerator.parseUID(uid);
+            LOGGER.info("Parsed UID: {}", parsed);
+            return Result.success(parsed);
+        } catch (Exception e) {
+            LOGGER.error("Failed to parse UID", e);
+            return Result.error("Failed to parse UID: " + e.getMessage());
+        }
+    }
+
+    // 统一响应结果封装类
+    public static class Result<T> {
+        private int code;
+        private String message;
+        private T data;
+
+        private Result(int code, String message, T data) {
+            this.code = code;
+            this.message = message;
+            this.data = data;
+        }
+
+        public static <T> Result<T> success(T data) {
+            return new Result<>(200, "Success", data);
+        }
+
+        public static <T> Result<T> error(String message) {
+            return new Result<>(500, message, null);
+        }
+
+        // Getters and setters
+        public int getCode() { return code; }
+        public void setCode(int code) { this.code = code; }
+        public String getMessage() { return message; }
+        public void setMessage(String message) { this.message = message; }
+        public T getData() { return data; }
+        public void setData(T data) { this.data = data; }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/UidGenerator.java

@@ -0,0 +1,12 @@
+package com.tutoring_software.backend.uid_generate;
+
+import com.tutoring_software.backend.uid_generate.exception.UidGenerateException;
+
+public interface UidGenerator {
+    //获取一个唯一的ID
+    long getUID() throws UidGenerateException;
+
+    //将生成的UID解析为构成元素的详细信息
+    String parseUID(long uid);
+
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/UidGeneratorConfig.java

@@ -0,0 +1,23 @@
+package com.tutoring_software.backend.uid_generate;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import com.tutoring_software.backend.uid_generate.UidGenerator;
+import com.tutoring_software.backend.uid_generate.impl.DefaultUidGenerator;
+import com.tutoring_software.backend.uid_generate.worker.WorkerIdAssigner;
+
+@Configuration
+public class UidGeneratorConfig {
+
+    @Bean
+    public UidGenerator uidGenerator(WorkerIdAssigner workerIdAssigner) {
+        DefaultUidGenerator uidGenerator = new DefaultUidGenerator();
+        uidGenerator.setWorkerIdAssigner(workerIdAssigner);
+        // 可以根据需要调整位分配策略
+        uidGenerator.setTimeBits(28);    // 时间位数
+        uidGenerator.setWorkerBits(22);  // 工作节点位数
+        uidGenerator.setSeqBits(13);     // 序列号位数
+        uidGenerator.setEpochStr("2024-01-01"); // 设置纪元时间
+        return uidGenerator;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/exception/UidGenerateException.java

@@ -0,0 +1,35 @@
+package com.tutoring_software.backend.uid_generate.exception;
+
+import java.io.Serial;
+
+public class UidGenerateException extends RuntimeException{
+    //序列化版本标识符，用于确保序列化和反序列化的版本兼容性
+    @Serial
+    private static final long serialVersionUID = -27048199131316992L;
+
+    //父类无参构造方法
+    public UidGenerateException() {
+        super();
+    }
+
+    //带错误消息和原因的构造函数
+    public UidGenerateException(String message, Throwable cause) {
+        super(message, cause);
+    }
+
+    //支持带有错误消息的构造函数
+    public UidGenerateException(String message) {
+        super(message);
+    }
+
+    //支持消息格式化的构造函数
+    public UidGenerateException(String msgFormat, Object... args) {
+        super(String.format(msgFormat, args));
+    }
+
+    //仅仅带有异常原因的构造函数
+    public UidGenerateException(Throwable cause) {
+        super(cause);
+    }
+
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/impl/DefaultUidGenerator.java

@@ -0,0 +1,162 @@
+package com.tutoring_software.backend.uid_generate.impl;
+
+import java.util.Date;
+import java.util.concurrent.TimeUnit;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.InitializingBean;
+import org.apache.commons.lang3.StringUtils;
+
+import com.tutoring_software.backend.uid_generate.UidGenerator;
+import com.tutoring_software.backend.uid_generate.exception.UidGenerateException;
+import com.tutoring_software.backend.uid_generate.BitsAllocator;
+import com.tutoring_software.backend.uid_generate.worker.WorkerIdAssigner;
+import com.tutoring_software.backend.uid_generate.utils.UidDateUtils;
+
+public class DefaultUidGenerator implements UidGenerator, InitializingBean {
+    private static final Logger LOGGER = LoggerFactory.getLogger(DefaultUidGenerator.class);
+
+    //时间位数、工作区位数、序列位数
+    protected int timeBits = 28;
+    protected int workerBits = 22;
+    protected int seqBits = 13;
+
+    //时间戳计算
+    protected String epochStr = "2016-05-20";
+    protected long epochSeconds = TimeUnit.MILLISECONDS.toSeconds(1463673600000L);
+
+    //位分配器和工作节点
+    protected BitsAllocator bitsAllocator;
+    protected long workerId;
+
+    //序列号和上次生成ID的时间戳(秒)
+    protected long sequence = 0L;
+    protected long lastSecond = -1L;
+
+    //工作节点ID分配器，Spring注入
+    protected WorkerIdAssigner workerIdAssigner;
+
+    @Override
+    public void afterPropertiesSet() throws Exception {
+        //初始化位分配器
+        bitsAllocator = new BitsAllocator(timeBits, workerBits, seqBits);
+
+        //初始化工作节点ID
+        workerId = workerIdAssigner.assignWorkerId();
+        if (workerId > bitsAllocator.getMaxWorkerId()) {
+            throw new RuntimeException("Worker id " + workerId + " exceeds the max " + bitsAllocator.getMaxWorkerId());
+        }
+
+        LOGGER.info("初始化位分配器(1, {}, {}, {}) 作为工作节点ID:{}", timeBits, workerBits, seqBits, workerId);
+    }
+
+    //重写getUID()方法，获取下一个ID
+    @Override
+    public long getUID() throws UidGenerateException {
+        try {
+            return nextId();
+        } catch (Exception e) {
+            LOGGER.error("产生唯一一个ID失败 ", e);
+            throw new UidGenerateException(e);
+        }
+    }
+    //重写parseUID()方法，解析ID
+    @Override
+    public String parseUID(long uid) {
+        long totalBits = BitsAllocator.TOTAL_BITS;
+        long signBits = bitsAllocator.getSignBits();
+        long timestampBits = bitsAllocator.getTimestampBits();
+        long workerIdBits = bitsAllocator.getWorkerIdBits();
+        long sequenceBits = bitsAllocator.getSequenceBits();
+
+        //解析UID
+        long sequence = (uid << (totalBits - sequenceBits)) >>> (totalBits - sequenceBits);
+        long workerId = (uid << (timestampBits + signBits)) >>> (totalBits - workerIdBits);
+        long deltaSeconds = uid >>> (workerIdBits + sequenceBits);
+
+        Date thatTime = new Date(TimeUnit.SECONDS.toMillis(epochSeconds + deltaSeconds));
+        String thatTimeStr = UidDateUtils.formatByDateTimePattern(thatTime);
+
+        //使用JSON格式返回解析结果
+        return String.format("{\"UID\":\"%d\",\"timestamp\":\"%s\",\"workerId\":\"%d\",\"sequence\":\"%d\"}",
+                uid, thatTimeStr, workerId, sequence);
+    }
+
+    //寻找下一个 ID
+    protected synchronized long nextId() {
+        //获取当前时间戳
+        long currentSecond = getCurrentSecond();
+        // 处理时钟回拨异常
+        if (currentSecond < lastSecond) {
+            long refusedSeconds = lastSecond - currentSecond;
+            throw new UidGenerateException("Clock moved backwards. Refusing for %d seconds", refusedSeconds);
+        }
+        // 同一秒内递增序列号，达到阈值则等待下一秒，否则重置为0
+        if (currentSecond == lastSecond) {
+            sequence = (sequence + 1) & bitsAllocator.getMaxSequence();
+            // 等待下一秒
+            if (sequence == 0) {
+                currentSecond = getNextSecond(lastSecond);
+            }
+            // 在不同的秒内，序列号重置为0
+        } else {
+            sequence = 0L;
+        }
+        lastSecond = currentSecond;
+        // 分配UID
+        return bitsAllocator.allocate(currentSecond - epochSeconds, workerId, sequence);
+    }
+
+    //获取下一个可用秒数，处理序列号溢出情况
+    private long getNextSecond(long lastTimestamp) {
+        long timestamp = getCurrentSecond();
+        while (timestamp <= lastTimestamp) {
+            timestamp = getCurrentSecond();
+        }
+        return timestamp;
+    }
+
+    //获取当前时间戳(秒)，检查是否超出时间位数限制
+    private long getCurrentSecond() {
+        long currentSecond = TimeUnit.MILLISECONDS.toSeconds(System.currentTimeMillis());
+        if (currentSecond - epochSeconds > bitsAllocator.getMaxDeltaSeconds()) {
+            throw new UidGenerateException("Timestamp bits is exhausted. Refusing UID generate. Now: " + currentSecond);
+        }
+        return currentSecond;
+    }
+
+    //设置工作节点ID分配器
+    public void setWorkerIdAssigner(WorkerIdAssigner workerIdAssigner) {
+        this.workerIdAssigner = workerIdAssigner;
+    }
+
+    //设置时间位数
+    public void setTimeBits(int timeBits) {
+        if (timeBits > 0) {
+            this.timeBits = timeBits;
+        }
+    }
+
+    //设置工作节点位数
+    public void setWorkerBits(int workerBits) {
+        if (workerBits > 0) {
+            this.workerBits = workerBits;
+        }
+    }
+
+    //设置序列号位数
+    public void setSeqBits(int seqBits) {
+        if (seqBits > 0) {
+            this.seqBits = seqBits;
+        }
+    }
+
+    //设置纪元时间字符串
+    public void setEpochStr(String epochStr) {
+        if (StringUtils.isNotBlank(epochStr)) {
+            this.epochStr = epochStr;
+            this.epochSeconds = TimeUnit.MILLISECONDS.toSeconds(UidDateUtils.parseByDayPattern(epochStr).getTime());
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/utils/UidDateUtils.java

@@ -0,0 +1,56 @@
+package com.tutoring_software.backend.uid_generate.utils;
+
+import java.text.ParseException;
+import java.util.Calendar;
+import java.util.Date;
+
+import org.apache.commons.lang3.time.DateFormatUtils;
+import org.apache.commons.lang3.time.DateUtils;
+
+
+public abstract class UidDateUtils {
+
+    public static final String DAY_PATTERN = "yyyy-MM-dd";
+    public static final String DATETIME_PATTERN = "yyyy-MM-dd HH:mm:ss";
+    public static final String DATETIME_MS_PATTERN = "yyyy-MM-dd HH:mm:ss.SSS";
+
+    public static final Date DEFAULT_DATE = UidDateUtils.parseByDayPattern("1970-01-01");
+
+    public static Date parseByDayPattern(String str) {
+        return parseDate(str, DAY_PATTERN);
+    }
+
+    public static Date parseByDateTimePattern(String str) {
+        return parseDate(str, DATETIME_PATTERN);
+    }
+
+    public static Date parseDate(String str, String pattern) {
+        try {
+            return DateUtils.parseDate(str, new String[]{pattern});
+        } catch (ParseException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    public static String formatDate(Date date, String pattern) {
+        return DateFormatUtils.format(date, pattern);
+    }
+
+    public static String formatByDayPattern(Date date) {
+        if (date != null) {
+            return DateFormatUtils.format(date, DAY_PATTERN);
+        } else {
+            return null;
+        }
+    }
+
+    public static String formatByDateTimePattern(Date date) {
+        return DateFormatUtils.format(date, DATETIME_PATTERN);
+    }
+
+    public static String getCurrentDayByDayPattern() {
+        Calendar cal = Calendar.getInstance();
+        return formatByDayPattern(cal.getTime());
+    }
+
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/worker/WorkerIdAssigner.java

@@ -0,0 +1,5 @@
+package com.tutoring_software.backend.uid_generate.worker;
+
+public interface WorkerIdAssigner {
+    long assignWorkerId();
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_generate/worker/entity/DefaultWorkerIdAssigner.java

@@ -0,0 +1,21 @@
+package com.tutoring_software.backend.uid_generate.worker.entity;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Component;
+
+import com.tutoring_software.backend.uid_generate.worker.WorkerIdAssigner;
+
+@Component
+public class DefaultWorkerIdAssigner implements WorkerIdAssigner {
+    private static final Logger LOGGER = LoggerFactory.getLogger(DefaultWorkerIdAssigner.class);
+
+    // 固定的工作节点ID，单机环境下可以使用固定值
+    private static final long WORKER_ID = 1L;
+
+    @Override
+    public long assignWorkerId() {
+        LOGGER.info("Assigned worker ID: {}", WORKER_ID);
+        return WORKER_ID;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/Result.java

@@ -0,0 +1,32 @@
+package com.tutoring_software.backend.uid_management;
+
+/**
+ * 统一响应结果封装类
+ */
+public class Result<T> {
+    private int code;
+    private String message;
+    private T data;
+
+    private Result(int code, String message, T data) {
+        this.code = code;
+        this.message = message;
+        this.data = data;
+    }
+
+    public static <T> Result<T> success(T data) {
+        return new Result<>(200, "Success", data);
+    }
+
+    public static <T> Result<T> error(String message) {
+        return new Result<>(500, message, null);
+    }
+
+    // Getters and Setters
+    public int getCode() { return code; }
+    public void setCode(int code) { this.code = code; }
+    public String getMessage() { return message; }
+    public void setMessage(String message) { this.message = message; }
+    public T getData() { return data; }
+    public void setData(T data) { this.data = data; }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/CommentItemController.java

@@ -0,0 +1,103 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import com.tutoring_software.backend.uid_management.entity.CommentItem;
+import com.tutoring_software.backend.uid_management.entity.Teacher;
+import com.tutoring_software.backend.uid_management.service.CommentItemService;
+import com.tutoring_software.backend.uid_management.service.TeacherService;
+import com.tutoring_software.backend.uid_management.Result;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.time.LocalDateTime;
+
+/**
+ * 评论控制器
+ */
+@RestController
+@RequestMapping("/api/comment")
+public class CommentItemController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(CommentItemController.class);
+
+    @Autowired
+    private CommentItemService commentItemService;
+
+    @Autowired
+    private TeacherService teacherService;
+
+    /**
+     * 根据老师UID获取评论列表
+     */
+    @GetMapping("/teacher/{teacherUid}")
+    public Result<List<CommentItem>> getCommentsByTeacher(@PathVariable Long teacherUid) {
+        LOGGER.info("需要查询老师{}的评论列表", teacherUid);
+        try {
+            List<CommentItem> result = commentItemService.getCommentsByTeacherUid(teacherUid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("No comments found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting comments by teacher UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    /**
+     * 根据学生UID获取评论列表
+     */
+    @GetMapping("/student/{studentUid}")
+    public Result<List<CommentItem>> getCommentsByStudent(@PathVariable Long studentUid) {
+        LOGGER.info("需要查询学生{}的评论列表", studentUid);
+        try {
+            List<CommentItem> result = commentItemService.getCommentsByStudentUid(studentUid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("No comments found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting comments by student UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    /**
+     * 保存评论
+     */
+    @PostMapping("/save")
+    public Result<String> saveComment(@RequestBody CommentItem commentItem) {
+        LOGGER.info("保存评论: 学生{} 评论老师{}", commentItem.getStudentUid(), commentItem.getTeacherUid());
+        try {
+            // 设置创建时间
+            if (commentItem.getCreatedAt() == null) {
+                commentItem.setCreatedAt(LocalDateTime.now());
+            }
+            boolean success = commentItemService.saveComment(commentItem);
+            if (success) {
+                LOGGER.info("成功保存评论: 学生{} 评论老师{}", commentItem.getStudentUid(), commentItem.getTeacherUid());
+                // 更新老师的评论数
+                Teacher teacher = teacherService.getByTeacherUid(commentItem.getTeacherUid());
+                if (teacher != null) {
+                    double commentRating = Double.parseDouble(commentItem.getRating());
+                    double currentRating = teacher.getRating();
+                    double newRating = (currentRating * teacher.getComments() + commentRating)
+                            / (teacher.getComments() + 1);
+                    int newComments = teacher.getComments() + 1;
+                    teacherService.updateTeacher(commentItem.getTeacherUid(), newRating, newComments);
+                }
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving comment", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/EmailUidController.java

@@ -0,0 +1,126 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import com.tutoring_software.backend.uid_management.Result;
+import com.tutoring_software.backend.uid_management.entity.EmailUid;
+import com.tutoring_software.backend.uid_management.service.EmailUidService;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/email-uid")
+public class EmailUidController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(EmailUidController.class);
+
+    @Autowired
+    private EmailUidService emailUidService;
+
+    @GetMapping("/by-email/{email}")
+    public Result<EmailUid> getByEmail(@PathVariable String email) {
+        try {
+            EmailUid result = emailUidService.getByEmail(email);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("Email not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by email", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @GetMapping("/by-uid/{uid}")
+    public Result<EmailUid> getByUid(@PathVariable Long uid) {
+        try {
+            EmailUid result = emailUidService.getByUid(uid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PostMapping
+    public Result<EmailUid> save(@RequestBody EmailUid emailUid) {
+        try {
+            boolean success = emailUidService.saveEmailUid(emailUid.getEmail(), emailUid.getUid());
+            if (success) {
+                return Result.success(emailUid);
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving email UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PostMapping("/save")
+    public Result<EmailUid> saveEmailUid(@RequestParam String email, @RequestParam Long uid) {
+        try {
+            boolean success = emailUidService.saveEmailUid(email, uid);
+            if (success) {
+                // 打印成功信息
+                LOGGER.info("Successfully saved EmailUid: email={}, uid={}", email, uid);
+                return Result.success(new EmailUid(email, uid));
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving email UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PutMapping
+    public Result<String> updateEmailUid(@RequestParam String email, @RequestParam Long uid) {
+        try {
+            boolean success = emailUidService.updateByEmail(email, uid);
+            if (success) {
+                return Result.success("Update successful");
+            } else {
+                return Result.error("Update failed or email not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error updating email UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @DeleteMapping("/delete/email/{email}")
+    public Result<String> deleteByEmail(@PathVariable String email) {
+        try {
+            boolean success = emailUidService.deleteByEmail(email);
+            if (success) {
+                return Result.success("Delete successful");
+            } else {
+                return Result.error("Delete failed or email not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error deleting by email", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @DeleteMapping("/delete/uid/{uid}")
+    public Result<String> deleteByUid(@PathVariable Long uid) {
+        try {
+            boolean success = emailUidService.deleteByUid(uid);
+            if (success) {
+                return Result.success("Delete successful");
+            } else {
+                return Result.error("Delete failed or UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error deleting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/PhoneNumberUidController.java

@@ -0,0 +1,112 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import com.tutoring_software.backend.uid_management.entity.PhoneNumberUid;
+import com.tutoring_software.backend.uid_management.service.PhoneNumberUidService;
+import com.tutoring_software.backend.uid_management.Result;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/phone-uid")
+public class PhoneNumberUidController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(PhoneNumberUidController.class);
+
+    @Autowired
+    private PhoneNumberUidService phoneNumberUidService;
+
+    @GetMapping("/by-phone/{phoneNumber}")
+    public Result<PhoneNumberUid> getByPhoneNumber(@PathVariable String phoneNumber) {
+        try {
+            PhoneNumberUid result = phoneNumberUidService.getByPhoneNumber(phoneNumber);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("Phone number not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by phone number", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @GetMapping("/by-uid/{uid}")
+    public Result<PhoneNumberUid> getByUid(@PathVariable Long uid) {
+        try {
+            PhoneNumberUid result = phoneNumberUidService.getByUid(uid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PostMapping("/save")
+    public Result<String> savePhoneNumberUid(@RequestParam String phoneNumber, @RequestParam Long uid) {
+        try {
+            boolean success = phoneNumberUidService.savePhoneNumberUid(phoneNumber, uid);
+            if (success) {
+                // 打印成功信息
+                LOGGER.info("Successfully saved PhoneNumberUid: phoneNumber={}, uid={}", phoneNumber, uid);
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving phone number UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PutMapping
+    public Result<String> updatePhoneNumberUid(@RequestParam String phoneNumber, @RequestParam Long uid) {
+        try {
+            boolean success = phoneNumberUidService.updateByPhoneNumber(phoneNumber, uid);
+            if (success) {
+                return Result.success("Update successful");
+            } else {
+                return Result.error("Update failed or phone number not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error updating phone number UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @DeleteMapping("/delete/phone/{phoneNumber}")
+    public Result<String> deleteByPhoneNumber(@PathVariable String phoneNumber) {
+        try {
+            boolean success = phoneNumberUidService.deleteByPhoneNumber(phoneNumber);
+            if (success) {
+                return Result.success("Delete successful");
+            } else {
+                return Result.error("Delete failed or phone number not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error deleting by phone number", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @DeleteMapping("/delete/uid/{uid}")
+    public Result<String> deleteByUid(@PathVariable Long uid) {
+        try {
+            boolean success = phoneNumberUidService.deleteByUid(uid);
+            if (success) {
+                return Result.success("Delete successful");
+            } else {
+                return Result.error("Delete failed or UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error deleting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/TSRelationshipController.java

@@ -0,0 +1,129 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import java.util.List;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.tutoring_software.backend.uid_management.Result;
+import com.tutoring_software.backend.uid_management.entity.TSRelationship;
+import com.tutoring_software.backend.uid_management.service.TSRelationshipService;
+
+/**
+ * 师生关系控制器
+ */
+@RestController
+@RequestMapping("/api/ts-relationship")
+public class TSRelationshipController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(TSRelationshipController.class);
+
+    @Autowired
+    private TSRelationshipService tsRelationshipService;
+    
+    /**
+     * 根据学生UID获取师生关系列表
+     */
+    @GetMapping("/student/{studentUid}")
+    public Result<List<TSRelationship>> getRelationshipsByStudent(@PathVariable Long studentUid) {
+        LOGGER.info("需要查询学生{}的师生关系列表", studentUid);
+        try {
+            List<TSRelationship> result = tsRelationshipService.selectByStudentUid(studentUid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("No relationships found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting relationships by student UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+    
+    /**
+     * 根据老师UID获取师生关系列表
+     */
+    @GetMapping("/teacher/{teacherUid}")
+    public Result<List<TSRelationship>> getRelationshipsByTeacher(@PathVariable Long teacherUid) {
+        LOGGER.info("需要查询老师{}的师生关系列表", teacherUid);
+        try {
+            List<TSRelationship> result = tsRelationshipService.selectByTeacherUid(teacherUid);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("No relationships found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting relationships by teacher UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+    
+    /**
+     * 根据学生UID和老师UID查询特定师生关系
+     */
+    @GetMapping("/check")
+    public Result<TSRelationship> checkRelationship(@RequestParam Long studentUid, @RequestParam Long teacherUid) {
+        LOGGER.info("检查学生{}和老师{}的关系", studentUid, teacherUid);
+        try {
+            TSRelationship relationship = tsRelationshipService.selectByStudentAndTeacherUid(studentUid, teacherUid);
+            if (relationship != null) {
+                return Result.success(relationship);
+            } else {
+                return Result.error("Relationship not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error checking relationship", e);
+            return Result.error("Internal server error");
+        }
+    }
+    
+    /**
+     * 保存师生关系
+     */
+    @PostMapping("/save")
+    public Result<String> saveRelationship(@RequestBody TSRelationship tsRelationship) {
+        LOGGER.info("保存师生关系: 学生{} 和老师{}", tsRelationship.getStudentUid(), tsRelationship.getTeacherUid());
+        try {
+            boolean success = tsRelationshipService.saveRelationship(tsRelationship);
+            if (success) {
+                LOGGER.info("成功保存师生关系: 学生{} 和老师{}", tsRelationship.getStudentUid(), tsRelationship.getTeacherUid());
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving relationship", e);
+            return Result.error("Internal server error");
+        }
+    }
+    
+    /**
+     * 删除师生关系
+     */
+    @DeleteMapping("/delete")
+    public Result<String> deleteRelationship(@RequestParam Long studentUid, @RequestParam Long teacherUid) {
+        LOGGER.info("删除师生关系: 学生{} 和老师{}", studentUid, teacherUid);
+        try {
+            boolean success = tsRelationshipService.deleteRelationship(studentUid, teacherUid);
+            if (success) {
+                LOGGER.info("成功删除师生关系: 学生{} 和老师{}", studentUid, teacherUid);
+                return Result.success("Delete successful");
+            } else {
+                return Result.error("Delete failed or relationship not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error deleting relationship", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/TeacherInfoController.java

@@ -0,0 +1,462 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.tutoring_software.backend.uid_management.Result;
+import com.tutoring_software.backend.uid_management.entity.Teacher;
+import com.tutoring_software.backend.uid_management.entity.TeacherCourse;
+import com.tutoring_software.backend.uid_management.service.TeacherCourseService;
+import com.tutoring_software.backend.uid_management.service.TeacherService;
+
+@RestController
+@RequestMapping("/api/teacher_info")
+public class TeacherInfoController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(TeacherInfoController.class);
+
+    @Autowired
+    private TeacherService teacherService;
+
+    @Autowired
+    private TeacherCourseService teacherCourseService;
+
+    /**
+     * 根据用户选择的条件查询老师列表
+     *
+     * @param request 包含查询条件的请求体
+     * @return 符合条件的老师列表
+     */
+    @PostMapping("/search")
+    public Result<List<TeacherInfo>> searchTeachers(@RequestBody Map<String, Object> request) {
+        // 用来存储老师信息的列表
+        List<TeacherInfo> result = new ArrayList<>();
+        try {
+            LOGGER.info("开始根据条件查询老师信息: {}", request);
+
+            // 1. 提取查询条件 - 修改subjects的处理逻辑，确保正确接收Map<String,String>类型
+            Map<String, String> subjects = new HashMap<>();
+            if (request.get("subjects") instanceof Map) {
+                subjects = (Map<String, String>) request.get("subjects");
+            }
+
+            Double minRating = 0.0;
+            if (request.get("minRating") != null) {
+                try {
+                    minRating = Double.parseDouble(request.get("minRating").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.warn("评分格式无效: {}", request.get("minRating"));
+                }
+            }
+            Integer minComments = 0;
+            if (request.get("minComments") != null) {
+                try {
+                    minComments = Integer.parseInt(request.get("minComments").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.warn("评论数格式无效: {}", request.get("minComments"));
+                }
+            }
+
+            Integer maxComments = null;
+            if (request.get("maxComments") != null) {
+                try {
+                    maxComments = Integer.parseInt(request.get("maxComments").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.warn("最大评论数格式无效: {}", request.get("maxComments"));
+                }
+            }
+
+            // 2. 获取符合条件的老师列表
+            List<Teacher> filteredTeachers = new ArrayList<>();
+
+            // 根据评分和评论数阈值过滤
+            if (minRating != null && minComments != null) {
+                // 先按评分过滤，再对结果按评论数过滤
+                List<Teacher> ratingFiltered = teacherService.getByRatingGreaterThan(minRating);
+                if (maxComments == null) {
+                    for (Teacher teacher : ratingFiltered) {
+                        if (teacher.getComments() >= minComments) {
+                            filteredTeachers.add(teacher);
+                        }
+                    }
+                } else {
+                    for (Teacher teacher : ratingFiltered) {
+                        if (teacher.getComments() >= minComments && teacher.getComments() <= maxComments) {
+                            filteredTeachers.add(teacher);
+                        }
+                    }
+                }
+            } else if (minRating != null && maxComments != null) {
+                filteredTeachers = teacherService.getByCommentsBetween(minComments, maxComments);
+            } else {
+                filteredTeachers = teacherService.getByRatingGreaterThan(minRating);
+            }
+
+            // 3. 根据教学科目进一步过滤
+            List<Teacher> finalFilteredTeachers = new ArrayList<>();
+            if (!subjects.isEmpty()) {
+                for (Teacher teacher : filteredTeachers) {
+                    TeacherCourse teacherCourse = teacherCourseService.getByTeacherUid(teacher.getTeacherUid());
+                    if (teacherCourse != null && subjects.containsValue(teacherCourse.getSubject())) {
+                        finalFilteredTeachers.add(teacher);
+                    }
+                }
+            } else {
+                finalFilteredTeachers = filteredTeachers;
+            }
+
+            // 4. 组装返回数据
+            for (Teacher teacher : finalFilteredTeachers) {
+                // 处理老师可能教授多个学科的情况，确保每个老师只出现一次
+                boolean teacherExists = false;
+                TeacherInfo existingTeacherInfo = null;
+
+                // 查找是否已存在该老师
+                for (TeacherInfo ti : result) {
+                    if (ti.getTeacherUid().equals(teacher.getTeacherUid())) {
+                        teacherExists = true;
+                        existingTeacherInfo = ti;
+                        break;
+                    }
+                }
+                // 获取当前老师的学科信息
+                TeacherCourse teacherCourse = teacherCourseService.getByTeacherUid(teacher.getTeacherUid());
+                String subject = (teacherCourse != null) ? teacherCourse.getSubject() : null;
+
+                if (teacherExists && existingTeacherInfo != null) {
+                    // 老师已存在，检查是否需要添加新学科
+                    List<String> existingSubjects = existingTeacherInfo.getSubjects();
+                    if (subject != null && !existingSubjects.contains(subject)) {
+                        existingSubjects.add(subject);
+                        // 更新学科匹配数量
+                        if (subjects.containsValue(subject)) {
+                            existingTeacherInfo.setSubjectMatchCount(existingTeacherInfo.getSubjectMatchCount() + 1);
+                        }
+                    }
+                } else {
+                    // 老师不存在，创建新的TeacherInfo对象
+                    TeacherInfo newTeacherInfo = new TeacherInfo();
+                    newTeacherInfo.setTeacherUid(teacher.getTeacherUid());
+                    newTeacherInfo.setRating(teacher.getRating());
+                    newTeacherInfo.setComments(teacher.getComments());
+
+                    // 初始化学科列表并添加当前学科
+                    List<String> teacherSubjects = new ArrayList<>();
+                    if (subject != null) {
+                        teacherSubjects.add(subject);
+                    }
+                    newTeacherInfo.setSubjects(teacherSubjects);
+
+                    // 设置科目匹配数量
+                    int matchCount = (subject != null && subjects.containsValue(subject)) ? 1 : 0;
+                    newTeacherInfo.setSubjectMatchCount(matchCount);
+
+                    result.add(newTeacherInfo);
+                }
+            }
+            LOGGER.info("查询完成，共找到{}位符合条件的老师", result.size());
+            return Result.success(result);
+        } catch (Exception e) {
+            LOGGER.error("查询老师信息失败", e);
+            return Result.error("查询老师信息失败：" + e.getMessage());
+        }
+    }
+
+    @PostMapping("/register")
+    public Result<String> registerTeacher(@RequestBody Map<String, Object> request) {
+        try {
+            LOGGER.info("开始存储老师注册信息: {}", request);
+
+            // 1. 提取请求参数
+            Long teacherUid = null;
+            // String subjectCode = null;
+            Map<String, String> subjects = new HashMap<>();
+
+            if (request.get("teacherUid") != null) {
+                try {
+                    teacherUid = Long.parseLong(request.get("teacherUid").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.error("老师UID格式无效: {}", request.get("teacherUid"));
+                    return Result.error("老师UID格式无效");
+                }
+            }
+
+            // 修改为处理Map类型的subjects
+            if (request.get("subjects") != null) {
+                try {
+                    // 假设传入的subjects是一个Map<String, String>，其中key为学科ID，value为学科名称
+                    Object subjectsObj = request.get("subjects");
+                    if (subjectsObj instanceof Map) {
+                        subjects = (Map<String, String>) subjectsObj;
+                    } else {
+                        LOGGER.error("学科信息格式不正确，应为Map类型");
+                        return Result.error("学科信息格式不正确，应为Map类型");
+                    }
+                } catch (Exception e) {
+                    LOGGER.error("解析学科信息失败: {}", e.getMessage());
+                    return Result.error("解析学科信息失败");
+                }
+            }
+
+            // 2. 参数校验
+            if (teacherUid == null) {
+                LOGGER.error("老师UID不能为空");
+                return Result.error("老师UID不能为空");
+            }
+
+            if (subjects.isEmpty()) {
+                LOGGER.error("至少需要选择一个学科");
+                return Result.error("至少需要选择一个学科");
+            }
+
+            // 3. 存储老师基本信息到teachers表（只需要存储一次）
+            // 保存老师信息：teacherUid, 初始评分0.0, 初始评论数0
+            boolean teacherSaved = teacherService.saveTeacher(teacherUid, 0.0, 0);
+            if (!teacherSaved) {
+                LOGGER.error("保存老师基本信息失败，teacherUid: {}", teacherUid);
+                return Result.error("保存老师基本信息失败");
+            }
+
+            // 4. 遍历所有学科，存储老师课程信息到teachers_courses表
+            boolean allCoursesSaved = true;
+            StringBuilder failedSubjects = new StringBuilder();
+
+            for (Map.Entry<String, String> entry : subjects.entrySet()) {
+                String subjectCode = entry.getKey();
+
+                boolean courseSaved = teacherCourseService.saveTeacherCourse(teacherUid, subjectCode);
+                if (!courseSaved) {
+                    allCoursesSaved = false;
+                    failedSubjects.append(subjectCode).append(", ");
+                    LOGGER.error("保存老师课程信息失败，teacherUid: {}, subjectCode: {}", teacherUid, subjectCode);
+                }
+            }
+
+            if (!allCoursesSaved) {
+                LOGGER.error("部分课程信息保存失败，失败的学科代码: {}", failedSubjects.toString());
+                return Result.error("部分课程信息保存失败: " + failedSubjects.toString());
+            }
+
+            LOGGER.info("老师注册信息存储成功，teacherUid: {}, 学科数量: {}", teacherUid, subjects.size());
+            return Result.success("老师注册信息存储成功");
+        } catch (Exception e) {
+            LOGGER.error("存储老师注册信息失败", e);
+            return Result.error("存储老师注册信息失败：" + e.getMessage());
+        }
+    }
+
+    // 当老师修改了自己的教学选课信息的时候，要更新teachers_courses表
+    /**
+     * 更新老师课程信息
+     *
+     * @param request 包含老师UID和新学科信息的请求体
+     * @return 操作结果
+     */
+    @PostMapping("/updateCourses")
+    public Result<String> updateTeacherCourses(@RequestBody Map<String, Object> request) {
+        try {
+            LOGGER.info("开始更新老师课程信息: {}", request);
+
+            // 1. 提取请求参数
+            Long teacherUid = null;
+            Map<String, String> subjects = new HashMap<>();
+
+            if (request.get("teacherUid") != null) {
+                try {
+                    teacherUid = Long.parseLong(request.get("teacherUid").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.error("老师UID格式无效: {}", request.get("teacherUid"));
+                    return Result.error("老师UID格式无效");
+                }
+            }
+
+            // 获取学科信息
+            if (request.get("subjects") != null) {
+                try {
+                    Object subjectsObj = request.get("subjects");
+                    if (subjectsObj instanceof Map) {
+                        subjects = (Map<String, String>) subjectsObj;
+                    } else {
+                        LOGGER.error("学科信息格式不正确，应为Map类型");
+                        return Result.error("学科信息格式不正确，应为Map类型");
+                    }
+                } catch (Exception e) {
+                    LOGGER.error("解析学科信息失败: {}", e.getMessage());
+                    return Result.error("解析学科信息失败");
+                }
+            }
+
+            // 2. 参数校验
+            if (teacherUid == null) {
+                LOGGER.error("老师UID不能为空");
+                return Result.error("老师UID不能为空");
+            }
+
+            if (subjects.isEmpty()) {
+                LOGGER.error("至少需要选择一个学科");
+                return Result.error("至少需要选择一个学科");
+            }
+
+            // 3. 先删除老师现有的所有课程信息
+            boolean coursesDeleted = teacherCourseService.deleteTeacherCourse(teacherUid);
+            if (!coursesDeleted) {
+                LOGGER.error("删除老师原有课程信息失败，teacherUid: {}", teacherUid);
+                // 即使删除失败也继续尝试添加新课程，因为可能是因为课程不存在
+            }
+
+            // 4. 遍历所有学科，更新老师课程信息
+            boolean allCoursesUpdated = true;
+            StringBuilder failedSubjects = new StringBuilder();
+            for (Map.Entry<String, String> entry : subjects.entrySet()) {
+                String subjectCode = entry.getKey();
+
+                boolean courseSaved = teacherCourseService.saveTeacherCourse(teacherUid, subjectCode);
+                if (!courseSaved) {
+                    allCoursesUpdated = false;
+                    failedSubjects.append(subjectCode).append(", ");
+                    LOGGER.error("更新老师课程信息失败，teacherUid: {}, subjectCode: {}", teacherUid, subjectCode);
+                }
+            }
+
+            if (!allCoursesUpdated) {
+                LOGGER.error("部分课程信息更新失败，失败的学科代码: {}", failedSubjects.toString());
+                return Result.error("部分课程信息更新失败: " + failedSubjects.toString());
+            }
+
+            LOGGER.info("老师课程信息更新成功，teacherUid: {}, 学科数量: {}", teacherUid, subjects.size());
+            return Result.success("老师课程信息更新成功");
+        } catch (Exception e) {
+            LOGGER.error("更新老师课程信息失败", e);
+            return Result.error("更新老师课程信息失败：" + e.getMessage());
+        }
+    }
+
+    // 删除老师信息
+    /**
+     * 删除老师信息
+     *
+     * @param request 包含老师UID的请求体
+     * @return 操作结果
+     */
+    @DeleteMapping("/delete")
+    public Result<String> deleteTeacher(@RequestBody Map<String, Object> request) {
+        try {
+            LOGGER.info("开始删除老师信息: {}", request);
+
+            // 1. 提取请求参数
+            Long teacherUid = null;
+            if (request.get("teacherUid") != null) {
+                try {
+                    teacherUid = Long.parseLong(request.get("teacherUid").toString());
+                } catch (NumberFormatException e) {
+                    LOGGER.error("老师UID格式无效: {}", request.get("teacherUid"));
+                    return Result.error("老师UID格式无效");
+                }
+            }
+
+            // 2. 参数校验
+            if (teacherUid == null) {
+                LOGGER.error("老师UID不能为空");
+                return Result.error("老师UID不能为空");
+            }
+
+            // 3. 先删除老师的课程信息
+            teacherCourseService.deleteTeacherCourse(teacherUid);
+            // 即使课程信息不存在，也继续删除老师基本信息
+
+            // 4. 再删除老师基本信息
+            boolean teacherDeleted = teacherService.deleteTeacher(teacherUid);
+
+            if (teacherDeleted) {
+                LOGGER.info("删除老师信息成功，teacherUid: {}", teacherUid);
+                return Result.success("删除老师信息成功");
+            } else {
+                LOGGER.error("删除老师基本信息失败，teacherUid: {}", teacherUid);
+                return Result.error("删除老师信息失败");
+            }
+        } catch (Exception e) {
+            LOGGER.error("删除老师信息异常", e);
+            return Result.error("删除老师信息失败：" + e.getMessage());
+        }
+    }
+
+    // 老师信息的存储
+    // @PostMapping("/save")
+    /**
+     * 老师信息内部类 用于表示老师的详细信息
+     */
+    public static class TeacherInfo {
+
+        private Long teacherUid; // 老师uid
+        private double rating = 0.0; // 老师评分
+        private int comments = 0; // 老师评价数量
+        private List<String> subjects = new ArrayList<>(); // 老师选择的学科
+        private int subjectMatchCount = 0; // 老师选择学科对口数量
+
+        // 无参构造函数
+        public TeacherInfo() {
+        }
+
+        // 全参构造函数
+        public TeacherInfo(Long teacherUid, double rating, int comments, List<String> subjects, int subjectMatchCount) {
+            this.teacherUid = teacherUid;
+            this.rating = rating;
+            this.comments = comments;
+            this.subjects = subjects;
+            this.subjectMatchCount = subjectMatchCount;
+        }
+
+        // getter和setter方法
+        public Long getTeacherUid() {
+            return teacherUid;
+        }
+
+        public void setTeacherUid(Long teacherUid) {
+            this.teacherUid = teacherUid;
+        }
+
+        public double getRating() {
+            return rating;
+        }
+
+        public void setRating(double rating) {
+            this.rating = rating;
+        }
+
+        public int getComments() {
+            return comments;
+        }
+
+        public void setComments(int comments) {
+            this.comments = comments;
+        }
+
+        public List<String> getSubjects() {
+            return subjects;
+        }
+
+        public void setSubjects(List<String> subjects) {
+            this.subjects = subjects;
+        }
+
+        public int getSubjectMatchCount() {
+            return subjectMatchCount;
+        }
+
+        public void setSubjectMatchCount(int subjectMatchCount) {
+            this.subjectMatchCount = subjectMatchCount;
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/UserAvatarsController.java

@@ -0,0 +1,82 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import com.tutoring_software.backend.uid_management.Result;
+import com.tutoring_software.backend.uid_management.entity.UserAvatars;
+import com.tutoring_software.backend.uid_management.service.UserAvatarsService;
+
+@RestController
+@RequestMapping("/api/user-avatars")
+public class UserAvatarsController {
+    private static final Logger LOGGER = LoggerFactory.getLogger(UserAvatarsController.class);
+
+    @Autowired
+    private UserAvatarsService userAvatarsService;
+
+    @GetMapping("/get/{uid}")
+    public Result<UserAvatars> getByUid(@PathVariable String uid) {
+        // 把uid转换为Long类型
+        Long uidLong = Long.parseLong(uid);
+        LOGGER.info("需要查询的uid为:{}", uidLong);
+        try {
+            UserAvatars result = userAvatarsService.getByUid(uidLong);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    // 存储头像数据
+    @PostMapping("/save")
+    public Result<String> saveUserAvatars(@RequestBody UserAvatars userAvatars) {
+        try {
+            // 首先检查用户是否已存在
+            UserAvatars existingUser = userAvatarsService.getByUid(userAvatars.getUid());
+            if (existingUser != null) {
+                LOGGER.error("用户{}已存在，保存失败", userAvatars.getUid());
+                return Result.error("User already exists"); // 返回明确的用户已存在错误
+            }
+            boolean success = userAvatarsService.saveUserAvatars(
+                    userAvatars.getUid(), userAvatars.getImageData(),
+                    userAvatars.getMimeType());
+            if (success) {
+                LOGGER.info("成功存储数据:uid={}", userAvatars.getUid());
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving user avatar", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    // 更新头像数据
+    @PutMapping("/update")
+    public Result<String> updateUserAvatars(@RequestBody UserAvatars userAvatars) {
+        try {
+            boolean success = userAvatarsService.updateUserAvatars(
+                    userAvatars.getUid(), userAvatars.getImageData(),
+                    userAvatars.getMimeType());
+            if (success) {
+                LOGGER.info("成功更新用户{}的头像", userAvatars.getUid());
+                return Result.success("Update successful");
+            } else {
+                LOGGER.warn("更新用户{}头像失败，用户不存在", userAvatars.getUid());
+                return Result.error("User not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error updating user avatar", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/UserDataItemController.java

@@ -0,0 +1,95 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import com.tutoring_software.backend.uid_management.Result;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import com.tutoring_software.backend.uid_management.entity.UserDataItem;
+import com.tutoring_software.backend.uid_management.service.UserDataItemService;
+
+@RestController
+@RequestMapping("/api/user-data-item")
+public class UserDataItemController {
+
+    private static final Logger LOGGER = LoggerFactory.getLogger(UserDataItemController.class);
+
+    @Autowired
+    private UserDataItemService userDataItemService;
+
+    @GetMapping("/get/{uid}")
+    public Result<UserDataItem> getByUid(@PathVariable String uid) {
+        // 把uid转换为Long类型
+        Long uidLong = Long.parseLong(uid);
+        LOGGER.info("需要查询的uid为:{}", uidLong);
+        try {
+            UserDataItem result = userDataItemService.getByUid(uidLong);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PostMapping("/save")
+    public Result<String> saveUserDataItem(@RequestBody UserDataItem userDataItem) {
+        try {
+            // 首先检查用户是否已存在
+            UserDataItem existingUser = userDataItemService.getByUid(userDataItem.getUid());
+            if (existingUser != null) {
+                LOGGER.error("用户{}已存在，保存失败", userDataItem.getUid());
+                return Result.error("User already exists"); // 返回明确的用户已存在错误
+            }
+            boolean success = userDataItemService.saveUserDataItem(
+                    userDataItem.getUid(), userDataItem.getUsername(),
+                    userDataItem.getPhoneNumber(), userDataItem.getEmail(),
+                    userDataItem.getBirthday(), userDataItem.getRole(),
+                    userDataItem.getGender(), userDataItem.getPassword(),
+                    userDataItem.getTeachingSubjects(), userDataItem.getLearningSubjects());
+            if (success) {
+                LOGGER.info("成功存储数据:uid={},username={}", userDataItem.getUid(), userDataItem.getUsername());
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving user data item", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    @PutMapping("/update")
+    public Result<String> updateUserDataItem(@RequestBody UserDataItem userDataItem) {
+        try {
+            // 检查用户是否存在
+            UserDataItem existingUser = userDataItemService.getByUid(userDataItem.getUid());
+            if (existingUser == null) {
+                LOGGER.error("用户{}不存在，更新失败", userDataItem.getUid());
+                return Result.error("User not found");
+            }
+
+            boolean success = userDataItemService.updateUserDataItem(
+                    userDataItem.getUid(), userDataItem.getUsername(),
+                    userDataItem.getPhoneNumber(), userDataItem.getEmail(),
+                    userDataItem.getBirthday(), userDataItem.getRole(),
+                    userDataItem.getGender(), userDataItem.getPassword(),
+                    userDataItem.getTeachingSubjects(), userDataItem.getLearningSubjects());
+
+            if (success) {
+                LOGGER.info("成功更新用户数据:uid={},username={}", userDataItem.getUid(), userDataItem.getUsername());
+                return Result.success("Update successful");
+            } else {
+                return Result.error("Update failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error updating user data item", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/controller/UserSignatureController.java

@@ -0,0 +1,81 @@
+package com.tutoring_software.backend.uid_management.controller;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import com.tutoring_software.backend.uid_management.Result;
+import com.tutoring_software.backend.uid_management.entity.UserSignature;
+import com.tutoring_software.backend.uid_management.service.UserSignatureService;
+
+@RestController
+@RequestMapping("/api/user-signatures")
+public class UserSignatureController {
+    private static final Logger LOGGER = LoggerFactory.getLogger(UserSignatureController.class);
+
+    @Autowired
+    private UserSignatureService userSignatureService;
+
+    // 通过uid获取用户的签名
+    @GetMapping("/get/{uid}")
+    public Result<UserSignature> getByUid(@PathVariable String uid) {
+        // 把uid转换为Long类型
+        Long uidLong = Long.parseLong(uid);
+        LOGGER.info("需要查询的uid为:{}", uidLong);
+        try {
+            UserSignature result = userSignatureService.getByUid(uidLong);
+            if (result != null) {
+                return Result.success(result);
+            } else {
+                return Result.error("UID not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error getting by UID", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    // 存储用户签名数据
+    @PostMapping("/save")
+    public Result<String> saveUserSignature(@RequestBody UserSignature userSignature) {
+        try {
+            // 首先检查用户是否已存在
+            UserSignature existingUser = userSignatureService.getByUid(userSignature.getUid());
+            if (existingUser != null) {
+                LOGGER.error("用户{}已存在，保存失败", userSignature.getUid());
+                return Result.error("User already exists"); // 返回明确的用户已存在错误
+            }
+            boolean success = userSignatureService.saveUserSignature(
+                    userSignature.getUid(), userSignature.getSignatures());
+            if (success) {
+                LOGGER.info("成功存储数据:uid={}", userSignature.getUid());
+                return Result.success("Save successful");
+            } else {
+                return Result.error("Save failed");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error saving user signature", e);
+            return Result.error("Internal server error");
+        }
+    }
+
+    // 更新签名数据
+    @PutMapping("/update")
+    public Result<String> updateUserSignatures(@RequestBody UserSignature userSignature) {
+        try {
+            boolean success = userSignatureService.updateSignature(
+                    userSignature.getUid(), userSignature.getSignatures());
+            if (success) {
+                LOGGER.info("成功更新用户{}的签名", userSignature.getUid());
+                return Result.success("Update successful");
+            } else {
+                LOGGER.warn("更新用户{}签名失败，用户不存在", userSignature.getUid());
+                return Result.error("User not found");
+            }
+        } catch (Exception e) {
+            LOGGER.error("Error updating user signature", e);
+            return Result.error("Internal server error");
+        }
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/CommentItem.java

@@ -0,0 +1,94 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import java.time.LocalDateTime;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.fasterxml.jackson.annotation.JsonFormat; 
+
+@TableName("comments")
+public class CommentItem {
+    //BIGSERVAL
+    @TableId(type=IdType.AUTO)
+    private Long id;
+
+    /*字段*/
+    //学生UID
+    //老师UID
+    @TableField("student_uid")
+    private Long studentUid;
+    @TableField("teacher_uid")
+    private Long teacherUid;
+
+    //评论的内容 VarChar(1000)
+    //评分 Char(1)
+    //评论的时间 TIMESTAMP、
+    //评论的学科VarChar(40)
+    @TableField("content")
+    private String content;
+    @TableField("rating")
+    private String rating;
+    @TableField("created_at")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private LocalDateTime createdAt;
+    @TableField("subject")
+    private String subject;
+
+    //构造函数
+    public CommentItem() {
+    }
+    public CommentItem(Long studentUid, Long teacherUid, String content, String rating, LocalDateTime createdAt, String subject) {
+        this.studentUid = studentUid;
+        this.teacherUid = teacherUid;
+        this.content = content;
+        this.rating = rating;
+        this.createdAt = createdAt;
+        this.subject = subject;
+    }
+    //getter和setter
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+    public Long getStudentUid() {
+        return studentUid;
+    }
+    public void setStudentUid(Long studentUid) {
+        this.studentUid = studentUid;
+    }
+    public Long getTeacherUid() {
+        return teacherUid;
+    }
+    public void setTeacherUid(Long teacherUid) {
+        this.teacherUid = teacherUid;
+    }
+    public String getContent() {
+        return content;
+    }
+    public void setContent(String content) {
+        this.content = content;
+    }
+    public String getRating() {
+        return rating;
+    }
+    public void setRating(String rating) {
+        this.rating = rating;
+    }
+    public LocalDateTime getCreatedAt() {
+        return createdAt;
+    }
+    public void setCreatedAt(LocalDateTime createdAt) {
+        this.createdAt = createdAt;
+    }
+    public String getSubject() {
+        return subject;
+    }
+    public void setSubject(String subject) {
+        this.subject = subject;
+    }
+
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/EmailUid.java

@@ -0,0 +1,49 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("email_id")
+public class EmailUid {
+    @TableId(type=IdType.AUTO)
+    private Long id;
+
+    //字段
+    @TableField("email")
+    private String email;
+    @TableField("uid") // UID字段
+    private Long uid;
+
+    //构造函数
+    public EmailUid() {}
+    public EmailUid(String email, Long uid){
+        this.email = email;
+        this.uid = uid;
+    }
+    //getter和setter
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public Long getUid() {
+        return uid;
+    }
+
+    public void setUid(Long uid) {
+        this.uid = uid;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/PhoneNumberUid.java

@@ -0,0 +1,49 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("phone_number_id")
+public class PhoneNumberUid {
+    //主键字段
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    //字段
+    @TableField("phone_number") // 手机号字段
+    private String phoneNumber;
+    @TableField("uid") // UID字段
+    private Long uid;
+
+    // 构造函数
+    public PhoneNumberUid() {}
+    public PhoneNumberUid(String phoneNumber, Long uid){
+        this.phoneNumber = phoneNumber;
+        this.uid = uid;
+    }
+    //getter和setter
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getPhoneNumber() {
+        return phoneNumber;
+    }
+
+    public void setPhoneNumber(String phoneNumber) {
+        this.phoneNumber = phoneNumber;
+    }
+
+    public Long getUid() {
+        return uid;
+    }
+
+    public void setUid(Long uid) {
+        this.uid = uid;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/TSRelationship.java

@@ -0,0 +1,78 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("teacher_student_relationship")
+public class TSRelationship {
+    // 主键字段 - BIGSERIAL类型
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    
+    // 学生UID字段
+    @TableField("student_uid")
+    private Long studentUid;
+    
+    // 老师UID字段
+    @TableField("teacher_uid")
+    private Long teacherUid;
+
+    //学科选择关系char(6)
+    @TableField("subject")
+    private int subject;
+
+    //学情分析
+    @TableField("analysis")    
+    private String analysis;
+    
+    // 构造函数
+    public TSRelationship() {}
+    
+    public TSRelationship(Long studentUid, Long teacherUid) {
+        this.studentUid = studentUid;
+        this.teacherUid = teacherUid;
+    }
+    
+    // getter和setter方法
+    public Long getId() {
+        return id;
+    }
+    
+    public void setId(Long id) {
+        this.id = id;
+    }
+    
+    public Long getStudentUid() {
+        return studentUid;
+    }
+    
+    public void setStudentUid(Long studentUid) {
+        this.studentUid = studentUid;
+    }
+    
+    public Long getTeacherUid() {
+        return teacherUid;
+    }
+    
+    public void setTeacherUid(Long teacherUid) {
+        this.teacherUid = teacherUid;
+    }
+    
+    public int getSubject() {
+        return subject;
+    }
+    
+    public void setSubject(int subject) {
+        this.subject = subject;
+    }
+
+    public String getAnalysis() {
+        return analysis;
+    }
+
+    public void setAnalysis(String analysis) {
+        this.analysis = analysis;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/Teacher.java

@@ -0,0 +1,69 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("teachers")
+public class Teacher {
+    // BIGSERIAL 自增id
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    
+    // 老师的uid
+    @TableField("teacher_uid")
+    private Long teacherUid;
+    
+    // 老师的评分rating
+    @TableField("rating")
+    private double rating;
+    
+    // 老师的评价数量 int comments
+    @TableField("comments")
+    private int comments;
+
+    // 无参构造函数
+    public Teacher() {
+    }
+    
+    // 全参构造函数
+    public Teacher(Long teacherUid, double rating, int comments) {
+        this.teacherUid = teacherUid;
+        this.rating = rating;
+        this.comments = comments;
+    }
+    
+    // getter 和 setter 方法
+    public Long getId() {
+        return id;
+    }
+    
+    public void setId(Long id) {
+        this.id = id;
+    }
+    
+    public Long getTeacherUid() {
+        return teacherUid;
+    }
+    
+    public void setTeacherUid(Long teacherUid) {
+        this.teacherUid = teacherUid;
+    }
+    
+    public double getRating() {
+        return rating;
+    }
+    
+    public void setRating(double rating) {
+        this.rating = rating;
+    }
+    
+    public int getComments() {
+        return comments;
+    }
+    
+    public void setComments(int comments) {
+        this.comments = comments;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/TeacherCourse.java

@@ -0,0 +1,56 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("teachers_courses")
+public class TeacherCourse {
+    // BIGSERIAL 自增id
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    
+    // 老师的uid
+    @TableField("teacher_uid")
+    private Long teacherUid;
+    
+    // 老师选择教学的学科(6位整数组成的学科ID)
+    @TableField("subject")
+    private String subject;
+
+    // 无参构造函数
+    public TeacherCourse() {
+    }
+    
+    // 全参构造函数
+    public TeacherCourse(Long teacherUid, String subject) {
+        this.teacherUid = teacherUid;
+        this.subject = subject;
+    }
+    
+    // getter 和 setter 方法
+    public Long getId() {
+        return id;
+    }
+    
+    public void setId(Long id) {
+        this.id = id;
+    }
+    
+    public Long getTeacherUid() {
+        return teacherUid;
+    }
+    
+    public void setTeacherUid(Long teacherUid) {
+        this.teacherUid = teacherUid;
+    }
+    
+    public String getSubject(){
+        return subject;
+    }
+        
+    public void setSubject(String subject){
+        this.subject = subject;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/UserAvatars.java

@@ -0,0 +1,75 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import java.time.LocalDateTime;
+
+@TableName("user_avatars")
+public class UserAvatars {
+    // 主键字段
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    // 关联用户ID，NOT NULL约束
+    @TableField("uid")
+    private Long uid;
+    // 图片二进制数据，NOT NULL约束
+    @TableField("image_data")
+    private byte[] imageData;
+    // 图片类型，如 'image/jpeg'
+    @TableField("mime_type")
+    private String mimeType;
+    // 创建时间，默认值为当前时间戳
+    @TableField("created_at")
+    private LocalDateTime createdAt;
+
+    //构造方法
+    public UserAvatars(){}
+    public UserAvatars(Long uid, byte[] imageData, String mimeType) {
+        this.uid = uid;
+        this.imageData = imageData;
+        this.mimeType = mimeType;
+    }
+
+    // Getter和Setter方法
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public Long getUid() {
+        return uid;
+    }
+
+    public void setUid(Long uid) {
+        this.uid = uid;
+    }
+
+    public byte[] getImageData() {
+        return imageData;
+    }
+
+    public void setImageData(byte[] imageData) {
+        this.imageData = imageData;
+    }
+
+    public String getMimeType() {
+        return mimeType;
+    }
+
+    public void setMimeType(String mimeType) {
+        this.mimeType = mimeType;
+    }
+
+    public LocalDateTime getCreatedAt() {
+        return createdAt;
+    }
+
+    public void setCreatedAt(LocalDateTime createdAt) {
+        this.createdAt = createdAt;
+    }
+}

src/backend/src/main/java/com/tutoring_software/backend/uid_management/entity/UserDataItem.java

@@ -0,0 +1,130 @@
+package com.tutoring_software.backend.uid_management.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+
+@TableName("user_data_item")
+public class UserDataItem {
+    //主键字段
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    //字段：分别为
+    // uid BIGINT 不能为空
+    // 用户名 varchar(100) 不能为空
+    // 手机号 varchar(20) 可以为空
+    // 邮箱 varchar(255) 可以为空
+    // 生日 varchar(20) 可以为空
+    // 身份 varchar(15) 不可为空
+    //性别 varchar(10) 不可为空
+    // 密码 varchar(40) 不可为空
+    // 教学科目 varchar(1000) 可以为空
+    // 学习科目 varchar(1000) 可以为空
+    @TableField("uid")
+    private Long uid;
+    @TableField("username")
+    private String username;
+    @TableField("phone_number")
+    private String phoneNumber = "";
+    @TableField("email")
+    private String email = "";
+    @TableField("birthday")
+    private String birthday = "";
+    @TableField("role")
+    private String role;
+    @TableField("gender")
+    private String gender = "隐藏";
+    @TableField("password")
+    private String password;
+    @TableField("teaching_subjects")
+    private String teachingSubjects ;
+    @TableField("learning_subjects")
+    private String learningSubjects ;
+    
+    public UserDataItem(){}
+    public UserDataItem(
+            Long uid, String username, String phoneNumber,
+            String email, String birthday, String role,
+            String gender, String password,
+            String teachingSubjects, String learningSubjects) {
+        this.uid = uid;
+        this.username = username;
+        this.phoneNumber = phoneNumber;
+        this.email = email;
+        this.birthday = birthday;
+        this.role = role;
+        this.gender = gender;
+        this.password = password;
+        this.teachingSubjects = teachingSubjects;
+        this.learningSubjects = learningSubjects;
+    }
+
+    //getter 和 setter
+    public Long getId() {
+        return id;
+    }
+    public void setId(Long id) {
+        this.id = id;
+    }
+    public Long getUid() {
+        return uid;
+    }
+    public void setUid(Long uid) {
+        this.uid = uid;
+    }
+    public String getUsername() {
+        return username;
+    }
+    public void setUsername(String username) {
+        this.username = username;
+    }
+    public String getPhoneNumber() {
+        return phoneNumber;
+    }
+    public void setPhoneNumber(String phoneNumber) {
+        this.phoneNumber = phoneNumber;
+    }
+    public String getEmail() {
+        return email;
+    }
+    public void setEmail(String email) {
+        this.email = email;
+    }
+    public String getBirthday() {
+        return birthday;
+    }
+    public void setBirthday(String birthday) {
+        this.birthday = birthday;
+    }
+    public String getRole() {
+        return role;
+    }
+    public void setRole(String role) {
+        this.role = role;
+    }
+    public String getGender() {
+        return gender;
+    }
+    public void setGender(String gender) {
+        this.gender = gender;
+    }
+    public String getPassword() {
+        return password;
+    }
+    public void setPassword(String password) {
+        this.password = password;
+    }
+    public String getTeachingSubjects() {
+        return teachingSubjects;
+    }
+    public void setTeachingSubjects(String teachingSubjects) {
+        this.teachingSubjects = teachingSubjects;
+    }
+    public String getLearningSubjects() {
+        return learningSubjects;
+    }
+    public void setLearningSubjects(String learningSubjects) {
+        this.learningSubjects = learningSubjects;
+    }
+}