From 2e2697140c70542068d7fe5419cffaf2c08dfb64 Mon Sep 17 00:00:00 2001
From: meowrain <meowrain@126.com>
Date: Sat, 10 Jan 2026 14:46:36 +0800
Subject: [PATCH] =?UTF-8?q?feat=20:AIOJ=20=E5=90=8E=E7=AB=AF=E6=A8=A1?=
 =?UTF-8?q?=E5=9D=97=E5=B9=B6=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE=E7=BB=93?=
 =?UTF-8?q?=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 引入了新模块：gateway、judge service、question service、user service 和 UPMS。
- 在 gateway 和 user service 模块中创建了 package-info.java 文件用于文档说明。
- 更新了 pom.xml 文件以反映新的模块结构和依赖关系。
- 在 UserController 中实现了基本的用户资料管理端点。
- 为每个新模块添加了扁平化 POM 文件以有效管理依赖。
- 增强了项目属性，以实现更好的版本管理和模块间一致性。
---
 .flattened-pom.xml                            | 239 ++++++++++++++++++
 .idea/CoolRequestCommonStatePersistent.xml    |   2 +-
 .idea/dataSources.xml                         |  24 ++
 .idea/db-forest-config.xml                    |   2 +-
 .idea/encodings.xml                           |   3 +
 .idea/misc.xml                                |   1 +
 aioj-backend-ai-service/.flattened-pom.xml    |  19 ++
 aioj-backend-ai-service/pom.xml               |  14 +-
 aioj-backend-auth/.flattened-pom.xml          | 106 ++++++++
 aioj-backend-auth/pom.xml                     |  64 ++---
 .../aioj/backend/auth/package-info.java       |  21 ++
 aioj-backend-common/.flattened-pom.xml        |  28 ++
 .../.flattened-pom.xml                        |   9 +
 .../aioj-backend-common-bom/pom.xml           | 187 +++++++++++---
 .../.flattened-pom.xml                        |  68 +++++
 .../aioj-backend-common-core/pom.xml          |  14 +-
 .../aioj/backend/framework/package-info.java  |  21 ++
 .../meowrain/aioj/backend/package-info.java   |  15 ++
 .../java/cn/meowrain/aioj/package-info.java   |  15 ++
 .../.flattened-pom.xml                        |  53 ++++
 .../aioj-backend-common-feign/pom.xml         |  15 +-
 .../.flattened-pom.xml                        |  45 ++++
 .../aioj-backend-common-log/pom.xml           |  20 +-
 .../.flattened-pom.xml                        |  50 ++++
 .../aioj-backend-common-mybatis/pom.xml       |  28 +-
 .../aioj/generator/CodeGenerator.java         | 119 +++++++++
 .../generator/InteractiveCodeGenerator.java   | 153 +++++++++++
 .../.flattened-pom.xml                        |  30 +++
 .../aioj-backend-common-starter/pom.xml       |  20 +-
 .../aioj-backend-common-swagger/pom.xml       |  21 --
 .../aioj/backend/common/swagger/Main.java     |  17 --
 aioj-backend-common/pom.xml                   |  33 +--
 aioj-backend-file-service/.flattened-pom.xml  |  73 ++++++
 aioj-backend-file-service/pom.xml             |  85 +++++++
 .../fileservice/FileServiceApplication.java   |  11 +
 .../fileservice/dao/AttachmentDAO.java        |   8 +
 .../src/main/resources/application-dev.yml    |  35 +++
 .../src/main/resources/application-prod.yml   |  11 +
 .../src/main/resources/application-test.yml   |  11 +
 .../src/main/resources/application.yml        |  37 +++
 aioj-backend-gateway/.flattened-pom.xml       |  75 ++++++
 aioj-backend-gateway/pom.xml                  |  43 ++--
 .../aioj/backend/gateway/package-info.java    |  16 ++
 aioj-backend-judge-service/.flattened-pom.xml |  19 ++
 aioj-backend-judge-service/pom.xml            |  14 +-
 .../.flattened-pom.xml                        |  19 ++
 aioj-backend-question-service/pom.xml         |  14 +-
 aioj-backend-upms/.flattened-pom.xml          |  24 ++
 .../aioj-backend-upms-api/.flattened-pom.xml  |  41 +++
 .../aioj-backend-upms-api/pom.xml             |  44 +---
 .../aioj/backend/upms/package-info.java       |  21 ++
 .../aioj-backend-upms-biz/.flattened-pom.xml  |  41 +++
 .../aioj-backend-upms-biz/pom.xml             |  42 +--
 aioj-backend-upms/pom.xml                     |  14 +-
 aioj-backend-user-service/.flattened-pom.xml  |  79 ++++++
 aioj-backend-user-service/pom.xml             |  78 +++---
 .../controller/UserController.java            |  28 +-
 .../backend/userservice/package-info.java     |  21 ++
 pom.xml                                       | 109 +++++---
 59 files changed, 2070 insertions(+), 399 deletions(-)
 create mode 100644 .flattened-pom.xml
 create mode 100644 aioj-backend-ai-service/.flattened-pom.xml
 create mode 100644 aioj-backend-auth/.flattened-pom.xml
 create mode 100644 aioj-backend-auth/src/main/java/cn/meowrain/aioj/backend/auth/package-info.java
 create mode 100644 aioj-backend-common/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-bom/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-core/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/framework/package-info.java
 create mode 100644 aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/package-info.java
 create mode 100644 aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/package-info.java
 create mode 100644 aioj-backend-common/aioj-backend-common-feign/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-log/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-mybatis/.flattened-pom.xml
 create mode 100644 aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/CodeGenerator.java
 create mode 100644 aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/InteractiveCodeGenerator.java
 create mode 100644 aioj-backend-common/aioj-backend-common-starter/.flattened-pom.xml
 delete mode 100644 aioj-backend-common/aioj-backend-common-swagger/pom.xml
 delete mode 100644 aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java
 create mode 100644 aioj-backend-file-service/.flattened-pom.xml
 create mode 100644 aioj-backend-file-service/pom.xml
 create mode 100644 aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/FileServiceApplication.java
 create mode 100644 aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/dao/AttachmentDAO.java
 create mode 100644 aioj-backend-file-service/src/main/resources/application-dev.yml
 create mode 100644 aioj-backend-file-service/src/main/resources/application-prod.yml
 create mode 100644 aioj-backend-file-service/src/main/resources/application-test.yml
 create mode 100644 aioj-backend-file-service/src/main/resources/application.yml
 create mode 100644 aioj-backend-gateway/.flattened-pom.xml
 create mode 100644 aioj-backend-gateway/src/main/java/cn/meowrain/aioj/backend/gateway/package-info.java
 create mode 100644 aioj-backend-judge-service/.flattened-pom.xml
 create mode 100644 aioj-backend-question-service/.flattened-pom.xml
 create mode 100644 aioj-backend-upms/.flattened-pom.xml
 create mode 100644 aioj-backend-upms/aioj-backend-upms-api/.flattened-pom.xml
 create mode 100644 aioj-backend-upms/aioj-backend-upms-api/src/main/java/cn/meowrain/aioj/backend/upms/package-info.java
 create mode 100644 aioj-backend-upms/aioj-backend-upms-biz/.flattened-pom.xml
 create mode 100644 aioj-backend-user-service/.flattened-pom.xml
 create mode 100644 aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/package-info.java

diff --git a/.flattened-pom.xml b/.flattened-pom.xml
new file mode 100644
index 0000000..80616b8
--- /dev/null
+++ b/.flattened-pom.xml
@@ -0,0 +1,239 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-parent</artifactId>
+    <version>3.5.7</version>
+    <relativePath></relativePath>
+  </parent>
+  <groupId>cn.meowrain.aioj</groupId>
+  <artifactId>ai-oj</artifactId>
+  <version>1.0.0</version>
+  <packaging>pom</packaging>
+  <name>ai-oj-microservices</name>
+  <description>一款集成了AI功能的OJ判题系统</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <modules>
+    <module>aioj-backend-common</module>
+    <module>aioj-backend-gateway</module>
+    <module>aioj-backend-judge-service</module>
+    <module>aioj-backend-user-service</module>
+    <module>aioj-backend-question-service</module>
+    <module>aioj-backend-ai-service</module>
+    <module>aioj-backend-auth</module>
+    <module>aioj-backend-upms</module>
+    <module>aioj-backend-file-service</module>
+  </modules>
+  <properties>
+    <docker.spring.active>dev</docker.spring.active>
+    <flatten.plugin.version>1.6.0</flatten.plugin.version>
+    <git.commit.plugin>9.0.2</git.commit.plugin>
+    <java.version>17</java.version>
+    <jib.plugin.version>3.4.5</jib.plugin.version>
+    <maven.compiler.source>${java.version}</maven.compiler.source>
+    <spring-boot.version>3.5.7</spring-boot.version>
+    <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>
+    <revision>1.0.0</revision>
+    <spring-cloud.version>2025.0.0</spring-cloud.version>
+    <maven.compiler.target>${java.version}</maven.compiler.target>
+    <maven.compiler.plugin.version>3.14.1</maven.compiler.plugin.version>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <spring.checkstyle.plugin>0.0.47</spring.checkstyle.plugin>
+  </properties>
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>cn.meowrain.aioj</groupId>
+        <artifactId>aioj-backend-common-bom</artifactId>
+        <version>1.0.0</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+      <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-dependencies</artifactId>
+        <version>${spring-boot.version}</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+      <dependency>
+        <groupId>org.springframework.cloud</groupId>
+        <artifactId>spring-cloud-dependencies</artifactId>
+        <version>${spring-cloud.version}</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+      <dependency>
+        <groupId>com.alibaba.cloud</groupId>
+        <artifactId>spring-cloud-alibaba-dependencies</artifactId>
+        <version>${spring-cloud-alibaba.version}</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+  <dependencies>
+    <dependency>
+      <groupId>org.projectlombok</groupId>
+      <artifactId>lombok</artifactId>
+      <optional>true</optional>
+    </dependency>
+  </dependencies>
+  <build>
+    <resources>
+      <resource>
+        <filtering>true</filtering>
+        <directory>src/main/resources</directory>
+      </resource>
+    </resources>
+    <pluginManagement>
+      <plugins>
+        <plugin>
+          <groupId>com.google.cloud.tools</groupId>
+          <artifactId>jib-maven-plugin</artifactId>
+          <version>${jib.plugin.version}</version>
+          <executions>
+            <execution>
+              <phase>package</phase>
+              <goals>
+                <goal>build</goal>
+                <goal>buildTar</goal>
+              </goals>
+            </execution>
+          </executions>
+          <configuration>
+            <allowInsecureRegistries>true</allowInsecureRegistries>
+            <from>
+              <image>registry.cn-shanghai.aliyuncs.com/all_lib/eclipse-temurin:17.0.10_7-jdk-jammy</image>
+            </from>
+            <to>
+              <image>10.0.0.3/aioj/${project.artifactId}:${project.version}</image>
+              <tags>
+                <tag>${project.version}</tag>
+              </tags>
+              <auth>
+                <username></username>
+                <password></password>
+              </auth>
+            </to>
+            <outputPaths>
+              <tar>${project.build.directory}/${project.artifactId}-${project.version}.tar</tar>
+            </outputPaths>
+            <container>
+              <environment>
+                <TZ>Asia/Shanghai</TZ>
+                <PROFILES_ACTIVE>${docker.spring.active}</PROFILES_ACTIVE>
+              </environment>
+              <jvmFlags>
+                <jvmFlag>-Xms512m</jvmFlag>
+                <jvmFlag>-Xmx512m</jvmFlag>
+              </jvmFlags>
+            </container>
+          </configuration>
+        </plugin>
+      </plugins>
+    </pluginManagement>
+    <plugins>
+      <plugin>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>${maven.compiler.plugin.version}</version>
+        <configuration>
+          <source>${java.version}</source>
+          <target>${java.version}</target>
+          <encoding>UTF-8</encoding>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-maven-plugin</artifactId>
+        <version>${spring-boot.version}</version>
+      </plugin>
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>flatten-maven-plugin</artifactId>
+        <version>${flatten.plugin.version}</version>
+        <executions>
+          <execution>
+            <id>flatten</id>
+            <phase>process-resources</phase>
+            <goals>
+              <goal>flatten</goal>
+            </goals>
+          </execution>
+          <execution>
+            <id>flatten.clean</id>
+            <phase>clean</phase>
+            <goals>
+              <goal>clean</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <updatePomFile>true</updatePomFile>
+          <flattenMode>resolveCiFriendliesOnly</flattenMode>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>io.spring.javaformat</groupId>
+        <artifactId>spring-javaformat-maven-plugin</artifactId>
+        <version>${spring.checkstyle.plugin}</version>
+        <executions>
+          <execution>
+            <phase>validate</phase>
+            <inherited>true</inherited>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <groupId>io.github.git-commit-id</groupId>
+        <artifactId>git-commit-id-maven-plugin</artifactId>
+        <version>${git.commit.plugin}</version>
+        <executions>
+          <execution>
+            <id>get-the-git-infos</id>
+            <phase>initialize</phase>
+          </execution>
+        </executions>
+        <configuration>
+          <failOnNoGitDirectory>false</failOnNoGitDirectory>
+          <generateGitPropertiesFile>true</generateGitPropertiesFile>
+          <dateFormat>yyyy-MM-dd HH:mm:ss</dateFormat>
+          <includeOnlyProperties>
+            <includeOnlyProperty>^git.build.(time|version)$</includeOnlyProperty>
+            <includeOnlyProperty>^git.commit.(id|message|time).*$</includeOnlyProperty>
+          </includeOnlyProperties>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  <profiles>
+    <profile>
+      <id>dev</id>
+      <activation>
+        <activeByDefault>true</activeByDefault>
+      </activation>
+      <properties>
+        <env>dev</env>
+      </properties>
+    </profile>
+    <profile>
+      <id>test</id>
+      <properties>
+        <env>test</env>
+      </properties>
+    </profile>
+    <profile>
+      <id>prod</id>
+      <properties>
+        <env>prod</env>
+      </properties>
+    </profile>
+  </profiles>
+</project>
diff --git a/.idea/CoolRequestCommonStatePersistent.xml b/.idea/CoolRequestCommonStatePersistent.xml
index 9b96684..9d0591c 100644
--- a/.idea/CoolRequestCommonStatePersistent.xml
+++ b/.idea/CoolRequestCommonStatePersistent.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="CoolRequestCommonStatePersistent">
-    <option name="searchCache" value="JwtAuthenticationFilter" />
+    <option name="searchCache" value="AIOJAdmin" />
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/dataSources.xml b/.idea/dataSources.xml
index 267fcc1..c4d21bb 100644
--- a/.idea/dataSources.xml
+++ b/.idea/dataSources.xml
@@ -25,5 +25,29 @@
       <jdbc-url>jdbc:mysql://10.0.0.10/aioj_dev</jdbc-url>
       <working-dir>$ProjectFileDir$</working-dir>
     </data-source>
+    <data-source source="LOCAL" name="jdbc:mysql://10.0.0.10/aioj_dev [DEBUG]" group="​AIOJAdminApplication" uuid="1323cc2e-0b2e-40de-abe6-d1f4c7567b1e">
+      <driver-ref>mysql.8</driver-ref>
+      <synchronize>true</synchronize>
+      <imported>true</imported>
+      <jdbc-driver>com.mysql.cj.jdbc.Driver</jdbc-driver>
+      <jdbc-url>jdbc:mysql://10.0.0.10/aioj_dev</jdbc-url>
+      <working-dir>$ProjectFileDir$</working-dir>
+    </data-source>
+    <data-source source="LOCAL" name="jdbc:mysql://10.0.0.10/aioj_dev [DEBUG]" group="​UserServiceApplication" uuid="c52f5e64-993d-4013-9e2b-838e23d604a2">
+      <driver-ref>mysql.8</driver-ref>
+      <synchronize>true</synchronize>
+      <imported>true</imported>
+      <jdbc-driver>com.mysql.cj.jdbc.Driver</jdbc-driver>
+      <jdbc-url>jdbc:mysql://10.0.0.10/aioj_dev</jdbc-url>
+      <working-dir>$ProjectFileDir$</working-dir>
+    </data-source>
+    <data-source source="LOCAL" name="jdbc:mysql://10.0.0.10/aioj_dev [DEBUG]" group="​AIOJAuthApplication" uuid="e757fbaf-3605-4bf2-9eb5-852d06273adc">
+      <driver-ref>mysql.8</driver-ref>
+      <synchronize>true</synchronize>
+      <imported>true</imported>
+      <jdbc-driver>com.mysql.cj.jdbc.Driver</jdbc-driver>
+      <jdbc-url>jdbc:mysql://10.0.0.10/aioj_dev</jdbc-url>
+      <working-dir>$ProjectFileDir$</working-dir>
+    </data-source>
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/db-forest-config.xml b/.idea/db-forest-config.xml
index de227fd..6437a7f 100644
--- a/.idea/db-forest-config.xml
+++ b/.idea/db-forest-config.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="db-tree-configuration">
-    <option name="data" value="1:0:​AIOJAdminApplication&#10;3:0:​UserServiceApplication&#10;5:0:​AIOJAuthApplication&#10;----------------------------------------&#10;2:1:43cc61de-66e1-44cc-b4a2-b24d7e03b490&#10;4:3:903d03c4-df11-4cf8-939a-3e5fba0ab207&#10;6:5:2fd8684a-b9aa-4507-abb0-f7c259d91286&#10;" />
+    <option name="data" value="1:0:​AIOJAdminApplication&#10;4:0:​UserServiceApplication&#10;7:0:​AIOJAuthApplication&#10;----------------------------------------&#10;2:1:43cc61de-66e1-44cc-b4a2-b24d7e03b490&#10;3:1:1323cc2e-0b2e-40de-abe6-d1f4c7567b1e&#10;5:4:903d03c4-df11-4cf8-939a-3e5fba0ab207&#10;6:4:c52f5e64-993d-4013-9e2b-838e23d604a2&#10;8:7:2fd8684a-b9aa-4507-abb0-f7c259d91286&#10;9:7:e757fbaf-3605-4bf2-9eb5-852d06273adc&#10;" />
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/encodings.xml b/.idea/encodings.xml
index 06c2395..000e721 100644
--- a/.idea/encodings.xml
+++ b/.idea/encodings.xml
@@ -19,6 +19,7 @@
     <file url="file://$PROJECT_DIR$/aioj-backend-common/aioj-backend-common-swagger/src/main/java" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/aioj-backend-common/src/main/java" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/aioj-backend-common/src/main/resources" charset="UTF-8" />
+    <file url="file://$PROJECT_DIR$/aioj-backend-file-service/src/main/java" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/aioj-backend-gateway/src/main/java" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/aioj-backend-gateway/src/main/resources" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/aioj-backend-judge-service/src/main/java" charset="UTF-8" />
@@ -36,5 +37,7 @@
     <file url="file://$PROJECT_DIR$/aioj-backend-user-service/src/main/resources" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/src/main/java" charset="UTF-8" />
     <file url="file://$PROJECT_DIR$/src/main/resources" charset="UTF-8" />
+    <file url="file://$USER_HOME$/src/main/java" charset="UTF-8" />
+    <file url="file://$USER_HOME$/src/main/resources" charset="UTF-8" />
   </component>
 </project>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
index efe95dd..050f06f 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -10,6 +10,7 @@
     <option name="ignoredFiles">
       <set>
         <option value="$PROJECT_DIR$/aioj-backend-client/pom.xml" />
+        <option value="$PROJECT_DIR$/aioj-backend-common/aioj-backend-common-swagger/pom.xml" />
         <option value="$PROJECT_DIR$/aioj-backend-model/pom.xml" />
         <option value="$PROJECT_DIR$/aioj-backend-upms/aioj-upms-api/pom.xml" />
       </set>
diff --git a/aioj-backend-ai-service/.flattened-pom.xml b/aioj-backend-ai-service/.flattened-pom.xml
new file mode 100644
index 0000000..0f11d8c
--- /dev/null
+++ b/aioj-backend-ai-service/.flattened-pom.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-ai-service</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ AI服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+</project>
diff --git a/aioj-backend-ai-service/pom.xml b/aioj-backend-ai-service/pom.xml
index 24b55be..d6337ca 100644
--- a/aioj-backend-ai-service/pom.xml
+++ b/aioj-backend-ai-service/pom.xml
@@ -3,18 +3,16 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-ai-service</artifactId>
+    <packaging>jar</packaging>
+    <description>AIOJ AI服务</description>
 
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
+    <!-- TODO: 添加依赖 -->
 </project>
\ No newline at end of file
diff --git a/aioj-backend-auth/.flattened-pom.xml b/aioj-backend-auth/.flattened-pom.xml
new file mode 100644
index 0000000..dd1de8f
--- /dev/null
+++ b/aioj-backend-auth/.flattened-pom.xml
@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-auth</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 认证授权服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springdoc</groupId>
+      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-feign</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-mybatis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-crypto</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-json</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.apache.commons</groupId>
+      <artifactId>commons-lang3</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-oauth2-client</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-security</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.jsonwebtoken</groupId>
+      <artifactId>jjwt-api</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.jsonwebtoken</groupId>
+      <artifactId>jjwt-impl</artifactId>
+      <scope>runtime</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.jsonwebtoken</groupId>
+      <artifactId>jjwt-jackson</artifactId>
+      <scope>runtime</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-openfeign</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-data-redis</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>
+  </dependencies>
+</project>
diff --git a/aioj-backend-auth/pom.xml b/aioj-backend-auth/pom.xml
index 7c99de0..38acd83 100644
--- a/aioj-backend-auth/pom.xml
+++ b/aioj-backend-auth/pom.xml
@@ -1,68 +1,45 @@
 <?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-auth</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>jar</packaging>
+    <description>AIOJ 认证授权服务</description>
 
     <dependencies>
-        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <!-- ==================== API文档 ==================== -->
         <dependency>
             <groupId>org.springdoc</groupId>
             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.4</version>
         </dependency>
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
             <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-            <version>4.5.0</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-common</artifactId>
-                </exclusion>
-            </exclusions>
         </dependency>
 
-        <!-- 核心模块 -->
+        <!-- ==================== 内部模块 ==================== -->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-feign</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-mybatis</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
 
-        <!-- 工具类 -->
+        <!-- ==================== 工具类 ==================== -->
         <dependency>
             <groupId>cn.hutool</groupId>
             <artifactId>hutool-crypto</artifactId>
@@ -76,19 +53,19 @@
             <artifactId>commons-lang3</artifactId>
         </dependency>
 
-        <!-- Spring Cloud服务发现 -->
+        <!-- ==================== Spring Cloud 服务发现 ==================== -->
         <dependency>
             <groupId>com.alibaba.cloud</groupId>
             <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
         </dependency>
 
-        <!-- Web -->
+        <!-- ==================== Web ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
         </dependency>
 
-        <!-- OAuth2 & Spring Security -->
+        <!-- ==================== OAuth2 & Spring Security ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-oauth2-client</artifactId>
@@ -98,26 +75,23 @@
             <artifactId>spring-boot-starter-security</artifactId>
         </dependency>
 
-        <!-- JWT -->
+        <!-- ==================== JWT ==================== -->
         <dependency>
             <groupId>io.jsonwebtoken</groupId>
             <artifactId>jjwt-api</artifactId>
-            <version>0.13.0</version>
         </dependency>
         <dependency>
             <groupId>io.jsonwebtoken</groupId>
             <artifactId>jjwt-impl</artifactId>
-            <version>0.13.0</version>
             <scope>runtime</scope>
         </dependency>
         <dependency>
             <groupId>io.jsonwebtoken</groupId>
             <artifactId>jjwt-jackson</artifactId>
-            <version>0.13.0</version>
             <scope>runtime</scope>
         </dependency>
 
-        <!-- Feign客户端 -->
+        <!-- ==================== Feign 客户端 ==================== -->
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-openfeign</artifactId>
@@ -127,13 +101,13 @@
             <artifactId>spring-cloud-starter-loadbalancer</artifactId>
         </dependency>
 
-        <!-- Redis用于存储refreshToken -->
+        <!-- ==================== Redis ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-data-redis</artifactId>
         </dependency>
 
-        <!-- 开发工具 -->
+        <!-- ==================== 开发工具 ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-devtools</artifactId>
@@ -141,7 +115,7 @@
             <optional>true</optional>
         </dependency>
 
-        <!-- 测试 -->
+        <!-- ==================== 测试 ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-test</artifactId>
diff --git a/aioj-backend-auth/src/main/java/cn/meowrain/aioj/backend/auth/package-info.java b/aioj-backend-auth/src/main/java/cn/meowrain/aioj/backend/auth/package-info.java
new file mode 100644
index 0000000..a640aae
--- /dev/null
+++ b/aioj-backend-auth/src/main/java/cn/meowrain/aioj/backend/auth/package-info.java
@@ -0,0 +1,21 @@
+/**
+ * AIOJ 认证授权模块
+ * <p>
+ * 提供系统的认证与授权功能，包括：
+ * <ul>
+ *     <li>OAuth2 认证</li>
+ *     <li>JWT Token 生成与验证</li>
+ *     <li>用户登录认证</li>
+ *     <li>权限校验</li>
+ * </ul>
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj.backend.auth;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/aioj-backend-common/.flattened-pom.xml b/aioj-backend-common/.flattened-pom.xml
new file mode 100644
index 0000000..594a3d6
--- /dev/null
+++ b/aioj-backend-common/.flattened-pom.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common</artifactId>
+  <version>1.0.0</version>
+  <packaging>pom</packaging>
+  <description>AIOJ 公共模块聚合</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <modules>
+    <module>aioj-backend-common-bom</module>
+    <module>aioj-backend-common-core</module>
+    <module>aioj-backend-common-log</module>
+    <module>aioj-backend-common-mybatis</module>
+    <module>aioj-backend-common-feign</module>
+    <module>aioj-backend-common-starter</module>
+  </modules>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-bom/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-bom/.flattened-pom.xml
new file mode 100644
index 0000000..933f5cc
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-bom/.flattened-pom.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>cn.meowrain.aioj</groupId>
+  <artifactId>aioj-backend-common-bom</artifactId>
+  <version>1.0.0</version>
+  <packaging>pom</packaging>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-bom/pom.xml b/aioj-backend-common/aioj-backend-common-bom/pom.xml
index b39f94d..2a5aaa9 100644
--- a/aioj-backend-common/aioj-backend-common-bom/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-bom/pom.xml
@@ -3,43 +3,109 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
-    <artifactId>aioj-backend-common-bom</artifactId>
+    
     <groupId>cn.meowrain.aioj</groupId>
-    <packaging>pom</packaging>
+    <artifactId>aioj-backend-common-bom</artifactId>
     <version>${revision}</version>
+    <packaging>pom</packaging>
 
     <name>aioj-common-bom</name>
-    <description>依赖管理</description>
+    <description>AIOJ 依赖版本统一管理 (Bill of Materials)</description>
+
     <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <!-- 项目版本 -->
         <revision>1.0.0</revision>
-        <mybatis-plus.version>3.5.14</mybatis-plus.version>
+        
+        <!-- ==================== 框架版本 ==================== -->
         <spring-boot.version>3.5.7</spring-boot.version>
+        <spring-cloud.version>2025.0.0</spring-cloud.version>
         <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>
+        <spring-security.version>6.5.6</spring-security.version>
+        
+        <!-- ==================== ORM & 数据库 ==================== -->
+        <mybatis-plus.version>3.5.14</mybatis-plus.version>
         <mysql.version>9.4.0</mysql.version>
-        <jackson.bom>3.0.2</jackson.bom>
+        
+        <!-- ==================== 工具库 ==================== -->
+        <hutool.version>5.8.41</hutool.version>
+        <jackson.version>3.0.2</jackson.version>
+        <gson.version>2.9.1</gson.version>
+        <easyexcel.version>4.0.3</easyexcel.version>
+        
+        <!-- ==================== API文档 ==================== -->
+        <springdoc.version>2.8.4</springdoc.version>
+        <knife4j.version>4.5.0</knife4j.version>
+        
+        <!-- ==================== JWT ==================== -->
+        <jjwt.version>0.13.0</jjwt.version>
+        
+        <!-- ==================== Spring Cloud Gateway ==================== -->
+        <spring-cloud-gateway.version>4.3.2</spring-cloud-gateway.version>
+        <spring-cloud-loadbalancer.version>4.3.0</spring-cloud-loadbalancer.version>
+        
+        <!-- ==================== 代码生成器 ==================== -->
+        <freemarker.version>2.3.33</freemarker.version>
     </properties>
+
     <dependencyManagement>
         <dependencies>
-            <!-- https://mvnrepository.com/artifact/tools.jackson/jackson-bom -->
+            <!-- ==================== 内部模块版本管理 ==================== -->
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-common-core</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-common-log</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-common-mybatis</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-common-feign</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-common-starter</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-upms-api</artifactId>
+                <version>${revision}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.meowrain.aioj</groupId>
+                <artifactId>aioj-backend-upms-biz</artifactId>
+                <version>${revision}</version>
+            </dependency>
+
+            <!-- ==================== 第三方BOM导入 ==================== -->
+            <!-- Jackson BOM -->
             <dependency>
                 <groupId>tools.jackson</groupId>
                 <artifactId>jackson-bom</artifactId>
-                <version>${jackson.bom}</version>
+                <version>${jackson.version}</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
-            <!-- https://mvnrepository.com/artifact/cn.hutool/hutool-bom -->
+            
+            <!-- Hutool BOM -->
             <dependency>
                 <groupId>cn.hutool</groupId>
                 <artifactId>hutool-bom</artifactId>
-                <version>5.8.41</version>
+                <version>${hutool.version}</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
-            <!--orm 相关 -->
+            
+            <!-- MyBatis Plus BOM -->
             <dependency>
                 <groupId>com.baomidou</groupId>
                 <artifactId>mybatis-plus-bom</artifactId>
@@ -47,44 +113,105 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+
+            <!-- ==================== 数据库 ==================== -->
             <dependency>
                 <groupId>com.mysql</groupId>
                 <artifactId>mysql-connector-j</artifactId>
                 <version>${mysql.version}</version>
             </dependency>
 
-            <!-- https://github.com/alibaba/easyexcel -->
-            <!-- https://mvnrepository.com/artifact/com.alibaba/easyexcel -->
+            <!-- ==================== 工具库 ==================== -->
+            <dependency>
+                <groupId>com.google.code.gson</groupId>
+                <artifactId>gson</artifactId>
+                <version>${gson.version}</version>
+            </dependency>
             <dependency>
                 <groupId>com.alibaba</groupId>
                 <artifactId>easyexcel</artifactId>
-                <version>4.0.3</version>
+                <version>${easyexcel.version}</version>
             </dependency>
 
-
-            <!-- OAuth2 Client -->
-            <!-- https://mvnrepository.com/artifact/org.springframework.security/spring-security-oauth2-client -->
-            <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-oauth2-client -->
+            <!-- ==================== API文档 ==================== -->
             <dependency>
-                <groupId>org.springframework.boot</groupId>
-                <artifactId>spring-boot-starter-oauth2-client</artifactId>
-                <version>3.5.7</version>
+                <groupId>org.springdoc</groupId>
+                <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                <version>${springdoc.version}</version>
             </dependency>
-            <!-- https://mvnrepository.com/artifact/org.springframework.security/spring-security-test -->
+            <dependency>
+                <groupId>com.github.xiaoymin</groupId>
+                <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+                <version>${knife4j.version}</version>
+                <exclusions>
+                    <exclusion>
+                        <groupId>org.springdoc</groupId>
+                        <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                    </exclusion>
+                    <exclusion>
+                        <groupId>org.springdoc</groupId>
+                        <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                    </exclusion>
+                    <exclusion>
+                        <groupId>org.springdoc</groupId>
+                        <artifactId>springdoc-openapi-starter-common</artifactId>
+                    </exclusion>
+                </exclusions>
+            </dependency>
+            <dependency>
+                <groupId>com.github.xiaoymin</groupId>
+                <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
+                <version>${knife4j.version}</version>
+            </dependency>
+
+            <!-- ==================== JWT ==================== -->
+            <dependency>
+                <groupId>io.jsonwebtoken</groupId>
+                <artifactId>jjwt-api</artifactId>
+                <version>${jjwt.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.jsonwebtoken</groupId>
+                <artifactId>jjwt-impl</artifactId>
+                <version>${jjwt.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.jsonwebtoken</groupId>
+                <artifactId>jjwt-jackson</artifactId>
+                <version>${jjwt.version}</version>
+            </dependency>
+
+            <!-- ==================== Spring Cloud Gateway ==================== -->
+            <dependency>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-starter-gateway-server-webflux</artifactId>
+                <version>${spring-cloud-gateway.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+                <version>${spring-cloud-loadbalancer.version}</version>
+            </dependency>
+
+            <!-- ==================== Spring Security Test ==================== -->
             <dependency>
                 <groupId>org.springframework.security</groupId>
                 <artifactId>spring-security-test</artifactId>
-                <version>6.5.6</version>
+                <version>${spring-security.version}</version>
                 <scope>test</scope>
             </dependency>
 
-            <!-- Spring Security -->
+            <!-- ==================== 代码生成器 ==================== -->
             <dependency>
-                <groupId>org.springframework.boot</groupId>
-                <artifactId>spring-boot-starter-security</artifactId>
-                <version>3.5.7</version>
+                <groupId>com.baomidou</groupId>
+                <artifactId>mybatis-plus-generator</artifactId>
+                <version>${mybatis-plus.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>org.freemarker</groupId>
+                <artifactId>freemarker</artifactId>
+                <version>${freemarker.version}</version>
             </dependency>
-
         </dependencies>
     </dependencyManagement>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-core/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-core/.flattened-pom.xml
new file mode 100644
index 0000000..e9b54a3
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-core/.flattened-pom.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-common</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common-core</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 公共工具类核心包</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>jakarta.servlet</groupId>
+      <artifactId>jakarta.servlet-api</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-commons</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework</groupId>
+      <artifactId>spring-webmvc</artifactId>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-extra</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-http</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-json</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-validation</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-autoconfigure</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-security</artifactId>
+      <optional>true</optional>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-core/pom.xml b/aioj-backend-common/aioj-backend-common-core/pom.xml
index 23cbba8..739af61 100644
--- a/aioj-backend-common/aioj-backend-common-core/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-core/pom.xml
@@ -3,22 +3,16 @@
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-common-core</artifactId>
-
     <packaging>jar</packaging>
-    <description>aioj 公共工具类核心包</description>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <description>AIOJ 公共工具类核心包</description>
 
     <dependencies>
         <!--hutool-->
diff --git a/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/framework/package-info.java b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/framework/package-info.java
new file mode 100644
index 0000000..075a972
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/framework/package-info.java
@@ -0,0 +1,21 @@
+/**
+ * AIOJ 框架层
+ * <p>
+ * 提供通用的框架支持，包括：
+ * <ul>
+ *     <li>统一响应封装 (Result)</li>
+ *     <li>全局异常处理</li>
+ *     <li>通用工具类</li>
+ *     <li>公共配置</li>
+ * </ul>
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj.backend.framework;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/package-info.java b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/package-info.java
new file mode 100644
index 0000000..671e945
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/backend/package-info.java
@@ -0,0 +1,15 @@
+/**
+ * AIOJ 后端服务模块
+ * <p>
+ * 包含所有后端微服务的公共代码和业务逻辑。
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj.backend;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/package-info.java b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/package-info.java
new file mode 100644
index 0000000..c105c6f
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-core/src/main/java/cn/meowrain/aioj/package-info.java
@@ -0,0 +1,15 @@
+/**
+ * AIOJ - AI在线判题系统
+ * <p>
+ * 一款集成了AI功能的OJ判题系统，支持多种编程语言的在线编译运行与判题。
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/aioj-backend-common/aioj-backend-common-feign/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-feign/.flattened-pom.xml
new file mode 100644
index 0000000..80693cd
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-feign/.flattened-pom.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-common</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common-feign</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ Feign 远程调用封装</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-openfeign</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.github.openfeign</groupId>
+      <artifactId>feign-okhttp</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.ben-manes.caffeine</groupId>
+      <artifactId>caffeine</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.security</groupId>
+      <artifactId>spring-security-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework</groupId>
+      <artifactId>spring-webmvc</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-feign/pom.xml b/aioj-backend-common/aioj-backend-common-feign/pom.xml
index b7a00bf..7c8a4a7 100644
--- a/aioj-backend-common/aioj-backend-common-feign/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-feign/pom.xml
@@ -3,24 +3,21 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-common-feign</artifactId>
+    <packaging>jar</packaging>
+    <description>AIOJ Feign 远程调用封装</description>
 
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
     <dependencies>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
             <groupId>com.alibaba.cloud</groupId>
diff --git a/aioj-backend-common/aioj-backend-common-log/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-log/.flattened-pom.xml
new file mode 100644
index 0000000..daf8740
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-log/.flattened-pom.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-common</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common-log</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 日志模块</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springframework.security</groupId>
+      <artifactId>spring-security-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.security</groupId>
+      <artifactId>spring-security-oauth2-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-extra</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-http</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-upms-api</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-log/pom.xml b/aioj-backend-common/aioj-backend-common-log/pom.xml
index 77aca82..05ef541 100644
--- a/aioj-backend-common/aioj-backend-common-log/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-log/pom.xml
@@ -3,19 +3,16 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-common-log</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>jar</packaging>
+    <description>AIOJ 日志模块</description>
 
     <dependencies>
         <!--安全依赖获取上下文信息-->
@@ -36,15 +33,12 @@
             <artifactId>hutool-http</artifactId>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
-
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-upms-api</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
     </dependencies>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-mybatis/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-mybatis/.flattened-pom.xml
new file mode 100644
index 0000000..4f0d620
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-mybatis/.flattened-pom.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-common</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common-mybatis</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ MyBatis Plus 封装</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.baomidou</groupId>
+      <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.baomidou</groupId>
+      <artifactId>mybatis-plus-spring</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.baomidou</groupId>
+      <artifactId>mybatis-plus-jsqlparser</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.mysql</groupId>
+      <artifactId>mysql-connector-j</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.security</groupId>
+      <artifactId>spring-security-core</artifactId>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-mybatis/pom.xml b/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
index ff68bc2..eec8c20 100644
--- a/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
@@ -3,22 +3,17 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-common-mybatis</artifactId>
     <packaging>jar</packaging>
+    <description>AIOJ MyBatis Plus 封装</description>
 
-    <description>aioj mybatis 封装</description>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
     <dependencies>
         <!--hutool-->
         <dependency>
@@ -52,9 +47,20 @@
         </dependency>
 
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
+        </dependency>
+
+        <!-- ==================== 代码生成器 (test scope) ==================== -->
+        <dependency>
+            <groupId>com.baomidou</groupId>
+            <artifactId>mybatis-plus-generator</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.freemarker</groupId>
+            <artifactId>freemarker</artifactId>
+            <scope>test</scope>
         </dependency>
     </dependencies>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/CodeGenerator.java b/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/CodeGenerator.java
new file mode 100644
index 0000000..3059b50
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/CodeGenerator.java
@@ -0,0 +1,119 @@
+package cn.meowrain.aioj.generator;
+
+import com.baomidou.mybatisplus.annotation.FieldFill;
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.generator.FastAutoGenerator;
+import com.baomidou.mybatisplus.generator.config.OutputFile;
+import com.baomidou.mybatisplus.generator.config.rules.DateType;
+import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
+import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
+import com.baomidou.mybatisplus.generator.fill.Column;
+
+import java.util.Collections;
+
+/**
+ * MyBatis Plus 代码生成器
+ * <p>
+ * 使用方法：
+ * 1. 修改下方的数据库连接配置
+ * 2. 修改要生成的表名
+ * 3. 修改输出路径和包名
+ * 4. 运行 main 方法
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+public class CodeGenerator {
+
+    // ==================== 数据库配置 ====================
+    /** 数据库地址 */
+    private static final String DB_URL = "jdbc:mysql://10.0.0.10:3306/aioj?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai";
+    /** 数据库用户名 */
+    private static final String DB_USERNAME = "root";
+    /** 数据库密码 */
+    private static final String DB_PASSWORD = "123456";
+
+    // ==================== 代码生成配置 ====================
+    /** 作者名 */
+    private static final String AUTHOR = "meowrain";
+    /** 父包名 */
+    private static final String PARENT_PACKAGE = "cn.meowrain.aioj.backend";
+    /** 模块名 (如: userservice, questionservice) */
+    private static final String MODULE_NAME = "userservice";
+    /** 要生成的表名 (多个表用逗号分隔) */
+    private static final String[] TABLE_NAMES = {"sys_user", "sys_role"};
+    /** 表前缀 (生成时会去掉前缀) */
+    private static final String[] TABLE_PREFIX = {"sys_", "t_"};
+
+    // ==================== 输出路径配置 ====================
+    /** 代码输出目录 (默认当前项目的 src/main/java) */
+    private static final String OUTPUT_DIR = System.getProperty("user.dir") + "/src/main/java";
+    /** Mapper XML 输出目录 */
+    private static final String MAPPER_XML_DIR = System.getProperty("user.dir") + "/src/main/resources/mapper";
+
+    public static void main(String[] args) {
+        generateCode();
+    }
+
+    /**
+     * 执行代码生成
+     */
+    public static void generateCode() {
+        FastAutoGenerator.create(DB_URL, DB_USERNAME, DB_PASSWORD)
+                // 全局配置
+                .globalConfig(builder -> builder
+                        .author(AUTHOR)
+                        .outputDir(OUTPUT_DIR)
+                        .dateType(DateType.TIME_PACK)  // 使用 Java 8 日期类型
+                        .commentDate("yyyy-MM-dd")
+                        .disableOpenDir()  // 生成后不打开目录
+                )
+                // 包配置
+                .packageConfig(builder -> builder
+                        .parent(PARENT_PACKAGE)
+                        .moduleName(MODULE_NAME)
+                        .entity("dao.entity")
+                        .mapper("dao.mapper")
+                        .service("service")
+                        .serviceImpl("service.impl")
+                        .controller("controller")
+                        .xml("mapper")
+                        .pathInfo(Collections.singletonMap(OutputFile.xml, MAPPER_XML_DIR))
+                )
+                // 策略配置
+                .strategyConfig(builder -> builder
+                        .addInclude(TABLE_NAMES)
+                        .addTablePrefix(TABLE_PREFIX)
+                        // Entity 策略
+                        .entityBuilder()
+                        .enableLombok()
+                        .enableTableFieldAnnotation()
+                        .naming(NamingStrategy.underline_to_camel)
+                        .columnNaming(NamingStrategy.underline_to_camel)
+                        .idType(IdType.ASSIGN_ID)  // 雪花算法ID
+                        .addTableFills(new Column("create_time", FieldFill.INSERT))
+                        .addTableFills(new Column("update_time", FieldFill.INSERT_UPDATE))
+                        .logicDeleteColumnName("del_flag")
+                        .logicDeletePropertyName("delFlag")
+                        // Mapper 策略
+                        .mapperBuilder()
+                        .enableBaseResultMap()
+                        .enableBaseColumnList()
+                        // Service 策略
+                        .serviceBuilder()
+                        .formatServiceFileName("%sService")
+                        .formatServiceImplFileName("%sServiceImpl")
+                        // Controller 策略
+                        .controllerBuilder()
+                        .enableRestStyle()
+                )
+                // 模板引擎
+                .templateEngine(new FreemarkerTemplateEngine())
+                .execute();
+
+        System.out.println("========== 代码生成完成 ==========");
+        System.out.println("输出目录: " + OUTPUT_DIR);
+        System.out.println("Mapper XML: " + MAPPER_XML_DIR);
+    }
+}
diff --git a/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/InteractiveCodeGenerator.java b/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/InteractiveCodeGenerator.java
new file mode 100644
index 0000000..5cf0421
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-mybatis/src/test/java/cn/meowrain/aioj/generator/InteractiveCodeGenerator.java
@@ -0,0 +1,153 @@
+package cn.meowrain.aioj.generator;
+
+import com.baomidou.mybatisplus.annotation.FieldFill;
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.generator.FastAutoGenerator;
+import com.baomidou.mybatisplus.generator.config.OutputFile;
+import com.baomidou.mybatisplus.generator.config.rules.DateType;
+import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
+import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
+import com.baomidou.mybatisplus.generator.fill.Column;
+
+import java.util.Collections;
+import java.util.Scanner;
+
+/**
+ * 交互式代码生成器
+ * <p>
+ * 运行后会在控制台提示输入相关配置信息
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+public class InteractiveCodeGenerator {
+
+    public static void main(String[] args) {
+        Scanner scanner = new Scanner(System.in);
+
+        System.out.println("========== AIOJ 代码生成器 ==========");
+        System.out.println();
+
+        // 数据库配置
+        System.out.print("请输入数据库地址 (默认: localhost:3306/aioj): ");
+        String dbHost = scanner.nextLine().trim();
+        if (dbHost.isEmpty()) {
+            dbHost = "localhost:3306/aioj";
+        }
+        String dbUrl = "jdbc:mysql://" + dbHost + "?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai";
+
+        System.out.print("请输入数据库用户名 (默认: root): ");
+        String dbUsername = scanner.nextLine().trim();
+        if (dbUsername.isEmpty()) {
+            dbUsername = "root";
+        }
+
+        System.out.print("请输入数据库密码: ");
+        String dbPassword = scanner.nextLine().trim();
+
+        // 代码配置
+        System.out.print("请输入模块名 (如 userservice, questionservice): ");
+        String moduleName = scanner.nextLine().trim();
+
+        System.out.print("请输入要生成的表名 (多个表用逗号分隔): ");
+        String tableInput = scanner.nextLine().trim();
+        String[] tableNames = tableInput.split(",");
+
+        System.out.print("请输入表前缀 (如 sys_,t_ 留空则不去除前缀): ");
+        String prefixInput = scanner.nextLine().trim();
+        String[] tablePrefixes = prefixInput.isEmpty() ? new String[]{} : prefixInput.split(",");
+
+        System.out.print("请输入输出目录 (留空使用当前目录): ");
+        String outputDir = scanner.nextLine().trim();
+        if (outputDir.isEmpty()) {
+            outputDir = System.getProperty("user.dir") + "/src/main/java";
+        }
+
+        String mapperXmlDir = outputDir.replace("/java", "/resources") + "/mapper";
+
+        System.out.println();
+        System.out.println("========== 配置确认 ==========");
+        System.out.println("数据库: " + dbUrl);
+        System.out.println("模块名: " + moduleName);
+        System.out.println("表名: " + String.join(", ", tableNames));
+        System.out.println("输出目录: " + outputDir);
+        System.out.println();
+        System.out.print("确认生成? (y/n): ");
+
+        String confirm = scanner.nextLine().trim().toLowerCase();
+        if (!confirm.equals("y") && !confirm.equals("yes")) {
+            System.out.println("已取消生成");
+            return;
+        }
+
+        // 执行生成
+        generate(dbUrl, dbUsername, dbPassword, moduleName, tableNames, tablePrefixes, outputDir, mapperXmlDir);
+
+        scanner.close();
+    }
+
+    private static void generate(String dbUrl, String dbUsername, String dbPassword,
+                                  String moduleName, String[] tableNames, String[] tablePrefixes,
+                                  String outputDir, String mapperXmlDir) {
+        FastAutoGenerator.create(dbUrl, dbUsername, dbPassword)
+                // 全局配置
+                .globalConfig(builder -> builder
+                        .author("meowrain")
+                        .outputDir(outputDir)
+                        .dateType(DateType.TIME_PACK)
+                        .commentDate("yyyy-MM-dd")
+                        .disableOpenDir()
+                )
+                // 包配置
+                .packageConfig(builder -> builder
+                        .parent("cn.meowrain.aioj.backend")
+                        .moduleName(moduleName)
+                        .entity("dao.entity")
+                        .mapper("dao.mapper")
+                        .service("service")
+                        .serviceImpl("service.impl")
+                        .controller("controller")
+                        .xml("mapper")
+                        .pathInfo(Collections.singletonMap(OutputFile.xml, mapperXmlDir))
+                )
+                // 策略配置
+                .strategyConfig(builder -> {
+                    builder.addInclude(tableNames);
+                    if (tablePrefixes.length > 0) {
+                        builder.addTablePrefix(tablePrefixes);
+                    }
+                    builder
+                            // Entity 策略
+                            .entityBuilder()
+                            .enableLombok()
+                            .enableTableFieldAnnotation()
+                            .naming(NamingStrategy.underline_to_camel)
+                            .columnNaming(NamingStrategy.underline_to_camel)
+                            .idType(IdType.ASSIGN_ID)
+                            .addTableFills(new Column("create_time", FieldFill.INSERT))
+                            .addTableFills(new Column("update_time", FieldFill.INSERT_UPDATE))
+                            .logicDeleteColumnName("del_flag")
+                            .logicDeletePropertyName("delFlag")
+                            // Mapper 策略
+                            .mapperBuilder()
+                            .enableBaseResultMap()
+                            .enableBaseColumnList()
+                            // Service 策略
+                            .serviceBuilder()
+                            .formatServiceFileName("%sService")
+                            .formatServiceImplFileName("%sServiceImpl")
+                            // Controller 策略
+                            .controllerBuilder()
+                            .enableRestStyle();
+                })
+                // 模板引擎
+                .templateEngine(new FreemarkerTemplateEngine())
+                .execute();
+
+        System.out.println();
+        System.out.println("========== 代码生成完成 ==========");
+        System.out.println("Java 代码: " + outputDir);
+        System.out.println("Mapper XML: " + mapperXmlDir);
+    }
+}
diff --git a/aioj-backend-common/aioj-backend-common-starter/.flattened-pom.xml b/aioj-backend-common/aioj-backend-common-starter/.flattened-pom.xml
new file mode 100644
index 0000000..1cdf92b
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-starter/.flattened-pom.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-common</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-common-starter</artifactId>
+  <version>1.0.0</version>
+  <packaging>pom</packaging>
+  <description>AIOJ 公共模块启动器 (聚合常用依赖)</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-log</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-common/aioj-backend-common-starter/pom.xml b/aioj-backend-common/aioj-backend-common-starter/pom.xml
index 1ba3521..594c787 100644
--- a/aioj-backend-common/aioj-backend-common-starter/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-starter/pom.xml
@@ -3,31 +3,25 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
-    <packaging>pom</packaging>
 
     <artifactId>aioj-backend-common-starter</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>pom</packaging>
+    <description>AIOJ 公共模块启动器 (聚合常用依赖)</description>
 
     <dependencies>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-log</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
     </dependencies>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-swagger/pom.xml b/aioj-backend-common/aioj-backend-common-swagger/pom.xml
deleted file mode 100644
index ec11c36..0000000
--- a/aioj-backend-common/aioj-backend-common-swagger/pom.xml
+++ /dev/null
@@ -1,21 +0,0 @@
-<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <modelVersion>4.0.0</modelVersion>
-    <parent>
-        <groupId>cn.meowrain</groupId>
-        <artifactId>aioj-backend-common</artifactId>
-        <version>1.0-SNAPSHOT</version>
-    </parent>
-
-    <groupId>cn.meowrain.aioj.backend.common.swagger</groupId>
-    <artifactId>aioj-backend-common-swagger</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
-</project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java b/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java
deleted file mode 100644
index 53a9441..0000000
--- a/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java
+++ /dev/null
@@ -1,17 +0,0 @@
-package cn.meowrain.aioj.backend.common.swagger;
-
-//TIP 要<b>运行</b>代码，请按 <shortcut actionId="Run"/> 或
-// 点击装订区域中的 <icon src="AllIcons.Actions.Execute"/> 图标。
-public class Main {
-    public static void main(String[] args) {
-        //TIP 当文本光标位于高亮显示的文本处时按 <shortcut actionId="ShowIntentionActions"/>
-        // 查看 IntelliJ IDEA 建议如何修正。
-        System.out.printf("Hello and welcome!");
-
-        for (int i = 1; i <= 5; i++) {
-            //TIP 按 <shortcut actionId="Debug"/> 开始调试代码。我们已经设置了一个 <icon src="AllIcons.Debugger.Db_set_breakpoint"/> 断点
-            // 但您始终可以通过按 <shortcut actionId="ToggleLineBreakpoint"/> 添加更多断点。
-            System.out.println("i = " + i);
-        }
-    }
-}
\ No newline at end of file
diff --git a/aioj-backend-common/pom.xml b/aioj-backend-common/pom.xml
index 4e45643..e918cef 100644
--- a/aioj-backend-common/pom.xml
+++ b/aioj-backend-common/pom.xml
@@ -3,38 +3,23 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-common</artifactId>
     <packaging>pom</packaging>
+    <description>AIOJ 公共模块聚合</description>
+
     <modules>
-        <module>aioj-backend-common-log</module>
-        <module>aioj-backend-common-core</module>
-        <module>aioj-backend-common-starter</module>
-        <module>aioj-backend-common-mybatis</module>
         <module>aioj-backend-common-bom</module>
+        <module>aioj-backend-common-core</module>
+        <module>aioj-backend-common-log</module>
+        <module>aioj-backend-common-mybatis</module>
         <module>aioj-backend-common-feign</module>
+        <module>aioj-backend-common-starter</module>
     </modules>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
-    <dependencyManagement>
-        <dependencies>
-            <dependency>
-                <groupId>cn.meowrain.aioj</groupId>
-                <artifactId>aioj-backend-common-bom</artifactId>
-                <version>1.0.0</version>
-                <type>pom</type>
-                <scope>import</scope>
-            </dependency>
-        </dependencies>
-    </dependencyManagement>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-file-service/.flattened-pom.xml b/aioj-backend-file-service/.flattened-pom.xml
new file mode 100644
index 0000000..202478e
--- /dev/null
+++ b/aioj-backend-file-service/.flattened-pom.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-file-service</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 文件服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <properties>
+    <maven.compiler.target>17</maven.compiler.target>
+    <maven.compiler.source>17</maven.compiler.source>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>com.qcloud</groupId>
+      <artifactId>cos_api</artifactId>
+      <version>5.6.260.1</version>
+    </dependency>
+    <dependency>
+      <groupId>org.springdoc</groupId>
+      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-log</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-mybatis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.mysql</groupId>
+      <artifactId>mysql-connector-j</artifactId>
+      <scope>runtime</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-file-service/pom.xml b/aioj-backend-file-service/pom.xml
new file mode 100644
index 0000000..9f0b477
--- /dev/null
+++ b/aioj-backend-file-service/pom.xml
@@ -0,0 +1,85 @@
+<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>cn.meowrain.aioj</groupId>
+        <artifactId>ai-oj</artifactId>
+        <version>${revision}</version>
+    </parent>
+
+    <packaging>jar</packaging>
+    <description>AIOJ 文件服务</description>
+    <artifactId>aioj-backend-file-service</artifactId>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+    <dependencies>
+        <!--        =========== 腾讯云cos =========== -->
+        <!-- https://mvnrepository.com/artifact/com.qcloud/cos_api -->
+        <dependency>
+            <groupId>com.qcloud</groupId>
+            <artifactId>cos_api</artifactId>
+            <version>5.6.260.1</version>
+        </dependency>
+        <!-- ==================== API文档 ==================== -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+        </dependency>
+
+        <!-- ==================== 内部模块 ==================== -->
+        <dependency>
+            <groupId>cn.meowrain.aioj</groupId>
+            <artifactId>aioj-backend-common-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>cn.meowrain.aioj</groupId>
+            <artifactId>aioj-backend-common-log</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>cn.meowrain.aioj</groupId>
+            <artifactId>aioj-backend-common-mybatis</artifactId>
+        </dependency>
+
+        <!-- ==================== Web ==================== -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <!-- ==================== 工具类 ==================== -->
+        <dependency>
+            <groupId>cn.hutool</groupId>
+            <artifactId>hutool-core</artifactId>
+        </dependency>
+
+        <!-- ==================== 数据库 ==================== -->
+        <dependency>
+            <groupId>com.mysql</groupId>
+            <artifactId>mysql-connector-j</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+
+        <!-- ==================== Spring Cloud 服务发现 ==================== -->
+        <dependency>
+            <groupId>com.alibaba.cloud</groupId>
+            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+        </dependency>
+
+        <!-- ==================== 测试 ==================== -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+</project>
\ No newline at end of file
diff --git a/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/FileServiceApplication.java b/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/FileServiceApplication.java
new file mode 100644
index 0000000..9033663
--- /dev/null
+++ b/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/FileServiceApplication.java
@@ -0,0 +1,11 @@
+package cn.meowrain.aioj.backend.fileservice;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class FileServiceApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(FileServiceApplication.class);
+    }
+}
diff --git a/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/dao/AttachmentDAO.java b/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/dao/AttachmentDAO.java
new file mode 100644
index 0000000..1464bc1
--- /dev/null
+++ b/aioj-backend-file-service/src/main/java/cn/meowrain/aioj/backend/fileservice/dao/AttachmentDAO.java
@@ -0,0 +1,8 @@
+package cn.meowrain.aioj.backend.fileservice.dao;
+
+import lombok.Data;
+
+@Data
+public class AttachmentDAO {
+
+}
diff --git a/aioj-backend-file-service/src/main/resources/application-dev.yml b/aioj-backend-file-service/src/main/resources/application-dev.yml
new file mode 100644
index 0000000..9448ab5
--- /dev/null
+++ b/aioj-backend-file-service/src/main/resources/application-dev.yml
@@ -0,0 +1,35 @@
+spring:
+  mail:
+    host: smtp.qq.com
+    port: 465
+    username: 2705356115@qq.com
+    # 这里使用授权码
+    password: yohcndfrlxwcdfed
+    default-encoding: UTF-8
+    protocol: smtp
+    properties:
+      mail:
+        smtp:
+          ssl:
+            enable: true # 在 properties 中明确指定
+          auth: true
+          starttls:
+            enable: true # QQ邮箱也支持STARTTLS，但使用465端口时，ssl.enable=true是必须的
+  data:
+    redis:
+      host: 10.0.0.10
+      port: 6379
+      password: 123456
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://10.0.0.10/aioj_dev
+    username: root
+    password: root
+  cloud:
+    nacos:
+      discovery:
+        enabled: true
+        register-enabled: true
+        server-addr: 10.0.0.10:8848
+        username: nacos
+        password: nacos
\ No newline at end of file
diff --git a/aioj-backend-file-service/src/main/resources/application-prod.yml b/aioj-backend-file-service/src/main/resources/application-prod.yml
new file mode 100644
index 0000000..ed56224
--- /dev/null
+++ b/aioj-backend-file-service/src/main/resources/application-prod.yml
@@ -0,0 +1,11 @@
+spring:
+  data:
+    redis:
+      host: 10.0.0.10
+      port: 6379
+      password: 123456
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://10.0.0.10/aioj_prod
+    username: root
+    password: root
\ No newline at end of file
diff --git a/aioj-backend-file-service/src/main/resources/application-test.yml b/aioj-backend-file-service/src/main/resources/application-test.yml
new file mode 100644
index 0000000..1e38912
--- /dev/null
+++ b/aioj-backend-file-service/src/main/resources/application-test.yml
@@ -0,0 +1,11 @@
+spring:
+  data:
+    redis:
+      host: 10.0.0.10
+      port: 6379
+      password: 123456
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://10.0.0.10/aioj_test
+    username: root
+    password: 123456
\ No newline at end of file
diff --git a/aioj-backend-file-service/src/main/resources/application.yml b/aioj-backend-file-service/src/main/resources/application.yml
new file mode 100644
index 0000000..5f2c040
--- /dev/null
+++ b/aioj-backend-file-service/src/main/resources/application.yml
@@ -0,0 +1,37 @@
+spring:
+  application:
+    name: file-service
+  profiles:
+    active: @env@
+server:
+  port: 10013
+  servlet:
+    context-path: /api
+  error:
+    include-stacktrace: never
+springdoc:
+  api-docs:
+    enabled: true
+    path: /v3/api-docs
+  default-flat-param-object: true
+  swagger-ui:
+    path: /swagger-ui.html
+    tags-sorter: alpha
+    operations-sorter: alpha
+  group-configs:
+    - group: 'default'
+      paths-to-match: '/api/**'
+      packages-to-scan: cn.meowrain.aioj.backend.fileservice.controller
+knife4j:
+  basic:
+    enable: true
+  setting:
+    language: zh_cn
+mybatis-plus:
+  configuration:
+    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
+  mapper-locations: classpath*:/mapper/**/*.xml
+aioj:
+  log:
+    enabled: true
+    max-length: 20000
\ No newline at end of file
diff --git a/aioj-backend-gateway/.flattened-pom.xml b/aioj-backend-gateway/.flattened-pom.xml
new file mode 100644
index 0000000..ff26a0e
--- /dev/null
+++ b/aioj-backend-gateway/.flattened-pom.xml
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-gateway</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ API网关服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-webflux</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-gateway-server-webflux</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-alibaba-sentinel-gateway</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.csp</groupId>
+      <artifactId>sentinel-datasource-extension</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.cloud</groupId>
+      <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+      <exclusions>
+        <exclusion>
+          <groupId>org.springframework.boot</groupId>
+          <artifactId>spring-boot-starter-web</artifactId>
+        </exclusion>
+        <exclusion>
+          <groupId>jakarta.servlet</groupId>
+          <artifactId>jakarta.servlet-api</artifactId>
+        </exclusion>
+        <exclusion>
+          <groupId>org.springframework</groupId>
+          <artifactId>spring-webmvc</artifactId>
+        </exclusion>
+      </exclusions>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-actuator</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-gateway/pom.xml b/aioj-backend-gateway/pom.xml
index 8bf41e4..78540e1 100644
--- a/aioj-backend-gateway/pom.xml
+++ b/aioj-backend-gateway/pom.xml
@@ -3,32 +3,29 @@
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-gateway</artifactId>
+    <packaging>jar</packaging>
+    <description>AIOJ API网关服务</description>
 
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <spring-cloud-gateway.version>4.3.2</spring-cloud-gateway.version>
-    </properties>
     <dependencies>
+        <!-- Spring Cloud Gateway (WebFlux) -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-webflux</artifactId>
         </dependency>
-        <!-- Spring Cloud Gateway -->
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-gateway-server-webflux</artifactId>
-            <version>4.3.2</version>
         </dependency>
-        <!-- Nacos Discovery (parent 应已引入 alibaba 版本管理) -->
+        
+        <!-- Nacos 服务发现与配置 -->
         <dependency>
             <groupId>com.alibaba.cloud</groupId>
             <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
@@ -37,48 +34,50 @@
             <groupId>com.alibaba.cloud</groupId>
             <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
         </dependency>
+        
+        <!-- Sentinel 网关限流 -->
         <dependency>
             <groupId>com.alibaba.cloud</groupId>
             <artifactId>spring-cloud-alibaba-sentinel-gateway</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.springframework.cloud</groupId>
-            <artifactId>spring-cloud-starter-loadbalancer</artifactId>
-            <version>4.3.0</version>
-        </dependency>
         <dependency>
             <groupId>com.alibaba.csp</groupId>
             <artifactId>sentinel-datasource-extension</artifactId>
         </dependency>
+        
+        <!-- 负载均衡 -->
+        <dependency>
+            <groupId>org.springframework.cloud</groupId>
+            <artifactId>spring-cloud-starter-loadbalancer</artifactId>
+        </dependency>
 
+        <!-- API文档聚合 -->
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
             <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
-            <version>4.5.0</version>
         </dependency>
 
+        <!-- 内部模块 (排除WebMVC相关依赖) -->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
             <exclusions>
-                <!-- 🚫 必须排除：Spring MVC 核心 -->
                 <exclusion>
                     <groupId>org.springframework.boot</groupId>
                     <artifactId>spring-boot-starter-web</artifactId>
                 </exclusion>
-                <!-- 🚫 必须排除：Servlet API (Gateway用不到) -->
                 <exclusion>
                     <groupId>jakarta.servlet</groupId>
                     <artifactId>jakarta.servlet-api</artifactId>
                 </exclusion>
-                <!-- 🚫 必须排除：Spring WebMVC -->
                 <exclusion>
                     <groupId>org.springframework</groupId>
                     <artifactId>spring-webmvc</artifactId>
                 </exclusion>
             </exclusions>
         </dependency>
+        
+        <!-- 监控 -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-actuator</artifactId>
diff --git a/aioj-backend-gateway/src/main/java/cn/meowrain/aioj/backend/gateway/package-info.java b/aioj-backend-gateway/src/main/java/cn/meowrain/aioj/backend/gateway/package-info.java
new file mode 100644
index 0000000..91fa0e1
--- /dev/null
+++ b/aioj-backend-gateway/src/main/java/cn/meowrain/aioj/backend/gateway/package-info.java
@@ -0,0 +1,16 @@
+/**
+ * AIOJ API网关模块
+ * <p>
+ * 基于 Spring Cloud Gateway 实现的API网关，提供：
+ * <ul>
+ *     <li>请求路由转发</li>
+ *     <li>负载均衡</li>
+ *     <li>限流熔断 (Sentinel)</li>
+ *     <li>API文档聚合 (Knife4j)</li>
+ * </ul>
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+package cn.meowrain.aioj.backend.gateway;
diff --git a/aioj-backend-judge-service/.flattened-pom.xml b/aioj-backend-judge-service/.flattened-pom.xml
new file mode 100644
index 0000000..8969325
--- /dev/null
+++ b/aioj-backend-judge-service/.flattened-pom.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-judge-service</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 判题服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+</project>
diff --git a/aioj-backend-judge-service/pom.xml b/aioj-backend-judge-service/pom.xml
index 00c0116..36778c9 100644
--- a/aioj-backend-judge-service/pom.xml
+++ b/aioj-backend-judge-service/pom.xml
@@ -3,18 +3,16 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-judge-service</artifactId>
+    <packaging>jar</packaging>
+    <description>AIOJ 判题服务</description>
 
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
+    <!-- TODO: 添加依赖 -->
 </project>
\ No newline at end of file
diff --git a/aioj-backend-question-service/.flattened-pom.xml b/aioj-backend-question-service/.flattened-pom.xml
new file mode 100644
index 0000000..cceb665
--- /dev/null
+++ b/aioj-backend-question-service/.flattened-pom.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-question-service</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 题目服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+</project>
diff --git a/aioj-backend-question-service/pom.xml b/aioj-backend-question-service/pom.xml
index 0424c61..fe987f1 100644
--- a/aioj-backend-question-service/pom.xml
+++ b/aioj-backend-question-service/pom.xml
@@ -3,18 +3,16 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-question-service</artifactId>
+    <packaging>jar</packaging>
+    <description>AIOJ 题目服务</description>
 
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
+    <!-- TODO: 添加依赖 -->
 </project>
\ No newline at end of file
diff --git a/aioj-backend-upms/.flattened-pom.xml b/aioj-backend-upms/.flattened-pom.xml
new file mode 100644
index 0000000..04ca761
--- /dev/null
+++ b/aioj-backend-upms/.flattened-pom.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-upms</artifactId>
+  <version>1.0.0</version>
+  <packaging>pom</packaging>
+  <description>AIOJ 用户权限管理系统 (UPMS)</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <modules>
+    <module>aioj-backend-upms-api</module>
+    <module>aioj-backend-upms-biz</module>
+  </modules>
+</project>
diff --git a/aioj-backend-upms/aioj-backend-upms-api/.flattened-pom.xml b/aioj-backend-upms/aioj-backend-upms-api/.flattened-pom.xml
new file mode 100644
index 0000000..d66ee98
--- /dev/null
+++ b/aioj-backend-upms/aioj-backend-upms-api/.flattened-pom.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-upms</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-upms-api</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ UPMS API 接口定义</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springdoc</groupId>
+      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-mybatis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-feign</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-upms/aioj-backend-upms-api/pom.xml b/aioj-backend-upms/aioj-backend-upms-api/pom.xml
index 13b113d..4c51f81 100644
--- a/aioj-backend-upms/aioj-backend-upms-api/pom.xml
+++ b/aioj-backend-upms/aioj-backend-upms-api/pom.xml
@@ -3,62 +3,40 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-upms</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-upms-api</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>jar</packaging>
+    <description>AIOJ UPMS API 接口定义</description>
 
     <dependencies>
-        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <!-- API文档 -->
         <dependency>
             <groupId>org.springdoc</groupId>
             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.4</version>
         </dependency>
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
             <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-            <version>4.5.0</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-common</artifactId>
-                </exclusion>
-            </exclusions>
         </dependency>
-
+        
+        <!-- 内部模块 -->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-mybatis</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
-        <!--feign 注解依赖-->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-feign</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
     </dependencies>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-upms/aioj-backend-upms-api/src/main/java/cn/meowrain/aioj/backend/upms/package-info.java b/aioj-backend-upms/aioj-backend-upms-api/src/main/java/cn/meowrain/aioj/backend/upms/package-info.java
new file mode 100644
index 0000000..f484068
--- /dev/null
+++ b/aioj-backend-upms/aioj-backend-upms-api/src/main/java/cn/meowrain/aioj/backend/upms/package-info.java
@@ -0,0 +1,21 @@
+/**
+ * AIOJ 用户权限管理系统 (UPMS)
+ * <p>
+ * 统一的权限管理模块，提供：
+ * <ul>
+ *     <li>用户管理</li>
+ *     <li>角色管理</li>
+ *     <li>菜单权限</li>
+ *     <li>操作日志</li>
+ * </ul>
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj.backend.upms;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/aioj-backend-upms/aioj-backend-upms-biz/.flattened-pom.xml b/aioj-backend-upms/aioj-backend-upms-biz/.flattened-pom.xml
new file mode 100644
index 0000000..91d5071
--- /dev/null
+++ b/aioj-backend-upms/aioj-backend-upms-biz/.flattened-pom.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>aioj-backend-upms</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-upms-biz</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ UPMS 业务实现</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springdoc</groupId>
+      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-mybatis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-upms-api</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-upms/aioj-backend-upms-biz/pom.xml b/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
index 408d51d..e604039 100644
--- a/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
+++ b/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
@@ -3,57 +3,39 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>aioj-backend-upms</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-upms-biz</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>jar</packaging>
+    <description>AIOJ UPMS 业务实现</description>
 
     <dependencies>
-        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <!-- API文档 -->
         <dependency>
             <groupId>org.springdoc</groupId>
             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.4</version>
         </dependency>
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
             <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-            <version>4.5.0</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-common</artifactId>
-                </exclusion>
-            </exclusions>
         </dependency>
-
+        
+        <!-- 内部模块 -->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-mybatis</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-upms-api</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
+        
+        <!-- Web -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
diff --git a/aioj-backend-upms/pom.xml b/aioj-backend-upms/pom.xml
index ce2311f..b91e308 100644
--- a/aioj-backend-upms/pom.xml
+++ b/aioj-backend-upms/pom.xml
@@ -3,23 +3,19 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-upms</artifactId>
     <packaging>pom</packaging>
+    <description>AIOJ 用户权限管理系统 (UPMS)</description>
+
     <modules>
         <module>aioj-backend-upms-api</module>
         <module>aioj-backend-upms-biz</module>
     </modules>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
-
 </project>
\ No newline at end of file
diff --git a/aioj-backend-user-service/.flattened-pom.xml b/aioj-backend-user-service/.flattened-pom.xml
new file mode 100644
index 0000000..ff9ff70
--- /dev/null
+++ b/aioj-backend-user-service/.flattened-pom.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>cn.meowrain.aioj</groupId>
+    <artifactId>ai-oj</artifactId>
+    <version>1.0.0</version>
+  </parent>
+  <artifactId>aioj-backend-user-service</artifactId>
+  <version>1.0.0</version>
+  <description>AIOJ 用户服务</description>
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+  <dependencies>
+    <dependency>
+      <groupId>org.springdoc</groupId>
+      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.github.xiaoymin</groupId>
+      <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-core</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-log</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.meowrain.aioj</groupId>
+      <artifactId>aioj-backend-common-mybatis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-crypto</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-mail</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-data-redis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.session</groupId>
+      <artifactId>spring-session-data-redis</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-cache</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>com.mysql</groupId>
+      <artifactId>mysql-connector-j</artifactId>
+      <scope>runtime</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.alibaba.cloud</groupId>
+      <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>
diff --git a/aioj-backend-user-service/pom.xml b/aioj-backend-user-service/pom.xml
index 7b0d2fe..490a73f 100644
--- a/aioj-backend-user-service/pom.xml
+++ b/aioj-backend-user-service/pom.xml
@@ -3,76 +3,61 @@
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+
     <parent>
-        <groupId>cn.meowrain</groupId>
+        <groupId>cn.meowrain.aioj</groupId>
         <artifactId>ai-oj</artifactId>
-        <version>1.0-SNAPSHOT</version>
+        <version>${revision}</version>
     </parent>
 
     <artifactId>aioj-backend-user-service</artifactId>
-
-    <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    </properties>
+    <packaging>jar</packaging>
+    <description>AIOJ 用户服务</description>
 
     <dependencies>
-        <!--引入spring boot email-->
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-mail</artifactId>
-        </dependency>
-        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <!-- ==================== API文档 ==================== -->
         <dependency>
             <groupId>org.springdoc</groupId>
             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.4</version>
         </dependency>
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
             <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-            <version>4.5.0</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
-                </exclusion>
-                <exclusion>
-                    <groupId>org.springdoc</groupId>
-                    <artifactId>springdoc-openapi-starter-common</artifactId>
-                </exclusion>
-            </exclusions>
         </dependency>
 
+        <!-- ==================== 内部模块 ==================== -->
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-log</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
         <dependency>
-            <groupId>cn.meowrain</groupId>
+            <groupId>cn.meowrain.aioj</groupId>
             <artifactId>aioj-backend-common-mybatis</artifactId>
-            <version>1.0-SNAPSHOT</version>
         </dependency>
+
+        <!-- ==================== Web ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
         </dependency>
+
+        <!-- ==================== 工具类 ==================== -->
         <dependency>
             <groupId>cn.hutool</groupId>
             <artifactId>hutool-crypto</artifactId>
         </dependency>
 
+        <!-- ==================== 邮件 ==================== -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-mail</artifactId>
+        </dependency>
+
+        <!-- ==================== Redis & 缓存 ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-data-redis</artifactId>
@@ -81,30 +66,29 @@
             <groupId>org.springframework.session</groupId>
             <artifactId>spring-session-data-redis</artifactId>
         </dependency>
-        <!--        引入cache-->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-cache</artifactId>
         </dependency>
+
+        <!-- ==================== 数据库 ==================== -->
         <dependency>
             <groupId>com.mysql</groupId>
             <artifactId>mysql-connector-j</artifactId>
             <scope>runtime</scope>
         </dependency>
+
+        <!-- ==================== Spring Cloud 服务发现 ==================== -->
+        <dependency>
+            <groupId>com.alibaba.cloud</groupId>
+            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
+        </dependency>
+
+        <!-- ==================== 测试 ==================== -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-test</artifactId>
             <scope>test</scope>
         </dependency>
-<!--        <dependency>-->
-<!--            <groupId>org.springframework.boot</groupId>-->
-<!--            <artifactId>spring-boot-devtools</artifactId>-->
-<!--            <scope>runtime</scope>-->
-<!--            <optional>true</optional>-->
-<!--        </dependency>-->
-        <dependency>
-            <groupId>com.alibaba.cloud</groupId>
-            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
-        </dependency>
     </dependencies>
 </project>
\ No newline at end of file
diff --git a/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/controller/UserController.java b/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/controller/UserController.java
index 8f5a064..203ee3a 100644
--- a/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/controller/UserController.java
+++ b/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/controller/UserController.java
@@ -14,6 +14,7 @@ import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
 
 @RequiredArgsConstructor
 @RestController()
@@ -79,13 +80,36 @@ public class UserController {
     /**
      * 解绑邮箱
      *
-     * @param email 邮箱
      * @return
      */
     @Operation(summary = "解绑邮箱", description = "根据用户注册的邮箱解绑邮箱")
     @PostMapping("/email/unbind")
-    public Result<Void> unbindEmail(@RequestBody String email) {
+    public Result<Void> unbindEmail() {
         userService.unbindEmail(ContextHolderUtils.getCurrentUserId());
         return Results.success(null);
     }
+
+
+    @Operation(summary = "个人资料管理", description = "获取完整个人资料")
+    @GetMapping("/profile")
+    public Result<Void> getUserProfile() {
+        return Results.success();
+    }
+
+    @Operation(summary = "个人资料管理", description = "更新个人资料")
+    @PutMapping("/profile")
+    public Result<Void> updateUserProfile() {
+        return Results.success();
+    }
+
+    @Operation(summary = "个人资料管理", description = "上传/更新头像")
+    @PostMapping("/avatar")
+    public Result<Void> uploadAvatar(@RequestParam("file") MultipartFile file) {
+        return Results.success();
+    }
+
+    @Operation(summary = "个人资料管理",description = "修改密码")
+    public Result<Void> changePassword() {
+        return Results.success();
+    }
 }
diff --git a/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/package-info.java b/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/package-info.java
new file mode 100644
index 0000000..6f0882d
--- /dev/null
+++ b/aioj-backend-user-service/src/main/java/cn/meowrain/aioj/backend/userservice/package-info.java
@@ -0,0 +1,21 @@
+/**
+ * AIOJ 用户服务模块
+ * <p>
+ * 提供用户相关的功能，包括：
+ * <ul>
+ *     <li>用户注册与登录</li>
+ *     <li>用户信息管理</li>
+ *     <li>邮箱验证</li>
+ *     <li>用户权限</li>
+ * </ul>
+ * </p>
+ *
+ * @author meowrain
+ * @since 1.0.0
+ */
+@NonNullApi
+@NonNullFields
+package cn.meowrain.aioj.backend.userservice;
+
+import org.springframework.lang.NonNullApi;
+import org.springframework.lang.NonNullFields;
diff --git a/pom.xml b/pom.xml
index 4b88ff7..f069109 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,18 +3,21 @@
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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 />
     </parent>
-    <groupId>cn.meowrain</groupId>
+
+    <groupId>cn.meowrain.aioj</groupId>
     <artifactId>ai-oj</artifactId>
-    <version>1.0-SNAPSHOT</version>
+    <version>${revision}</version>
     <packaging>pom</packaging>
     <name>ai-oj-microservices</name>
     <description>一款集成了AI功能的OJ判题系统</description>
+
     <modules>
         <module>aioj-backend-common</module>
         <module>aioj-backend-gateway</module>
@@ -24,51 +27,54 @@
         <module>aioj-backend-ai-service</module>
         <module>aioj-backend-auth</module>
         <module>aioj-backend-upms</module>
-        <module>aioj-backend-common/aioj-backend-common-swagger</module>
+        <module>aioj-backend-file-service</module>
     </modules>
+
     <properties>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
+        <!-- ==================== 项目基础配置 ==================== -->
+        <revision>1.0.0</revision>
+        <java.version>17</java.version>
+        <maven.compiler.source>${java.version}</maven.compiler.source>
+        <maven.compiler.target>${java.version}</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        
+        <!-- ==================== Spring生态版本 ==================== -->
         <spring-boot.version>3.5.7</spring-boot.version>
         <spring-cloud.version>2025.0.0</spring-cloud.version>
         <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>
+        
+        <!-- ==================== 构建插件版本 ==================== -->
         <spring.checkstyle.plugin>0.0.47</spring.checkstyle.plugin>
         <git.commit.plugin>9.0.2</git.commit.plugin>
+        <maven.compiler.plugin.version>3.14.1</maven.compiler.plugin.version>
+        <jib.plugin.version>3.4.5</jib.plugin.version>
+        <flatten.plugin.version>1.6.0</flatten.plugin.version>
+        
+        <!-- ==================== Docker配置 ==================== -->
         <docker.spring.active>dev</docker.spring.active>
     </properties>
+
+    <!-- 全局依赖：所有子模块都会继承 -->
     <dependencies>
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-aop</artifactId>
-        </dependency>
-        <!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
-        <dependency>
-            <groupId>org.apache.commons</groupId>
-            <artifactId>commons-lang3</artifactId>
-        </dependency>
-        <dependency>
-            <groupId>com.google.code.gson</groupId>
-            <artifactId>gson</artifactId>
-            <version>2.9.1</version>
-        </dependency>
         <dependency>
             <groupId>org.projectlombok</groupId>
             <artifactId>lombok</artifactId>
             <optional>true</optional>
         </dependency>
     </dependencies>
+
     <dependencyManagement>
         <dependencies>
+            <!-- AIOJ 内部模块BOM (优先级最高，放在最前面) -->
             <dependency>
                 <groupId>cn.meowrain.aioj</groupId>
                 <artifactId>aioj-backend-common-bom</artifactId>
-                <version>1.0.0</version>
+                <version>${revision}</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
-            <!--Spring
-            Boot依赖-->
+            
+            <!-- Spring Boot 依赖管理 -->
             <dependency>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-dependencies</artifactId>
@@ -76,9 +82,8 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
-            <!--            Spring Cloud依赖-->
-            <!--
-            https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-dependencies -->
+            
+            <!-- Spring Cloud 依赖管理 -->
             <dependency>
                 <groupId>org.springframework.cloud</groupId>
                 <artifactId>spring-cloud-dependencies</artifactId>
@@ -86,6 +91,8 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+            
+            <!-- Spring Cloud Alibaba 依赖管理 -->
             <dependency>
                 <groupId>com.alibaba.cloud</groupId>
                 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
@@ -102,27 +109,55 @@
                 <filtering>true</filtering>
             </resource>
         </resources>
+        
         <plugins>
+            <!-- Java 编译插件 -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.14.1</version>
+                <version>${maven.compiler.plugin.version}</version>
                 <configuration>
-                    <source>17</source>
-                    <target>17</target>
+                    <source>${java.version}</source>
+                    <target>${java.version}</target>
                     <encoding>UTF-8</encoding>
                 </configuration>
             </plugin>
+            
+            <!-- Spring Boot Maven 插件 -->
             <plugin>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-maven-plugin</artifactId>
                 <version>${spring-boot.version}</version>
             </plugin>
-            <!--
-				代码格式插件，默认使用spring 规则，可运行命令进行项目格式化：./mvnw spring-javaformat:apply 或 mvn
-            spring-javaformat:apply，可在IDEA中安装插件以下插件进行自动格式化：
-				https://repo1.maven.org/maven2/io/spring/javaformat/spring-javaformat-intellij-idea-plugin
-			-->
+            
+            <!-- Flatten 插件：处理 ${revision} 变量 -->
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>flatten-maven-plugin</artifactId>
+                <version>${flatten.plugin.version}</version>
+                <configuration>
+                    <updatePomFile>true</updatePomFile>
+                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>flatten</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>flatten</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>flatten.clean</id>
+                        <phase>clean</phase>
+                        <goals>
+                            <goal>clean</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            
+            <!-- 代码格式插件 -->
             <plugin>
                 <groupId>io.spring.javaformat</groupId>
                 <artifactId>spring-javaformat-maven-plugin</artifactId>
@@ -135,8 +170,7 @@
                 </executions>
             </plugin>
 
-            <!--打包jar
-            与git commit 关联插件-->
+            <!-- Git Commit 信息插件 -->
             <plugin>
                 <groupId>io.github.git-commit-id</groupId>
                 <artifactId>git-commit-id-maven-plugin</artifactId>
@@ -150,7 +184,6 @@
                 <configuration>
                     <failOnNoGitDirectory>false</failOnNoGitDirectory>
                     <generateGitPropertiesFile>true</generateGitPropertiesFile>
-                    <!--因为项目定制了jackson的日期时间序列化/反序列化格式，因此这里要进行配置,不然通过management.info.git.mode=full进行完整git信息监控时会存在问题-->
                     <dateFormat>yyyy-MM-dd HH:mm:ss</dateFormat>
                     <includeOnlyProperties>
                         <includeOnlyProperty>^git.build.(time|version)$</includeOnlyProperty>
@@ -159,12 +192,14 @@
                 </configuration>
             </plugin>
         </plugins>
+        
         <pluginManagement>
             <plugins>
+                <!-- JIB Docker 镜像构建插件 -->
                 <plugin>
                     <groupId>com.google.cloud.tools</groupId>
                     <artifactId>jib-maven-plugin</artifactId>
-                    <version>3.4.5</version>
+                    <version>${jib.plugin.version}</version>
                     <configuration>
                         <allowInsecureRegistries>true</allowInsecureRegistries>
                         <from>