From 0422b4bb419af834ecca90413ce68a39a78a58be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=97=E5=AD=90=E6=B6=B5?= <33446700@qq.com>
Date: Mon, 5 Jan 2026 10:55:12 +0800
Subject: [PATCH 01/22] =?UTF-8?q?fix(Home.vue)=E4=BF=AE=E5=A4=8D=E9=A1=B5?=
 =?UTF-8?q?=E8=84=9A=E7=9A=84=E9=A2=9C=E8=89=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/pages/Home.vue | 44 ++++++++++++++++----------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/webapp/letapp/src/pages/Home.vue b/webapp/letapp/src/pages/Home.vue
index efc2f22..8becccf 100644
--- a/webapp/letapp/src/pages/Home.vue
+++ b/webapp/letapp/src/pages/Home.vue
@@ -200,62 +200,62 @@ const features = [
     </section>
 
     <!-- 页脚 -->
-    <footer class="bg-gray-900 text-gray-300 py-12">
+    <footer class="bg-gray-100 dark:bg-gray-900 text-gray-700 dark:text-gray-300 py-12">
       <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
         <div class="grid grid-cols-1 md:grid-cols-4 gap-8">
           <div>
             <div class="flex items-center gap-2 mb-4">
               <img src="/assets/logo.png" alt="Let Coding" class="w-8 h-8" />
-              <span class="text-white font-semibold text-lg">Let Coding</span>
+              <span class="text-gray-900 dark:text-white font-semibold text-lg">Let Coding</span>
             </div>
-            <p class="text-gray-400 mb-4">
+            <p class="text-gray-600 dark:text-gray-400 mb-4">
               让编程变得简单有趣，随时随地编写和运行代码。
             </p>
             <div class="flex gap-4">
-              <a href="#" class="text-gray-400 hover:text-white transition-colors">
+              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
                 <Icon icon="mdi:github" class="w-5 h-5" />
               </a>
-              <a href="#" class="text-gray-400 hover:text-white transition-colors">
+              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
                 <Icon icon="mdi:twitter" class="w-5 h-5" />
               </a>
-              <a href="#" class="text-gray-400 hover:text-white transition-colors">
+              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
                 <Icon icon="mdi:instagram" class="w-5 h-5" />
               </a>
             </div>
           </div>
           
           <div>
-            <h3 class="text-white font-semibold mb-4">产品</h3>
+            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">产品</h3>
             <ul class="space-y-2">
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">在线编辑器</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">学习资源</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">社区论坛</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">API 文档</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">在线编辑器</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">学习资源</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">社区论坛</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">API 文档</a></li>
             </ul>
           </div>
           
           <div>
-            <h3 class="text-white font-semibold mb-4">公司</h3>
+            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">公司</h3>
             <ul class="space-y-2">
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">关于我们</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">联系我们</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">加入我们</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">隐私政策</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">关于我们</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">联系我们</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">加入我们</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">隐私政策</a></li>
             </ul>
           </div>
           
           <div>
-            <h3 class="text-white font-semibold mb-4">支持</h3>
+            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">支持</h3>
             <ul class="space-y-2">
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">帮助中心</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">常见问题</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">提交反馈</a></li>
-              <li><a href="#" class="text-gray-400 hover:text-white transition-colors">状态页面</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">帮助中心</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">常见问题</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">提交反馈</a></li>
+              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">状态页面</a></li>
             </ul>
           </div>
         </div>
         
-        <div class="mt-12 pt-8 border-t border-gray-800 text-center text-gray-500">
+        <div class="mt-12 pt-8 border-t border-gray-200 dark:border-gray-800 text-center text-gray-600 dark:text-gray-500">
           <p>© {{ new Date().getFullYear() }} Let Coding. 保留所有权利。</p>
         </div>
       </div>
-- 
Gitee


From e5f1aed7e64e55ec7b758a464587083639464b24 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=97=E5=AD=90=E6=B6=B5?= <33446700@qq.com>
Date: Mon, 5 Jan 2026 11:28:51 +0800
Subject: [PATCH 02/22] =?UTF-8?q?fix(MainLayout.vue)=E5=88=A0=E4=BA=86styl?=
 =?UTF-8?q?e.css=E7=9A=84a=E6=A0=87=E7=AD=BE=EF=BC=8C=E8=AE=A9=E7=99=BB?=
 =?UTF-8?q?=E5=BD=95=E6=B3=A8=E5=86=8C=E6=8C=89=E9=92=AE=E7=9A=84=E7=99=BD?=
 =?UTF-8?q?=E8=89=B2=E6=96=87=E5=AD=97=E8=83=BD=E6=AD=A3=E5=B8=B8=E6=98=BE?=
 =?UTF-8?q?=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/layouts/MainLayout.vue | 10 +++++-----
 webapp/letapp/src/style.css              |  4 ----
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/webapp/letapp/src/layouts/MainLayout.vue b/webapp/letapp/src/layouts/MainLayout.vue
index 30cb98f..83722f9 100644
--- a/webapp/letapp/src/layouts/MainLayout.vue
+++ b/webapp/letapp/src/layouts/MainLayout.vue
@@ -45,7 +45,7 @@
               <!-- Login/Register or Logout Button -->
               <router-link
                 to="/login"
-                class="ml-4 px-4 py-2 bg-blue-500 text-white text-sm font-medium rounded-full hover:bg-blue-600 transition-colors"
+                class="ml-4 px-4 py-2 bg-blue-500 dark:bg-blue-600 text-white text-sm font-medium rounded-full hover:bg-blue-600 dark:hover:bg-blue-700 transition-colors focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 dark:focus:ring-offset-black no-underline"
               >
                 登录/注册
               </router-link>
@@ -107,21 +107,21 @@
                 <div class="px-4 py-1 space-y-0.5">
                   <router-link
                       to="/"
-                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
+                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
                       @click="drawerVisible = false"
                   >
                     首页
                   </router-link>
                   <router-link
                       to="/playground"
-                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
+                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
                       @click="drawerVisible = false"
                   >
                     在线编辑
                   </router-link>
                   <router-link
                       to="/learn"
-                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
+                      class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
                       @click="drawerVisible = false"
                   >
                     学习资源
@@ -130,7 +130,7 @@
                   <div class="pt-1.5 border-t border-gray-200 dark:border-gray-800">
                     <router-link
                         to="/login"
-                        class="block w-full px-4 py-2.5 bg-blue-500 text-white text-base font-medium rounded-lg hover:bg-blue-600 transition-colors"
+                        class="block w-full px-4 py-2.5 bg-blue-500 dark:bg-blue-600 text-white text-base font-medium rounded-lg hover:bg-blue-600 dark:hover:bg-blue-700 transition-colors no-underline"
                         @click="drawerVisible = false"
                     >
                       登录/注册
diff --git a/webapp/letapp/src/style.css b/webapp/letapp/src/style.css
index 09b9048..c723d14 100644
--- a/webapp/letapp/src/style.css
+++ b/webapp/letapp/src/style.css
@@ -185,8 +185,4 @@ html, body {
 
 h1:focus {
     outline: none;
-}
-
-a {
-    color: #0071c1;
 }
\ No newline at end of file
-- 
Gitee


From bb632b7550f8431f1666fd0153602e0e8cdaa7a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=97=E5=AD=90=E6=B6=B5?= <33446700@qq.com>
Date: Mon, 5 Jan 2026 15:01:41 +0800
Subject: [PATCH 03/22] =?UTF-8?q?create(About.vue)tm=E6=84=9F=E8=A7=89?=
 =?UTF-8?q?=E6=9C=89=E7=82=B9=E4=B8=91=EF=BC=8C=E5=85=88=E6=94=BE=E5=9C=A8?=
 =?UTF-8?q?=E8=BF=99=E9=87=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/layouts/MainLayout.vue |   8 +-
 webapp/letapp/src/pages/About.vue        | 249 +++++++++++++++++++++++
 webapp/letapp/src/pages/Home.vue         |  79 ++-----
 webapp/letapp/src/router.ts              |   6 +
 4 files changed, 278 insertions(+), 64 deletions(-)
 create mode 100644 webapp/letapp/src/pages/About.vue

diff --git a/webapp/letapp/src/layouts/MainLayout.vue b/webapp/letapp/src/layouts/MainLayout.vue
index 83722f9..05a36c2 100644
--- a/webapp/letapp/src/layouts/MainLayout.vue
+++ b/webapp/letapp/src/layouts/MainLayout.vue
@@ -30,10 +30,10 @@
                 首页
               </router-link>
               <router-link 
-                to="/playground" 
+                to="/about" 
                 class="text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 transition-colors"
               >
-                在线编辑
+                关于我们
               </router-link>
               <router-link 
                 to="/learn" 
@@ -113,11 +113,11 @@
                     首页
                   </router-link>
                   <router-link
-                      to="/playground"
+                      to="/about"
                       class="block px-4 py-2.5 text-base font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800"
                       @click="drawerVisible = false"
                   >
-                    在线编辑
+                    关于我们
                   </router-link>
                   <router-link
                       to="/learn"
diff --git a/webapp/letapp/src/pages/About.vue b/webapp/letapp/src/pages/About.vue
new file mode 100644
index 0000000..5bcd5e2
--- /dev/null
+++ b/webapp/letapp/src/pages/About.vue
@@ -0,0 +1,249 @@
+<template>
+  <div class="min-h-screen bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100 transition-colors duration-300">
+    <!-- 英雄区域 -->
+    <section class="py-16 md:py-24 bg-gradient-to-br from-blue-50 via-indigo-50 to-purple-50 dark:from-gray-800 dark:via-gray-800 dark:to-gray-900 relative overflow-hidden">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center">
+          <h1 class="text-4xl md:text-5xl font-bold tracking-tight mb-6">
+            <span class="block text-gray-900 dark:text-white mb-4 text-3xl md:text-4xl">关于我们</span>
+            <span class="block text-blue-600 dark:text-blue-400 text-2xl md:text-3xl font-normal mt-6">{{ clubInfo.name }}</span>
+          </h1>
+          <p class="text-lg text-gray-600 dark:text-gray-300 max-w-3xl mx-auto mt-4">
+            {{ clubInfo.subtitle }}
+          </p>
+        </div>
+      </div>
+    </section>
+
+    <!-- 社团信息 -->
+    <section class="py-16 bg-white dark:bg-gray-900">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-16">
+          <h2 class="text-3xl font-bold mb-4">社团简介</h2>
+          <p class="text-gray-600 dark:text-gray-300 max-w-2xl mx-auto">
+            {{ clubInfo.description }}
+          </p>
+        </div>
+
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-8 mb-16">
+          <div class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1 flex flex-col items-center justify-center min-h-[150px]">
+            <h3 class="text-base md:text-lg font-semibold mb-1 text-center">成立时间</h3>
+            <p class="text-xl md:text-2xl font-bold text-center text-blue-600 dark:text-blue-400">2019年9月</p>
+          </div>
+          <div class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1 flex flex-col items-center justify-center min-h-[150px]">
+            <h3 class="text-base md:text-lg font-semibold mb-1 text-center">别称</h3>
+            <p class="text-xl md:text-2xl font-bold text-center text-blue-600 dark:text-blue-400">{{ clubInfo.alias }}</p>
+          </div>
+          <div class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1 flex flex-col items-center justify-center min-h-[150px]">
+            <h3 class="text-base md:text-lg font-semibold mb-1 text-center">性质</h3>
+            <p class="text-xl md:text-2xl font-bold text-center text-blue-600 dark:text-blue-400">创新创业类社团</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- 我们的使命 -->
+    <section class="py-16 bg-gray-50 dark:bg-gray-800">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-16">
+          <h2 class="text-3xl font-bold mb-4">我们的使命</h2>
+          <p class="text-gray-600 dark:text-gray-300 max-w-2xl mx-auto">
+            作为创新创业类社团，我们致力于为学生提供全面的编程和创业支持
+          </p>
+        </div>
+
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+          <div 
+            v-for="(mission, index) in missions" 
+            :key="index"
+            class="bg-white dark:bg-gray-900 p-6 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1"
+          >
+            <div class="flex items-start gap-4">
+              <div class="flex-shrink-0 w-10 h-10 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center">
+                <span class="text-blue-600 dark:text-blue-400 font-bold">{{ index + 1 }}</span>
+              </div>
+              <p class="text-gray-700 dark:text-gray-300">{{ mission }}</p>
+            </div>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- 社团业务 -->
+    <section class="py-16 bg-white dark:bg-gray-900">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-16">
+          <h2 class="text-3xl font-bold mb-4">社团业务</h2>
+          <p class="text-gray-600 dark:text-gray-300 max-w-2xl mx-auto">
+            作为学术性社团，我们担负着学校创新创业项目深化、发展的重担
+          </p>
+        </div>
+
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+          <div 
+            v-for="(competition, index) in competitions" 
+            :key="index"
+            class="bg-gray-50 dark:bg-gray-800 p-6 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1"
+          >
+            <h3 class="text-xl font-semibold mb-3 text-blue-600 dark:text-blue-400">{{ competition.name }}</h3>
+            <h4 class="text-lg font-medium mb-2">{{ competition.title }}</h4>
+            <p class="text-gray-600 dark:text-gray-300">{{ competition.description }}</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- 社团活动 -->
+    <section class="py-16 bg-gray-50 dark:bg-gray-800">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-16">
+          <h2 class="text-3xl font-bold mb-4">社团活动</h2>
+          <p class="text-gray-600 dark:text-gray-300 max-w-2xl mx-auto">
+            我们提供丰富的活动和资源，帮助成员学习和成长
+          </p>
+        </div>
+
+        <div class="bg-white dark:bg-gray-900 rounded-2xl shadow-xl p-6 md:p-8 border border-gray-200 dark:border-gray-700 max-w-4xl mx-auto">
+          <ul class="space-y-4">
+            <li 
+              v-for="(activity, index) in activities" 
+              :key="index"
+              class="flex items-start gap-3 p-2 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors duration-200"
+            >
+              <div class="flex-shrink-0 mt-1">
+                <Icon icon="material-symbols:check-circle" class="w-5 h-5 text-green-500" />
+              </div>
+              <span class="text-gray-700 dark:text-gray-300">{{ activity }}</span>
+            </li>
+          </ul>
+        </div>
+      </div>
+    </section>
+
+    <!-- 社团媒体 -->
+    <section class="py-16 bg-white dark:bg-gray-900">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-16">
+          <h2 class="text-3xl font-bold mb-4">社团媒体</h2>
+          <p class="text-gray-600 dark:text-gray-300 max-w-2xl mx-auto">
+            关注我们的社交媒体，获取最新动态和资源
+          </p>
+        </div>
+
+        <div class="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-7 gap-6">
+          <a 
+            v-for="(platform, index) in media" 
+            :key="index"
+            :href="platform.url"
+            target="_blank"
+            class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md hover:shadow-lg transition-shadow border border-gray-200 dark:border-gray-700 flex flex-col items-center justify-center gap-2 hover:translate-y-[-4px] transition-transform"
+          >
+            <div class="w-12 h-12 rounded-full bg-gray-100 dark:bg-gray-700 flex items-center justify-center">
+              <Icon :icon="platform.icon" class="w-6 h-6 text-gray-700 dark:text-gray-300" />
+            </div>
+            <span class="text-sm font-medium text-center">{{ platform.name }}</span>
+          </a>
+        </div>
+      </div>
+    </section>
+
+    <!-- 联系我们 -->
+    <section class="py-16 bg-gray-50 dark:bg-gray-800">
+      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
+        <h2 class="text-3xl font-bold mb-4">联系我们</h2>
+        <p class="text-gray-600 dark:text-gray-300 mb-8 max-w-2xl mx-auto">
+          欢迎给我们写邮箱提意见! 邮箱号: 
+          <a 
+            href="mailto:iosclubxauat@163.com" 
+            class="text-blue-600 dark:text-blue-400 hover:underline"
+          >
+            iosclubxauat@163.com
+          </a>
+        </p>
+        <p class="text-sm text-gray-500 dark:text-gray-400">
+          © {{ new Date().getFullYear() }} {{ clubInfo.name }}. 保留所有权利。
+        </p>
+      </div>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { Icon } from '@iconify/vue';
+
+// 社团信息
+const clubInfo = {
+  name: '西建大iOS众创空间俱乐部',
+  alias: '西建大iOS Club',
+  subtitle: '受信息与控制工程学院指导的创新创业类社团',
+  founded: '2019年9月',
+  description: '西建大iOS众创空间俱乐部没有设备要求，或者说没有任何限制 —— 只要你喜欢数码，热爱编程，或者想要学习编程开发搞项目，就可以加入到西建大iOS众创空间俱乐部。'
+};
+
+// 我们的使命
+const missions = [
+  '助力高校创新创业项目，搭建学生创新创业平台，丰富教学内容，深化校企合作发展。',
+  '培养俱乐部成员的创新创业意识及软件开发、项目编程能力，提升学生自我竞争力，为毕业后服务社会奠定良好基础。',
+  '探讨学科前沿，提升学校在相关学科的技术开发水平和业界影响力。',
+  '帮助扶持创业团队，引入社会项目进入高校，同时助力学生的创新成果转化为社会有效财富。'
+];
+
+// 社团业务
+const competitions = [
+  {
+    name: 'WWDC Scholarship',
+    title: '苹果全球开发者大会学生奖学金',
+    description: 'WWDC是全球iOS开发者的盛会，苹果会在大会上公布新的软、硬件，同时在大会上设立奖学金，每年通过选拔在全球范围内遴选350名优秀开发者参加盛会，Apple公司提供WWDC的门票以及来回机票和住宿。',
+    icon: 'logos:apple'
+  },
+  {
+    name: 'C4',
+    title: '全国高校计算机大赛移动应用创新赛',
+    description: 'C4 是国家级高校计算机能力应用的大赛，其中大赛主要分为四个模块，苹果公司赞助了移动应用创新赛这一模块。',
+    icon: 'material-symbols:code'
+  }
+];
+
+// 社团活动
+const activities = [
+  '每周一次免费iOS开发基础知识培训（由Apple专门讲师进行）',
+  '每周两次免费基础设备使用（Mac、MacBook、ipad、iPhone）',
+  '有机会免费参加Apple组织的青少年开发者冬、夏令营培训。',
+  '定期举行的技术讲座以及区域性学生开发论坛活动。',
+  '当然，你也可以结交到很多优秀的学长学姐，以及你的开发者同好们，组建一个快乐温馨的大家庭！'
+];
+
+// 社团媒体
+const media = [
+  { name: 'Gitee组织', url: '#', icon: 'simple-icons:gitee' },
+  { name: 'Github组织', url: '#', icon: 'simple-icons:github' },
+  { name: 'B站', url: '#', icon: 'simple-icons:bilibili' },
+  { name: '知乎', url: '#', icon: 'simple-icons:zhihu' },
+  { name: '掘金', url: '#', icon: 'simple-icons:juejin' },
+  { name: '抖音', url: '#', icon: 'simple-icons:bytedance' },
+  { name: '微信公众号', url: '#', icon: 'simple-icons:wechat' }
+];
+
+</script>
+
+<style scoped>
+/* 自定义滚动条样式 */
+::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: #f1f1f1;
+  dark:bg-gray-800;
+}
+
+::-webkit-scrollbar-thumb {
+  background: #888;
+  border-radius: 3px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: #555;
+}
+</style>
\ No newline at end of file
diff --git a/webapp/letapp/src/pages/Home.vue b/webapp/letapp/src/pages/Home.vue
index 8becccf..c659970 100644
--- a/webapp/letapp/src/pages/Home.vue
+++ b/webapp/letapp/src/pages/Home.vue
@@ -50,8 +50,8 @@ const features = [
         <div class="flex flex-col md:flex-row items-center justify-between gap-12">
           <div class="md:w-1/2 space-y-6">
             <h1 class="text-4xl md:text-5xl font-bold tracking-tight">
-              <span class="block">让编程变得</span>
-              <span class="block text-transparent bg-clip-text bg-gradient-to-r from-blue-600 to-indigo-600 dark:from-blue-400 dark:to-indigo-400">简单有趣</span>
+              <span class="block text-gray-900 dark:text-white mb-2">让编程变得</span>
+              <span class="block text-blue-600 dark:text-blue-400">简单有趣</span>
             </h1>
             <p class="text-lg text-gray-600 dark:text-gray-300 max-w-md">
               Let Coding 是一个在线代码执行平台，支持多种编程语言，无需安装环境，即可随时编写和运行代码。
@@ -198,65 +198,24 @@ const features = [
         </div>
       </div>
     </section>
+    
+    <footer
+        class="relative z-10 border-t border-slate-200 dark:border-white/10 bg-slate-100 dark:bg-slate-800 backdrop-blur-xl">
+      <div class="max-w-7xl mx-auto px-6 py-12 flex flex-col md:flex-row justify-between items-center gap-6">
+        <p class="text-[10px] md:text-xs text-slate-500 dark:text-slate-400 font-medium">
+          Copyright © 2023 - {{ new Date().getFullYear() }} iOS Club of XAUAT. All rights reserved.
+        </p>
 
-    <!-- 页脚 -->
-    <footer class="bg-gray-100 dark:bg-gray-900 text-gray-700 dark:text-gray-300 py-12">
-      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-        <div class="grid grid-cols-1 md:grid-cols-4 gap-8">
-          <div>
-            <div class="flex items-center gap-2 mb-4">
-              <img src="/assets/logo.png" alt="Let Coding" class="w-8 h-8" />
-              <span class="text-gray-900 dark:text-white font-semibold text-lg">Let Coding</span>
-            </div>
-            <p class="text-gray-600 dark:text-gray-400 mb-4">
-              让编程变得简单有趣，随时随地编写和运行代码。
-            </p>
-            <div class="flex gap-4">
-              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
-                <Icon icon="mdi:github" class="w-5 h-5" />
-              </a>
-              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
-                <Icon icon="mdi:twitter" class="w-5 h-5" />
-              </a>
-              <a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">
-                <Icon icon="mdi:instagram" class="w-5 h-5" />
-              </a>
-            </div>
-          </div>
-          
-          <div>
-            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">产品</h3>
-            <ul class="space-y-2">
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">在线编辑器</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">学习资源</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">社区论坛</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">API 文档</a></li>
-            </ul>
-          </div>
-          
-          <div>
-            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">公司</h3>
-            <ul class="space-y-2">
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">关于我们</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">联系我们</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">加入我们</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">隐私政策</a></li>
-            </ul>
-          </div>
-          
-          <div>
-            <h3 class="text-gray-900 dark:text-white font-semibold mb-4">支持</h3>
-            <ul class="space-y-2">
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">帮助中心</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">常见问题</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">提交反馈</a></li>
-              <li><a href="#" class="text-gray-600 dark:text-gray-400 hover:text-gray-900 dark:hover:text-white transition-colors">状态页面</a></li>
-            </ul>
-          </div>
-        </div>
-        
-        <div class="mt-12 pt-8 border-t border-gray-200 dark:border-gray-800 text-center text-gray-600 dark:text-gray-500">
-          <p>© {{ new Date().getFullYear() }} Let Coding. 保留所有权利。</p>
+        <div class="flex items-center gap-6 text-xs font-medium text-slate-500 dark:text-slate-400">
+          <a href="https://cn.xauat.edu.cn/" target="_blank"
+             class="text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">学校官网</a>
+          <a href="https://beian.miit.gov.cn/" target="_blank"
+             class="text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">陕ICP备2024031872号</a>
+          <a href="https://gitee.com/XAUATiOSClub" target="_blank"
+             class="text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors flex items-center gap-1">
+            <Icon icon="simple-icons:gitee"/>
+            Gitee
+          </a>
         </div>
       </div>
     </footer>
diff --git a/webapp/letapp/src/router.ts b/webapp/letapp/src/router.ts
index ead00f3..27edb08 100644
--- a/webapp/letapp/src/router.ts
+++ b/webapp/letapp/src/router.ts
@@ -27,6 +27,12 @@ const routes = [
                 meta: {title: "学习资源 - Let Coding"},
                 component: () => import('./pages/Learn.vue'),
             },
+            {
+                path: '/about',
+                name: 'About',
+                meta: {title: "关于我们 - Let Coding"},
+                component: () => import('./pages/About.vue'),
+            },
         ]
     },
     {
-- 
Gitee


From 2153bd94071640a616e9602a8df684fc6585c26c Mon Sep 17 00:00:00 2001
From: zs <18031751980@163.com>
Date: Fri, 9 Jan 2026 23:10:20 +0800
Subject: [PATCH 04/22] =?UTF-8?q?=E7=94=A8=E6=88=B7=E7=99=BB=E5=BD=95?=
 =?UTF-8?q?=E7=B3=BB=E7=BB=9F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .env                                          | 25 +++++++
 .../controllers/auth_controller.py            | 37 +++++++---
 .../interfaces/service_interfaces.py          | 19 +++++
 .../fastapi_of_letcoing/models/db_models.py   |  7 +-
 webapi/fastapi_of_letcoing/requirements.txt   |  2 +-
 .../services/oidc_service.py                  | 14 +++-
 .../services/user_service.py                  | 73 ++++++++++++++++++-
 7 files changed, 162 insertions(+), 15 deletions(-)
 create mode 100644 .env

diff --git a/.env b/.env
new file mode 100644
index 0000000..365c4a3
--- /dev/null
+++ b/.env
@@ -0,0 +1,25 @@
+API_TOKEN=993cb7df-6ff5-40c3-9a9c-773921e3a12d
+JWT_SECRET_KEY=MjM3NTg1NDM4ODQ0MTYxMTE3MzUxODIzMTA0ODY2NjQ=
+
+REDIS_HOST=hkg1.clusters.zeabur.com
+REDIS_PORT=30123
+REDIS_DB=0
+REDIS_PASSWORD=2g8o1A45x9n3hsE0m7yrfL6VkbqJXaBW
+
+GITHUB_CLIENT_ID=Ov23liSEPDKQ0r51vqBC
+GITHUB_CLIENT_SECRET=0ce1c2a2a19cb4562fb1b57e64de3c93877d656e
+
+OIDC_PROVIDERS=[
+  {
+    "name": "iOSClub",
+    "issuer": "https://api.xauat.site",
+    "client_id": "ca_0200be03d08f4f58",
+    "client_secret": "$2b$10$AnmhmDe4lO27E.XQwHyWcOVOPiy/tBTymd4zMXt9i6l73vHlxkW1q"
+  }
+]
+
+DB_HOST=hkg1.clusters.zeabur.com
+DB_PORT=32627
+DB_NAME=lettest
+DB_USER=root
+DB_PASSWORD=60zquVE1c7TLInwOivZg9H543Kr2GM8p
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/auth_controller.py b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
index 99228da..c75d5d8 100644
--- a/webapi/fastapi_of_letcoing/controllers/auth_controller.py
+++ b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
@@ -1,6 +1,6 @@
 from flask import request, jsonify, url_for
 from flask_restx import Resource, Namespace, fields
-from interfaces.service_interfaces import IConfigService, ILoggerService, IJWTService, IOIDCService
+from interfaces.service_interfaces import IConfigService, ILoggerService, IJWTService, IOIDCService, IUserService
 from core.di_container import inject
 from models.auth_models import (
     LoginRequest, LoginResponse, AuthCallbackRequest, 
@@ -88,10 +88,11 @@ class AuthCallbackController(Resource):
     @api.response(200, 'Success', auth_result_model)
     @api.response(400, 'Bad Request')
     def get(self, provider: str):
-        """处理认证回调"""
+        """处理认证回调，实现注册和登录集成"""
         # 注入服务
         oidc_service = inject(IOIDCService)
         jwt_service = inject(IJWTService)
+        user_service = inject(IUserService)
         
         # 验证提供商
         if not oidc_service.validate_provider(provider):
@@ -125,14 +126,29 @@ class AuthCallbackController(Resource):
         if not user_info_data:
             return {'success': False, 'error': '获取用户信息失败'}, 500
         
+        # 获取provider_id
+        provider_id = user_info_data.get('id')
+        if not provider_id:
+            return {'success': False, 'error': '无法获取提供商用户ID'}, 500
+        
+        # 查找或创建用户（支持注册和登录集成）
+        try:
+            user_data = user_service.find_or_create_user(
+                provider=provider,
+                provider_id=provider_id,
+                user_info=user_info_data
+            )
+        except Exception as e:
+            return {'success': False, 'error': f'用户处理失败: {str(e)}'}, 500
+        
         # 创建用户信息对象
         user_info = UserInfo(
-            id=user_info_data['id'],
-            username=user_info_data.get('username', ''),
-            email=user_info_data.get('email', ''),
-            name=user_info_data.get('name', ''),
-            avatar_url=user_info_data.get('avatar_url', ''),
-            provider=user_info_data.get('provider', provider)
+            id=user_data['id'],
+            username=user_data.get('username', ''),
+            email=user_data.get('email', ''),
+            name=user_data.get('name', ''),
+            avatar_url=user_data.get('avatar_url', ''),
+            provider=provider
         )
         
         # 生成JWT令牌
@@ -150,7 +166,10 @@ class AuthCallbackController(Resource):
         return {
             'success': True,
             'user_info': user_info.to_dict(),
-            'tokens': token_response.to_dict()
+            'tokens': token_response.to_dict(),
+            'is_new_user': not user_data.get('last_login') or (
+                user_data.get('created_at') == user_data.get('updated_at')
+            )
         }, 200
 
 
diff --git a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
index f5a39e7..c264dc3 100644
--- a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
+++ b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
@@ -271,4 +271,23 @@ class IJWTService(ABC):
         Returns:
             是否成功
         """
+        pass
+
+
+class IUserService(ABC):
+    """用户服务接口"""
+    
+    @abstractmethod
+    async def find_or_create_user(self, provider: str, provider_id: str, user_info: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        根据第三方登录信息查找或创建用户
+        
+        Args:
+            provider: 登录提供商 (如 'github', 'api.xauat.site/sso/signup')
+            provider_id: 提供商的用户ID
+            user_info: 用户信息字典
+            
+        Returns:
+            用户信息字典
+        """
         pass
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/db_models.py b/webapi/fastapi_of_letcoing/models/db_models.py
index 0047483..026eeb2 100644
--- a/webapi/fastapi_of_letcoing/models/db_models.py
+++ b/webapi/fastapi_of_letcoing/models/db_models.py
@@ -83,11 +83,14 @@ class User(BaseModel):
     """用户模型"""
     
     id = AutoField(primary_key=True, verbose_name="用户ID")
-    username = CharField(max_length=50, unique=True, null=False, verbose_name="用户名")
+    username = CharField(max_length=50, unique=True, null=True, verbose_name="用户名")
     email = CharField(max_length=100, unique=True, null=True, verbose_name="邮箱")
-    password_hash = CharField(max_length=255, null=False, verbose_name="密码哈希")
+    password_hash = CharField(max_length=255, null=True, verbose_name="密码")
     is_active = BooleanField(default=True, verbose_name="是否激活")
     last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    provider = CharField(max_length=50, null=True, verbose_name="登录提供商")
+    provider_id = CharField(max_length=255, null=True, verbose_name="提供商用户ID")
+    avatar_url = CharField(max_length=500, null=True, verbose_name="头像URL")
     
     class Meta:
         table_name = "users"
diff --git a/webapi/fastapi_of_letcoing/requirements.txt b/webapi/fastapi_of_letcoing/requirements.txt
index f8faadb..032e878 100644
--- a/webapi/fastapi_of_letcoing/requirements.txt
+++ b/webapi/fastapi_of_letcoing/requirements.txt
@@ -34,4 +34,4 @@ requests==2.32.5
 rpds-py==0.30.0
 urllib3==2.6.2
 Werkzeug==3.1.4
-yarl==1.22.0
+yarl==1.22.0
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/oidc_service.py b/webapi/fastapi_of_letcoing/services/oidc_service.py
index b9b6297..c3d2138 100644
--- a/webapi/fastapi_of_letcoing/services/oidc_service.py
+++ b/webapi/fastapi_of_letcoing/services/oidc_service.py
@@ -175,9 +175,19 @@ class OIDCService(Injectable, IOIDCService):
                     'provider': provider
                 }
             else:
-                # 标准 OIDC 用户信息端点
+                # 标准 OIDC 用户信息端点（支持 api.xauat.site/sso/signup 等自定义提供商）
                 resp = client.get('userinfo', token=token)
-                return resp.json()
+                user_data = resp.json()
+                
+                # 标准化用户信息格式
+                return {
+                    'id': user_data.get('sub') or user_data.get('id'),
+                    'username': user_data.get('preferred_username') or user_data.get('username') or user_data.get('name'),
+                    'name': user_data.get('name', ''),
+                    'email': user_data.get('email', ''),
+                    'avatar_url': user_data.get('picture') or user_data.get('avatar_url', ''),
+                    'provider': provider
+                }
                 
         except Exception as ex:
             self._logger_service.error(f"获取用户信息失败: {provider}", ex)
diff --git a/webapi/fastapi_of_letcoing/services/user_service.py b/webapi/fastapi_of_letcoing/services/user_service.py
index 5c742d0..1a6f645 100644
--- a/webapi/fastapi_of_letcoing/services/user_service.py
+++ b/webapi/fastapi_of_letcoing/services/user_service.py
@@ -162,4 +162,75 @@ class UserService(DatabaseService, Injectable):
         except DoesNotExist:
             return None
         except Exception as e:
-            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
\ No newline at end of file
+            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
+    
+    async def find_or_create_user(self, provider: str, provider_id: str, user_info: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        根据第三方登录信息查找或创建用户
+        
+        Args:
+            provider: 登录提供商 (如 'github', 'api.xauat.site/sso/signup')
+            provider_id: 提供商的用户ID
+            user_info: 用户信息字典
+            
+        Returns:
+            用户信息字典
+        """
+        try:
+            # 尝试根据provider和provider_id查找用户
+            try:
+                user = User.get(
+                    (User.provider == provider) & 
+                    (User.provider_id == provider_id)
+                )
+                
+                # 更新用户信息
+                if user_info.get('username') and user.username != user_info['username']:
+                    user.username = user_info['username']
+                if user_info.get('email') and user.email != user_info['email']:
+                    user.email = user_info['email']
+                if user_info.get('avatar_url') and user.avatar_url != user_info['avatar_url']:
+                    user.avatar_url = user_info['avatar_url']
+                
+                user.last_login = datetime.now()
+                user.save()
+                
+                print(f"用户登录成功: {user.id} ({provider})")
+                return user.to_dict()
+                
+            except DoesNotExist:
+                # 用户不存在，创建新用户
+                username = user_info.get('username') or f"{provider}_{provider_id}"
+                email = user_info.get('email')
+                
+                # 检查用户名是否已存在
+                try:
+                    existing_user = User.get(User.username == username)
+                    username = f"{username}_{provider_id}"
+                except DoesNotExist:
+                    pass
+                
+                # 检查邮箱是否已存在
+                if email:
+                    try:
+                        existing_user = User.get(User.email == email)
+                        email = None
+                    except DoesNotExist:
+                        pass
+                
+                user = User.create(
+                    username=username,
+                    email=email,
+                    password_hash=None,
+                    provider=provider,
+                    provider_id=provider_id,
+                    avatar_url=user_info.get('avatar_url'),
+                    is_active=True,
+                    last_login=datetime.now()
+                )
+                
+                print(f"新用户注册成功: {user.id} ({provider})")
+                return user.to_dict()
+                
+        except Exception as e:
+            raise RuntimeError(f"查找或创建用户时发生错误: {e}")
\ No newline at end of file
-- 
Gitee


From bb71334ea7c1a2642e24bbfbb25a33677053bb36 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=97=E5=AD=90=E6=B6=B5?= <33446700@qq.com>
Date: Sat, 10 Jan 2026 14:54:20 +0800
Subject: [PATCH 05/22] =?UTF-8?q?=E4=BC=98=E5=8C=96(Home,About)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/pages/About.vue | 30 ++++++++---------
 webapp/letapp/src/pages/Home.vue  | 54 +++++++++++++++----------------
 2 files changed, 42 insertions(+), 42 deletions(-)

diff --git a/webapp/letapp/src/pages/About.vue b/webapp/letapp/src/pages/About.vue
index 5bcd5e2..7238f69 100644
--- a/webapp/letapp/src/pages/About.vue
+++ b/webapp/letapp/src/pages/About.vue
@@ -55,7 +55,7 @@
         <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
           <div 
             v-for="(mission, index) in missions" 
-            :key="index"
+            :key="`mission-${index}`"
             class="bg-white dark:bg-gray-900 p-6 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1"
           >
             <div class="flex items-start gap-4">
@@ -82,7 +82,7 @@
         <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
           <div 
             v-for="(competition, index) in competitions" 
-            :key="index"
+            :key="`competition-${index}`"
             class="bg-gray-50 dark:bg-gray-800 p-6 rounded-xl shadow-md border border-gray-200 dark:border-gray-700 hover:shadow-xl transition-all duration-300 hover:-translate-y-1"
           >
             <h3 class="text-xl font-semibold mb-3 text-blue-600 dark:text-blue-400">{{ competition.name }}</h3>
@@ -107,7 +107,7 @@
           <ul class="space-y-4">
             <li 
               v-for="(activity, index) in activities" 
-              :key="index"
+              :key="`activity-${index}`"
               class="flex items-start gap-3 p-2 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors duration-200"
             >
               <div class="flex-shrink-0 mt-1">
@@ -133,7 +133,7 @@
         <div class="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-7 gap-6">
           <a 
             v-for="(platform, index) in media" 
-            :key="index"
+            :key="`media-${index}`"
             :href="platform.url"
             target="_blank"
             class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md hover:shadow-lg transition-shadow border border-gray-200 dark:border-gray-700 flex flex-col items-center justify-center gap-2 hover:translate-y-[-4px] transition-transform"
@@ -169,27 +169,28 @@
 </template>
 
 <script setup lang="ts">
+import { readonly } from 'vue';
 import { Icon } from '@iconify/vue';
 
 // 社团信息
-const clubInfo = {
+const clubInfo = readonly({
   name: '西建大iOS众创空间俱乐部',
   alias: '西建大iOS Club',
   subtitle: '受信息与控制工程学院指导的创新创业类社团',
   founded: '2019年9月',
   description: '西建大iOS众创空间俱乐部没有设备要求，或者说没有任何限制 —— 只要你喜欢数码，热爱编程，或者想要学习编程开发搞项目，就可以加入到西建大iOS众创空间俱乐部。'
-};
+});
 
 // 我们的使命
-const missions = [
+const missions = readonly([
   '助力高校创新创业项目，搭建学生创新创业平台，丰富教学内容，深化校企合作发展。',
   '培养俱乐部成员的创新创业意识及软件开发、项目编程能力，提升学生自我竞争力，为毕业后服务社会奠定良好基础。',
   '探讨学科前沿，提升学校在相关学科的技术开发水平和业界影响力。',
   '帮助扶持创业团队，引入社会项目进入高校，同时助力学生的创新成果转化为社会有效财富。'
-];
+]);
 
 // 社团业务
-const competitions = [
+const competitions = readonly([
   {
     name: 'WWDC Scholarship',
     title: '苹果全球开发者大会学生奖学金',
@@ -202,19 +203,19 @@ const competitions = [
     description: 'C4 是国家级高校计算机能力应用的大赛，其中大赛主要分为四个模块，苹果公司赞助了移动应用创新赛这一模块。',
     icon: 'material-symbols:code'
   }
-];
+]);
 
 // 社团活动
-const activities = [
+const activities = readonly([
   '每周一次免费iOS开发基础知识培训（由Apple专门讲师进行）',
   '每周两次免费基础设备使用（Mac、MacBook、ipad、iPhone）',
   '有机会免费参加Apple组织的青少年开发者冬、夏令营培训。',
   '定期举行的技术讲座以及区域性学生开发论坛活动。',
   '当然，你也可以结交到很多优秀的学长学姐，以及你的开发者同好们，组建一个快乐温馨的大家庭！'
-];
+]);
 
 // 社团媒体
-const media = [
+const media = readonly([
   { name: 'Gitee组织', url: '#', icon: 'simple-icons:gitee' },
   { name: 'Github组织', url: '#', icon: 'simple-icons:github' },
   { name: 'B站', url: '#', icon: 'simple-icons:bilibili' },
@@ -222,8 +223,7 @@ const media = [
   { name: '掘金', url: '#', icon: 'simple-icons:juejin' },
   { name: '抖音', url: '#', icon: 'simple-icons:bytedance' },
   { name: '微信公众号', url: '#', icon: 'simple-icons:wechat' }
-];
-
+]);
 </script>
 
 <style scoped>
diff --git a/webapp/letapp/src/pages/Home.vue b/webapp/letapp/src/pages/Home.vue
index c659970..3ca8895 100644
--- a/webapp/letapp/src/pages/Home.vue
+++ b/webapp/letapp/src/pages/Home.vue
@@ -1,12 +1,13 @@
 <script setup lang="ts">
-// import { ref } from 'vue'; // 未使用，注释掉
-import { Icon } from '@iconify/vue';
 import { useRouter } from 'vue-router';
+import { readonly } from 'vue';
+import { defineAsyncComponent } from 'vue';
 
+const Icon = defineAsyncComponent(() => import('@iconify/vue').then(m => m.Icon));
 const router = useRouter();
 
 // 支持的编程语言
-const languages = [
+const languages = readonly([
   { name: 'JavaScript', icon: 'vscode-icons:file-type-js-official', color: '#F7DF1E' },
   { name: 'Python', icon: 'vscode-icons:file-type-python', color: '#3776AB' },
   { name: 'Java', icon: 'vscode-icons:file-type-java', color: '#ED8B00' },
@@ -15,10 +16,9 @@ const languages = [
   { name: 'Rust', icon: 'vscode-icons:file-type-rust', color: '#DEA584' },
   { name: 'Swift', icon: 'vscode-icons:file-type-swift', color: '#FA7343' },
   { name: 'Kotlin', icon: 'vscode-icons:file-type-kotlin', color: '#7F52FF' },
-];
-
+]);
 // 核心功能
-const features = [
+const features = readonly([
   {
     icon: 'material-symbols:code',
     title: '多语言支持',
@@ -39,7 +39,7 @@ const features = [
     title: '社区分享',
     description: '与其他开发者分享你的代码，学习和交流编程技巧。',
   },
-];
+]);
 </script>
 
 <template>
@@ -57,14 +57,14 @@ const features = [
               Let Coding 是一个在线代码执行平台，支持多种编程语言，无需安装环境，即可随时编写和运行代码。
             </p>
             <div class="flex flex-col sm:flex-row gap-4">
-              <button 
-                class="px-8 py-3 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors shadow-lg hover:shadow-xl"
+              <button
+                class="px-8 py-3 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors shadow-lg hover:shadow-xl hover:scale-105 hover:shadow-lg transition-all duration-300"
                 @click="router.push('/playground')"
               >
                 立即开始
               </button>
-              <button 
-                class="px-8 py-3 bg-white dark:bg-gray-800 text-gray-900 dark:text-white font-medium rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors shadow-md border border-gray-200 dark:border-gray-700"
+              <button
+                class="px-8 py-3 bg-white dark:bg-gray-800 text-gray-900 dark:text-white font-medium rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors shadow-md border border-gray-200 dark:border-gray-700 hover:scale-105 hover:shadow-lg transition-all duration-300"
                 @click="router.push('/learn')"
               >
                 学习资源
@@ -110,10 +110,10 @@ const features = [
             Let Coding 提供了一系列强大的功能，帮助你更高效地学习和编写代码。
           </p>
         </div>
-        
+
         <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-8">
-          <div 
-            v-for="(feature, index) in features" 
+          <div
+            v-for="(feature, index) in features"
             :key="index"
             class="bg-white dark:bg-gray-800 p-6 rounded-xl shadow-lg hover:shadow-xl transition-shadow border border-gray-200 dark:border-gray-700 hover:translate-y-[-4px] transition-transform"
           >
@@ -136,15 +136,15 @@ const features = [
             选择你喜欢的编程语言，开始编写代码吧！
           </p>
         </div>
-        
+
         <div class="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-8 gap-6">
-          <div 
-            v-for="(lang, index) in languages" 
+          <div
+            v-for="(lang, index) in languages"
             :key="index"
             class="bg-white dark:bg-gray-900 p-4 rounded-lg shadow-md hover:shadow-lg transition-shadow border border-gray-200 dark:border-gray-700 flex flex-col items-center justify-center gap-2 hover:translate-y-[-2px] transition-transform"
           >
             <div class="w-12 h-12 rounded-full bg-gray-100 dark:bg-gray-800 flex items-center justify-center">
-              <Icon :icon="lang.icon" class="w-6 h-6" :style="{ color: lang.color }" />
+              <Icon :icon="lang.icon" class="w-6 h-6 transform hover:scale-125 hover:rotate-5 transition-transform duration-200" :style="{ color: lang.color }" />
             </div>
             <span class="text-sm font-medium">{{ lang.name }}</span>
           </div>
@@ -161,25 +161,25 @@ const features = [
             只需三步，即可开始使用 Let Coding 编写和运行代码。
           </p>
         </div>
-        
+
         <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
-          <div class="flex flex-col items-center text-center">
+          <div class="flex flex-col items-center text-centerp-4 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-all duration-300 hover:-translate-y-1">
             <div class="w-16 h-16 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center text-blue-600 dark:text-blue-400 font-bold text-2xl mb-4">1</div>
             <h3 class="text-xl font-semibold mb-2">选择语言</h3>
             <p class="text-gray-600 dark:text-gray-300">
               从 20+ 种编程语言中选择你想要使用的语言。
             </p>
           </div>
-          
-          <div class="flex flex-col items-center text-center">
+
+          <div class="flex flex-col items-center text-center p-4 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-all duration-300 hover:-translate-y-1">
             <div class="w-16 h-16 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center text-blue-600 dark:text-blue-400 font-bold text-2xl mb-4">2</div>
             <h3 class="text-xl font-semibold mb-2">编写代码</h3>
             <p class="text-gray-600 dark:text-gray-300">
               在我们的在线编辑器中编写你的代码，支持语法高亮和自动补全。
             </p>
           </div>
-          
-          <div class="flex flex-col items-center text-center">
+
+          <div class="flex flex-col items-center text-center rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800 transition-all duration-300 hover:-translate-y-1">
             <div class="w-16 h-16 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center text-blue-600 dark:text-blue-400 font-bold text-2xl mb-4">3</div>
             <h3 class="text-xl font-semibold mb-2">运行代码</h3>
             <p class="text-gray-600 dark:text-gray-300">
@@ -187,9 +187,9 @@ const features = [
             </p>
           </div>
         </div>
-        
+
         <div class="mt-16 text-center">
-          <button 
+          <button
             class="px-8 py-3 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors shadow-lg hover:shadow-xl"
             @click="router.push('/playground')"
           >
@@ -198,7 +198,7 @@ const features = [
         </div>
       </div>
     </section>
-    
+
     <footer
         class="relative z-10 border-t border-slate-200 dark:border-white/10 bg-slate-100 dark:bg-slate-800 backdrop-blur-xl">
       <div class="max-w-7xl mx-auto px-6 py-12 flex flex-col md:flex-row justify-between items-center gap-6">
-- 
Gitee


From 3dad614e578fcdba79d8bd6a2d0d4f147bf9cff4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=AE=97=E5=AD=90=E6=B6=B5?= <33446700@qq.com>
Date: Mon, 12 Jan 2026 15:10:26 +0800
Subject: [PATCH 06/22] =?UTF-8?q?fix(About)=E5=A2=9E=E5=8A=A0=E8=B7=B3?=
 =?UTF-8?q?=E8=BD=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/pages/About.vue | 26 ++++++++++++++++++++------
 1 file changed, 20 insertions(+), 6 deletions(-)

diff --git a/webapp/letapp/src/pages/About.vue b/webapp/letapp/src/pages/About.vue
index 7238f69..0ba5599 100644
--- a/webapp/letapp/src/pages/About.vue
+++ b/webapp/letapp/src/pages/About.vue
@@ -136,6 +136,12 @@
             :key="`media-${index}`"
             :href="platform.url"
             target="_blank"
+            @click="(e) => {
+            const shouldNavigate = handleMediaClick(platform);
+            if (!shouldNavigate) {
+              e.preventDefault();
+            }
+          }"
             class="bg-gray-50 dark:bg-gray-800 p-4 rounded-xl shadow-md hover:shadow-lg transition-shadow border border-gray-200 dark:border-gray-700 flex flex-col items-center justify-center gap-2 hover:translate-y-[-4px] transition-transform"
           >
             <div class="w-12 h-12 rounded-full bg-gray-100 dark:bg-gray-700 flex items-center justify-center">
@@ -216,14 +222,22 @@ const activities = readonly([
 
 // 社团媒体
 const media = readonly([
-  { name: 'Gitee组织', url: '#', icon: 'simple-icons:gitee' },
-  { name: 'Github组织', url: '#', icon: 'simple-icons:github' },
+  { name: 'Gitee组织', url: 'https://gitee.com/XAUATiOSClub', icon: 'simple-icons:gitee' },
+  { name: 'Github组织', url: 'https://github.com/XAUAT-iOSClub', icon: 'simple-icons:github' },
   { name: 'B站', url: '#', icon: 'simple-icons:bilibili' },
-  { name: '知乎', url: '#', icon: 'simple-icons:zhihu' },
-  { name: '掘金', url: '#', icon: 'simple-icons:juejin' },
-  { name: '抖音', url: '#', icon: 'simple-icons:bytedance' },
-  { name: '微信公众号', url: '#', icon: 'simple-icons:wechat' }
+  { name: '知乎', url: 'https://www.zhihu.com/people/83-49-80-67', icon: 'simple-icons:zhihu' },
+  { name: '掘金', url: 'https://juejin.cn/user/939445846031627', icon: 'simple-icons:juejin' },
+  { name: '抖音', url: 'https://www.douyin.com/user/MS4wLjABAAAA042crZROwmNV69KtvhQSGtyLEZZATt4z1ewoXk-dLxCmt2S_DNus5c2KP_5S2CTY?from_tab_name=main', icon: 'simple-icons:bytedance' },
+  { name: '微信公众号', url: '#', icon: 'simple-icons:wechat', action: 'search' }
 ]);
+
+const handleMediaClick = (platform) => {
+  if (platform.action === 'search' && platform.name === '微信公众号') {
+    alert('请在微信中搜索公众号：西建大iOS众创空间俱乐部');
+    return false; // 阻止默认导航行为
+  }
+  return true;
+}
 </script>
 
 <style scoped>
-- 
Gitee


From 943b26240f0e64160aa47e76303aa6d0603b5ca0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E7=BB=AA=E4=B8=9C?=
 <16368191+wu_wxd@user.noreply.gitee.com>
Date: Wed, 14 Jan 2026 18:43:30 +0800
Subject: [PATCH 07/22] =?UTF-8?q?=E7=94=A8=E6=88=B7API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../core/service_config.py                    |   19 +-
 .../interfaces/__init__.py                    |   27 +
 .../interfaces/service_interfaces.py          | 1358 ++++++++++++++++-
 .../services/config_service.py                |   52 +-
 .../services/database_service.py              |  157 +-
 5 files changed, 1473 insertions(+), 140 deletions(-)

diff --git a/webapi/fastapi_of_letcoing/core/service_config.py b/webapi/fastapi_of_letcoing/core/service_config.py
index 3dbd17b..b850512 100644
--- a/webapi/fastapi_of_letcoing/core/service_config.py
+++ b/webapi/fastapi_of_letcoing/core/service_config.py
@@ -13,7 +13,10 @@ from services.jwt_service import JWTService
 from services.redis_service import RedisService
 from services.database_service import DatabaseService
 from services.user_service import UserService
-from interfaces.service_interfaces import IConfigService, ILoggerService, ICodeExecutionService, IRedisService, IOIDCService, IJWTService
+from interfaces.service_interfaces import (
+    IConfigService, ILoggerService, ICodeExecutionService, 
+    IRedisService, IOIDCService, IJWTService, IDatabaseService, IUserService
+)
 
 
 def setup_services(app_config: dict) -> None:
@@ -29,18 +32,8 @@ def setup_services(app_config: dict) -> None:
         container.register_scoped(ICodeExecutionService, GlotService)
         container.register_singleton(IOIDCService, OIDCService)
         container.register_singleton(IJWTService, JWTService)
-        
-        # 数据库服务（依赖于ConfigService）
-        def create_database_service():
-            config_service = container.resolve(IConfigService)
-            return DatabaseService(config_service)
-        
-        def create_user_service():
-            config_service = container.resolve(IConfigService)
-            return UserService(config_service)
-        
-        container.register_singleton(DatabaseService, factory=create_database_service)
-        container.register_singleton(UserService, factory=create_user_service)
+        container.register_singleton(IDatabaseService, DatabaseService)
+        container.register_singleton(IUserService, UserService)
     
     configure_services(service_configurator)
 
diff --git a/webapi/fastapi_of_letcoing/interfaces/__init__.py b/webapi/fastapi_of_letcoing/interfaces/__init__.py
index e69de29..e320797 100644
--- a/webapi/fastapi_of_letcoing/interfaces/__init__.py
+++ b/webapi/fastapi_of_letcoing/interfaces/__init__.py
@@ -0,0 +1,27 @@
+"""
+接口模块
+
+包含所有服务接口定义。
+"""
+
+from .service_interfaces import (
+    IConfigService,
+    ICodeExecutionService,
+    ILoggerService,
+    IRedisService,
+    IOIDCService,
+    IJWTService,
+    IDatabaseService,
+    IUserService
+)
+
+__all__ = [
+    "IConfigService",
+    "ICodeExecutionService",
+    "ILoggerService",
+    "IRedisService",
+    "IOIDCService",
+    "IJWTService",
+    "IDatabaseService",
+    "IUserService"
+]
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
index f5a39e7..b1f4523 100644
--- a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
+++ b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
@@ -6,7 +6,6 @@
 
 from abc import ABC, abstractmethod
 from typing import Optional, Dict, Any, List
-import os
 from models.auth_models import JWTToken
 from models.glot_models import CodeExecutionResponse
 
@@ -28,6 +27,16 @@ class IConfigService(ABC):
     def get_config(self, key: str, default: Any = None) -> Any:
         """获取配置值"""
         pass
+    
+    @abstractmethod
+    def get_database_config(self) -> Dict[str, Any]:
+        """获取数据库配置"""
+        pass
+    
+    @abstractmethod
+    def get_redis_config(self) -> Dict[str, Any]:
+        """获取Redis配置"""
+        pass
 
 
 class ICodeExecutionService(ABC):
@@ -239,7 +248,7 @@ class IJWTService(ABC):
         """
         验证访问令牌
         
-        Args:
+Args:
             token: JWT 访问令牌
             
         Returns:
@@ -271,4 +280,1347 @@ class IJWTService(ABC):
         Returns:
             是否成功
         """
-        pass
\ No newline at end of file
+        pass
+
+
+class IDatabaseService(ABC):
+    """数据库服务接口"""
+    
+    @abstractmethod
+    def connect(self) -> bool:
+        """连接数据库"""
+        pass
+    
+    @abstractmethod
+    def disconnect(self) -> None:
+        """断开数据库连接"""
+        pass
+    
+    @abstractmethod
+    def is_connected(self) -> bool:
+        """检查是否已连接"""
+        pass
+    
+    @abstractmethod
+    def create(self, model_class, **kwargs) -> Dict[str, Any]:
+        """创建记录"""
+        pass
+    
+    @abstractmethod
+    def get_by_id(self, model_class, record_id: int) -> Optional[Dict[str, Any]]:
+        """根据ID获取记录"""
+        pass
+    
+    @abstractmethod
+    def update(self, model_class, record_id: int, **kwargs) -> bool:
+        """更新记录"""
+        pass
+    
+    @abstractmethod
+    def delete(self, model_class, record_id: int) -> bool:
+        """删除记录"""
+        pass
+    
+    @abstractmethod
+    def list_all(self, model_class, limit: int = 100, offset: int = 0) -> List[Dict[str, Any]]:
+        """获取所有记录"""
+        pass
+    
+    @abstractmethod
+    def count(self, model_class) -> int:
+        """统计记录数量"""
+        pass
+
+
+class IUserService(ABC):
+    """用户服务接口"""
+    
+    @abstractmethod
+    async def create_user(self, username: str, password_hash: str = None, email: Optional[str] = None, role: str = "user") -> Dict[str, Any]:
+        """创建用户"""
+        pass
+    
+    @abstractmethod
+    async def get_user_by_id(self, user_id: int) -> Optional[Dict[str, Any]]:
+        """根据ID获取用户"""
+        pass
+    
+    @abstractmethod
+    async def get_user_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        """根据用户名获取用户"""
+        pass
+    
+    @abstractmethod
+    async def get_user_by_email(self, email: str) -> Optional[Dict[str, Any]]:
+        """根据邮箱获取用户"""
+        pass
+    
+    @abstractmethod
+    async def get_user_by_provider(self, provider: str, provider_user_id: str) -> Optional[Dict[str, Any]]:
+        """根据认证提供商和用户ID获取用户"""
+        pass
+    
+    @abstractmethod
+    async def link_user_provider(self, user_id: int, provider: str, provider_user_id: str, 
+                               provider_email: str = None, access_token: str = None, 
+                               refresh_token: str = None, expires_at: Any = None) -> bool:
+        """为用户关联第三方认证提供商"""
+        pass
+    
+    @abstractmethod
+    async def unlink_user_provider(self, user_id: int, provider: str) -> bool:
+        """取消用户与第三方认证提供商的关联"""
+        pass
+    
+    @abstractmethod
+    async def update_user_last_login(self, user_id: int) -> bool:
+        """更新用户最后登录时间"""
+        pass
+    
+    @abstractmethod
+    async def update_user_info(self, user_id: int, **kwargs) -> bool:
+        """更新用户信息"""
+        pass
+    
+    @abstractmethod
+    async def admin_update_user(self, user_id: int, **kwargs) -> bool:
+        """管理员更新用户信息"""
+        pass
+    
+    @abstractmethod
+    async def deactivate_user(self, user_id: int) -> bool:
+        """停用用户"""
+        pass
+    
+    @abstractmethod
+    async def activate_user(self, user_id: int) -> bool:
+        """激活用户"""
+        pass
+    
+    @abstractmethod
+    async def update_user_password(self, user_id: int, password_hash: str) -> bool:
+        """更新用户密码"""
+        pass
+    
+    @abstractmethod
+    async def delete_user(self, user_id: int) -> bool:
+        """删除用户"""
+        pass
+    
+    @abstractmethod
+    async def list_users(self, limit: int = 50, offset: int = 0, active_only: bool = False) -> List[Dict[str, Any]]:
+        """获取用户列表"""
+        pass
+    
+    @abstractmethod
+    async def search_users(self, keyword: str, limit: int = 20) -> List[Dict[str, Any]]:
+        """搜索用户"""
+        pass
+    
+    @abstractmethod
+    async def count_users(self, active_only: bool = False) -> int:
+        """统计用户数量"""
+        pass
+    
+    @abstractmethod
+    async def get_user_with_password_hash(self, user_id: int) -> Optional[Dict[str, Any]]:
+        """获取包含密码哈希的用户信息（用于认证）"""
+        pass
+    
+    @abstractmethod
+    async def get_user_with_password_hash_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        """根据用户名获取包含密码哈希的用户信息"""
+        pass
+    
+    @abstractmethod
+    async def get_user_auths(self, user_id: int) -> List[Dict[str, Any]]:
+        """获取用户的所有认证方式"""
+        pass
+    
+    @abstractmethod
+    async def is_admin(self, user_id: int) -> bool:
+        """检查用户是否为管理员"""
+        pass
+
+
+"""
+认证API控制器
+处理用户认证相关的API请求
+"""
+from datetime import datetime
+from typing import Dict, Any, List, Optional
+from fastapi import APIRouter, Depends, HTTPException, status, Request
+from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
+from pydantic import BaseModel, Field
+from passlib.context import CryptContext
+
+from core.di_container import get_container
+from interfaces.service_interfaces import IJWTService, IOIDCService
+from services.user_service import UserService
+from models.db_models import AuthProvider
+
+
+# 创建路由
+router = APIRouter(
+    prefix="/auth",
+    tags=["auth"],
+    responses={404: {"description": "Not found"}},
+)
+
+
+# 依赖注入
+container = get_container()
+jwt_service = container.resolve(IJWTService)
+oidc_service = container.resolve(IOIDCService)
+user_service = container.resolve(UserService)
+
+
+# 密码上下文
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+
+
+# 数据模型
+class LoginRequest(BaseModel):
+    """登录请求模型"""
+    username: str = Field(..., min_length=3, max_length=50)
+    password: str = Field(..., min_length=6, max_length=100)
+
+
+class RegisterRequest(BaseModel):
+    """注册请求模型"""
+    username: str = Field(..., min_length=3, max_length=50)
+    email: str = Field(..., max_length=100)
+    password: str = Field(..., min_length=6, max_length=100)
+
+
+class TokenResponse(BaseModel):
+    """令牌响应模型"""
+    access_token: str
+    refresh_token: str
+    token_type: str = "bearer"
+    expires_in: int
+
+
+class RefreshTokenRequest(BaseModel):
+    """刷新令牌请求模型"""
+    refresh_token: str
+
+
+class OAuthProviderList(BaseModel):
+    """OAuth提供商列表模型"""
+    providers: List[str]
+
+
+class OAuthLoginURL(BaseModel):
+    """OAuth登录URL模型"""
+    url: str
+
+
+# 路由处理
+@router.post("/login", response_model=TokenResponse, summary="用户登录")
+async def login(login_data: LoginRequest):
+    """用户登录，返回JWT令牌"""
+    user = await user_service.get_user_with_password_hash_by_username(login_data.username)
+    
+    if not user or not pwd_context.verify(login_data.password, user.get("password_hash")):
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="用户名或密码错误"
+        )
+    
+    if not user.get("is_active"):
+        raise HTTPException(
+            status_code=status.HTTP_403_FORBIDDEN,
+            detail="用户已被禁用"
+        )
+    
+    # 更新最后登录时间
+    await user_service.update_user_last_login(user.get("id"))
+    
+    # 生成令牌
+    user_info = {
+        "user_id": user.get("id"),
+        "username": user.get("username"),
+        "email": user.get("email"),
+        "role": user.get("role")
+    }
+    
+    tokens = jwt_service.generate_tokens(user_info)
+    
+    return {
+        "access_token": tokens.access_token,
+        "refresh_token": tokens.refresh_token,
+        "token_type": "bearer",
+        "expires_in": tokens.expires_in
+    }
+
+
+@router.post("/register", response_model=TokenResponse, summary="用户注册")
+async def register(register_data: RegisterRequest):
+    """用户注册，返回JWT令牌"""
+    # 检查用户名是否已存在
+    existing_user = await user_service.get_user_by_username(register_data.username)
+    if existing_user:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="用户名已存在"
+        )
+    
+    # 检查邮箱是否已存在
+    existing_email = await user_service.get_user_by_email(register_data.email)
+    if existing_email:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="邮箱已存在"
+        )
+    
+    # 创建用户
+    password_hash = pwd_context.hash(register_data.password)
+    user = await user_service.create_user(
+        username=register_data.username,
+        password_hash=password_hash,
+        email=register_data.email
+    )
+    
+    # 关联本地认证
+    await user_service.link_user_provider(
+        user_id=user.get("id"),
+        provider=AuthProvider.LOCAL,
+        provider_user_id=user.get("id"),
+        provider_email=user.get("email")
+    )
+    
+    # 生成令牌
+    user_info = {
+        "user_id": user.get("id"),
+        "username": user.get("username"),
+        "email": user.get("email"),
+        "role": user.get("role")
+    }
+    
+    tokens = jwt_service.generate_tokens(user_info)
+    
+    return {
+        "access_token": tokens.access_token,
+        "refresh_token": tokens.refresh_token,
+        "token_type": "bearer",
+        "expires_in": tokens.expires_in
+    }
+
+
+@router.post("/refresh", response_model=TokenResponse, summary="刷新访问令牌")
+async def refresh_token(refresh_data: RefreshTokenRequest):
+    """使用刷新令牌获取新的访问令牌"""
+    tokens = jwt_service.refresh_access_token(refresh_data.refresh_token)
+    
+    if not tokens:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="刷新令牌无效或已过期"
+        )
+    
+    return {
+        "access_token": tokens.access_token,
+        "refresh_token": tokens.refresh_token,
+        "token_type": "bearer",
+        "expires_in": tokens.expires_in
+    }
+
+
+@router.post("/logout", summary="用户登出")
+async def logout(credentials: HTTPAuthorizationCredentials = Depends(HTTPBearer())):
+    """用户登出，将访问令牌加入黑名单"""
+    token = credentials.credentials
+    revoked = jwt_service.revoke_token(token)
+    
+    if not revoked:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="令牌撤销失败"
+        )
+    
+    return {"message": "登出成功"}
+
+
+@router.get("/oauth/providers", response_model=OAuthProviderList, summary="获取支持的OAuth提供商")
+async def get_oauth_providers():
+    """获取系统支持的所有OAuth提供商"""
+    providers = oidc_service.get_supported_providers()
+    return {"providers": providers}
+
+
+@router.get("/oauth/login/{provider}", response_model=OAuthLoginURL, summary="获取OAuth登录URL")
+async def get_oauth_login_url(provider: str, request: Request):
+    """获取指定OAuth提供商的登录URL"""
+    if not oidc_service.validate_provider(provider):
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="不支持的认证提供商"
+        )
+    
+    # 构建回调URL
+    redirect_uri = request.url_for("oauth_callback", provider=provider)
+    
+    # 获取授权URL
+    auth_url = oidc_service.get_authorization_url(provider, str(redirect_uri))
+    
+    if not auth_url:
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail="获取授权URL失败"
+        )
+    
+    return {"url": auth_url}
+
+
+@router.get("/oauth/callback/{provider}", summary="OAuth回调处理")
+async def oauth_callback(provider: str, request: Request):
+    """处理OAuth提供商的回调，返回JWT令牌"""
+    if not oidc_service.validate_provider(provider):
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="不支持的认证提供商"
+        )
+    
+    # 处理回调
+    user_info = oidc_service.authorize_callback(provider)
+    
+    if not user_info:
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail="处理认证回调失败"
+        )
+    
+    # 获取令牌信息
+    token = user_info.get("token", {})
+    
+    # 查找或创建用户
+    existing_user = await user_service.get_user_by_provider(provider, user_info.get("id"))
+    
+    if existing_user:
+        user_id = existing_user.get("id")
+        # 更新用户信息
+        update_data = {}
+        if user_info.get("email") and not existing_user.get("email"):
+            update_data["email"] = user_info.get("email")
+        
+        if update_data:
+            await user_service.update_user_info(user_id, **update_data)
+            
+        # 更新认证信息
+        await user_service.link_user_provider(
+            user_id=user_id,
+            provider=provider,
+            provider_user_id=user_info.get("id"),
+            provider_email=user_info.get("email"),
+            access_token=token.get("access_token"),
+            refresh_token=token.get("refresh_token"),
+            expires_at=datetime.fromtimestamp(token.get("expires_at")) if token.get("expires_at") else None
+        )
+    else:
+        # 创建新用户
+        # 生成唯一用户名
+        base_username = user_info.get("username", "user").lower()
+        username = base_username
+        counter = 1
+        
+        while await user_service.get_user_by_username(username):
+            username = f"{base_username}{counter}"
+            counter += 1
+        
+        # 创建用户
+        user = await user_service.create_user(
+            username=username,
+            email=user_info.get("email"),
+            password_hash=None  # OAuth用户不需要密码
+        )
+        
+        user_id = user.get("id")
+        
+        # 关联认证提供商
+        await user_service.link_user_provider(
+            user_id=user_id,
+            provider=provider,
+            provider_user_id=user_info.get("id"),
+            provider_email=user_info.get("email"),
+            access_token=token.get("access_token"),
+            refresh_token=token.get("refresh_token"),
+            expires_at=datetime.fromtimestamp(token.get("expires_at")) if token.get("expires_at") else None
+        )
+    
+    # 获取用户信息
+    user = await user_service.get_user_by_id(user_id)
+    
+    # 生成JWT令牌
+    jwt_user_info = {
+        "user_id": user.get("id"),
+        "username": user.get("username"),
+        "email": user.get("email"),
+        "role": user.get("role")
+    }
+    
+    tokens = jwt_service.generate_tokens(jwt_user_info)
+    
+    # 重定向到前端，包含令牌信息
+    # 这里可以根据实际情况调整重定向逻辑
+    frontend_redirect_url = f"http://localhost:3000/login-success?access_token={tokens.access_token}&refresh_token={tokens.refresh_token}"
+    
+    return {
+        "access_token": tokens.access_token,
+        "refresh_token": tokens.refresh_token,
+        "token_type": "bearer",
+        "expires_in": tokens.expires_in
+    }
+
+
+@router.get("/me", response_model=UserResponse, summary="获取当前用户信息")
+async def get_current_user(auth_data: dict = Depends(require_auth)):
+    """获取当前登录用户的信息"""
+    user_id = auth_data.get("user_id")
+    user = await user_service.get_user_by_id(user_id)
+    if not user:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="用户不存在"
+        )
+    return user
+
+
+@router.put("/me", response_model=UserResponse, summary="更新当前用户信息")
+async def update_current_user(
+    user_update: UserUpdate,
+    auth_data: dict = Depends(require_auth)
+):
+    """更新当前登录用户的信息"""
+    user_id = auth_data.get("user_id")
+    update_data = user_update.dict(exclude_unset=True)
+    if not update_data:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="没有提供要更新的字段"
+        )
+    
+    try:
+        updated = await user_service.update_user_info(user_id, **update_data)
+        if not updated:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="更新失败"
+            )
+        
+        updated_user = await user_service.get_user_by_id(user_id)
+        return updated_user
+    except ValueError as e:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=str(e)
+        )
+
+
+@router.get("/me/auths", response_model=List[UserAuthInfo], summary="获取当前用户的认证方式")
+async def get_current_user_auths(auth_data: dict = Depends(require_auth)):
+    """获取当前登录用户的所有认证方式"""
+    user_id = auth_data.get("user_id")
+    auths = await user_service.get_user_auths(user_id)
+    return auths
+
+
+@router.get("/", response_model=UserListResponse, summary="获取用户列表")
+async def get_users(
+    page: int = 1,
+    page_size: int = 50,
+    active_only: bool = False,
+    auth_data: dict = Depends(RoleBasedAuth("admin"))
+):
+    """获取用户列表（需要管理员权限）"""
+    if page < 1:
+        page = 1
+    if page_size < 1 or page_size > 100:
+        page_size = 50
+    
+    offset = (page - 1) * page_size
+    users = await user_service.list_users(limit=page_size, offset=offset, active_only=active_only)
+    total = await user_service.count_users(active_only=active_only)
+    
+    return {
+        "users": users,
+        "total": total,
+        "page": page,
+        "page_size": page_size
+    }
+
+
+@router.get("/{user_id}", response_model=UserResponse, summary="获取指定用户信息")
+async def get_user(user_id: int, auth_data: dict = Depends(RoleBasedAuth("admin"))):
+    """获取指定用户的信息（需要管理员权限）"""
+    user = await user_service.get_user_by_id(user_id)
+    if not user:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="用户不存在"
+        )
+    return user
+@router.put("/{user_id}", response_model=UserResponse, summary="更新指定用户信息")
+async def update_user(
+    user_id: int,
+    user_update: UserAdminUpdate,
+    auth_data: dict = Depends(RoleBasedAuth("admin"))
+):
+    """更新指定用户的信息（需要管理员权限）"""
+    update_data = user_update.dict(exclude_unset=True)
+    if not update_data:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="没有提供要更新的字段"
+        )
+    
+    try:
+        updated = await user_service.admin_update_user(user_id, **update_data)
+        if not updated:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="更新失败"
+            )
+        
+        updated_user = await user_service.get_user_by_id(user_id)
+        return updated_user
+    except ValueError as e:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=str(e)
+        )
+
+
+@router.delete("/{user_id}", status_code=status.HTTP_204_NO_CONTENT, summary="删除指定用户")
+async def delete_user(user_id: int, auth_data: dict = Depends(RoleBasedAuth("admin"))):
+    """删除指定用户（需要管理员权限）"""
+    # 不能删除自己
+    if auth_data.get("user_id") == user_id:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="不能删除自己"
+        )
+    
+    deleted = await user_service.delete_user(user_id)
+    if not deleted:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="删除失败"
+        )
+    
+    return None
+
+
+@router.get("/{user_id}/auths", response_model=List[UserAuthInfo], summary="获取指定用户的认证方式")
+async def get_user_auths(user_id: int, auth_data: dict = Depends(RoleBasedAuth("admin"))):
+    """获取指定用户的所有认证方式（需要管理员权限）"""
+    user = await user_service.get_user_by_id(user_id)
+    if not user:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="用户不存在"
+        )
+    
+    auths = await user_service.get_user_auths(user_id)
+    return auths
+
+
+@router.post("/{user_id}/auths/{provider}/unlink", status_code=status.HTTP_204_NO_CONTENT, summary="取消用户与认证提供商的关联")
+async def unlink_auth_provider(
+    user_id: int,
+    provider: str,
+    auth_data: dict = Depends(RoleBasedAuth("admin"))
+):
+    """取消用户与第三方认证提供商的关联（需要管理员权限）"""
+    # 检查是否为自己或管理员
+    if auth_data.get("user_id") != user_id and auth_data.get("role") != "admin":
+        raise HTTPException(
+            status_code=status.HTTP_403_FORBIDDEN,
+            detail="没有权限执行此操作"
+        )
+    
+    unlinked = await user_service.unlink_user_provider(user_id, provider)
+    if not unlinked:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="取消关联失败"
+        )
+    
+    return None
+
+
+class UserService(DatabaseService, Injectable):
+    """用户服务类"""
+    
+    async def create_user(self, username: str, password_hash: str = None, email: Optional[str] = None, role: str = "user") -> Dict[str, Any]:
+        """创建用户"""
+        try:
+            user_data = await self.create(
+                User,
+                username=username,
+                email=email,
+                password_hash=password_hash,
+                is_active=True,
+                role=role
+            )
+            return user_data
+        except ValueError as e:
+            if "username" in str(e):
+                raise ValueError("用户名已存在")
+            elif "email" in str(e):
+                raise ValueError("邮箱已存在")
+            else:
+                raise ValueError("创建用户失败")
+        except Exception as e:
+            raise RuntimeError(f"创建用户时发生错误: {e}")
+    
+    async def get_user_by_id(self, user_id: int) -> Optional[Dict[str, Any]]:
+        """根据ID获取用户"""
+        return await self.get_by_id(User, user_id)
+    
+    async def get_user_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        """根据用户名获取用户"""
+        try:
+            user = User.get(User.username == username)
+            return user.to_dict()
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取用户时发生错误: {e}")
+    
+    async def get_user_by_email(self, email: str) -> Optional[Dict[str, Any]]:
+        """根据邮箱获取用户"""
+        try:
+            user = User.get(User.email == email)
+            return user.to_dict()
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取用户时发生错误: {e}")
+    
+    async def get_user_by_provider(self, provider: str, provider_user_id: str) -> Optional[Dict[str, Any]]:
+        """根据认证提供商和用户ID获取用户"""
+        try:
+            user_auth = UserAuth.get(
+                (UserAuth.provider == provider) & 
+                (UserAuth.provider_user_id == provider_user_id)
+            )
+            return user_auth.user.to_dict()
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取用户时发生错误: {e}")
+    
+    async def link_user_provider(self, user_id: int, provider: str, provider_user_id: str, 
+                               provider_email: str = None, access_token: str = None, 
+                               refresh_token: str = None, expires_at: datetime = None) -> bool:
+        """为用户关联第三方认证提供商"""
+        try:
+            # 检查是否已存在
+            existing_auth = UserAuth.select().where(
+                (UserAuth.user_id == user_id) & 
+                (UserAuth.provider == provider)
+            ).first()
+            
+            if existing_auth:
+                # 更新现有记录
+                update_data = {
+                    'provider_user_id': provider_user_id,
+                    'provider_email': provider_email,
+                    'access_token': access_token,
+                    'refresh_token': refresh_token,
+                    'expires_at': expires_at
+                }
+                return await self.update(UserAuth, existing_auth.id, **update_data)
+            else:
+                # 创建新记录
+                await self.create(
+                    UserAuth,
+                    user_id=user_id,
+                    provider=provider,
+                    provider_user_id=provider_user_id,
+                    provider_email=provider_email,
+                    access_token=access_token,
+                    refresh_token=refresh_token,
+                    expires_at=expires_at
+                )
+                return True
+        except Exception as e:
+            raise RuntimeError(f"关联认证提供商时发生错误: {e}")
+    
+    async def unlink_user_provider(self, user_id: int, provider: str) -> bool:
+        """取消用户与第三方认证提供商的关联"""
+        try:
+            user_auth = UserAuth.get(
+                (UserAuth.user_id == user_id) & 
+                (UserAuth.provider == provider)
+            )
+            return await self.delete(UserAuth, user_auth.id)
+        except DoesNotExist:
+            return False
+        except Exception as e:
+            raise RuntimeError(f"取消关联认证提供商时发生错误: {e}")
+    
+    async def update_user_last_login(self, user_id: int) -> bool:
+        """更新用户最后登录时间"""
+        return await self.update(User, user_id, last_login=datetime.now())
+    
+    async def update_user_info(self, user_id: int, **kwargs) -> bool:
+        """更新用户信息"""
+        # 过滤允许更新的字段
+        allowed_fields = {'username', 'email', 'is_active', 'role'}
+        update_data = {k: v for k, v in kwargs.items() if k in allowed_fields}
+        
+        if not update_data:
+            return False
+        
+        return await self.update(User, user_id, **update_data)
+    
+    async def admin_update_user(self, user_id: int, **kwargs) -> bool:
+        """管理员更新用户信息（允许更新更多字段）"""
+        # 管理员可以更新所有用户字段
+        allowed_fields = {'username', 'email', 'is_active', 'role', 'last_login'}
+        update_data = {k: v for k, v in kwargs.items() if k in allowed_fields}
+        
+        if not update_data:
+            return False
+        
+        return await self.update(User, user_id, **update_data)
+    
+    async def deactivate_user(self, user_id: int) -> bool:
+        """停用用户"""
+        return await self.update(User, user_id, is_active=False)
+    
+    async def activate_user(self, user_id: int) -> bool:
+        """激活用户"""
+        return await self.update(User, user_id, is_active=True)
+    
+    async def update_user_password(self, user_id: int, password_hash: str) -> bool:
+        """更新用户密码"""
+        return await self.update(User, user_id, password_hash=password_hash)
+    
+    async def delete_user(self, user_id: int) -> bool:
+        """删除用户"""
+        return await self.delete(User, user_id)
+    
+    async def list_users(self, limit: int = 50, offset: int = 0, active_only: bool = False) -> List[Dict[str, Any]]:
+        """获取用户列表"""
+        try:
+            query = User.select()
+            if active_only:
+                query = query.where(User.is_active == True)
+            
+            query = query.order_by(User.created_at.desc()).limit(limit).offset(offset)
+            
+            return [user.to_dict() for user in query]
+        except Exception as e:
+            raise RuntimeError(f"获取用户列表时发生错误: {e}")
+    
+    async def search_users(self, keyword: str, limit: int = 20) -> List[Dict[str, Any]]:
+        """搜索用户"""
+        try:
+            search_pattern = f"%{keyword}%"
+            query = (User.select()
+                    .where((User.username.contains(search_pattern)) | 
+                           (User.email.contains(search_pattern)))
+                    .limit(limit))
+            
+            return [user.to_dict() for user in query]
+        except Exception as e:
+            raise RuntimeError(f"搜索用户时发生错误: {e}")
+    
+    async def count_users(self, active_only: bool = False) -> int:
+        """统计用户数量"""
+        try:
+            query = User.select()
+            if active_only:
+                query = query.where(User.is_active == True)
+            return query.count()
+        except Exception as e:
+            raise RuntimeError(f"统计用户数量时发生错误: {e}")
+    
+    async def get_user_with_password_hash(self, user_id: int) -> Optional[Dict[str, Any]]:
+        """获取包含密码哈希的用户信息（用于认证）"""
+        try:
+            user = User.get_by_id(user_id)
+            # 不排除密码哈希，用于认证
+            user_dict = {
+                'id': user.id,
+                'username': user.username,
+                'email': user.email,
+                'password_hash': user.password_hash,
+                'is_active': user.is_active,
+                'role': user.role,
+                'last_login': user.last_login.isoformat() if user.last_login else None,
+                'created_at': user.created_at.isoformat(),
+                'updated_at': user.updated_at.isoformat()
+            }
+            return user_dict
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
+    
+    async def get_user_with_password_hash_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        """根据用户名获取包含密码哈希的用户信息"""
+        try:
+            user = User.get(User.username == username)
+            user_dict = {
+                'id': user.id,
+                'username': user.username,
+                'email': user.email,
+                'password_hash': user.password_hash,
+                'is_active': user.is_active,
+                'role': user.role,
+                'last_login': user.last_login.isoformat() if user.last_login else None,
+                'created_at': user.created_at.isoformat(),
+                'updated_at': user.updated_at.isoformat()
+            }
+            return user_dict
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
+    
+    async def get_user_auths(self, user_id: int) -> List[Dict[str, Any]]:
+        """获取用户的所有认证方式"""
+        try:
+            auths = UserAuth.select().where(UserAuth.user_id == user_id)
+            return [auth.to_dict() for auth in auths]
+        except Exception as e:
+            raise RuntimeError(f"获取用户认证方式时发生错误: {e}")
+    
+    async def is_admin(self, user_id: int) -> bool:
+        """检查用户是否为管理员"""
+        try:
+            user = User.get_by_id(user_id)
+            return user.role == 'admin'
+        except DoesNotExist:
+            return False
+        except Exception as e:
+            raise RuntimeError(f"检查用户角色时发生错误: {e}")
+
+
+"""
+数据库模型文件
+使用 Peewee ORM 定义的数据库模型
+"""
+from datetime import datetime
+from typing import Optional
+
+from peewee import (
+    Model, CharField, TextField, DateTimeField, BooleanField,
+    IntegerField, ForeignKeyField, AutoField, Database
+)
+from playhouse.postgres_ext import PostgresqlExtDatabase
+
+from core.db_config import DatabaseConfig
+
+
+# 数据库连接实例
+database: Optional[PostgresqlExtDatabase] = None
+
+
+# 定义用户角色枚举
+class UserRole:
+    USER = "user"
+    ADMIN = "admin"
+
+    @classmethod
+    def values(cls) -> list:
+        return [cls.USER, cls.ADMIN]
+
+
+# 定义认证提供商枚举
+class AuthProvider:
+    LOCAL = "local"
+    GITHUB = "github"
+    GOOGLE = "google"
+    MICROSOFT = "microsoft"
+    CUSTOM_OIDC = "custom_oidc"
+
+    @classmethod
+    def values(cls) -> list:
+        return [cls.LOCAL, cls.GITHUB, cls.GOOGLE, cls.MICROSOFT, cls.CUSTOM_OIDC]
+
+
+def get_database() -> PostgresqlExtDatabase:
+    """获取数据库连接实例"""
+    global database
+    if database is None:
+        try:
+            # 尝试使用 ConfigService
+            from core.di_container import get_container
+            from interfaces.service_interfaces import IConfigService
+            
+            config_service = get_container().resolve(IConfigService)
+            db_config = config_service.get_database_config()
+            
+            database = PostgresqlExtDatabase(
+                db_config["database"],
+                user=db_config["username"],
+                password=db_config["password"],
+                host=db_config["host"],
+                port=db_config["port"],
+                max_connections=db_config["max_connections"],
+                stale_timeout=db_config["stale_timeout"]
+            )
+        except Exception:
+            # 回退到 DatabaseConfig
+            config = DatabaseConfig()
+            database = PostgresqlExtDatabase(
+                config.database,
+                user=config.username,
+                password=config.password,
+                host=config.host,
+                port=config.port,
+                max_connections=config.max_connections,
+                stale_timeout=config.stale_timeout
+            )
+    return database
+
+
+class BaseModel(Model):
+    """基础模型类"""
+    
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+    
+    class Meta:
+        database = get_database()
+    
+    def save(self, force_insert=False, only=None):
+        """保存时更新 updated_at 字段"""
+        self.updated_at = datetime.now()
+        return super().save(force_insert, only)
+    
+    def to_dict(self) -> dict:
+        """转换为字典"""
+        data = {}
+        for field_name in self._meta.fields.keys():
+            value = getattr(self, field_name)
+            if isinstance(value, datetime):
+                value = value.isoformat()
+            data[field_name] = value
+        return data
+
+
+class User(BaseModel):
+    """用户模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="用户ID")
+    username = CharField(max_length=50, unique=True, null=False, verbose_name="用户名")
+    email = CharField(max_length=100, unique=True, null=True, verbose_name="邮箱")
+    password_hash = CharField(max_length=255, null=True, verbose_name="密码哈希")  # 可以为null，因为第三方登录不需要密码
+    is_active = BooleanField(default=True, verbose_name="是否激活")
+    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    role = CharField(max_length=20, default=UserRole.USER, choices=UserRole.values(), verbose_name="用户角色")
+    
+    class Meta:
+        table_name = "users"
+    
+    def to_dict(self) -> dict:
+        """转换为字典，排除敏感信息"""
+        data = super().to_dict()
+        data.pop("password_hash", None)
+        return data
+
+
+class UserAuth(BaseModel):
+    """用户认证信息模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="ID")
+    user = ForeignKeyField(User, backref="auths", on_delete="CASCADE", verbose_name="用户")
+    provider = CharField(max_length=20, choices=AuthProvider.values(), verbose_name="认证提供商")
+    provider_user_id = CharField(max_length=100, verbose_name="提供商用户ID")
+    provider_email = CharField(max_length=100, null=True, verbose_name="提供商邮箱")
+    access_token = CharField(max_length=500, null=True, verbose_name="访问令牌")
+    refresh_token = CharField(max_length=500, null=True, verbose_name="刷新令牌")
+    expires_at = DateTimeField(null=True, verbose_name="令牌过期时间")
+    
+    class Meta:
+        table_name = "user_auths"
+        indexes = (
+            # 确保每个用户在每个提供商上只有一个记录
+            (('user', 'provider'), True),
+            # 确保每个提供商用户ID唯一
+            (('provider', 'provider_user_id'), True),
+        )
+
+
+class AuthProviderConfig(BaseModel):
+    """认证提供商配置模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="ID")
+    name = CharField(max_length=50, unique=True, verbose_name="提供商名称")
+    provider_type = CharField(max_length=20, choices=AuthProvider.values(), verbose_name="提供商类型")
+    client_id = CharField(max_length=255, verbose_name="客户端ID")
+    client_secret = CharField(max_length=255, verbose_name="客户端密钥")
+    authorize_url = CharField(max_length=255, null=True, verbose_name="授权URL")
+    token_url = CharField(max_length=255, null=True, verbose_name="令牌URL")
+    userinfo_url = CharField(max_length=255, null=True, verbose_name="用户信息URL")
+    callback_url = CharField(max_length=255, null=True, verbose_name="回调URL")
+    scopes = TextField(null=True, verbose_name="请求范围")
+    is_enabled = BooleanField(default=True, verbose_name="是否启用")
+    
+    class Meta:
+        table_name = "auth_provider_configs"
+
+
+# 模型列表
+MODELS = [User, UserAuth, AuthProviderConfig]
+
+
+def create_tables():
+    """创建所有表"""
+    db = get_database()
+    db.create_tables(MODELS, safe=True)
+
+
+def drop_tables():
+    """删除所有表"""
+    db = get_database()
+    db.drop_tables(MODELS, safe=True)
+
+
+def connect_database():
+    """连接数据库"""
+    db = get_database()
+    if not db.is_connection_usable():
+        db.connect()
+
+
+def close_database():
+    """关闭数据库连接"""
+    db = get_database()
+    if not db.is_closed():
+        db.close()
+
+
+"""
+OIDC 认证服务实现
+"""
+import os
+import json
+from typing import Dict, Any, List, Optional
+
+from authlib.integrations.flask_client import OAuth
+from authlib.common.urls import urlparse
+
+from interfaces.service_interfaces import IOIDCService, IConfigService
+from core.di_container import Injectable
+from models.db_models import AuthProvider
+
+
+class OIDCService(IOIDCService, Injectable):
+    """OIDC 认证服务实现"""
+    
+    def __init__(self, config_service: IConfigService):
+        """初始化服务"""
+        self.config_service = config_service
+        self.logger = self.config_service.get_logger()
+        self.oauth = None
+        self.providers = []
+    
+    def initialize_oauth(self, app) -> None:
+        """初始化 OAuth"""
+        self.oauth = OAuth(app)
+        
+        # 注册 GitHub OAuth
+        if self.config_service.get_config("GITHUB_CLIENT_ID") and self.config_service.get_config("GITHUB_CLIENT_SECRET"):
+            self.register_provider(
+                name="github",
+                client_id=self.config_service.get_config("GITHUB_CLIENT_ID"),
+                client_secret=self.config_service.get_config("GITHUB_CLIENT_SECRET"),
+                authorize_url="https://github.com/login/oauth/authorize",
+                token_url="https://github.com/login/oauth/access_token",
+                api_base_url="https://api.github.com/",
+                userinfo_endpoint="user",
+                client_kwargs={
+                    "scope": "user:email"
+                }
+            )
+        
+        # 注册 Google OAuth
+        if self.config_service.get_config("GOOGLE_CLIENT_ID") and self.config_service.get_config("GOOGLE_CLIENT_SECRET"):
+            self.register_provider(
+                name="google",
+                client_id=self.config_service.get_config("GOOGLE_CLIENT_ID"),
+                client_secret=self.config_service.get_config("GOOGLE_CLIENT_SECRET"),
+                authorize_url="https://accounts.google.com/o/oauth2/v2/auth",
+                token_url="https://oauth2.googleapis.com/token",
+                api_base_url="https://www.googleapis.com/oauth2/v1/",
+                userinfo_endpoint="userinfo",
+                client_kwargs={
+                    "scope": "openid email profile"
+                }
+            )
+        
+        # 注册 Microsoft OAuth
+        if self.config_service.get_config("MICROSOFT_CLIENT_ID") and self.config_service.get_config("MICROSOFT_CLIENT_SECRET"):
+            self.register_provider(
+                name="microsoft",
+                client_id=self.config_service.get_config("MICROSOFT_CLIENT_ID"),
+                client_secret=self.config_service.get_config("MICROSOFT_CLIENT_SECRET"),
+                authorize_url="https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
+                token_url="https://login.microsoftonline.com/common/oauth2/v2.0/token",
+                api_base_url="https://graph.microsoft.com/v1.0/",
+                userinfo_endpoint="me",
+                client_kwargs={
+                    "scope": "openid email profile User.Read"
+                }
+            )
+        
+        # 注册自定义 OIDC 提供商
+        custom_oidc = self.config_service.get_config("CUSTOM_OIDC")
+        if custom_oidc:
+            try:
+                oidc_config = json.loads(custom_oidc)
+                self.register_provider(
+                    name="custom_oidc",
+                    client_id=oidc_config.get("CLIENT_ID"),
+                    client_secret=oidc_config.get("CLIENT_SECRET"),
+                    authorize_url=oidc_config.get("AUTHORIZE_URL"),
+                    token_url=oidc_config.get("TOKEN_URL"),
+                    api_base_url=oidc_config.get("API_BASE_URL", ""),
+                    userinfo_endpoint=oidc_config.get("USERINFO_ENDPOINT"),
+                    client_kwargs={
+                        "scope": oidc_config.get("SCOPE", "openid email profile")
+                    }
+                )
+            except Exception as e:
+                self.logger.error(f"Failed to register custom OIDC provider: {e}")
+    
+    def register_provider(self, name: str, **kwargs) -> None:
+        """注册 OAuth 提供商"""
+        if self.oauth:
+            self.oauth.register(
+                name=name,
+                **kwargs
+            )
+            self.providers.append(name)
+    
+    def get_authorization_url(self, provider: str, redirect_uri: Optional[str] = None) -> Optional[str]:
+        """获取授权 URL"""
+        if not self.oauth or not self.validate_provider(provider):
+            return None
+        
+        try:
+            oauth_provider = self.oauth.create_client(provider)
+            if not oauth_provider:
+                return None
+            
+            if redirect_uri:
+                oauth_provider.redirect_uri = redirect_uri
+            
+            auth_uri, _ = oauth_provider.authorize_redirect(
+                redirect_uri=oauth_provider.redirect_uri
+            )
+            
+            return auth_uri
+        except Exception as e:
+            self.logger.error(f"Failed to get authorization URL for {provider}: {e}")
+            return None
+    
+    def authorize_callback(self, provider: str) -> Optional[Dict[str, Any]]:
+        """处理授权回调"""
+        if not self.oauth or not self.validate_provider(provider):
+            return None
+        
+        try:
+            oauth_provider = self.oauth.create_client(provider)
+            if not oauth_provider:
+                return None
+            
+            # 获取令牌
+            token = oauth_provider.authorize_access_token()
+            
+            # 获取用户信息
+            user_info = self._get_user_info(provider, oauth_provider, token)
+            if not user_info:
+                return None
+            
+            # 合并用户信息和令牌
+            user_info["token"] = token
+            
+            return user_info
+        except Exception as e:
+            self.logger.error(f"Failed to handle callback for {provider}: {e}")
+            return None
+    
+    def _get_user_info(self, provider: str, oauth_provider, token: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+        """获取用户信息"""
+        try:
+            if provider == "github":
+                # GitHub API 需要特殊处理
+                resp = oauth_provider.get("user")
+                user_info = resp.json()
+                
+                # 获取邮箱信息
+                emails = oauth_provider.get("user/emails").json()
+                primary_email = next((email["email"] for email in emails if email["primary"]), None)
+                
+                return {
+                    "id": str(user_info.get("id")),
+                    "name": user_info.get("name"),
+                    "username": user_info.get("login"),
+                    "email": primary_email,
+                    "avatar": user_info.get("avatar_url"),
+                    "provider": provider
+                }
+            
+            elif provider == "google":
+                # Google API
+                resp = oauth_provider.get("userinfo")
+                user_info = resp.json()
+                
+                return {
+                    "id": user_info.get("id"),
+                    "name": user_info.get("name"),
+                    "username": user_info.get("email").split("@")[0],
+                    "email": user_info.get("email"),
+                    "avatar": user_info.get("picture"),
+                    "provider": provider
+                }
+            
+            elif provider == "microsoft":
+                # Microsoft Graph API
+                resp = oauth_provider.get("me")
+                user_info = resp.json()
+                
+                return {
+                    "id": user_info.get("id"),
+                    "name": user_info.get("displayName"),
+                    "username": user_info.get("userPrincipalName").split("@")[0],
+                    "email": user_info.get("mail"),
+                    "avatar": None,  # Microsoft 需要单独请求头像
+                    "provider": provider
+                }
+            
+            elif provider == "custom_oidc":
+                # 自定义 OIDC 提供商
+                userinfo_endpoint = getattr(oauth_provider, "_userinfo_endpoint", "userinfo")
+                resp = oauth_provider.get(userinfo_endpoint)
+                user_info = resp.json()
+                
+                return {
+                    "id": user_info.get("sub"),
+                    "name": user_info.get("name"),
+                    "username": user_info.get("preferred_username"),
+                    "email": user_info.get("email"),
+                    "avatar": user_info.get("picture"),
+                    "provider": provider
+                }
+            
+            return None
+        except Exception as e:
+            self.logger.error(f"Failed to get user info from {provider}: {e}")
+            return None
+    
+    def get_supported_providers(self) -> List[str]:
+        """获取支持的提供商列表"""
+        return self.providers.copy()
+    
+    def validate_provider(self, provider: str) -> bool:
+        """验证提供商是否支持"""
+        return provider in self.providers
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/config_service.py b/webapi/fastapi_of_letcoing/services/config_service.py
index 7b63336..907a343 100644
--- a/webapi/fastapi_of_letcoing/services/config_service.py
+++ b/webapi/fastapi_of_letcoing/services/config_service.py
@@ -1,47 +1,51 @@
 """
 配置服务实现
-
-提供配置管理功能，支持环境变量和应用配置。
 """
 
-from typing import Any, Optional
+from typing import Any, Dict
 from interfaces.service_interfaces import IConfigService
+from core.di_container import Injectable
 
 
-class ConfigService(IConfigService):
-    """配置服务实现"""
+class ConfigService(IConfigService, Injectable):
+    """配置服务实现类"""
     
-    def __init__(self, app_config: Optional[dict] = None):
-        """
-        初始化配置服务
-        
-        Args:
-            app_config: Flask应用配置字典
-        """
-        self._app_config = app_config or {}
+    def __init__(self, app_config: Dict[str, Any]):
+        """初始化配置服务"""
+        self.app_config = app_config
     
     def get_api_token(self) -> str:
         """获取API Token"""
-        return self._app_config.get('API_TOKEN', '')
+        return self.app_config.get('API_TOKEN', '')
     
     def get_timeout(self) -> int:
         """获取请求超时时间"""
-        return int(self._app_config.get('REQUEST_TIMEOUT', '30'))
+        return self.app_config.get('TIMEOUT', 30)
     
     def get_config(self, key: str, default: Any = None) -> Any:
         """获取配置值"""
-        return self._app_config.get(key, default)
+        return self.app_config.get(key, default)
     
-    def get_database_config(self) -> dict:
+    def get_database_config(self) -> Dict[str, Any]:
         """获取数据库配置"""
         return {
-            "host": self.get_config("DB_HOST", "localhost"),
-            "port": self.get_config("DB_PORT", 5432),
-            "database": self.get_config("DB_NAME", "letcoding"),
-            "username": self.get_config("DB_USER", "postgres"),
-            "password": self.get_config("DB_PASSWORD", ""),
-            "max_connections": self.get_config("DB_MAX_CONNECTIONS", 20),
-            "stale_timeout": self.get_config("DB_STALE_TIMEOUT", 300)
+            "host": self.app_config.get('DB_HOST', 'localhost'),
+            "port": self.app_config.get('DB_PORT', 5432),
+            "database": self.app_config.get('DB_NAME', 'letcoding'),
+            "username": self.app_config.get('DB_USER', 'postgres'),
+            "password": self.app_config.get('DB_PASSWORD', ''),
+            "max_connections": self.app_config.get('DB_MAX_CONNECTIONS', 20),
+            "stale_timeout": self.app_config.get('DB_STALE_TIMEOUT', 300)
+        }
+    
+    def get_redis_config(self) -> Dict[str, Any]:
+        """获取Redis配置"""
+        return {
+            "host": self.app_config.get('REDIS_HOST', 'localhost'),
+            "port": self.app_config.get('REDIS_PORT', 6379),
+            "db": self.app_config.get('REDIS_DB', 0),
+            "password": self.app_config.get('REDIS_PASSWORD'),
+            "timeout": self.app_config.get('REDIS_TIMEOUT', 5)
         }
     
     def get_database_url(self) -> str:
diff --git a/webapi/fastapi_of_letcoing/services/database_service.py b/webapi/fastapi_of_letcoing/services/database_service.py
index ccfffdd..8de7039 100644
--- a/webapi/fastapi_of_letcoing/services/database_service.py
+++ b/webapi/fastapi_of_letcoing/services/database_service.py
@@ -1,134 +1,91 @@
 """
-数据库服务基类
-提供数据库连接和基础操作
+数据库服务实现
 """
-from datetime import datetime
-from typing import List, Optional, Dict, Any
 
-from peewee import DoesNotExist, IntegrityError, fn, Model, Database
-from playhouse.postgres_ext import PostgresqlExtDatabase
+from typing import Dict, Any, List, Optional
+from interfaces.service_interfaces import IDatabaseService
 from core.di_container import Injectable
-from interfaces.service_interfaces import IConfigService
+from models.db_models import get_database, connect_database, close_database
+from peewee import Model, DoesNotExist
 
 
-class DatabaseService(Injectable):
-    """数据库服务基类"""
+class DatabaseService(IDatabaseService, Injectable):
+    """数据库服务实现类"""
     
-    def __init__(self, config_service: IConfigService):
+    def __init__(self, config_service):
         """初始化数据库服务"""
-        self._config_service = config_service
-        self._database = None
-        self._ensure_connection()
+        self.config_service = config_service
+        self.database = get_database()
     
-    def _get_database(self) -> PostgresqlExtDatabase:
-        """获取数据库连接实例"""
-        if self._database is None:
-            db_config = self._config_service.get_database_config()
-            self._database = PostgresqlExtDatabase(
-                db_config["database"],
-                user=db_config["username"],
-                password=db_config["password"],
-                host=db_config["host"],
-                port=db_config["port"],
-                max_connections=db_config["max_connections"],
-                stale_timeout=db_config["stale_timeout"]
-            )
-        return self._database
-    
-    def _ensure_connection(self):
-        """确保数据库连接正常"""
+    def connect(self) -> bool:
+        """连接数据库"""
         try:
-            db = self._get_database()
-            if not db.is_connection_usable():
-                db.connect()
-        except Exception as e:
-            print(f"数据库连接失败: {e}")
-            raise
+            connect_database()
+            return True
+        except Exception:
+            return False
+    
+    def disconnect(self) -> None:
+        """断开数据库连接"""
+        close_database()
+    
+    def is_connected(self) -> bool:
+        """检查是否已连接"""
+        return self.database.is_connection_usable()
     
-    # 通用CRUD操作
-    async def create(self, model_class: type, **kwargs) -> Dict[str, Any]:
-        """通用创建操作"""
+    def create(self, model_class, **kwargs) -> Dict[str, Any]:
+        """创建记录"""
         try:
-            with self._get_database().atomic():
-                instance = model_class.create(**kwargs)
-                return instance.to_dict()
-        except IntegrityError as e:
-            raise ValueError(f"创建失败: {str(e)}")
+            instance = model_class.create(**kwargs)
+            return instance.to_dict()
         except Exception as e:
-            raise RuntimeError(f"创建记录时发生错误: {e}")
+            raise ValueError(f"创建记录失败: {e}")
     
-    async def get_by_id(self, model_class: type, record_id: int) -> Optional[Dict[str, Any]]:
-        """通用根据ID获取记录"""
+    def get_by_id(self, model_class, record_id: int) -> Optional[Dict[str, Any]]:
+        """根据ID获取记录"""
         try:
             instance = model_class.get_by_id(record_id)
             return instance.to_dict()
         except DoesNotExist:
             return None
         except Exception as e:
-            raise RuntimeError(f"获取记录时发生错误: {e}")
+            raise RuntimeError(f"获取记录失败: {e}")
     
-    async def update(self, model_class: type, record_id: int, **kwargs) -> bool:
-        """通用更新操作"""
+    def update(self, model_class, record_id: int, **kwargs) -> bool:
+        """更新记录"""
         try:
-            with self._get_database().atomic():
-                query = model_class.update(**kwargs).where(model_class.id == record_id)
-                return query.execute() > 0
+            instance = model_class.get_by_id(record_id)
+            for key, value in kwargs.items():
+                setattr(instance, key, value)
+            instance.save()
+            return True
+        except DoesNotExist:
+            return False
         except Exception as e:
-            raise RuntimeError(f"更新记录时发生错误: {e}")
+            raise RuntimeError(f"更新记录失败: {e}")
     
-    async def delete(self, model_class: type, record_id: int) -> bool:
-        """通用删除操作"""
+    def delete(self, model_class, record_id: int) -> bool:
+        """删除记录"""
         try:
-            with self._get_database().atomic():
-                query = model_class.delete().where(model_class.id == record_id)
-                return query.execute() > 0
+            instance = model_class.get_by_id(record_id)
+            instance.delete_instance()
+            return True
+        except DoesNotExist:
+            return False
         except Exception as e:
-            raise RuntimeError(f"删除记录时发生错误: {e}")
+            raise RuntimeError(f"删除记录失败: {e}")
     
-    async def list_all(self, model_class: type, limit: int = 50, offset: int = 0, order_by=None) -> List[Dict[str, Any]]:
-        """通用列表查询"""
+    def list_all(self, model_class, limit: int = 100, offset: int = 0) -> List[Dict[str, Any]]:
+        """获取所有记录"""
         try:
-            query = model_class.select()
-            if order_by:
-                query = query.order_by(order_by)
-            query = query.limit(limit).offset(offset)
-            
+            query = model_class.select().limit(limit).offset(offset)
             return [instance.to_dict() for instance in query]
         except Exception as e:
-            raise RuntimeError(f"查询列表时发生错误: {e}")
+            raise RuntimeError(f"获取记录列表失败: {e}")
     
-    async def count(self, model_class: type) -> int:
-        """通用计数操作"""
+    def count(self, model_class) -> int:
+        """统计记录数量"""
         try:
             return model_class.select().count()
         except Exception as e:
-            raise RuntimeError(f"计数时发生错误: {e}")
-    
-    # 数据库管理操作
-    def test_connection(self) -> bool:
-        """测试数据库连接"""
-        try:
-            db = self._get_database()
-            db.execute_sql("SELECT 1")
-            return True
-        except Exception:
-            return False
-    
-    def get_database_info(self) -> Dict[str, Any]:
-        """获取数据库信息"""
-        try:
-            db = self._get_database()
-            return {
-                "database": db.database,
-                "host": db.connect_kwargs.get("host", "localhost"),
-                "port": db.connect_kwargs.get("port", 5432),
-                "is_connected": not db.is_closed() and db.is_connection_usable()
-            }
-        except Exception as e:
-            return {"error": str(e)}
-    
-    def close(self):
-        """关闭数据库连接"""
-        db = self._get_database()
-        if not db.is_closed():
-            db.close()
\ No newline at end of file
+            raise RuntimeError(f"统计记录数量失败: {e}")
\ No newline at end of file
-- 
Gitee


From 7ad97c5c24a8704e1a04a492d4828ea014a5e405 Mon Sep 17 00:00:00 2001
From: D4016 <zhangsanwei05@gmail.com>
Date: Wed, 14 Jan 2026 06:26:54 -0500
Subject: [PATCH 08/22] =?UTF-8?q?=E9=A2=98=E7=9B=AE=E5=AD=98=E5=82=A8?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controllers/question_controller.py        | 87 +++++++++++++++++++
 .../core/service_config.py                    | 11 +++
 .../interfaces/service_interfaces.py          | 28 ++++++
 webapi/fastapi_of_letcoing/main.py            |  2 +
 .../fastapi_of_letcoing/models/db_models.py   | 21 ++++-
 .../models/question_models.py                 | 33 +++++++
 .../services/question_service.py              | 56 ++++++++++++
 7 files changed, 236 insertions(+), 2 deletions(-)
 create mode 100644 webapi/fastapi_of_letcoing/controllers/question_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/models/question_models.py
 create mode 100644 webapi/fastapi_of_letcoing/services/question_service.py

diff --git a/webapi/fastapi_of_letcoing/controllers/question_controller.py b/webapi/fastapi_of_letcoing/controllers/question_controller.py
new file mode 100644
index 0000000..d92508e
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/question_controller.py
@@ -0,0 +1,87 @@
+from flask import request
+from flask_restx import Resource, Namespace, fields
+from core.di_container import inject
+from interfaces.service_interfaces import IQuestionService
+from models.question_models import QuestionResponse
+
+# 创建命名空间
+api = Namespace('questions', description='题目管理')
+
+# 定义数据模型
+question_model = api.model('Question', {
+    'id': fields.Integer(readonly=True, description="题目ID"),
+    'title': fields.String(required=True, description="题目标题"),
+    'intro': fields.String(description="题目介绍"),
+    'difficulty': fields.Integer(required=True, description="难度 (1-5)", min=1, max=5),
+    'testcode': fields.String(description="验证代码"),
+    'lang': fields.String(description="编程语言", default="cpp"),
+    'created_at': fields.DateTime(readonly=True, description="创建时间"),
+    'updated_at': fields.DateTime(readonly=True, description="更新时间"),
+})
+
+@api.route('/')
+class QuestionList(Resource):
+    @api.doc('list_questions')
+    @api.marshal_list_with(question_model)
+    def get(self):
+        """获取题目列表"""
+        # 注入服务
+        service = inject(IQuestionService)
+        
+        # 获取分页参数
+        skip = request.args.get('skip', 0, type=int)
+        limit = request.args.get('limit', 100, type=int)
+        
+        return service.get_questions(skip=skip, limit=limit)
+    
+    @api.doc('create_question')
+    @api.expect(question_model)
+    @api.marshal_with(question_model, code=201)
+    def post(self):
+        """创建新题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # request.json 包含前端发来的数据
+        return service.create_question(request.json), 201    
+    
+@api.route('/<int:id>')
+class QuestionDetail(Resource):
+    @api.doc('get_question')
+    @api.marshal_with(question_model)
+    def get(self, id):
+        """获取一个题目详情"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 提取题目ID
+        result = service.get_question(id)
+        if result:
+            return result
+        api.abort(404, "Question not found")
+    
+    @api.doc('update_question')
+    @api.expect(question_model)
+    @api.marshal_with(question_model)
+    def put(self, id):
+        """更新题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 更新题目信息
+        result = service.update_question(id, request.json)
+        if result:
+            return result
+        api.abort(404, "Question not found")
+
+    @api.doc('delete_question')
+    @api.response(204, 'Question deleted')
+    def delete(self, id):
+        """删除题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 删除题目
+        if service.delete_question(id):
+            return '', 204
+        api.abort(404, "Question not found")
diff --git a/webapi/fastapi_of_letcoing/core/service_config.py b/webapi/fastapi_of_letcoing/core/service_config.py
index 3dbd17b..a9fc977 100644
--- a/webapi/fastapi_of_letcoing/core/service_config.py
+++ b/webapi/fastapi_of_letcoing/core/service_config.py
@@ -26,6 +26,17 @@ def setup_services(app_config: dict) -> None:
         container.register_singleton(ILoggerService,
                                   factory=lambda: LoggerService())
         container.register_singleton(IRedisService, RedisService)
+        
+        # # 注册 QuestionService
+        # from interfaces.service_interfaces import IQuestionService
+        # from services.question_service import QuestionService
+        # container.register_scoped(IQuestionService, QuestionService)
+        
+        # 注册 QuestionService
+        from interfaces.service_interfaces import IQuestionService
+        from services.question_service import QuestionService
+        container.register_scoped(IQuestionService, QuestionService)
+        
         container.register_scoped(ICodeExecutionService, GlotService)
         container.register_singleton(IOIDCService, OIDCService)
         container.register_singleton(IJWTService, JWTService)
diff --git a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
index f5a39e7..34293f4 100644
--- a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
+++ b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
@@ -271,4 +271,32 @@ class IJWTService(ABC):
         Returns:
             是否成功
         """
+        pass
+
+class IQuestionService(ABC):
+    """题目服务接口"""
+    
+    @abstractmethod
+    def create_question(self, data: Dict[str, Any]) -> Any:
+        """创建题目"""
+        pass
+
+    @abstractmethod
+    def get_question(self, question_id: int) -> Optional[Any]:
+        """获取单个题目"""
+        pass
+    
+    @abstractmethod
+    def get_questions(self, skip: int = 0, limit: int = 100) -> List[Any]:
+        """获取题目列表"""
+        pass
+
+    @abstractmethod
+    def update_question(self, question_id: int, data: Dict[str, Any]) -> Optional[Any]:
+        """更新题目"""
+        pass
+
+    @abstractmethod
+    def delete_question(self, question_id: int) -> bool:
+        """删除题目"""
         pass
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/main.py b/webapi/fastapi_of_letcoing/main.py
index e2c237f..6a2d90a 100644
--- a/webapi/fastapi_of_letcoing/main.py
+++ b/webapi/fastapi_of_letcoing/main.py
@@ -2,6 +2,7 @@ from flask import Flask
 from flask_restx import Api, Resource
 from controllers.code_controller import api as code_api
 from controllers.auth_controller import api as auth_api
+from controllers.question_controller import api as question_api
 import os
 from core.service_config import setup_services
 from interfaces.service_interfaces import IOIDCService
@@ -74,6 +75,7 @@ api = Api(
 # 注册命名空间
 api.add_namespace(code_api, path='/code')
 api.add_namespace(auth_api, path='/auth')
+api.add_namespace(question_api, path='/questions')
 
 if __name__ == '__main__':
     app.run(debug=True, host='0.0.0.0', port=6173)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/db_models.py b/webapi/fastapi_of_letcoing/models/db_models.py
index 0047483..922fc6a 100644
--- a/webapi/fastapi_of_letcoing/models/db_models.py
+++ b/webapi/fastapi_of_letcoing/models/db_models.py
@@ -9,7 +9,7 @@ from peewee import (
     Model, CharField, TextField, DateTimeField, BooleanField,
     IntegerField, ForeignKeyField, AutoField, Database
 )
-from playhouse.postgres_ext import PostgresqlExtDatabase
+from playhouse.postgres_ext import PostgresqlExtDatabase 
 
 from core.db_config import DatabaseConfig
 
@@ -98,8 +98,25 @@ class User(BaseModel):
         data.pop("password_hash", None)
         return data
 
+class Question(BaseModel):
+    """题目模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="题目ID")
+    title = CharField(max_length=200, null=False, verbose_name="题目标题")
+    intro = TextField(null=True, verbose_name="题目介绍")
+    difficulty = IntegerField(null=False, verbose_name="题目难度")
+    testcode = TextField(null=True, verbose_name="验证代码")
+    lang = CharField(max_length=50, null=False, verbose_name="可使用语言")
+
+    class Meta:
+        table_name = "questions"
+    
+    def to_dict(self) -> dict:
+        """转换为字典"""
+        return super().to_dict()
+    
 # 模型列表
-MODELS = [User]
+MODELS = [User, Question]
 
 
 def create_tables():
diff --git a/webapi/fastapi_of_letcoing/models/question_models.py b/webapi/fastapi_of_letcoing/models/question_models.py
new file mode 100644
index 0000000..42e8522
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/question_models.py
@@ -0,0 +1,33 @@
+from pydantic import BaseModel, Field
+from typing import Optional
+from datetime import datetime
+
+class QuestionCreate(BaseModel):
+    """创建题目模型"""
+    title: str
+    intro: Optional[str] = None 
+    difficulty: int = Field(..., ge=1, le=5, description="难度等级 (1-5)")
+    testcode: Optional[str] = None
+    lang: str = "cpp"
+
+class QuestionUpdate(BaseModel):
+    """更新题目模型"""
+    title: Optional[str] = None
+    intro: Optional[str] = None
+    difficulty: Optional[int] = Field(None, ge=1, le=5, description="难度等级 (1-5)")
+    testcode: Optional[str] = None
+    lang: Optional[str] = None
+
+class QuestionResponse(BaseModel):
+    """题目响应模型"""
+    id: int
+    title: str
+    intro: Optional[str] = None
+    difficulty: int
+    testcode: Optional[str] = None
+    lang: str
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        orm_mode = True
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/question_service.py b/webapi/fastapi_of_letcoing/services/question_service.py
new file mode 100644
index 0000000..3d2bb17
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/question_service.py
@@ -0,0 +1,56 @@
+from typing import Dict, Any, Optional, List
+from interfaces.service_interfaces import IQuestionService
+from models.db_models import Question
+from models.question_models import QuestionResponse
+
+class QuestionService(IQuestionService):
+    """题目服务实现"""
+    
+    def create_question(self, data: Dict[str, Any]) -> Any:
+        """创建题目"""
+        question = Question.create(
+            title = data.get('title'),
+            intro = data.get('intro'),
+            difficulty = data.get('difficulty'),
+            testcode = data.get('testcode'),
+            lang = data.get('lang', 'cpp')
+        )
+        return QuestionResponse.from_orm(question)
+
+    def update_question(self, question_id: int, data: Dict[str, Any]) -> Optional[QuestionResponse]:
+        """更新题目"""
+        try:
+            question = Question.get_by_id(question_id)
+
+            if 'title' in data: question.title = data['title']
+            if 'intro' in data: question.intro = data['intro']
+            if 'difficulty' in data: question.difficulty = data['difficulty']
+            if 'testcode' in data: question.testcode = data['testcode']
+            if 'lang' in data: question.lang = data['lang']
+        
+            question.save()
+            return QuestionResponse.from_orm(question)
+        except Question.DoesNotExist:
+            return None
+    
+    def get_question(self, question_id: int) -> Optional[QuestionResponse]:
+        """获取一个题目"""
+        try:
+            question = Question.get_by_id(question_id)
+            return QuestionResponse.from_orm(question)
+        except Question.DoesNotExist:
+            return None
+    
+    def get_questions(self, skip: int = 0, limit: int = 100) -> List[QuestionResponse]:
+        """获取题目列表"""
+        questions = Question.select().offset(skip).limit(limit)
+        return [QuestionResponse.from_orm(q) for q in questions]
+
+    def delete_question(self, question_id: int) -> bool:
+        """删除题目"""
+        try:
+            question = Question.get_by_id(question_id)
+            question.delete_instance()
+            return True
+        except Question.DoesNotExist:
+            return False
\ No newline at end of file
-- 
Gitee


From d6acd784f8a2e7334aac11855d784324183b52ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=96=9B=E6=97=AD=E9=98=B3?= <xuexuyang@MacOS.local>
Date: Thu, 15 Jan 2026 23:06:05 +0800
Subject: [PATCH 09/22] =?UTF-8?q?=E5=90=8E=E7=AB=AF-=E5=AD=98=E5=82=A8-?=
 =?UTF-8?q?=E5=AD=A6=E7=94=9FID=E8=AF=BE=E7=A8=8B=E2=80=9C=20git=20push=20?=
 =?UTF-8?q?-u=20origin=20=E2=80=9Coj?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .idea/.gitignore                              |   3 +
 .idea/inspectionProfiles/Project_Default.xml  |  10 +
 .../inspectionProfiles/profiles_settings.xml  |   6 +
 .idea/misc.xml                                |   7 +
 .idea/modules.xml                             |   8 +
 .idea/oj_object.iml                           |  10 +
 course_system.db                              | Bin 0 -> 20480 bytes
 oj_object.py                                  | 548 ++++++++++++++++++
 8 files changed, 592 insertions(+)
 create mode 100644 .idea/.gitignore
 create mode 100644 .idea/inspectionProfiles/Project_Default.xml
 create mode 100644 .idea/inspectionProfiles/profiles_settings.xml
 create mode 100644 .idea/misc.xml
 create mode 100644 .idea/modules.xml
 create mode 100644 .idea/oj_object.iml
 create mode 100644 course_system.db
 create mode 100644 oj_object.py

diff --git a/.idea/.gitignore b/.idea/.gitignore
new file mode 100644
index 0000000..359bb53
--- /dev/null
+++ b/.idea/.gitignore
@@ -0,0 +1,3 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
new file mode 100644
index 0000000..146ab09
--- /dev/null
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -0,0 +1,10 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
+      <option name="processCode" value="true" />
+      <option name="processLiterals" value="true" />
+      <option name="processComments" value="true" />
+    </inspection_tool>
+  </profile>
+</component>
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/profiles_settings.xml b/.idea/inspectionProfiles/profiles_settings.xml
new file mode 100644
index 0000000..105ce2d
--- /dev/null
+++ b/.idea/inspectionProfiles/profiles_settings.xml
@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
new file mode 100644
index 0000000..1886999
--- /dev/null
+++ b/.idea/misc.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.13 (oj_object)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13" project-jdk-type="Python SDK" />
+</project>
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
new file mode 100644
index 0000000..1922b8e
--- /dev/null
+++ b/.idea/modules.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/oj_object.iml" filepath="$PROJECT_DIR$/.idea/oj_object.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file
diff --git a/.idea/oj_object.iml b/.idea/oj_object.iml
new file mode 100644
index 0000000..b6731d8
--- /dev/null
+++ b/.idea/oj_object.iml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.13" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
\ No newline at end of file
diff --git a/course_system.db b/course_system.db
new file mode 100644
index 0000000000000000000000000000000000000000..976c5b5dfb6a64855e63682c3f6081cbd45c9ba0
GIT binary patch
literal 20480
zcmeI%KWp1S9LDie?9`3Gbv9!{;5SONl$OxBRn5gQb(KVsOEVcYR*N8!NGyl0&YHK9
zchWc1u{z0uy2KefnD2q^pEyg;=d>I?I~^r?EZ?)6t0<QPwW};keGpMfHHvGyxawlY
z&3aI@)?fW~-G+L7d*AN-R?YT<>Uf=BFK&wt1px#QKmY**5I_I{1Q0;rNrA<n+3N1^
zTX#_&eY=dW=kY90vb1iu`+@dCEur^uq@|t}$KFY%GW0_|(1G~Jq4?v`=#|(z7g?Ie
zX)dAuT1>9onBUCe$(m&+!SJ&eoXaPDE>1Fa%}*U32YNX0&75<QEmyk|=tCW7zpu}v
znk^UD?&7G?>hA4XcR$J`vwS`+US!!cS8^;TpNNr0SFwEYg8q>gI0tXs{~V=dwYt5Y
zwMfb+Rm`g1S_x7Etlf^49Pj?g@fiBpAD)i2IA)=1yDzt%b>H_am88@7=j{5jIM+|2
zd7hQyN%i>2+p0BZ`RC?iYny7<R1^ddKmY**5I_I{1Q0*~0R#}(Q~}!r<NUv=+e<D4
z5I_I{1Q0*~0R#|0009I_0sjBzLqGrl1Q0*~0R#|0009ILKw$F)IR9_{9+MCO1Q0*~
P0R#|0009ILKmdV1XI!-q

literal 0
HcmV?d00001

diff --git a/oj_object.py b/oj_object.py
new file mode 100644
index 0000000..3792bfb
--- /dev/null
+++ b/oj_object.py
@@ -0,0 +1,548 @@
+from flask import Flask, request,jsonify
+from flask_sqlalchemy import SQLAlchemy
+from flask_cors import CORS
+import os
+import json
+
+
+app = Flask(__name__)
+CORS(app)
+
+# ====================== 环境变量配置 ======================
+# 安全认证配置
+API_TOKEN = os.environ.get('API_TOKEN', '993cb7df-6ff5-40c3-9a9c-773921e3a12d')
+JWT_SECRET_KEY = os.environ.get('JWT_SECRET_KEY', 'MjM3NTg1NDM4ODQ0MTYxMTE3MzUxODIzMTA0ODY2NjQ=')
+
+# Redis缓存配置
+REDIS_HOST = os.environ.get('REDIS_HOST', 'hkg1.clusters.zeabur.com')
+REDIS_PORT = os.environ.get('REDIS_PORT', '30123')
+REDIS_DB = os.environ.get('REDIS_DB', '0')
+REDIS_PASSWORD = os.environ.get('REDIS_PASSWORD', '2g8o1A45x9n3hsE0m7yrfL6VkbqJXaBW')
+
+# GitHub OAuth配置
+GITHUB_CLIENT_ID = os.environ.get('GITHUB_CLIENT_ID', '0v231iSEPDKQ0r51vqBC')
+GITHUB_CLIENT_SECRET = os.environ.get('GITHUB_CLIENT_SECRET', '0ce1c2a21b94562fb1b57e64de3c93877d656e')
+
+# OIDC配置
+OIDC_PROVIDERS_JSON = os.environ.get('OIDC_PROVIDERS',
+                                     '[{"name": "ioSCLub","issuer": "https://api.xauat.site","client_id": "ca_0200be03d08f4f58","client_secret": "$2b$10$AnhmhDe4L027E.XQwHyWcOV0Pi/tBTymd4zMXt9i6L73vHLxkW1q"}]')
+try:
+    OIDC_PROVIDERS = json.loads(OIDC_PROVIDERS_JSON)
+except json.JSONDecodeError:
+    OIDC_PROVIDERS = []
+# PostgreSQL数据库配置
+DB_HOST = os.environ.get('DB_HOST', 'hkg1.clusters.zeabur.com')
+DB_PORT = os.environ.get('DB_PORT', '32627')
+DB_NAME = os.environ.get('DB_NAME', 'lettest')
+DB_USER = os.environ.get('DB_USER', 'root')
+DB_PASSWORD = os.environ.get('DB_PASSWORD', '60zquVE1c7TLInw0ivZg9H543Kr2GM8p')
+
+
+# ====================== 应用配置 ======================
+# 配置PGSQL数据库连接
+DATABASE_URI = f"postgresql://{DB_USER}:{DB_PASSWORD}@{DB_HOST}:{DB_PORT}/{DB_NAME}"
+app.config['SQLALCHEMY_DATABASE_URI'] = DATABASE_URI
+# 关闭SQLAlchemy的修改跟踪功能，提升性能
+app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
+# 可选：开启PGSQL连接池，优化性能（适配多请求场景）
+app.config['SQLALCHEMY_POOL_SIZE'] = 5
+app.config['SQLALCHEMY_MAX_OVERFLOW'] = 2
+
+app.config['JWT_SECRET_KEY'] = JWT_SECRET_KEY
+app.config['API_TOKEN'] = API_TOKEN
+
+app.config['REDIS_HOST'] = REDIS_HOST
+app.config['REDIS_PORT'] = REDIS_PORT
+app.config['REDIS_DB'] = REDIS_DB
+app.config['REDIS_PASSWORD'] = REDIS_PASSWORD
+
+app.config['GITHUB_CLIENT_ID'] = GITHUB_CLIENT_ID
+app.config['GITHUB_CLIENT_SECRET'] = GITHUB_CLIENT_SECRET
+
+app.config['OIDC_PROVIDERS'] = OIDC_PROVIDERS
+
+# 初始化SQLAlchemy实例，关联Flask应用，实现ORM功能
+db = SQLAlchemy(app)
+
+# ====================== 数据库模型定义 ======================
+# 定义课程表模型，继承db.Model（SQLAlchemy的基础模型类）
+class Course(db.Model):
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
+    name = db.Column(db.String(50), unique=True, nullable=False)
+    # 课程与学员一对多
+    students = db.relationship('Student', backref='course', lazy=True)
+    # 课程与题目一个对多
+    questions = db.relationship('Question', backref='course', lazy=True)
+
+    def to_dict(self):
+        students_list = self.students \
+            if hasattr(self.students, '__len__') else list(self.students)
+        questions_list = self.questions \
+            if hasattr(self.questions, '__len__') else list(self.questions)
+        return \
+        {
+            'id': self.id,
+            'name': self.name,
+            'student_count': len(students_list),
+            'question_count': len(questions_list)
+        }
+
+# 定义学员表模型
+class Student(db.Model):
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
+    name = db.Column(db.String(30), nullable=False)
+    # 外键：关联课程表的id字段，建立学员与课程的关联
+    course_id = db.Column(db.Integer, db.ForeignKey('course.id'), nullable=False)
+
+    def to_dict(self):
+        course_name = None
+        if self.course:
+            course_name = self.course.name
+        return \
+        {
+            'id': self.id,
+            'name': self.name,
+            'course_id': self.course_id,
+            'course_name': course_name
+        }
+
+# 定义题目表模型
+class Question(db.Model):
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
+    content = db.Column(db.Text, nullable=False)
+    # 外键：关联课程表的id字段，建立题目与课程的关联
+    course_id = db.Column(db.Integer, db.ForeignKey('course.id'), nullable=False)
+
+    def to_dict(self):
+        course_name = None
+        if self.course:
+            course_name = self.course.name
+        return \
+        {
+            'id': self.id,
+            'content': self.content,
+            'course_id': self.course_id,
+            'course_name': course_name
+        }
+
+# ====================== 数据库初始化 ======================
+with app.app_context():
+    db.create_all()
+# ====================== 认证中间件 ======================
+def check_auth():
+    """检查API认证"""
+    # 排除不需要认证的公共路由
+    public_routes = ['health_check', 'config_info', 'query_course', 'query_student', 'query_question']
+
+    if request.endpoint in public_routes:
+        return None
+
+    # 获取Authorization头部
+    auth_header = request.headers.get('Authorization')
+
+    if not auth_header:
+        return jsonify({'code': 401, 'msg': '缺少认证令牌'}), 401
+
+    # 检查Bearer令牌格式
+    if not auth_header.startswith('Bearer '):
+        return jsonify({'code': 401, 'msg': '令牌格式错误，应为Bearer令牌'}), 401
+
+    token = auth_header.split(' ')[1]
+
+    # 验证令牌
+    if token != API_TOKEN:
+        return jsonify({'code': 401, 'msg': '无效的认证令牌'}), 401
+    return None
+
+@app.before_request
+def before_request():
+    """在每个请求之前执行"""
+    # 检查认证
+    auth_result = check_auth()
+    if auth_result:
+        return auth_result
+
+
+# ====================== 系统信息接口 ======================
+@app.route('/health', methods=['GET'])
+def health_check():
+    """健康检查接口"""
+    try:
+        # 尝试连接数据库
+        db.session.execute('SELECT 1')
+        db_status = 'connected'
+    except Exception as e:
+        db_status = f'error: {str(e)}'
+
+    return jsonify({
+        'code': 200,
+        'msg': '系统运行正常',
+        'data': {
+            'service': 'Online Judge System API',
+            'database': db_status,
+            'environment': 'production' if not app.debug else 'development'
+        }
+    }), 200
+
+
+@app.route('/config/info', methods=['GET'])
+def config_info():
+    """获取配置信息（安全信息已隐藏）"""
+    return jsonify({
+        'code': 200,
+        'msg': '配置信息获取成功',
+        'data': {
+            'database': {
+                'host': DB_HOST,
+                'port': DB_PORT,
+                'name': DB_NAME,
+                'user': DB_USER,
+                'connected': True if 'lettest' in DATABASE_URI else False
+            },
+            'redis': {
+                'host': REDIS_HOST,
+                'port': REDIS_PORT,
+                'enabled': True
+            },
+            'oauth': {
+                'github_enabled': bool(GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET),
+                'oidc_providers': [provider['name'] for provider in OIDC_PROVIDERS]
+            },
+            'security': {
+                'api_auth_enabled': True,
+                'jwt_enabled': bool(JWT_SECRET_KEY)
+            }
+        }
+    }), 200
+
+
+# ====================== 课程相关接口 ======================
+@app.route('/course/add', methods=['POST'])
+def add_course():
+    """新增课程"""
+    data = request.get_json() or {}
+    course_name = data.get('name')
+
+    if not course_name:
+        return jsonify({'code': 400, 'msg': '缺少课程名称参数'}), 400
+
+    existing_course = Course.query.filter_by(name=course_name).first()
+    if existing_course:
+        return jsonify({'code': 400, 'msg': '课程已存在'}), 400
+
+    new_course = Course(name=course_name)
+    db.session.add(new_course)
+
+    try:
+        db.session.commit()
+        return jsonify({
+            'code': 200,
+            'msg': '课程添加成功',
+            'data': {
+                'course_id': new_course.id,
+                'name': new_course.name
+            }
+        }), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'课程添加失败：{str(e)}'}), 500
+
+
+@app.route('/course/query', methods=['GET'])
+def query_course():
+    """查询课程"""
+    course_id = request.args.get('id')
+    if course_id:
+        course = Course.query.get(course_id)
+        if not course:
+            return jsonify({'code': 404, 'msg': '课程不存在'}), 404
+
+        course_info = course.to_dict()
+
+        students_list = list(course.students) \
+            if hasattr(course.students, '__iter__') else []
+        questions_list = list(course.questions)\
+            if hasattr(course.questions, '__iter__') else []
+
+        course_info['students'] = [{'id': s.id, 'name': s.name} for s in students_list]
+        course_info['questions'] = [{'id': q.id, 'content': q.content} for q in questions_list]
+
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': course_info}), 200
+    else:
+        all_courses = Course.query.all()
+        course_list = [c.to_dict() for c in all_courses]
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': course_list}), 200
+
+
+@app.route('/course/update', methods=['PUT'])
+def update_course():
+    """修改课程"""
+    data = request.get_json() or {}
+    course_id = data.get('id')
+    new_name = data.get('name')
+
+    if not course_id or not new_name:
+        return jsonify({'code': 400, 'msg': '缺少课程ID或新名称参数'}), 400
+    course = Course.query.get(course_id)
+    if not course:
+        return jsonify({'code': 404, 'msg': '课程不存在'}), 404
+    if Course.query.filter_by(name=new_name).filter(Course.id != course_id).first():
+        return jsonify({'code': 400, 'msg': '新课程名称已存在'}), 400
+
+    course.name = new_name
+
+    try:
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '课程修改成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'课程修改失败：{str(e)}'}), 500
+
+
+@app.route('/course/delete', methods=['DELETE'])
+def delete_course():
+    """删除课程"""
+    data = request.get_json() or {}
+    course_id = data.get('id')
+
+    if not course_id:
+        return jsonify({'code': 400, 'msg': '缺少课程ID参数'}), 400
+    course = Course.query.get(course_id)
+    if not course:
+        return jsonify({'code': 404, 'msg': '课程不存在'}), 404
+    try:
+        Student.query.filter_by(course_id=course_id).delete()
+        Question.query.filter_by(course_id=course_id).delete()
+        db.session.delete(course)
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '课程及关联学员/题目删除成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'课程删除失败：{str(e)}'}), 500
+
+
+# ====================== 学员相关接口 ======================
+@app.route('/student/add', methods=['POST'])
+def add_student():
+    """新增学员"""
+    data = request.get_json() or {}
+    student_name = data.get('name')
+    course_id = data.get('course_id')
+
+    if not student_name or not course_id:
+        return jsonify({'code': 400, 'msg': '缺少学员姓名或课程ID参数'}), 400
+    if not Course.query.get(course_id):
+        return jsonify({'code': 404, 'msg': '课程不存在'}), 404
+    new_student = Student(name=student_name, course_id=course_id)
+    db.session.add(new_student)
+
+    try:
+        db.session.commit()
+        return jsonify({
+            'code': 200,
+            'msg': '学员添加成功',
+            'data': {'student_id': new_student.id}
+        }), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'学员添加失败：{str(e)}'}), 500
+
+
+@app.route('/student/query', methods=['GET'])
+def query_student():
+    """查询学员"""
+    student_id = request.args.get('id')
+    course_id = request.args.get('course_id')
+
+    if student_id:
+        student = Student.query.get(student_id)
+        if not student:
+            return jsonify({'code': 404, 'msg': '学员不存在'}), 404
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': student.to_dict()}), 200
+    elif course_id:
+        students = Student.query.filter_by(course_id=course_id).all()
+        student_list = [s.to_dict() for s in students]
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': student_list}), 200
+    else:
+        all_students = Student.query.all()
+        student_list = [s.to_dict() for s in all_students]
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': student_list}), 200
+
+
+@app.route('/student/update', methods=['PUT'])
+def update_student():
+    """修改学员"""
+    data = request.get_json() or {}
+    student_id = data.get('id')
+    new_name = data.get('name')
+    new_course_id = data.get('course_id')
+
+    if not student_id or (not new_name and not new_course_id):
+        return jsonify({'code': 400, 'msg': '缺少学员ID或修改参数（姓名/课程ID）'}), 400
+    student = Student.query.get(student_id)
+    if not student:
+        return jsonify({'code': 404, 'msg': '学员不存在'}), 404
+    if new_course_id and not Course.query.get(new_course_id):
+        return jsonify({'code': 404, 'msg': '新课程不存在'}), 404
+    if new_name:
+        student.name = new_name
+    if new_course_id:
+        student.course_id = new_course_id
+
+    try:
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '学员修改成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'学员修改失败：{str(e)}'}), 500
+
+
+@app.route('/student/delete', methods=['DELETE'])
+def delete_student():
+    """删除学员"""
+    data = request.get_json() or {}
+    student_id = data.get('id')
+
+    if not student_id:
+        return jsonify({'code': 400, 'msg': '缺少学员ID参数'}), 400
+    student = Student.query.get(student_id)
+    if not student:
+        return jsonify({'code': 404, 'msg': '学员不存在'}), 404
+
+    try:
+        db.session.delete(student)
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '学员删除成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'学员删除失败：{str(e)}'}), 500
+
+
+# ====================== 题目相关接口 ======================
+@app.route('/question/add', methods=['POST'])
+def add_question():
+    """新增题目"""
+    data = request.get_json() or {}
+    question_content = data.get('content')
+    course_id = data.get('course_id')
+
+    if not question_content or not course_id:
+        return jsonify({'code': 400, 'msg': '缺少题目内容或课程ID参数'}), 400
+    if not Course.query.get(course_id):
+        return jsonify({'code': 404, 'msg': '课程不存在'}), 404
+
+    new_question = Question(content=question_content, course_id=course_id)
+    db.session.add(new_question)
+
+    try:
+        db.session.commit()
+        return jsonify({
+            'code': 200,
+            'msg': '题目添加成功',
+            'data': {'question_id': new_question.id}
+        }), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'题目添加失败：{str(e)}'}), 500
+
+
+@app.route('/question/query', methods=['GET'])
+def query_question():
+    """查询题目"""
+    question_id = request.args.get('id')
+    course_id = request.args.get('course_id')
+
+    if question_id:
+        question = Question.query.get(question_id)
+        if not question:
+            return jsonify({'code': 404, 'msg': '题目不存在'}), 404
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': question.to_dict()}), 200
+    elif course_id:
+        questions = Question.query.filter_by(course_id=course_id).all()
+        question_list = [q.to_dict() for q in questions]
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': question_list}), 200
+    else:
+        all_questions = Question.query.all()
+        question_list = [q.to_dict() for q in all_questions]
+        return jsonify({'code': 200, 'msg': '查询成功', 'data': question_list}), 200
+
+
+@app.route('/question/update', methods=['PUT'])
+def update_question():
+    """修改题目"""
+    data = request.get_json() or {}
+    question_id = data.get('id')
+    new_content = data.get('content')
+    new_course_id = data.get('course_id')
+
+    if not question_id or (not new_content and not new_course_id):
+        return jsonify({'code': 400, 'msg': '缺少题目ID或修改参数（内容/课程ID）'}), 400
+
+    question = Question.query.get(question_id)
+    if not question:
+        return jsonify({'code': 404, 'msg': '题目不存在'}), 404
+    if new_course_id and not Course.query.get(new_course_id):
+        return jsonify({'code': 404, 'msg': '新课程不存在'}), 404
+    if new_content:
+        question.content = new_content
+    if new_course_id:
+        question.course_id = new_course_id
+
+    try:
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '题目修改成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'题目修改失败：{str(e)}'}), 500
+
+
+@app.route('/question/delete', methods=['DELETE'])
+def delete_question():
+    """删除题目"""
+    data = request.get_json() or {}
+    question_id = data.get('id')
+
+    if not question_id:
+        return jsonify({'code': 400, 'msg': '缺少题目ID参数'}), 400
+    question = Question.query.get(question_id)
+    if not question:
+        return jsonify({'code': 404, 'msg': '题目不存在'}), 404
+    try:
+        db.session.delete(question)
+        db.session.commit()
+        return jsonify({'code': 200, 'msg': '题目删除成功'}), 200
+    except Exception as e:
+        db.session.rollback()
+        return jsonify({'code': 500, 'msg': f'题目删除失败：{str(e)}'}), 500
+
+
+# ====================== 认证相关接口 ======================
+@app.route('/auth/verify', methods=['POST'])
+def verify_auth():
+    """验证API令牌"""
+    data = request.get_json() or {}
+    token = data.get('token')
+
+    if not token:
+        return jsonify({'code': 400, 'msg': '缺少令牌参数'}), 400
+
+    if token == API_TOKEN:
+        return jsonify({
+            'code': 200,
+            'msg': '令牌验证成功',
+            'data': {
+                'valid': True,
+                'token_type': 'API'
+            }
+        }), 200
+    else:
+        return jsonify({
+            'code': 401,
+            'msg': '令牌验证失败',
+            'data': {'valid': False}
+        }), 401
+
+
+# ====================== 主函数入口 ======================
+if __name__ == '__main__':
+    app.run(debug=True, host='0.0.0.0', port=5000)
\ No newline at end of file
-- 
Gitee


From b2f734001f95ff8d942c877745d6adf41ad17043 Mon Sep 17 00:00:00 2001
From: Palosting <461007901@qq.com>
Date: Fri, 16 Jan 2026 13:24:04 +0800
Subject: [PATCH 10/22] =?UTF-8?q?=E7=94=A8=E6=88=B7=E7=9B=B8=E5=85=B3?=
 =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=82=A8=E5=AD=98=E5=92=8C=E5=9F=BA=E7=A1=80?=
 =?UTF-8?q?=E6=9C=8D=E5=8A=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controllers/course_controller.py          | 272 ++++++++++++++++++
 .../controllers/user_controller.py            | 177 ++++++++++++
 .../fastapi_of_letcoing/core/db_container.py  |  67 +++++
 .../interfaces/course_interfaces.py           |  61 ++++
 .../interfaces/user_interfaces.py             |  39 +++
 .../models/course_models.py                   |  49 ++++
 .../fastapi_of_letcoing/models/user_modles.py |  28 ++
 .../services/course_service.py                | 207 +++++++++++++
 8 files changed, 900 insertions(+)
 create mode 100644 webapi/fastapi_of_letcoing/controllers/course_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/user_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/core/db_container.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
 create mode 100644 webapi/fastapi_of_letcoing/models/course_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/user_modles.py
 create mode 100644 webapi/fastapi_of_letcoing/services/course_service.py

diff --git a/webapi/fastapi_of_letcoing/controllers/course_controller.py b/webapi/fastapi_of_letcoing/controllers/course_controller.py
new file mode 100644
index 0000000..f19ec1c
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/course_controller.py
@@ -0,0 +1,272 @@
+from flask import request, g
+from flask_restx import Resource, Namespace, fields
+from interfaces.service_interfaces import ICourseService
+from core.di_container import inject
+from middleware.auth_middleware import AuthMiddleware, RateLimitMiddleware
+
+# 创建命名空间
+api = Namespace('courses', description='课程及学习进度相关操作')
+
+# 定义课程数据模型
+course_model = api.model('Course', {
+    'title': fields.String(required=True, description='课程标题'),
+    'description': fields.String(required=True, description='课程描述'),
+    'cover_url': fields.String(required=False, description='课程封面', nullable=True)
+})
+
+course_update_model = api.model('CourseUpdate', {
+    'title': fields.String(required=False, description='课程标题'),
+    'description': fields.String(required=False, description='课程描述'),
+    'cover_url': fields.String(required=False, description='课程封面'),
+    'is_active': fields.Boolean(required=False, description='是否上架')
+})
+
+course_response_model = api.model('CourseResponse', {
+    'id': fields.Integer(description='课程ID'),
+    'title': fields.String(description='课程标题'),
+    'description': fields.String(description='课程描述'),
+    'cover_url': fields.String(description='课程封面', nullable=True),
+    'is_active': fields.Boolean(description='是否上架'),
+    'created_at': fields.String(description='创建时间'),
+    'updated_at': fields.String(description='更新时间')
+})
+
+# 定义学习进度数据模型
+progress_create_model = api.model('ProgressCreate', {
+    'course_id': fields.Integer(required=True, description='课程ID'),
+    'progress': fields.Integer(required=True, description='学习进度（0-100）')
+})
+
+progress_update_model = api.model('ProgressUpdate', {
+    'progress': fields.Integer(required=False, description='学习进度（0-100）'),
+    'completed': fields.Boolean(required=False, description='是否完成')
+})
+
+progress_response_model = api.model('ProgressResponse', {
+    'id': fields.Integer(description='进度ID'),
+    'user_id': fields.Integer(description='用户ID'),
+    'course_id': fields.Integer(description='课程ID'),
+    'progress': fields.Integer(description='学习进度'),
+    'completed': fields.Boolean(description='是否完成'),
+    'last_learned_at': fields.String(description='最后学习时间'),
+    'created_at': fields.String(description='创建时间'),
+    'updated_at': fields.String(description='更新时间')
+})
+
+# 定义用户课程关联响应模型
+user_course_response_model = api.model('UserCourseResponse', {
+    'course': fields.Nested(course_response_model, description='课程信息'),
+    'progress': fields.Nested(progress_response_model, description='学习进度')
+})
+
+error_model = api.model('ErrorResponse', {
+    'error': fields.String(description='错误信息')
+})
+
+
+# 课程相关接口
+@api.route('')
+class CourseListController(Resource):
+    @api.expect(course_model)
+    @api.doc('create_course')
+    @api.response(201, 'Created', course_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @AuthMiddleware.require_auth
+    def post(self):
+        """创建课程（需要认证）"""
+        course_service = inject(ICourseService)
+        model = request.get_json()
+
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        try:
+            from interfaces.course_interfaces import CourseCreateRequest
+            course_data = CourseCreateRequest(**model)
+            result = course_service.create_course(course_data)
+            return result, 201
+        except ValueError as e:
+            return {'error': str(e)}, 400
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+    @api.doc('list_courses')
+    @api.response(200, 'Success', [course_response_model])
+    def get(self):
+        """获取课程列表（公开接口）"""
+        course_service = inject(ICourseService)
+        limit = int(request.args.get('limit', 50))
+        offset = int(request.args.get('offset', 0))
+        active_only = request.args.get('active_only', 'true').lower() == 'true'
+
+        try:
+            result = course_service.list_courses(limit=limit, offset=offset, active_only=active_only)
+            return result, 200
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+
+@api.route('/<<int:course_id>')
+class CourseController(Resource):
+    @api.doc('get_course')
+    @api.response(200, 'Success', course_response_model)
+    @api.response(404, 'Not Found', error_model)
+    def get(self, course_id):
+        """获取课程详情（公开接口）"""
+        course_service = inject(ICourseService)
+
+        try:
+            result = course_service.get_course_by_id(course_id)
+            if not result:
+                return {'error': '课程不存在'}, 404
+            return result, 200
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+    @api.expect(course_update_model)
+    @api.doc('update_course')
+    @api.response(200, 'Success', course_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @api.response(404, 'Not Found', error_model)
+    @AuthMiddleware.require_auth
+    def put(self, course_id):
+        """更新课程（需要认证）"""
+        course_service = inject(ICourseService)
+        model = request.get_json()
+
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        try:
+            from interfaces.course_interfaces import CourseUpdateRequest
+            update_data = CourseUpdateRequest(**model)
+            result = course_service.update_course(course_id, update_data)
+            if not result:
+                return {'error': '课程不存在'}, 404
+            return result, 200
+        except ValueError as e:
+            return {'error': str(e)}, 400
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+
+# 学习进度相关接口
+@api.route('/progress')
+class LearningProgressController(Resource):
+    @api.expect(progress_create_model)
+    @api.doc('create_progress')
+    @api.response(201, 'Created', progress_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @AuthMiddleware.require_auth
+    def post(self):
+        """创建学习进度（需要认证）"""
+        course_service = inject(ICourseService)
+        current_user = getattr(g, 'current_user', None)
+
+        if not current_user:
+            return {'error': '未认证'}, 401
+
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        try:
+            from interfaces.course_interfaces import LearningProgressCreateRequest
+            progress_data = LearningProgressCreateRequest(**model)
+            result = course_service.create_learning_progress(
+                user_id=int(current_user['id']),
+                progress_data=progress_data
+            )
+            return result, 201
+        except ValueError as e:
+            return {'error': str(e)}, 400
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+
+@api.route('/progress/<<int:course_id>')
+class LearningProgressDetailController(Resource):
+    @api.doc('get_progress')
+    @api.response(200, 'Success', progress_response_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @api.response(404, 'Not Found', error_model)
+    @AuthMiddleware.require_auth
+    def get(self, course_id):
+        """获取用户某课程学习进度（需要认证）"""
+        course_service = inject(ICourseService)
+        current_user = getattr(g, 'current_user', None)
+
+        if not current_user:
+            return {'error': '未认证'}, 401
+
+        try:
+            result = course_service.get_learning_progress(
+                user_id=int(current_user['id']),
+                course_id=course_id
+            )
+            if not result:
+                return {'error': '学习进度不存在'}, 404
+            return result, 200
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+    @api.expect(progress_update_model)
+    @api.doc('update_progress')
+    @api.response(200, 'Success', progress_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @api.response(404, 'Not Found', error_model)
+    @AuthMiddleware.require_auth
+    @RateLimitMiddleware.rate_limit(max_requests=10, window_seconds=3600)
+    def put(self, course_id):
+        """更新用户某课程学习进度（需要认证）"""
+        course_service = inject(ICourseService)
+        current_user = getattr(g, 'current_user', None)
+
+        if not current_user:
+            return {'error': '未认证'}, 401
+
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        try:
+            from interfaces.course_interfaces import LearningProgressUpdateRequest
+            update_data = LearningProgressUpdateRequest(**model)
+            result = course_service.update_learning_progress(
+                user_id=int(current_user['id']),
+                course_id=course_id,
+                update_data=update_data
+            )
+            if not result:
+                return {'error': '学习进度不存在'}, 404
+            return result, 200
+        except ValueError as e:
+            return {'error': str(e)}, 400
+        except Exception as e:
+            return {'error': str(e)}, 500
+
+
+# 用户课程关联接口
+@api.route('/user/courses')
+class UserCourseController(Resource):
+    @api.doc('get_user_courses')
+    @api.response(200, 'Success', [user_course_response_model])
+    @api.response(401, 'Unauthorized', error_model)
+    @AuthMiddleware.require_auth
+    def get(self):
+        """获取用户已关联的所有课程及进度（需要认证）"""
+        course_service = inject(ICourseService)
+        current_user = getattr(g, 'current_user', None)
+
+        if not current_user:
+            return {'error': '未认证'}, 401
+
+        try:
+            result = course_service.get_user_courses(user_id=int(current_user['id']))
+            return result, 200
+        except Exception as e:
+            return {'error': str(e)}, 500
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/user_controller.py b/webapi/fastapi_of_letcoing/controllers/user_controller.py
new file mode 100644
index 0000000..2e4fd6a
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/user_controller.py
@@ -0,0 +1,177 @@
+from flask import request, g
+from flask_restx import Resource, Namespace, fields
+from interfaces.service_interfaces import IUserService
+from core.di_container import inject
+from models.user_models import UserRegistrationRequest, UserLoginRequest
+from middleware.auth_middleware import AuthMiddleware, RateLimitMiddleware
+
+# 创建命名空间
+api = Namespace('users', description='用户相关操作')
+
+# 定义数据模型
+user_registration_model = api.model('UserRegistration', {
+    'username': fields.String(required=True, description='用户名'),
+    'email': fields.String(required=True, description='电子邮箱'),
+    'password': fields.String(required=True, description='密码'),
+    'avatar_url': fields.String(required=False, description='头像地址', nullable=True)
+})
+
+user_login_model = api.model('UserLogin', {
+    'email': fields.String(required=True, description='电子邮箱'),
+    'password': fields.String(required=True, description='密码'),
+})
+
+# 定义响应模型
+user_response_model = api.model('UserResponse', {
+    'id': fields.String(description='用户ID'),
+    'username': fields.String(description='用户名'),
+    'email': fields.String(description='电子邮箱'),
+    'avatar_url': fields.String(description='头像地址', nullable=True),
+    'token': fields.String(description='认证令牌', nullable=True),
+})
+
+error_model = api.model('ErrorResponse', {
+    'error': fields.String(description='错误信息'),
+})
+
+
+@api.route('/register')
+class UserRegistrationController(Resource):
+    @api.expect(user_registration_model)
+    @api.doc('register_user')
+    @api.response(201, 'Created', user_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @RateLimitMiddleware.rate_limit(max_requests=10, window_seconds=3600)
+    def post(self):
+        """用户注册"""
+        user_service = inject(IUserService)
+
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        # 验证必填字段
+        required_fields = ['username', 'email', 'password']
+        for field in required_fields:
+            if field not in model or not model[field].strip():
+                return {'error': f'{field}不能为空'}, 400
+
+        # 构建注册请求对象
+        registration_request = UserRegistrationRequest(
+            username=model['username'],
+            email=model['email'],
+            password=model['password']
+            avatar_url = model.get('avatar_url')
+        )
+
+        # 调用服务
+        result = user_service.register_user(registration_request)
+
+        if not result.success:
+            return {'error': result.message}, 400
+
+        return {
+            'id': result.user.id,
+            'username': result.user.username,
+            'email': result.user.email,
+            'message': '用户注册成功'
+        }, 201
+
+
+@api.route('/login')
+class UserLoginController(Resource):
+    @api.expect(user_login_model)
+    @api.doc('login_user')
+    @api.response(200, 'Success', user_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @RateLimitMiddleware.rate_limit(max_requests=20, window_seconds=3600)
+    def post(self):
+        """用户登录"""
+        user_service = inject(IUserService)
+
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+
+        # 验证必填字段
+        for field in ['email', 'password']:
+            if field not in model or not model[field].strip():
+                return {'error': f'{field}不能为空'}, 400
+
+        # 构建登录请求对象
+        login_request = UserLoginRequest(
+            email=model['email'],
+            password=model['password']
+        )
+
+        # 调用服务
+        result = user_service.login_user(login_request)
+
+        if not result.success:
+            return {'error': result.message}, 401
+
+        return {
+            'id': result.user.id,
+            'username': result.user.username,
+            'email': result.user.email,
+            'token': result.token,
+            'message': '登录成功'
+        }, 200
+
+
+@api.route('/profile')
+class UserProfileController(Resource):
+    @api.doc('get_user_profile')
+    @api.response(200, 'Success', user_response_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @AuthMiddleware.require_auth
+    def get(self):
+        """获取当前用户信息（需要认证）"""
+        current_user = getattr(g, 'current_user', None)
+        if not current_user:
+            return {'error': '未认证'}, 401
+
+        return {
+            'id': current_user.get('id'),
+            'username': current_user.get('username'),
+            'email': current_user.get('email')
+        }, 200
+
+
+@api.route('/<<int:user_id>/avatar')
+class UserAvatarController(Resource):
+    @api.expect(fields.String(required=True, description='头像地址', name='avatar_url'))
+    @api.doc('update_user_avatar')
+    @api.response(200, 'Success', user_response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized', error_model)
+    @api.response(404, 'Not Found', error_model)
+    @AuthMiddleware.require_auth
+    @RateLimitMiddleware.rate_limit(max_requests=5, window_seconds=3600)
+    def put(self, user_id):
+        """更新用户头像（需要认证）"""
+        user_service = inject(IUserService)
+
+        model = request.get_json()
+        if not model or 'avatar_url' not in model:
+            return {'error': '头像地址不能为空'}, 400
+
+        avatar_url = model['avatar_url'].strip()
+        if not avatar_url:
+            return {'error': '头像地址不能为空'}, 400
+
+        try:
+            result = user_service.update_user_avatar(user_id, avatar_url)
+            if not result:
+                return {'error': '用户不存在'}, 404
+
+            return {
+                'id': result['id'],
+                'username': result['username'],
+                'email': result['email'],
+                'avatar_url': result['avatar_url'],
+                'message': '头像更新成功'
+            }, 200
+        except Exception as e:
+            return {'error': str(e)}, 500
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/db_container.py b/webapi/fastapi_of_letcoing/core/db_container.py
new file mode 100644
index 0000000..8ccf26d
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/core/db_container.py
@@ -0,0 +1,67 @@
+"""
+Peewee连接PostgreSQL配置
+基于Peewee的PostgreSQL数据库连接管理及基础模型定义
+"""
+from dataclasses import dataclass
+from typing import Optional
+
+from peewee import PostgresqlDatabase, Model
+from core.di_container import get_container
+from interfaces.service_interfaces import IConfigService
+
+
+@dataclass
+class PeeweeDatabaseConfig:
+    """Peewee数据库配置类"""
+
+    # 数据库连接参数
+    host: str = "localhost"
+    port: int = 5432
+    database: str = "letcoding"
+    user: str = "postgres"
+    password: str = "123456"
+
+    # 连接池配置
+    max_connections: int = 20
+    stale_timeout: int = 300
+
+    def __post_init__(self):
+        """初始化时从ConfigService读取配置"""
+        try:
+            config_service = get_container().resolve(IConfigService)
+            db_config = config_service.get_database_config()
+
+            self.host = db_config["host"]
+            self.port = db_config["port"]
+            self.database = db_config["database"]
+            self.user = db_config["username"]
+            self.password = db_config["password"]
+            self.max_connections = db_config["max_connections"]
+            self.stale_timeout = db_config["stale_timeout"]
+        except Exception:
+            # 依赖注入不可用时使用默认值
+            pass
+
+    @property
+    def connection_params(self) -> dict:
+        """获取Peewee连接参数字典"""
+        return {
+            "database": self.database,
+            "user": self.user,
+            "password": self.password,
+            "host": self.host,
+            "port": self.port,
+            "max_connections": self.max_connections,
+            "stale_timeout": self.stale_timeout
+        }
+
+
+# 初始化数据库连接
+db_config = PeeweeDatabaseConfig()
+db = PostgresqlDatabase(** db_config.connection_params)
+
+
+# Peewee基础模型（所有业务模型继承此类）
+class BaseModel(Model):
+    class Meta:
+        database = db  # 绑定数据库连接
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
new file mode 100644
index 0000000..7168727
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
@@ -0,0 +1,61 @@
+"""
+课程及学习进度请求/响应数据校验（Pydantic）
+"""
+from typing import Optional, List
+from pydantic import BaseModel, Field
+
+
+class CourseCreateRequest(BaseModel):
+    """创建课程请求参数"""
+    title: str = Field(min_length=2, max_length=100, description="课程标题")
+    description: str = Field(description="课程描述")
+    cover_url: Optional[str] = Field(None, max_length=255, description="课程封面")
+
+
+class CourseUpdateRequest(BaseModel):
+    """更新课程请求参数"""
+    title: Optional[str] = Field(None, min_length=2, max_length=100, description="课程标题")
+    description: Optional[str] = Field(None, description="课程描述")
+    cover_url: Optional[str] = Field(None, max_length=255, description="课程封面")
+    is_active: Optional[bool] = Field(None, description="是否上架")
+
+
+class CourseResponse(BaseModel):
+    """课程响应数据格式"""
+    id: int
+    title: str
+    description: str
+    cover_url: Optional[str] = None
+    is_active: bool
+    created_at: str
+    updated_at: str
+
+
+class LearningProgressCreateRequest(BaseModel):
+    """创建学习进度请求参数"""
+    course_id: int = Field(description="课程ID")
+    progress: int = Field(ge=0, le=100, description="学习进度（0-100）")
+
+
+class LearningProgressUpdateRequest(BaseModel):
+    """更新学习进度请求参数"""
+    progress: Optional[int] = Field(None, ge=0, le=100, description="学习进度（0-100）")
+    completed: Optional[bool] = Field(None, description="是否完成")
+
+
+class LearningProgressResponse(BaseModel):
+    """学习进度响应数据格式"""
+    id: int
+    user_id: int
+    course_id: int
+    progress: int
+    completed: bool
+    last_learned_at: str
+    created_at: str
+    updated_at: str
+
+
+class UserCourseResponse(BaseModel):
+    """用户关联课程响应数据（包含课程信息和进度）"""
+    course: CourseResponse
+    progress: LearningProgressResponse
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
new file mode 100644
index 0000000..201db4b
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
@@ -0,0 +1,39 @@
+"""
+用户请求/响应数据校验（Pydantic）
+
+定义用户相关的请求和响应数据模型，用于接口数据校验和序列化。
+"""
+
+from typing import Optional
+from pydantic import BaseModel, EmailStr, Field
+
+
+class UserCreateRequest(BaseModel):
+    """创建用户请求参数"""
+    username: str = Field(min_length=3, max_length=50, description="用户名")
+    email: EmailStr = Field(description="用户邮箱")
+    password: str = Field(min_length=6, description="用户密码")
+    avatar_url: Optional[str] = Field(None, max_length=255, description="头像地址")
+
+
+class UserUpdateRequest(BaseModel):
+    """更新用户请求参数（可选字段）"""
+    username: Optional[str] = Field(None, min_length=3, max_length=50)
+    email: Optional[EmailStr] = None
+    password: Optional[str] = Field(None, min_length=6)
+    avatar_url: Optional[str] = Field(None, max_length=255, description="头像地址")
+
+
+class UserResponse(BaseModel):
+    """用户响应数据格式"""
+    id: int
+    username: str
+    email: str
+    is_active: bool
+    avatar_url: Optional[str] = None
+    created_at: str
+    updated_at: Optional[str] = None
+    last_login: Optional[str] = None
+
+    class Config:
+        orm_mode = True  # 支持Peewee模型直接转换
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/course_models.py b/webapi/fastapi_of_letcoing/models/course_models.py
new file mode 100644
index 0000000..434bb34
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/course_models.py
@@ -0,0 +1,49 @@
+"""
+课程及学习进度模型
+"""
+from datetime import datetime
+from peewee import AutoField, CharField, TextField, IntegerField, ForeignKeyField, DateTimeField, BooleanField
+
+from core.db_container import BaseModel
+from models.user_models import User
+
+
+class Course(BaseModel):
+    """课程模型"""
+    id = AutoField(primary_key=True, verbose_name="课程ID")
+    title = CharField(max_length=100, verbose_name="课程标题")
+    description = TextField(verbose_name="课程描述")
+    cover_url = CharField(max_length=255, null=True, verbose_name="课程封面")
+    is_active = BooleanField(default=True, verbose_name="是否上架")
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+
+    class Meta:
+        table_name = "courses"
+
+    def to_dict(self) -> dict:
+        data = super().to_dict()
+        return data
+
+
+class LearningProgress(BaseModel):
+    """学习进度模型（关联用户与课程）"""
+    id = AutoField(primary_key=True, verbose_name="进度ID")
+    user = ForeignKeyField(User, on_delete='CASCADE', verbose_name="关联用户")
+    course = ForeignKeyField(Course, on_delete='CASCADE', verbose_name="关联课程")
+    progress = IntegerField(default=0, verbose_name="学习进度（百分比）")
+    completed = BooleanField(default=False, verbose_name="是否完成")
+    last_learned_at = DateTimeField(default=datetime.now, verbose_name="最后学习时间")
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+
+    class Meta:
+        table_name = "learning_progress"
+        unique_together = (('user', 'course'),)  # 一个用户对一个课程只能有一条进度记录
+
+    def to_dict(self) -> dict:
+        data = super().to_dict()
+        # 转换外键为ID
+        data['user_id'] = data.pop('user')
+        data['course_id'] = data.pop('course')
+        return data
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/user_modles.py b/webapi/fastapi_of_letcoing/models/user_modles.py
new file mode 100644
index 0000000..1c88b9b
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/user_modles.py
@@ -0,0 +1,28 @@
+"""
+用户模型
+"""
+from datetime import datetime
+from peewee import AutoField, CharField, BooleanField, DateTimeField
+
+from core.db_container import BaseModel
+
+
+class User(BaseModel):
+    """用户模型"""
+
+    id = AutoField(primary_key=True, verbose_name="用户ID")
+    username = CharField(max_length=50, unique=True, index=True, verbose_name="用户名")
+    email = CharField(max_length=100, unique=True, index=True, verbose_name="邮箱")
+    password_hash = CharField(max_length=255, verbose_name="密码哈希")
+    is_active = BooleanField(default=True, verbose_name="是否激活")
+    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    avatar_url = CharField(max_length=255, null=True, default=None, verbose_name="头像地址")
+
+    class Meta:
+        table_name = "users"
+
+    def to_dict(self) -> dict:
+        """转换为字典，排除敏感信息"""
+        data = super().to_dict()
+        data.pop("password_hash", None)
+        return data
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/course_service.py b/webapi/fastapi_of_letcoing/services/course_service.py
new file mode 100644
index 0000000..09a983f
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/course_service.py
@@ -0,0 +1,207 @@
+"""
+课程及学习进度服务文件
+"""
+from datetime import datetime
+from typing import List, Optional, Dict, Any
+from peewee import DoesNotExist, IntegrityError
+
+from services.database_service import DatabaseService
+from models.course_models import Course, LearningProgress
+from models.user_models import User
+from core.di_container import Injectable
+from interfaces.course_interfaces import (
+    CourseCreateRequest, CourseUpdateRequest, CourseResponse,
+    LearningProgressCreateRequest, LearningProgressUpdateRequest,
+    LearningProgressResponse
+)
+
+
+class CourseService(DatabaseService, Injectable):
+    """课程服务类"""
+
+    async def create_course(self, course_data: CourseCreateRequest) -> Dict[str, Any]:
+        """创建课程"""
+        try:
+            course_dict = await self.create(
+                Course,
+                title=course_data.title,
+                description=course_data.description,
+                cover_url=course_data.cover_url,
+                is_active=True,
+                created_at=datetime.now(),
+                updated_at=datetime.now()
+            )
+            return self._convert_course_to_response(course_dict)
+        except Exception as e:
+            raise RuntimeError(f"创建课程时发生错误: {e}")
+
+    async def get_course_by_id(self, course_id: int) -> Optional[Dict[str, Any]]:
+        """根据ID获取课程"""
+        course_dict = await self.get_by_id(Course, course_id)
+        return self._convert_course_to_response(course_dict) if course_dict else None
+
+    async def update_course(self, course_id: int, update_data: CourseUpdateRequest) -> Optional[Dict[str, Any]]:
+        """更新课程"""
+        try:
+            if not await self._course_exists(course_id):
+                return None
+
+            update_dict = update_data.dict(exclude_unset=True)
+            update_dict["updated_at"] = datetime.now()
+
+            update_result = await self.update(Course, course_id, **update_dict)
+            if not update_result:
+                return None
+
+            return await self.get_course_by_id(course_id)
+        except Exception as e:
+            raise RuntimeError(f"更新课程时发生错误: {e}")
+
+    async def list_courses(self, limit: int = 50, offset: int = 0, active_only: bool = True) -> List[Dict[str, Any]]:
+        """获取课程列表"""
+        try:
+            query = Course.select()
+            if active_only:
+                query = query.where(Course.is_active == True)
+
+            query = query.order_by(Course.created_at.desc()).limit(limit).offset(offset)
+            return [self._convert_course_to_response(course.to_dict()) for course in query]
+        except Exception as e:
+            raise RuntimeError(f"获取课程列表时发生错误: {e}")
+
+    # 学习进度相关方法
+    async def create_learning_progress(self, user_id: int, progress_data: LearningProgressCreateRequest) -> Dict[
+        str, Any]:
+        """创建用户学习进度"""
+        try:
+            if not await self._user_exists(user_id):
+                raise ValueError("用户不存在")
+            if not await self._course_exists(progress_data.course_id):
+                raise ValueError("课程不存在")
+
+            # 检查是否已存在进度记录
+            if await self._progress_exists(user_id, progress_data.course_id):
+                raise ValueError("已存在该课程的学习进度")
+
+            # 自动设置完成状态
+            completed = progress_data.progress >= 100
+
+            progress_dict = await self.create(
+                LearningProgress,
+                user_id=user_id,
+                course_id=progress_data.course_id,
+                progress=progress_data.progress,
+                completed=completed,
+                last_learned_at=datetime.now(),
+                created_at=datetime.now(),
+                updated_at=datetime.now()
+            )
+            return self._convert_progress_to_response(progress_dict)
+        except IntegrityError as e:
+            raise ValueError(f"创建学习进度失败: {str(e)}")
+        except Exception as e:
+            raise RuntimeError(f"创建学习进度时发生错误: {e}")
+
+    async def update_learning_progress(self, user_id: int, course_id: int,
+                                       update_data: LearningProgressUpdateRequest) -> Optional[Dict[str, Any]]:
+        """更新用户学习进度"""
+        try:
+            progress_id = await self._get_progress_id(user_id, course_id)
+            if not progress_id:
+                return None
+
+            update_dict = update_data.dict(exclude_unset=True)
+            # 进度更新时自动同步完成状态
+            if "progress" in update_dict:
+                update_dict["completed"] = update_dict["progress"] >= 100
+            update_dict["last_learned_at"] = datetime.now()
+            update_dict["updated_at"] = datetime.now()
+
+            update_result = await self.update(LearningProgress, progress_id, **update_dict)
+            if not update_result:
+                return None
+
+            return await self.get_learning_progress(user_id, course_id)
+        except Exception as e:
+            raise RuntimeError(f"更新学习进度时发生错误: {e}")
+
+    async def get_learning_progress(self, user_id: int, course_id: int) -> Optional[Dict[str, Any]]:
+        """获取用户某课程的学习进度"""
+        try:
+            progress = LearningProgress.get(
+                LearningProgress.user_id == user_id,
+                LearningProgress.course_id == course_id
+            )
+            return self._convert_progress_to_response(progress.to_dict())
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取学习进度时发生错误: {e}")
+
+    async def get_user_courses(self, user_id: int) -> List[Dict[str, Any]]:
+        """获取用户已关联的所有课程及进度"""
+        try:
+            if not await self._user_exists(user_id):
+                return []
+
+            query = (LearningProgress.select(LearningProgress, Course)
+                     .join(Course)
+                     .where(LearningProgress.user_id == user_id)
+                     .order_by(LearningProgress.last_learned_at.desc()))
+
+            result = []
+            for progress in query:
+                course_dict = self._convert_course_to_response(progress.course.to_dict())
+                progress_dict = self._convert_progress_to_response(progress.to_dict())
+                result.append({
+                    "course": course_dict,
+                    "progress": progress_dict
+                })
+            return result
+        except Exception as e:
+            raise RuntimeError(f"获取用户课程列表时发生错误: {e}")
+
+    # 辅助方法
+    async def _course_exists(self, course_id: int) -> bool:
+        """检查课程是否存在"""
+        return await self.get_course_by_id(course_id) is not None
+
+    async def _user_exists(self, user_id: int) -> bool:
+        """检查用户是否存在"""
+        from services.user_service import UserService
+        user_service = UserService()
+        return await user_service.get_user_by_id(user_id) is not None
+
+    async def _progress_exists(self, user_id: int, course_id: int) -> bool:
+        """检查学习进度是否已存在"""
+        return LearningProgress.select().where(
+            LearningProgress.user_id == user_id,
+            LearningProgress.course_id == course_id
+        ).exists()
+
+    async def _get_progress_id(self, user_id: int, course_id: int) -> Optional[int]:
+        """获取学习进度ID"""
+        try:
+            progress = LearningProgress.get(
+                LearningProgress.user_id == user_id,
+                LearningProgress.course_id == course_id
+            )
+            return progress.id
+        except DoesNotExist:
+            return None
+
+    def _convert_course_to_response(self, course_dict: Dict[str, Any]) -> Dict[str, Any]:
+        """转换课程数据为响应格式"""
+        if 'created_at' in course_dict and isinstance(course_dict['created_at'], datetime):
+            course_dict['created_at'] = course_dict['created_at'].isoformat()
+        if 'updated_at' in course_dict and isinstance(course_dict['updated_at'], datetime):
+            course_dict['updated_at'] = course_dict['updated_at'].isoformat()
+        return course_dict
+
+    def _convert_progress_to_response(self, progress_dict: Dict[str, Any]) -> Dict[str, Any]:
+        """转换学习进度数据为响应格式"""
+        # 处理日期格式
+        for field in ['last_learned_at', 'created_at', 'updated_at']:
+            if field in progress_dict and isinstance(progress_dict[field], datetime):
+                progress_dict[field] = progress_dict[field].isoformat()
+        return progress_dict
\ No newline at end of file
-- 
Gitee


From 8dd25644c558a8a9a549c32f646b5f265ea083f6 Mon Sep 17 00:00:00 2001
From: Palosting <461007901@qq.com>
Date: Fri, 16 Jan 2026 13:33:48 +0800
Subject: [PATCH 11/22] =?UTF-8?q?=E7=94=A8=E6=88=B7=E7=9B=B8=E5=85=B3?=
 =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=82=A8=E5=AD=98=E5=92=8C=E5=9F=BA=E7=A1=80?=
 =?UTF-8?q?=E6=9C=8D=E5=8A=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapi/fastapi_of_letcoing/main.py            |  12 +-
 .../services/user_service.py                  | 281 ++++++++++++------
 2 files changed, 198 insertions(+), 95 deletions(-)

diff --git a/webapi/fastapi_of_letcoing/main.py b/webapi/fastapi_of_letcoing/main.py
index e2c237f..9b7f821 100644
--- a/webapi/fastapi_of_letcoing/main.py
+++ b/webapi/fastapi_of_letcoing/main.py
@@ -1,11 +1,17 @@
-from flask import Flask
+from flask import Flask, jsonify
 from flask_restx import Api, Resource
 from controllers.code_controller import api as code_api
 from controllers.auth_controller import api as auth_api
+from controllers.course_controller import api as course_api
+from controllers.user_controller import api as user_bp
 import os
+import json
+import atexit
 from core.service_config import setup_services
 from interfaces.service_interfaces import IOIDCService
 from dotenv import load_dotenv
+from core.di_container import get_container
+from core.exceptions import ServiceInitError
 
 # 加载环境变量
 load_dotenv()
@@ -26,6 +32,7 @@ app.config['REDIS_PORT'] = int(os.environ.get('REDIS_PORT', '6379'))
 app.config['REDIS_DB'] = int(os.environ.get('REDIS_DB', '0'))
 app.config['REDIS_PASSWORD'] = os.environ.get('REDIS_PASSWORD')
 app.config['REDIS_TIMEOUT'] = int(os.environ.get('REDIS_TIMEOUT', '5'))
+app.config['REDIS_MAX_CONNECTIONS'] = int(os.environ.get('REDIS_MAX_CONNECTIONS', '10'))
 
 # 数据库配置
 app.config['DB_HOST'] = os.environ.get('DB_HOST', 'localhost')
@@ -35,6 +42,7 @@ app.config['DB_USER'] = os.environ.get('DB_USER', 'postgres')
 app.config['DB_PASSWORD'] = os.environ.get('DB_PASSWORD', '')
 app.config['DB_MAX_CONNECTIONS'] = int(os.environ.get('DB_MAX_CONNECTIONS', '20'))
 app.config['DB_STALE_TIMEOUT'] = int(os.environ.get('DB_STALE_TIMEOUT', '300'))
+app.config['DB_SSL_MODE'] = os.environ.get('DB_SSL_MODE', 'disable')
 
 # GitHub OAuth 配置
 app.config['GITHUB_CLIENT_ID'] = os.environ.get('GITHUB_CLIENT_ID')
@@ -74,6 +82,8 @@ api = Api(
 # 注册命名空间
 api.add_namespace(code_api, path='/code')
 api.add_namespace(auth_api, path='/auth')
+api.add_namespace(user_bp, path='/user')
+api.add_namespace(course_api, path='/courses')
 
 if __name__ == '__main__':
     app.run(debug=True, host='0.0.0.0', port=6173)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/user_service.py b/webapi/fastapi_of_letcoing/services/user_service.py
index 5c742d0..cae21a9 100644
--- a/webapi/fastapi_of_letcoing/services/user_service.py
+++ b/webapi/fastapi_of_letcoing/services/user_service.py
@@ -4,115 +4,179 @@
 """
 from datetime import datetime
 from typing import List, Optional, Dict, Any
-
+from passlib.context import CryptContext
 from peewee import DoesNotExist, IntegrityError
 
 from services.database_service import DatabaseService
 from models.db_models import User
 from core.di_container import Injectable
+from interfaces.user_interfaces import UserCreateRequest, UserUpdateRequest, UserResponse
+from core.db_container import db
+
+# 密码加密器（bcrypt算法）
+pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
 
 
 class UserService(DatabaseService, Injectable):
     """用户服务类"""
-    
-    async def create_user(self, username: str, password_hash: str, email: Optional[str] = None) -> Dict[str, Any]:
+
+    def _hash_password(self, password: str) -> str:
+        """密码加密（工具方法）"""
+        return pwd_context.hash(password)
+
+    def _verify_password(self, plain_password: str, hashed_password: str) -> bool:
+        """密码验证（工具方法）"""
+        return pwd_context.verify(plain_password, hashed_password)
+
+    async def create_user(self, user_data: UserCreateRequest) -> Dict[str, Any]:
         """创建用户"""
         try:
-            user_data = await self.create(
+            # 校验用户名唯一性
+            if await self._username_exists(user_data.username):
+                raise ValueError("用户名已被注册")
+
+            # 校验邮箱唯一性
+            if user_data.email and await self._email_exists(user_data.email):
+                raise ValueError("邮箱已被注册")
+
+            # 创建用户记录
+            user_dict = await self.create(
                 User,
-                username=username,
-                email=email,
-                password_hash=password_hash,
-                is_active=True
+                username=user_data.username,
+                email=user_data.email,
+                password_hash=self._hash_password(user_data.password),
+                avatar_url=user_data.avatar_url,
+                is_active=True,
+                created_at=datetime.now(),
+                updated_at=datetime.now()
             )
-            return user_data
-        except ValueError as e:
-            if "username" in str(e):
-                raise ValueError("用户名已存在")
-            elif "email" in str(e):
-                raise ValueError("邮箱已存在")
-            else:
-                raise ValueError("创建用户失败")
+
+            # 转换为响应格式
+            return self._convert_to_response(user_dict)
+
+        except IntegrityError as e:
+            raise ValueError(f"创建用户失败: {str(e)}")
         except Exception as e:
             raise RuntimeError(f"创建用户时发生错误: {e}")
-    
+
     async def get_user_by_id(self, user_id: int) -> Optional[Dict[str, Any]]:
-        """根据ID获取用户"""
-        return await self.get_by_id(User, user_id)
-    
+        """通过ID查询用户"""
+        user_dict = await self.get_by_id(User, user_id)
+        return self._convert_to_response(user_dict) if user_dict else None
+
     async def get_user_by_username(self, username: str) -> Optional[Dict[str, Any]]:
         """根据用户名获取用户"""
         try:
             user = User.get(User.username == username)
-            return user.to_dict()
+            return self._convert_to_response(user.to_dict())
         except DoesNotExist:
             return None
         except Exception as e:
             raise RuntimeError(f"获取用户时发生错误: {e}")
-    
+
     async def get_user_by_email(self, email: str) -> Optional[Dict[str, Any]]:
         """根据邮箱获取用户"""
         try:
             user = User.get(User.email == email)
-            return user.to_dict()
+            return self._convert_to_response(user.to_dict())
         except DoesNotExist:
             return None
         except Exception as e:
             raise RuntimeError(f"获取用户时发生错误: {e}")
-    
-    async def update_user_last_login(self, user_id: int) -> bool:
-        """更新用户最后登录时间"""
-        return await self.update(User, user_id, last_login=datetime.now())
-    
-    async def update_user_info(self, user_id: int, **kwargs) -> bool:
+
+    async def update_user(self, user_id: int, update_data: UserUpdateRequest) -> Optional[Dict[str, Any]]:
         """更新用户信息"""
-        # 过滤允许更新的字段
-        allowed_fields = {'username', 'email', 'is_active'}
-        update_data = {k: v for k, v in kwargs.items() if k in allowed_fields}
-        
-        if not update_data:
-            return False
-        
-        return await self.update(User, user_id, **update_data)
-    
-    async def deactivate_user(self, user_id: int) -> bool:
-        """停用用户"""
-        return await self.update(User, user_id, is_active=False)
-    
-    async def activate_user(self, user_id: int) -> bool:
-        """激活用户"""
-        return await self.update(User, user_id, is_active=True)
-    
-    async def update_user_password(self, user_id: int, password_hash: str) -> bool:
-        """更新用户密码"""
-        return await self.update(User, user_id, password_hash=password_hash)
-    
+        try:
+            # 检查用户是否存在
+            if not await self._user_exists(user_id):
+                return None
+
+            # 处理更新字段
+            update_dict = update_data.dict(exclude_unset=True)
+
+            # 密码更新需加密
+            if "password" in update_dict:
+                update_dict["password_hash"] = self._hash_password(update_dict.pop("password"))
+
+            # 邮箱唯一性校验
+            if "email" in update_dict:
+                if await self._email_exists(update_dict["email"], exclude_id=user_id):
+                    raise ValueError("邮箱已被注册")
+
+            # 用户名唯一性校验
+            if "username" in update_dict:
+                if await self._username_exists(update_dict["username"], exclude_id=user_id):
+                    raise ValueError("用户名已被注册")
+
+            # 添加更新时间
+            update_dict["updated_at"] = datetime.now()
+
+            # 执行更新
+            update_result = await self.update(User, user_id, **update_dict)
+            if not update_result:
+                return None
+
+            # 返回更新后的用户信息
+            return await self.get_user_by_id(user_id)
+
+        except Exception as e:
+            raise RuntimeError(f"更新用户时发生错误: {e}")
+
+    async def update_user_avatar(self, user_id: int, avatar_url: str) -> Optional[Dict[str, Any]]:
+        """更新用户头像"""
+        try:
+            if not await self._user_exists(user_id):
+                return None
+
+            update_result = await self.update(
+                User,
+                user_id,
+                avatar_url=avatar_url,
+                updated_at=datetime.now()
+            )
+
+            if not update_result:
+                return None
+
+            return await self.get_user_by_id(user_id)
+        except Exception as e:
+            raise RuntimeError(f"更新用户头像时发生错误: {e}")
+
+    async def delete_user(self, user_id: int) -> bool:
+        """删除用户"""
+        return await self.delete(User, user_id)
+
+    async def update_last_login(self, user_id: int) -> bool:
+        """更新最后登录时间"""
+        return await self.update(
+            User,
+            user_id,
+            last_login=datetime.now(),
+            updated_at=datetime.now()
+        )
+
+    async def update_user_status(self, user_id: int, is_active: bool) -> bool:
+        """更新用户状态"""
+        return await self.update(
+            User,
+            user_id,
+            is_active=is_active,
+            updated_at=datetime.now()
+        )
+
     async def list_users(self, limit: int = 50, offset: int = 0, active_only: bool = False) -> List[Dict[str, Any]]:
         """获取用户列表"""
         try:
             query = User.select()
             if active_only:
                 query = query.where(User.is_active == True)
-            
+
             query = query.order_by(User.created_at.desc()).limit(limit).offset(offset)
-            
-            return [user.to_dict() for user in query]
+
+            return [self._convert_to_response(user.to_dict()) for user in query]
         except Exception as e:
             raise RuntimeError(f"获取用户列表时发生错误: {e}")
-    
-    async def search_users(self, keyword: str, limit: int = 20) -> List[Dict[str, Any]]:
-        """搜索用户"""
-        try:
-            search_pattern = f"%{keyword}%"
-            query = (User.select()
-                    .where((User.username.contains(search_pattern)) | 
-                           (User.email.contains(search_pattern)))
-                    .limit(limit))
-            
-            return [user.to_dict() for user in query]
-        except Exception as e:
-            raise RuntimeError(f"搜索用户时发生错误: {e}")
-    
+
     async def count_users(self, active_only: bool = False) -> int:
         """统计用户数量"""
         try:
@@ -122,44 +186,73 @@ class UserService(DatabaseService, Injectable):
             return query.count()
         except Exception as e:
             raise RuntimeError(f"统计用户数量时发生错误: {e}")
-    
+
+    async def authenticate_user(self, username: str, password: str) -> Optional[Dict[str, Any]]:
+        """用户认证"""
+        user = await self.get_user_with_password_hash_by_username(username)
+        if not user or not user.get('is_active', False):
+            return None
+
+        if self._verify_password(password, user['password_hash']):
+            # 移除密码哈希，避免泄露
+            user.pop('password_hash', None)
+            return user
+
+        return None
+
     async def get_user_with_password_hash(self, user_id: int) -> Optional[Dict[str, Any]]:
-        """获取包含密码哈希的用户信息（用于认证）"""
+        """获取包含密码哈希的用户信息（用于认证） """
         try:
             user = User.get_by_id(user_id)
-            # 不排除密码哈希，用于认证
-            user_dict = {
-                'id': user.id,
-                'username': user.username,
-                'email': user.email,
-                'password_hash': user.password_hash,
-                'is_active': user.is_active,
-                'last_login': user.last_login.isoformat() if user.last_login else None,
-                'created_at': user.created_at.isoformat(),
-                'updated_at': user.updated_at.isoformat()
-            }
-            return user_dict
+            return user.to_dict()
         except DoesNotExist:
             return None
         except Exception as e:
             raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
-    
+
     async def get_user_with_password_hash_by_username(self, username: str) -> Optional[Dict[str, Any]]:
         """根据用户名获取包含密码哈希的用户信息"""
         try:
             user = User.get(User.username == username)
-            user_dict = {
-                'id': user.id,
-                'username': user.username,
-                'email': user.email,
-                'password_hash': user.password_hash,
-                'is_active': user.is_active,
-                'last_login': user.last_login.isoformat() if user.last_login else None,
-                'created_at': user.created_at.isoformat(),
-                'updated_at': user.updated_at.isoformat()
-            }
-            return user_dict
+            return user.to_dict()
         except DoesNotExist:
             return None
         except Exception as e:
-            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
\ No newline at end of file
+            raise RuntimeError(f"获取用户认证信息时发生错误: {e}")
+
+    # 辅助方法
+    async def _user_exists(self, user_id: int) -> bool:
+        """检查用户是否存在"""
+        return await self.get_user_by_id(user_id) is not None
+
+    async def _username_exists(self, username: str, exclude_id: Optional[int] = None) -> bool:
+        """检查用户名是否已存在"""
+        query = User.select().where(User.username == username)
+        if exclude_id:
+            query = query.where(User.id != exclude_id)
+        return query.exists()
+
+    async def _email_exists(self, email: str, exclude_id: Optional[int] = None) -> bool:
+        """检查邮箱是否已存在"""
+        query = User.select().where(User.email == email)
+        if exclude_id:
+            query = query.where(User.id != exclude_id)
+        return query.exists()
+
+    def _convert_to_response(self, user_dict: Dict[str, Any]) -> Dict[str, Any]:
+        """转换为响应格式"""
+        # 移除密码哈希，避免泄露
+        user_dict.pop('password_hash', None)
+
+        # 处理日期格式
+        if 'created_at' in user_dict and isinstance(user_dict['created_at'], datetime):
+            user_dict['created_at'] = user_dict['created_at'].isoformat()
+        if 'updated_at' in user_dict and isinstance(user_dict['updated_at'], datetime):
+            user_dict['updated_at'] = user_dict['updated_at'].isoformat()
+        if 'last_login' in user_dict:
+            if isinstance(user_dict['last_login'], datetime):
+                user_dict['last_login'] = user_dict['last_login'].isoformat()
+            else:
+                user_dict['last_login'] = None
+
+        return user_dict
\ No newline at end of file
-- 
Gitee


From bc9929d9089554765cbfbf71d2c68defcc88731b Mon Sep 17 00:00:00 2001
From: zs <18031751980@163.com>
Date: Thu, 29 Jan 2026 20:00:09 +0800
Subject: [PATCH 12/22] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=BC=82=E6=AD=A5?=
 =?UTF-8?q?=E5=A4=84=E7=90=86=E8=AE=A4=E8=AF=81=E5=9B=9E=E8=B0=83=E7=9A=84?=
 =?UTF-8?q?=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controllers/auth_controller.py                   |  4 ++--
 webapi/fastapi_of_letcoing/main.py                   | 11 +++++------
 webapi/fastapi_of_letcoing/simple_test.py            | 12 ++++++++++++
 3 files changed, 19 insertions(+), 8 deletions(-)
 create mode 100644 webapi/fastapi_of_letcoing/simple_test.py

diff --git a/webapi/fastapi_of_letcoing/controllers/auth_controller.py b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
index c75d5d8..8b085fe 100644
--- a/webapi/fastapi_of_letcoing/controllers/auth_controller.py
+++ b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
@@ -87,7 +87,7 @@ class AuthCallbackController(Resource):
     @api.doc('auth_callback')
     @api.response(200, 'Success', auth_result_model)
     @api.response(400, 'Bad Request')
-    def get(self, provider: str):
+    async def get(self, provider: str):
         """处理认证回调，实现注册和登录集成"""
         # 注入服务
         oidc_service = inject(IOIDCService)
@@ -133,7 +133,7 @@ class AuthCallbackController(Resource):
         
         # 查找或创建用户（支持注册和登录集成）
         try:
-            user_data = user_service.find_or_create_user(
+            user_data = await user_service.find_or_create_user(
                 provider=provider,
                 provider_id=provider_id,
                 user_info=user_info_data
diff --git a/webapi/fastapi_of_letcoing/main.py b/webapi/fastapi_of_letcoing/main.py
index e2c237f..b0c3eb1 100644
--- a/webapi/fastapi_of_letcoing/main.py
+++ b/webapi/fastapi_of_letcoing/main.py
@@ -55,12 +55,11 @@ else:
 setup_services(app.config)
 
 # 初始化 OIDC 服务
-oidc_service = setup_services.__globals__.get('oidc_service')
-if not oidc_service:
-    from core.di_container import get_container, inject
-    container = get_container()
-    oidc_service = container.resolve(IOIDCService)
-    oidc_service.initialize_oauth(app)
+from core.di_container import get_container
+container = get_container()
+oidc_service = container.resolve(IOIDCService)
+oidc_service.initialize_oauth(app)
+print("OIDC 服务初始化成功")
 
 # 创建 API 实例
 api = Api(
diff --git a/webapi/fastapi_of_letcoing/simple_test.py b/webapi/fastapi_of_letcoing/simple_test.py
new file mode 100644
index 0000000..90eec64
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/simple_test.py
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+print("Starting simple test...")
+
+# 测试基本导入
+try:
+    print("Importing Flask...")
+    from flask import Flask
+    print("Flask imported successfully!")
+except Exception as e:
+    print(f"Error importing Flask: {e}")
+
+print("Test completed!")
-- 
Gitee


From 6413e0517ff2a16bb94e44b5169f316ac70c7574 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?LuckyFish=E5=A5=BD=E7=89=9B=E7=9A=84?= <2383690354@qq.com>
Date: Mon, 2 Feb 2026 16:11:57 +0000
Subject: [PATCH 13/22] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20.e?=
 =?UTF-8?q?nv?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .env | 25 -------------------------
 1 file changed, 25 deletions(-)
 delete mode 100644 .env

diff --git a/.env b/.env
deleted file mode 100644
index 365c4a3..0000000
--- a/.env
+++ /dev/null
@@ -1,25 +0,0 @@
-API_TOKEN=993cb7df-6ff5-40c3-9a9c-773921e3a12d
-JWT_SECRET_KEY=MjM3NTg1NDM4ODQ0MTYxMTE3MzUxODIzMTA0ODY2NjQ=
-
-REDIS_HOST=hkg1.clusters.zeabur.com
-REDIS_PORT=30123
-REDIS_DB=0
-REDIS_PASSWORD=2g8o1A45x9n3hsE0m7yrfL6VkbqJXaBW
-
-GITHUB_CLIENT_ID=Ov23liSEPDKQ0r51vqBC
-GITHUB_CLIENT_SECRET=0ce1c2a2a19cb4562fb1b57e64de3c93877d656e
-
-OIDC_PROVIDERS=[
-  {
-    "name": "iOSClub",
-    "issuer": "https://api.xauat.site",
-    "client_id": "ca_0200be03d08f4f58",
-    "client_secret": "$2b$10$AnmhmDe4lO27E.XQwHyWcOVOPiy/tBTymd4zMXt9i6l73vHlxkW1q"
-  }
-]
-
-DB_HOST=hkg1.clusters.zeabur.com
-DB_PORT=32627
-DB_NAME=lettest
-DB_USER=root
-DB_PASSWORD=60zquVE1c7TLInwOivZg9H543Kr2GM8p
\ No newline at end of file
-- 
Gitee


From 83a599f7c40261271200fbce7c01fff5406d175e Mon Sep 17 00:00:00 2001
From: LuckyFish at macOS <2383690354@qq.com>
Date: Wed, 11 Mar 2026 20:23:07 +0800
Subject: [PATCH 14/22] refactor: update MainLayout and Learn components for
 improved UI and functionality

- Removed the home link from the desktop menu in MainLayout.vue.
- Updated the login/register button style in MainLayout.vue.
- Refactored Learn.vue to enhance the course listing layout and search functionality.
- Introduced a new course data structure and improved the filtering mechanism based on search keywords.
- Enhanced error handling for image loading in Learn.vue.
- Updated Playground.vue to include language selection and improved UI elements for a better user experience.
- Added functionality to save and reset code in Playground.vue with user feedback messages.
- Cleaned up unused CSS rules in style.css for better maintainability.
---
 webapp/letapp/src/layouts/MainLayout.vue |   9 +-
 webapp/letapp/src/pages/Learn.vue        | 432 ++++++++---------------
 webapp/letapp/src/pages/Playground.vue   | 308 ++++++++++------
 webapp/letapp/src/style.css              |   4 -
 4 files changed, 336 insertions(+), 417 deletions(-)

diff --git a/webapp/letapp/src/layouts/MainLayout.vue b/webapp/letapp/src/layouts/MainLayout.vue
index 30cb98f..268de14 100644
--- a/webapp/letapp/src/layouts/MainLayout.vue
+++ b/webapp/letapp/src/layouts/MainLayout.vue
@@ -22,13 +22,6 @@
 
             <!-- Desktop Menu -->
             <nav class="hidden md:flex items-center space-x-6">
-              <!-- 导航链接 -->
-              <router-link 
-                to="/" 
-                class="text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 transition-colors"
-              >
-                首页
-              </router-link>
               <router-link 
                 to="/playground" 
                 class="text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-blue-600 dark:hover:text-blue-400 transition-colors"
@@ -130,7 +123,7 @@
                   <div class="pt-1.5 border-t border-gray-200 dark:border-gray-800">
                     <router-link
                         to="/login"
-                        class="block w-full px-4 py-2.5 bg-blue-500 text-white text-base font-medium rounded-lg hover:bg-blue-600 transition-colors"
+                        class="block w-full px-4 py-2.5 bg-blue-500 text-white! text-base font-medium rounded-lg hover:bg-blue-600 transition-colors"
                         @click="drawerVisible = false"
                     >
                       登录/注册
diff --git a/webapp/letapp/src/pages/Learn.vue b/webapp/letapp/src/pages/Learn.vue
index b2c9ee0..038eb3e 100644
--- a/webapp/letapp/src/pages/Learn.vue
+++ b/webapp/letapp/src/pages/Learn.vue
@@ -1,309 +1,163 @@
-<script setup lang="ts">
-import { ref } from 'vue';
-import { Icon } from '@iconify/vue';
-import { useRouter } from 'vue-router';
+<template>
+  <div class="min-h-screen bg-slate-50 text-slate-900 transition-colors dark:bg-slate-950 dark:text-slate-100">
+    <div class="mx-auto w-full max-w-7xl px-4 py-8 sm:px-6 lg:px-8 lg:py-12">
+      <header class="mb-8 flex flex-col gap-6 lg:mb-12 lg:flex-row lg:items-start lg:justify-between">
+        <div class="flex-1">
+          <h1 class="mb-3 text-2xl font-semibold tracking-tight sm:text-3xl">课程列表</h1>
+          <p class="max-w-xl text-sm text-slate-600 sm:text-base dark:text-slate-400">
+            浏览我们精心策划的课程，开始您的学习之旅
+          </p>
+        </div>
+
+        <div class="w-full lg:w-auto">
+          <n-input
+            v-model:value="keyword"
+            class="course-search w-full sm:min-w-[300px] lg:min-w-[360px]"
+            round
+            clearable
+            placeholder="搜索课程..."
+          >
+            <template #prefix>
+              <Icon icon="mdi:magnify" class="text-[18px] text-slate-500 dark:text-slate-400" />
+            </template>
+          </n-input>
+        </div>
+      </header>
+
+      <section class="grid grid-cols-1 gap-5 sm:grid-cols-2 lg:grid-cols-3">
+        <article
+          v-for="course in filteredCourses"
+          :key="course.id"
+          class="group overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all duration-300 hover:-translate-y-1.5 hover:shadow-[0_20px_45px_-15px_rgba(16,24,40,0.22)] dark:border-slate-800 dark:bg-slate-900 dark:hover:shadow-[0_20px_45px_-18px_rgba(96,165,250,0.38)]"
+        >
+          <div class="relative h-44 overflow-hidden">
+            <img
+              :src="course.imageUrl"
+              :alt="course.name"
+              class="h-full w-full object-cover transition-transform duration-500 group-hover:scale-105"
+              loading="lazy"
+              @error="onImageError"
+            />
+          </div>
+
+          <div class="space-y-2 p-4">
+            <h2 class="course-title-clamp text-base font-medium leading-6">{{ course.name }}</h2>
+            <div class="flex items-center gap-2 text-sm text-slate-600 dark:text-slate-400">
+              <Icon icon="mdi:book-open-page-variant-outline" class="text-[18px]" />
+              <span>题目数：{{ course.questionCount }}</span>
+            </div>
+          </div>
+        </article>
+      </section>
+
+      <div
+        v-if="filteredCourses.length === 0"
+        class="rounded-2xl border border-dashed border-slate-300 py-14 text-center dark:border-slate-700"
+      >
+        <p class="text-slate-600 dark:text-slate-400">未找到相关课程，请尝试其他关键词。</p>
+      </div>
+    </div>
+  </div>
+</template>
 
-const router = useRouter();
+<script setup lang="ts">
+import { computed, ref } from "vue";
+import { NInput } from "naive-ui";
+import { Icon } from "@iconify/vue";
 
-// 学习资源分类
-const categories = [
-  { id: 'beginner', name: '入门教程', icon: 'material-symbols:school', color: '#4CAF50' },
-  { id: 'advanced', name: '进阶学习', icon: 'material-symbols:rocket-launch', color: '#2196F3' },
-  { id: 'project', name: '实战项目', icon: 'material-symbols:build', color: '#FF9800' },
-  { id: 'algorithm', name: '算法练习', icon: 'material-symbols:calculate', color: '#9C27B0' },
-];
+type Course = {
+  id: number;
+  name: string;
+  questionCount: number;
+  imageUrl: string;
+};
 
-// 热门教程
-const popularCourses = [
-  { 
-    id: 1, 
-    title: 'JavaScript 入门指南', 
-    description: '从零开始学习 JavaScript 编程语言，掌握基本语法和核心概念。', 
-    category: 'beginner', 
-    level: '入门', 
-    duration: '12 小时', 
-    author: 'Let Coding',
-    language: 'JavaScript'
+const courses = ref<Course[]>([
+  {
+    id: 1,
+    name: "前端开发基础",
+    questionCount: 120,
+    imageUrl:
+      "https://images.unsplash.com/photo-1565229284535-2cbbe3049123?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
   },
-  { 
-    id: 2, 
-    title: 'Python 数据分析实战', 
-    description: '学习使用 Python 进行数据分析和可视化，掌握 pandas、numpy 和 matplotlib 等库。', 
-    category: 'advanced', 
-    level: '进阶', 
-    duration: '15 小时', 
-    author: 'Let Coding',
-    language: 'Python'
+  {
+    id: 2,
+    name: "高等数学进阶",
+    questionCount: 85,
+    imageUrl:
+      "https://images.unsplash.com/photo-1758685848342-b5c350727ff5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
   },
-  { 
-    id: 3, 
-    title: 'Web 开发实战：Todo 应用', 
-    description: '使用 HTML、CSS 和 JavaScript 构建一个完整的 Todo 应用，学习前后端开发。', 
-    category: 'project', 
-    level: '入门', 
-    duration: '8 小时', 
-    author: 'Let Coding',
-    language: 'JavaScript'
+  {
+    id: 3,
+    name: "UI/UX 设计原理",
+    questionCount: 95,
+    imageUrl:
+      "https://images.unsplash.com/photo-1664520132859-727fc515fc8d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
   },
-  { 
-    id: 4, 
-    title: '算法基础：排序与搜索', 
-    description: '学习常见的排序和搜索算法，掌握算法分析和优化方法。', 
-    category: 'algorithm', 
-    level: '入门', 
-    duration: '10 小时', 
-    author: 'Let Coding',
-    language: 'Python'
+  {
+    id: 4,
+    name: "商务英语实战",
+    questionCount: 150,
+    imageUrl:
+      "https://images.unsplash.com/photo-1631888717179-7e213fc93e1d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
   },
-];
-
-// 当前选中的分类
-const selectedCategory = ref('all');
+  {
+    id: 5,
+    name: "在线学习方法论",
+    questionCount: 68,
+    imageUrl:
+      "https://images.unsplash.com/photo-1762330910399-95caa55acf04?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
+  },
+  {
+    id: 6,
+    name: "商业分析与决策",
+    questionCount: 110,
+    imageUrl:
+      "https://images.unsplash.com/photo-1709715357520-5e1047a2b691?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
+  }
+]);
 
-// 过滤后的教程
-const filteredCourses = ref([...popularCourses]);
+const keyword = ref("");
 
-// 按分类过滤教程
-const filterByCategory = (categoryId: string) => {
-  selectedCategory.value = categoryId;
-  if (categoryId === 'all') {
-    filteredCourses.value = [...popularCourses];
-  } else {
-    filteredCourses.value = popularCourses.filter(course => course.category === categoryId);
-  }
-};
+const filteredCourses = computed(() => {
+  const value = keyword.value.trim().toLowerCase();
+  if (!value) return courses.value;
+  return courses.value.filter((course) => course.name.toLowerCase().includes(value));
+});
 
-// 开始学习
-const startLearning = (courseId: number) => {
-  // 这里需要跳转到具体的课程页面
-  console.log('开始学习课程:', courseId);
-  // 暂时使用 alert
-  alert(`开始学习课程 ${courseId}，功能开发中...`);
+const onImageError = (event: Event) => {
+  const target = event.target as HTMLImageElement;
+  target.src =
+    "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 320 180'><rect width='320' height='180' fill='%23f1f5f9'/><text x='50%25' y='50%25' dominant-baseline='middle' text-anchor='middle' fill='%2364748b' font-size='14'>image unavailable</text></svg>";
 };
 </script>
 
-<template>
-  <div class="min-h-screen bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
-    <!-- 页面标题栏 -->
-    <div class="bg-white dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 sticky top-16 z-40">
-      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4 flex flex-wrap items-center justify-between gap-4">
-        <div class="flex items-center gap-4">
-          <button 
-            class="p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors" 
-            @click="router.back()"
-          >
-            <Icon icon="material-symbols:arrow-back" class="w-5 h-5" />
-          </button>
-          <h1 class="text-2xl font-bold">学习资源</h1>
-        </div>
-      </div>
-    </div>
-    
-    <!-- 学习资源主体 -->
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
-      <!-- 分类筛选 -->
-      <div class="mb-8">
-        <div class="flex flex-wrap items-center gap-3">
-          <button 
-            class="flex items-center gap-2 px-4 py-2 rounded-lg transition-colors" 
-            :class="selectedCategory === 'all' ? 'bg-blue-600 text-white' : 'bg-gray-100 dark:bg-gray-700 text-gray-700 dark:text-gray-300 hover:bg-gray-200 dark:hover:bg-gray-600'"
-            @click="filterByCategory('all')"
-          >
-            <Icon icon="material-symbols:category" class="w-4 h-4" />
-            全部
-          </button>
-          
-          <button 
-            v-for="category in categories" 
-            :key="category.id"
-            class="flex items-center gap-2 px-4 py-2 rounded-lg transition-colors" 
-            :class="selectedCategory === category.id ? 'bg-blue-600 text-white' : 'bg-gray-100 dark:bg-gray-700 text-gray-700 dark:text-gray-300 hover:bg-gray-200 dark:hover:bg-gray-600'"
-            @click="filterByCategory(category.id)"
-          >
-            <Icon :icon="category.icon" class="w-4 h-4" :style="{ color: selectedCategory === category.id ? 'white' : category.color }" />
-            {{ category.name }}
-          </button>
-        </div>
-      </div>
-      
-      <!-- 热门教程 -->
-      <div class="mb-12">
-        <h2 class="text-2xl font-bold mb-6">热门教程</h2>
-        
-        <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
-          <div 
-            v-for="course in filteredCourses" 
-            :key="course.id"
-            class="bg-white dark:bg-gray-800 rounded-xl shadow-lg hover:shadow-xl transition-shadow border border-gray-200 dark:border-gray-700 overflow-hidden hover:translate-y-[-4px] transition-transform"
-          >
-            <div class="p-6 space-y-3">
-              <div class="flex items-center gap-2 mb-2">
-                <span class="px-3 py-1 text-xs font-medium rounded-full bg-blue-100 dark:bg-blue-900 text-blue-700 dark:text-blue-300">
-                  {{ course.language }}
-                </span>
-                <span class="px-3 py-1 text-xs font-medium rounded-full bg-gray-100 dark:bg-gray-700 text-gray-700 dark:text-gray-300">
-                  {{ course.level }}
-                </span>
-              </div>
-              
-              <h3 class="text-xl font-semibold line-clamp-2">{{ course.title }}</h3>
-              <p class="text-gray-600 dark:text-gray-300 text-sm line-clamp-3">{{ course.description }}</p>
-              
-              <div class="flex items-center gap-4 text-sm text-gray-500 dark:text-gray-400 mt-2">
-                <div class="flex items-center gap-1">
-                  <Icon icon="material-symbols:person" class="w-4 h-4" />
-                  {{ course.author }}
-                </div>
-                <div class="flex items-center gap-1">
-                  <Icon icon="material-symbols:schedule" class="w-4 h-4" />
-                  {{ course.duration }}
-                </div>
-              </div>
-              
-              <button 
-                class="w-full mt-4 px-4 py-2 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors"
-                @click="startLearning(course.id)"
-              >
-                开始学习
-              </button>
-            </div>
-          </div>
-        </div>
-      </div>
-      
-      <!-- 学习路径 -->
-      <div>
-        <h2 class="text-2xl font-bold mb-6">学习路径</h2>
-        
-        <div class="grid grid-cols-1 md:grid-cols-3 gap-6">
-          <div class="bg-gradient-to-br from-blue-50 to-indigo-50 dark:from-gray-800 dark:to-gray-900 rounded-xl p-6 shadow-lg border border-gray-200 dark:border-gray-700">
-            <div class="flex items-center gap-3 mb-4">
-              <div class="w-12 h-12 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center">
-                <Icon icon="material-symbols:school" class="w-6 h-6 text-blue-600 dark:text-blue-400" />
-              </div>
-              <h3 class="text-xl font-semibold">Web 开发路径</h3>
-            </div>
-            <p class="text-gray-600 dark:text-gray-300 mb-4">
-              学习 Web 开发的完整路径，从 HTML、CSS 和 JavaScript 基础开始，到前端框架和后端开发。
-            </p>
-            <ul class="space-y-2 mb-6">
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                HTML & CSS 基础
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                JavaScript 核心
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                前端框架（Vue/React）
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                后端开发（Node.js/Python）
-              </li>
-            </ul>
-            <button 
-              class="w-full px-4 py-2 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors"
-            >
-              查看完整路径
-            </button>
-          </div>
-          
-          <div class="bg-gradient-to-br from-green-50 to-teal-50 dark:from-gray-800 dark:to-gray-900 rounded-xl p-6 shadow-lg border border-gray-200 dark:border-gray-700">
-            <div class="flex items-center gap-3 mb-4">
-              <div class="w-12 h-12 bg-green-100 dark:bg-green-900 rounded-full flex items-center justify-center">
-                <Icon icon="material-symbols:code" class="w-6 h-6 text-green-600 dark:text-green-400" />
-              </div>
-              <h3 class="text-xl font-semibold">数据科学路径</h3>
-            </div>
-            <p class="text-gray-600 dark:text-gray-300 mb-4">
-              学习数据科学和机器学习的完整路径，从 Python 基础开始，到数据分析、可视化和机器学习算法。
-            </p>
-            <ul class="space-y-2 mb-6">
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                Python 编程基础
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                数据分析库（pandas）
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                数据可视化（matplotlib）
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                机器学习算法
-              </li>
-            </ul>
-            <button 
-              class="w-full px-4 py-2 bg-green-600 text-white font-medium rounded-lg hover:bg-green-700 transition-colors"
-            >
-              查看完整路径
-            </button>
-          </div>
-          
-          <div class="bg-gradient-to-br from-orange-50 to-amber-50 dark:from-gray-800 dark:to-gray-900 rounded-xl p-6 shadow-lg border border-gray-200 dark:border-gray-700">
-            <div class="flex items-center gap-3 mb-4">
-              <div class="w-12 h-12 bg-orange-100 dark:bg-orange-900 rounded-full flex items-center justify-center">
-                <Icon icon="material-symbols:calculate" class="w-6 h-6 text-orange-600 dark:text-orange-400" />
-              </div>
-              <h3 class="text-xl font-semibold">算法与编程路径</h3>
-            </div>
-            <p class="text-gray-600 dark:text-gray-300 mb-4">
-              学习算法和编程基础的完整路径，从数据结构开始，到算法设计和优化方法。
-            </p>
-            <ul class="space-y-2 mb-6">
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                数据结构基础
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                排序与搜索算法
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                动态规划
-              </li>
-              <li class="flex items-center gap-2 text-sm">
-                <Icon icon="material-symbols:check-circle" class="w-4 h-4 text-green-500" />
-                算法优化
-              </li>
-            </ul>
-            <button 
-              class="w-full px-4 py-2 bg-orange-600 text-white font-medium rounded-lg hover:bg-orange-700 transition-colors"
-            >
-              查看完整路径
-            </button>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
 <style scoped>
-/* 自定义滚动条样式 */
-::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
-}
-
-::-webkit-scrollbar-track {
-  background: #f1f1f1;
-  dark:bg-gray-800;
+.course-title-clamp {
+  display: -webkit-box;
+  overflow: hidden;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
 }
 
-::-webkit-scrollbar-thumb {
-  background: #888;
-  border-radius: 3px;
+:deep(.course-search.n-input) {
+  --n-color: rgb(255 255 255);
+  --n-color-focus: rgb(255 255 255);
+  --n-color-disabled: rgb(255 255 255);
+  --n-border: 1px solid rgb(226 232 240);
+  --n-border-hover: 1px solid rgb(148 163 184);
+  --n-border-focus: 1px solid rgb(59 130 246);
+  --n-border-radius: 9999px;
+  --n-placeholder-color: rgb(100 116 139);
 }
 
-::-webkit-scrollbar-thumb:hover {
-  background: #555;
+:global(.dark) :deep(.course-search.n-input) {
+  --n-color: rgb(15 23 42);
+  --n-color-focus: rgb(15 23 42);
+  --n-color-disabled: rgb(15 23 42);
+  --n-border: 1px solid rgb(51 65 85);
+  --n-border-hover: 1px solid rgb(100 116 139);
+  --n-border-focus: 1px solid rgb(96 165 250);
+  --n-placeholder-color: rgb(148 163 184);
 }
 </style>
\ No newline at end of file
diff --git a/webapp/letapp/src/pages/Playground.vue b/webapp/letapp/src/pages/Playground.vue
index 57223bf..d12a417 100644
--- a/webapp/letapp/src/pages/Playground.vue
+++ b/webapp/letapp/src/pages/Playground.vue
@@ -1,12 +1,21 @@
 <script setup lang="ts">
-import { ref, computed } from 'vue';
+import { ref, computed, onMounted, onUnmounted } from 'vue';
 import { Icon } from '@iconify/vue';
 import { useRouter } from 'vue-router';
+import { useMessage } from 'naive-ui';
 
 const router = useRouter();
+const message = useMessage();
+
+interface Language {
+  name: string;
+  value: string;
+  icon: string;
+  color: string;
+}
 
 // 支持的编程语言
-const languages = [
+const languages: Language[] = [
   { name: 'JavaScript', value: 'javascript', icon: 'vscode-icons:file-type-js-official', color: '#F7DF1E' },
   { name: 'Python', value: 'python', icon: 'vscode-icons:file-type-python', color: '#3776AB' },
   { name: 'Java', value: 'java', icon: 'vscode-icons:file-type-java', color: '#ED8B00' },
@@ -16,40 +25,48 @@ const languages = [
 ];
 
 // 当前选择的语言
-const selectedLanguage = ref('javascript');
+const selectedLanguage = ref<string>('javascript');
+const showLanguageMenu = ref<boolean>(false);
 
 // 代码编辑器内容
-const code = ref(`function greet(name) {
-  return \`Hello, ${name}!\`;
+const code = ref<string>(`function greet(name) {
+  return \`Hello, \${name}!\`;
 }
 
 const message = greet('Let Coding');
 console.log(message);`);
 
 // 标准输入
-const stdin = ref('');
+const stdin = ref<string>('');
 
 // 执行结果
-const stdout = ref('');
-const stderr = ref('');
-const isExecuting = ref(false);
+const stdout = ref<string>('');
+const stderr = ref<string>('');
+const isExecuting = ref<boolean>(false);
 
 // 计算属性：获取当前语言的图标和名称
 const currentLanguageInfo = computed(() => {
   return languages.find(lang => lang.value === selectedLanguage.value) || languages[0];
 });
 
+// 选择语言
+const selectLanguage = (lang: Language) => {
+  selectedLanguage.value = lang.value;
+  showLanguageMenu.value = false;
+  message.info(`已切换到 ${lang.name}`);
+};
+
 // 运行代码
 const runCode = async () => {
   isExecuting.value = true;
   stdout.value = '';
   stderr.value = '';
-  
+
   try {
     // 这里需要调用后端 API 来执行代码
     // 暂时使用模拟数据
     await new Promise(resolve => setTimeout(resolve, 1000));
-    
+
     if (selectedLanguage.value === 'javascript') {
       stdout.value = 'Hello, Let Coding!\n';
     } else if (selectedLanguage.value === 'python') {
@@ -57,8 +74,10 @@ const runCode = async () => {
     } else {
       stdout.value = `Hello, Let Coding! (${selectedLanguage.value})\n`;
     }
+    message.success('代码执行成功');
   } catch (error) {
     stderr.value = `执行错误: ${error instanceof Error ? error.message : '未知错误'}\n`;
+    message.error('代码执行失败');
   } finally {
     isExecuting.value = false;
   }
@@ -68,8 +87,7 @@ const runCode = async () => {
 const saveCode = () => {
   // 这里需要调用后端 API 来保存代码
   console.log('保存代码:', code.value);
-  // 暂时使用 alert
-  alert('代码保存功能开发中...');
+  message.info('代码保存功能开发中...');
 };
 
 // 重置代码
@@ -78,142 +96,185 @@ const resetCode = () => {
   stdin.value = '';
   stdout.value = '';
   stderr.value = '';
+  message.info('已重置所有内容');
 };
+
+// 点击外部关闭语言菜单
+const handleClickOutside = (event: MouseEvent) => {
+  const target = event.target as HTMLElement;
+  if (!target.closest('.language-menu-container')) {
+    showLanguageMenu.value = false;
+  }
+};
+
+onMounted(() => {
+  document.addEventListener('click', handleClickOutside);
+});
+
+onUnmounted(() => {
+  document.removeEventListener('click', handleClickOutside);
+});
 </script>
 
 <template>
-  <div class="min-h-screen bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
-    <!-- 页面标题栏 -->
-    <div class="bg-white dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 sticky top-16 z-40">
-      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4 flex flex-wrap items-center justify-between gap-4">
-        <div class="flex items-center gap-4">
-          <button 
-            class="p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors" 
-            @click="router.back()"
-          >
-            <Icon icon="material-symbols:arrow-back" class="w-5 h-5" />
-          </button>
-          <h1 class="text-2xl font-bold">在线代码编辑器</h1>
-        </div>
-        
-        <div class="flex items-center gap-3 flex-wrap">
-          <!-- 语言选择 -->
-          <div class="relative">
-            <button 
-              class="flex items-center gap-2 px-4 py-2 bg-gray-100 dark:bg-gray-700 rounded-lg hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors border border-gray-200 dark:border-gray-600"
-              :title="currentLanguageInfo?.name || ''"
-            >
-              <Icon :icon="currentLanguageInfo?.icon || ''" class="w-4 h-4" :style="{ color: currentLanguageInfo?.color || '#6B7280' }" />
-              <span class="hidden sm:inline">{{ currentLanguageInfo?.name || '' }}</span>
-              <Icon icon="material-symbols:arrow-drop-down" class="w-4 h-4" />
+  <div class="min-h-screen bg-slate-50 text-slate-900 transition-colors duration-300 dark:bg-slate-950 dark:text-slate-100">
+    <!-- 页面标题栏 - Apple 风格 -->
+    <div class="fixed left-0 right-0 top-16 z-40 border-b border-slate-200/80 bg-white/80 backdrop-blur-xl transition-colors dark:border-slate-800/80 dark:bg-slate-900/80">
+      <div class="mx-auto max-w-7xl px-4 py-4 sm:px-6 lg:px-8">
+        <div class="flex flex-wrap items-center justify-between gap-4">
+          <div class="flex items-center gap-3">
+            <h1 class="text-xl font-semibold tracking-tight sm:text-2xl">代码编辑器</h1>
+          </div>
+
+          <div class="flex items-center gap-2 flex-wrap">
+            <!-- 语言选择 -->
+            <div class="relative language-menu-container">
+              <button
+                class="flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm font-medium transition-all duration-200 hover:border-slate-300 hover:shadow-sm active:scale-95 dark:border-slate-700 dark:bg-slate-900 dark:hover:border-slate-600"
+                @click="showLanguageMenu = !showLanguageMenu"
+                :title="currentLanguageInfo.name"
+              >
+                <Icon :icon="currentLanguageInfo.icon" class="h-4 w-4" :style="{ color: currentLanguageInfo.color }" />
+                <span class="hidden sm:inline">{{ currentLanguageInfo.name }}</span>
+                <Icon icon="solar:alt-arrow-down-linear" class="h-4 w-4 transition-transform" :class="{ 'rotate-180': showLanguageMenu }" />
+              </button>
+
+              <!-- 语言下拉菜单 -->
+              <Transition
+                enter-active-class="transition duration-200 ease-out"
+                enter-from-class="opacity-0 scale-95"
+                enter-to-class="opacity-100 scale-100"
+                leave-active-class="transition duration-150 ease-in"
+                leave-from-class="opacity-100 scale-100"
+                leave-to-class="opacity-0 scale-95"
+              >
+                <div
+                  v-if="showLanguageMenu"
+                  class="absolute right-0 top-full z-50 mt-2 w-48 origin-top-right overflow-hidden rounded-xl border border-slate-200 bg-white shadow-xl dark:border-slate-700 dark:bg-slate-900"
+                >
+                  <button
+                    v-for="lang in languages"
+                    :key="lang.value"
+                    class="flex w-full items-center gap-3 px-4 py-2.5 text-left text-sm transition-colors hover:bg-slate-50 dark:hover:bg-slate-800"
+                    :class="{ 'bg-slate-50 dark:bg-slate-800': selectedLanguage === lang.value }"
+                    @click="selectLanguage(lang)"
+                  >
+                    <Icon :icon="lang.icon" class="h-5 w-5" :style="{ color: lang.color }" />
+                    <span>{{ lang.name }}</span>
+                    <Icon v-if="selectedLanguage === lang.value" icon="solar:check-circle-bold" class="ml-auto h-4 w-4 text-blue-500" />
+                  </button>
+                </div>
+              </Transition>
+            </div>
+
+            <!-- 保存按钮 -->
+            <button
+              class="flex items-center gap-2 rounded-xl border border-emerald-200 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-700 transition-all duration-200 hover:border-emerald-300 hover:bg-emerald-100 active:scale-95 dark:border-emerald-900 dark:bg-emerald-950 dark:text-emerald-400 dark:hover:border-emerald-800 dark:hover:bg-emerald-900"
+              @click="saveCode"
+            >
+              <Icon icon="solar:diskette-linear" class="h-4 w-4" />
+              <span class="hidden sm:inline">保存</span>
+            </button>
+
+            <!-- 重置按钮 -->
+            <button
+              class="flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm font-medium transition-all duration-200 hover:border-slate-300 hover:shadow-sm active:scale-95 dark:border-slate-700 dark:bg-slate-900 dark:hover:border-slate-600"
+              @click="resetCode"
+            >
+              <Icon icon="solar:refresh-linear" class="h-4 w-4" />
+              <span class="hidden sm:inline">重置</span>
+            </button>
+
+            <!-- 运行按钮 -->
+            <button
+              class="flex items-center gap-2 rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition-all duration-200 hover:bg-blue-700 hover:shadow-md active:scale-95 disabled:cursor-not-allowed disabled:opacity-60"
+              @click="runCode"
+              :disabled="isExecuting"
+            >
+              <Icon
+                :icon="isExecuting ? 'solar:hourglass-line-linear' : 'solar:play-linear'"
+                class="h-4 w-4"
+                :class="{ 'animate-spin': isExecuting }"
+              />
+              <span>{{ isExecuting ? '执行中' : '运行' }}</span>
             </button>
           </div>
-          
-          <!-- 保存按钮 -->
-          <button 
-            class="flex items-center gap-2 px-4 py-2 bg-green-100 dark:bg-green-900 text-green-700 dark:text-green-300 rounded-lg hover:bg-green-200 dark:hover:bg-green-800 transition-colors"
-            @click="saveCode"
-          >
-            <Icon icon="material-symbols:save" class="w-4 h-4" />
-            <span class="hidden sm:inline">保存</span>
-          </button>
-          
-          <!-- 重置按钮 -->
-          <button 
-            class="flex items-center gap-2 px-4 py-2 bg-gray-100 dark:bg-gray-700 text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors"
-            @click="resetCode"
-          >
-            <Icon icon="material-symbols:refresh" class="w-4 h-4" />
-            <span class="hidden sm:inline">重置</span>
-          </button>
-          
-          <!-- 运行按钮 -->
-          <button 
-            class="flex items-center gap-2 px-4 py-2 bg-blue-600 text-white font-medium rounded-lg hover:bg-blue-700 transition-colors shadow-md"
-            @click="runCode"
-            :disabled="isExecuting"
-          >
-            <Icon 
-              :icon="isExecuting ? 'material-symbols:hourglass-top' : 'material-symbols:play-arrow'" 
-              class="w-4 h-4" 
-              :class="{ 'animate-spin': isExecuting }"
-            />
-            <span>{{ isExecuting ? '执行中...' : '运行' }}</span>
-          </button>
         </div>
       </div>
     </div>
-    
-    <!-- 编辑器主体 -->
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
-      <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+
+    <!-- 编辑器主体 - Apple 风格布局 -->
+    <div class="mx-auto max-w-7xl px-4 pt-32 pb-6 sm:px-6 lg:px-8 lg:pb-8">
+      <div class="grid grid-cols-1 gap-5 lg:grid-cols-2">
         <!-- 代码输入区域 -->
-        <div class="space-y-4">
+        <div class="space-y-5">
           <!-- 代码编辑器 -->
-          <div class="bg-gray-50 dark:bg-gray-800 rounded-xl shadow-md overflow-hidden border border-gray-200 dark:border-gray-700">
-            <div class="bg-gray-100 dark:bg-gray-700 px-4 py-2 flex items-center justify-between">
+          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
+            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
               <div class="flex items-center gap-2">
-                <Icon icon="material-symbols:code" class="w-5 h-5 text-gray-600 dark:text-gray-300" />
-                <span class="font-medium">代码</span>
+                <Icon icon="solar:code-square-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
+                <span class="text-sm font-medium">代码</span>
               </div>
-              <div class="text-sm text-gray-500 dark:text-gray-400">
+              <div class="text-xs text-slate-500 dark:text-slate-400">
                 {{ code.split('\n').length }} 行
               </div>
             </div>
-            <textarea 
-              v-model="code" 
-              class="w-full h-[400px] p-4 font-mono text-sm bg-white dark:bg-gray-900 border-none resize-none focus:outline-none focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400 rounded-b-xl"
+            <textarea
+              v-model="code"
+              class="h-[400px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed text-slate-900 placeholder-slate-400 focus:outline-none focus:ring-2 focus:ring-blue-500/50 dark:bg-slate-900 dark:text-slate-100 dark:placeholder-slate-600 dark:focus:ring-blue-400/50"
               placeholder="在此输入你的代码..."
+              spellcheck="false"
             ></textarea>
           </div>
-          
+
           <!-- 标准输入 -->
-          <div class="bg-gray-50 dark:bg-gray-800 rounded-xl shadow-md overflow-hidden border border-gray-200 dark:border-gray-700">
-            <div class="bg-gray-100 dark:bg-gray-700 px-4 py-2 flex items-center justify-between">
+          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
+            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
               <div class="flex items-center gap-2">
-                <Icon icon="material-symbols:input" class="w-5 h-5 text-gray-600 dark:text-gray-300" />
-                <span class="font-medium">标准输入</span>
+                <Icon icon="solar:import-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
+                <span class="text-sm font-medium">标准输入</span>
               </div>
             </div>
-            <textarea 
-              v-model="stdin" 
-              class="w-full h-[150px] p-4 font-mono text-sm bg-white dark:bg-gray-900 border-none resize-none focus:outline-none focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400 rounded-b-xl"
+            <textarea
+              v-model="stdin"
+              class="h-[150px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed text-slate-900 placeholder-slate-400 focus:outline-none focus:ring-2 focus:ring-blue-500/50 dark:bg-slate-900 dark:text-slate-100 dark:placeholder-slate-600 dark:focus:ring-blue-400/50"
               placeholder="在此输入标准输入..."
+              spellcheck="false"
             ></textarea>
           </div>
         </div>
-        
+
         <!-- 结果输出区域 -->
-        <div class="space-y-4">
+        <div class="space-y-5">
           <!-- 标准输出 -->
-          <div class="bg-gray-50 dark:bg-gray-800 rounded-xl shadow-md overflow-hidden border border-gray-200 dark:border-gray-700">
-            <div class="bg-gray-100 dark:bg-gray-700 px-4 py-2 flex items-center justify-between">
+          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
+            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
               <div class="flex items-center gap-2">
-                <Icon icon="material-symbols:output" class="w-5 h-5 text-green-600 dark:text-green-400" />
-                <span class="font-medium">标准输出</span>
+                <Icon icon="solar:export-linear" class="h-5 w-5 text-emerald-600 dark:text-emerald-400" />
+                <span class="text-sm font-medium">标准输出</span>
               </div>
             </div>
-            <div 
-              class="w-full h-[275px] p-4 font-mono text-sm bg-white dark:bg-gray-900 border-none resize-none overflow-auto rounded-b-xl"
+            <div
+              class="h-[275px] w-full overflow-auto bg-white p-4 font-mono text-sm leading-relaxed dark:bg-slate-900"
             >
-              <pre v-if="stdout" class="text-green-600 dark:text-green-400">{{ stdout }}</pre>
-              <div v-else class="text-gray-400 dark:text-gray-500 italic">执行结果将显示在这里...</div>
+              <pre v-if="stdout" class="text-emerald-600 dark:text-emerald-400">{{ stdout }}</pre>
+              <div v-else class="text-slate-400 dark:text-slate-600">执行结果将显示在这里...</div>
             </div>
           </div>
-          
+
           <!-- 错误输出 -->
-          <div class="bg-gray-50 dark:bg-gray-800 rounded-xl shadow-md overflow-hidden border border-gray-200 dark:border-gray-700">
-            <div class="bg-gray-100 dark:bg-gray-700 px-4 py-2 flex items-center justify-between">
+          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
+            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
               <div class="flex items-center gap-2">
-                <Icon icon="material-symbols:error" class="w-5 h-5 text-red-600 dark:text-red-400" />
-                <span class="font-medium">错误输出</span>
+                <Icon icon="solar:danger-circle-linear" class="h-5 w-5 text-red-600 dark:text-red-400" />
+                <span class="text-sm font-medium">错误输出</span>
               </div>
             </div>
-            <div 
-              class="w-full h-[275px] p-4 font-mono text-sm bg-white dark:bg-gray-900 border-none resize-none overflow-auto rounded-b-xl"
+            <div
+              class="h-[275px] w-full overflow-auto bg-white p-4 font-mono text-sm leading-relaxed dark:bg-slate-900"
             >
               <pre v-if="stderr" class="text-red-600 dark:text-red-400">{{ stderr }}</pre>
-              <div v-else class="text-gray-400 dark:text-gray-500 italic">错误信息将显示在这里...</div>
+              <div v-else class="text-slate-400 dark:text-slate-600">错误信息将显示在这里...</div>
             </div>
           </div>
         </div>
@@ -223,23 +284,38 @@ const resetCode = () => {
 </template>
 
 <style scoped>
-/* 自定义滚动条样式 */
+/* Apple 风格滚动条 */
 ::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
+  width: 8px;
+  height: 8px;
 }
 
 ::-webkit-scrollbar-track {
-  background: #f1f1f1;
-  dark:bg-gray-800;
+  background: transparent;
 }
 
 ::-webkit-scrollbar-thumb {
-  background: #888;
-  border-radius: 3px;
+  background: rgb(203 213 225);
+  border-radius: 4px;
+  transition: background 0.2s;
 }
 
 ::-webkit-scrollbar-thumb:hover {
-  background: #555;
+  background: rgb(148 163 184);
+}
+
+:global(.dark) ::-webkit-scrollbar-thumb {
+  background: rgb(51 65 85);
+}
+
+:global(.dark) ::-webkit-scrollbar-thumb:hover {
+  background: rgb(71 85 105);
+}
+
+/* 点击语言菜单外部关闭 */
+@media (hover: hover) {
+  button:active {
+    transform: scale(0.98);
+  }
 }
 </style>
\ No newline at end of file
diff --git a/webapp/letapp/src/style.css b/webapp/letapp/src/style.css
index 09b9048..c723d14 100644
--- a/webapp/letapp/src/style.css
+++ b/webapp/letapp/src/style.css
@@ -185,8 +185,4 @@ html, body {
 
 h1:focus {
     outline: none;
-}
-
-a {
-    color: #0071c1;
 }
\ No newline at end of file
-- 
Gitee


From 9de8e5055bb62ee27ccbd5a22a6609d43edd1bad Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 00:37:49 +0800
Subject: [PATCH 15/22] merge luckyfish branch

---
 webapi/.DS_Store                              |  Bin 8196 -> 0 bytes
 webapi/fastapi_of_letcoing/.gitignore         |   47 -
 webapi/fastapi_of_letcoing/.idea/.gitignore   |    8 -
 .../fastapi_of_letcoing/.idea/encodings.xml   |    4 -
 webapi/fastapi_of_letcoing/AGENTS.md          |  234 ---
 webapi/fastapi_of_letcoing/CLAUDE.md          |  536 ------
 .../fastapi_of_letcoing/DEVELOPMENT_GUIDE.md  | 1528 -----------------
 webapi/fastapi_of_letcoing/README.md          |  455 -----
 .../controllers/__init__.py                   |    1 -
 .../controllers/code_controller.py            |  130 --
 webapi/fastapi_of_letcoing/core/db_config.py  |   58 -
 .../fastapi_of_letcoing/core/di_container.py  |  216 ---
 .../core/service_config.py                    |   51 -
 .../interfaces/__init__.py                    |    0
 .../middleware/auth_middleware.py             |  200 ---
 webapi/fastapi_of_letcoing/models/__init__.py |    0
 .../fastapi_of_letcoing/models/auth_models.py |  182 --
 .../fastapi_of_letcoing/models/glot_models.py |   67 -
 .../services/config_service.py                |   50 -
 .../services/database_service.py              |  134 --
 .../services/glot_service.py                  |  187 --
 .../services/jwt_service.py                   |  251 ---
 .../services/logger_service.py                |   58 -
 .../services/redis_service.py                 |  448 -----
 24 files changed, 4845 deletions(-)
 delete mode 100644 webapi/.DS_Store
 delete mode 100644 webapi/fastapi_of_letcoing/.gitignore
 delete mode 100644 webapi/fastapi_of_letcoing/.idea/.gitignore
 delete mode 100644 webapi/fastapi_of_letcoing/.idea/encodings.xml
 delete mode 100644 webapi/fastapi_of_letcoing/AGENTS.md
 delete mode 100644 webapi/fastapi_of_letcoing/CLAUDE.md
 delete mode 100644 webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
 delete mode 100644 webapi/fastapi_of_letcoing/README.md
 delete mode 100644 webapi/fastapi_of_letcoing/controllers/__init__.py
 delete mode 100644 webapi/fastapi_of_letcoing/controllers/code_controller.py
 delete mode 100644 webapi/fastapi_of_letcoing/core/db_config.py
 delete mode 100644 webapi/fastapi_of_letcoing/core/di_container.py
 delete mode 100644 webapi/fastapi_of_letcoing/core/service_config.py
 delete mode 100644 webapi/fastapi_of_letcoing/interfaces/__init__.py
 delete mode 100644 webapi/fastapi_of_letcoing/middleware/auth_middleware.py
 delete mode 100644 webapi/fastapi_of_letcoing/models/__init__.py
 delete mode 100644 webapi/fastapi_of_letcoing/models/auth_models.py
 delete mode 100644 webapi/fastapi_of_letcoing/models/glot_models.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/config_service.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/database_service.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/glot_service.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/jwt_service.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/logger_service.py
 delete mode 100644 webapi/fastapi_of_letcoing/services/redis_service.py

diff --git a/webapi/.DS_Store b/webapi/.DS_Store
deleted file mode 100644
index 0b57f5e4d8ceb12f3efcdf531ea44806d12a461a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8196
zcmeHMU2GLa6rOKd%3fI8g;v|*-Eg5LNK;DrF)aw@_D}gQ(AM4-<Z|!brCr?amb-gz
zOTpNf_@aXGN#j3H8jU;{P~(dxDx!~CA27xTqDFneL|;@MJhQVUwxtOV#;EKhJKvs}
zIWs%oo^Pk;mNAC*g0Y^l8pfDHmq2YXRW~T2UtDtv4_itJLH>+o*eJ7Dnz`)goY7H3
z#6ZMA#6ZMA#6ZNrzkvZdvqe$nIrn96R7VU%4BV0oi0?y!E`iAqCnW}-4yu9_fKa3W
zL7{uf0|K8!h{+HqB?hiEr_3G@x*|+5Al<1yA%+tsL!6W--5I1iL%1@+3<bgJ<d+DB
zGbANOb;Ll#z+47|d@3nh&oGbqGxGN|vzbY4Im+fO=CC2d%h_4iwZ$Yi>0*1uj;!rw
z87t|@j@p*zH#dI;UQ)WCY@rfcv{=1O?@tX39#qrX(xPRKb&vX%>v#{Cd5<uyRd~bh
z*p8g*?8}>?zdz^Ng%QU~YfEw&J6EtXzS(BmJ=TOtZ53WF@7nf0*R#Yl11aAe_eI~F
zuGFCC=KYRfvXn*h%TZdvGY^<FsZ}&PX=<-(7Ga2;E3aN&f7jX#EnAaaJNE3Ks?e4!
zt*lbjLCY{5-#TiU`MxpB@P`L7Ue0t3%Ngn~TAr1)&0Z%nVlF{rEH+h9Q@iZWxUSDP
zG*!r2#|xH!LaS4hV2#8IT|H#bGwpE=v5KKxP-q@nebowGKPY-S@+Q?r=&+_iS9?9$
zyp{<EHmy_D-iIv5&^+-7<hpT_s`uHMtZ8dTOs><qS=IZCl7DSi*to4q)l)flWQ4Zp
zg>7x^x_($JyF26g-J_;Mk8~+q`#$O$^oBEevwO@j^I_{wY7Jf~wF{>%!}8srli1ix
zyBHADwHZdRhh;Uj6?%`}r)ZxmX-%`7qUF<zp;tvv@RYjgS5ud4khgUo49S~-=(=RH
zv|@C!=xhV)WV_iBmS-o~Y4$8T%g(cp*+upx`-c6<uCm_%lp%&iSd1zxLp>UCH(Jn&
z&1gqA_TvD0a0tV&a10*CF@cjfg~#wXp2TUK!83RfFXI)Q#p`$r=WzjV<9%Ghr}zwC
z;0nIQclaJx@jL#&HNJpX^BP{uSMo-_mN)Sh-paS|d-z`7%~L$Xk8zie%MI}G$YT#m
zd%ET)=<eo)I4Xt6&)ryv@%y*$*tzS!BgD()QhK-FQJq-Tux?Z9wzlgbDr0&&jQ=W*
zKoK)^6euEym|4+0B{ixppVseevG$Ra%yC61T3aYbuT<+5l9IMSnyb|{3W-Q7lV)SQ
zNg>&4JTTSu@r^MOr&c1(#&}Ci(IAa2>ed*^R4bLHt|ntKjRi)$Bi^Nu)HLPq(!gbQ
zh5f*OX4gmq<)}mrR->6B|6XjzUW$DY`F%KyG&0D-zz7_S;y9_`6duMSn8c%af>dw@
zPvL1ihv)GEUc#$*jg;^P-XtBogLm;BKEy}3h)+UAd`)`z3BSyW@jcVgEfK%oe2f=+
z@{a8~;v+Dvn3<DB)=UOUq*){K|E~Fe|DWj;SrG#f1OF=qP}<qk*-l%U@3Sd#?F3y%
z=n_SYo0J&1P!*)(gh4t^c>N!Sbf2K1!Y3Kxq(o|=@{j)zFkwdL|IELEqw_zA#9OQS
E6I6*g9{>OV

diff --git a/webapi/fastapi_of_letcoing/.gitignore b/webapi/fastapi_of_letcoing/.gitignore
deleted file mode 100644
index f436353..0000000
--- a/webapi/fastapi_of_letcoing/.gitignore
+++ /dev/null
@@ -1,47 +0,0 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
-
-node_modules
-dist
-dist-ssr
-*.local
-.env
-.env.local
-.env.development.local
-.env.production.local
-
-# Editor directories and files
-.vscode/*
-!.vscode/extensions.json
-.idea/
-.DS_Store
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
-
-bin/
-obj/
-/packages/
-riderModule.iml
-/_ReSharper.Caches/
-*.db
-*.db-shm
-*.db-wal
-
-keys/
-logs/
-
-appsettings.Development.json
-
-.venv/
-venv/
-
-*.pyc
diff --git a/webapi/fastapi_of_letcoing/.idea/.gitignore b/webapi/fastapi_of_letcoing/.idea/.gitignore
deleted file mode 100644
index 6d9e687..0000000
--- a/webapi/fastapi_of_letcoing/.idea/.gitignore
+++ /dev/null
@@ -1,8 +0,0 @@
-# 默认忽略的文件
-/shelf/
-/workspace.xml
-# 基于编辑器的 HTTP 客户端请求
-/httpRequests/
-# Datasource local storage ignored files
-/dataSources/
-/dataSources.local.xml
diff --git a/webapi/fastapi_of_letcoing/.idea/encodings.xml b/webapi/fastapi_of_letcoing/.idea/encodings.xml
deleted file mode 100644
index df87cf9..0000000
--- a/webapi/fastapi_of_letcoing/.idea/encodings.xml
+++ /dev/null
@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Encoding" addBOMForNewFiles="with BOM under Windows, with no BOM otherwise" />
-</project>
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/AGENTS.md b/webapi/fastapi_of_letcoing/AGENTS.md
deleted file mode 100644
index fb63080..0000000
--- a/webapi/fastapi_of_letcoing/AGENTS.md
+++ /dev/null
@@ -1,234 +0,0 @@
-# AGENTS.md
-
-**请使用中文回答和中文解释**
-
-This document provides guidelines for agentic coding agents working on this Flask-based code execution API service.
-
-## Project Overview
-
-This is a Flask web API service that provides code execution capabilities by integrating with the Glot.io API. The service supports 30+ programming languages and uses asynchronous HTTP requests for better performance.
-
-**Architecture:**
-- `main.py` - Flask application entry point with API routes
-- `services/glot_service.py` - Core service for Glot.io API integration
-- `controller/` - Directory for future controller implementations
-
-## Development Commands
-
-### Running the Application
-```bash
-# Install dependencies
-pip install -r requirements.txt
-
-# Start development server
-python3 main.py
-```
-
-The application runs on `http://localhost:5000` by default.
-
-### Testing
-This project currently does not have a formal test suite. When implementing tests:
-
-```bash
-# Run pytest (if added)
-python3 -m pytest
-
-# Run specific test file
-python3 -m pytest tests/test_service.py
-
-# Run with coverage
-python3 -m pytest --cov=services
-```
-
-### Code Quality
-```bash
-# Check syntax
-python3 -m py_compile main.py services/glot_service.py
-
-# Format code (if black is added)
-black main.py services/
-
-# Lint (if flake8 is added)
-flake8 main.py services/
-```
-
-## Code Style Guidelines
-
-### Imports
-- Standard library imports first, then third-party, then local imports
-- Use absolute imports for local modules
-- Keep imports sorted alphabetically within each section
-```python
-import asyncio
-import os
-from typing import Dict, List, Optional
-
-import aiohttp
-from flask import Flask, request, jsonify
-
-from services.glot_service import GlotService
-```
-
-### Formatting and Naming
-- **PEP 8 compliant** - Use 4 spaces for indentation
-- **Line length**: Maximum 88-100 characters
-- **Variable names**: `snake_case` for functions and variables
-- **Class names**: `PascalCase` for classes
-- **Constants**: `UPPER_SNAKE_CASE` for module-level constants
-- **Private methods**: Prefix with underscore `_`
-
-### Type Hints
-- Use type hints for all function parameters and return values
-- Import from `typing` module for complex types
-- Use `Optional[T]` for nullable types
-
-```python
-async def run_glot_async(self, 
-                        api_token: str, 
-                        code: str, 
-                        language: str = "javascript", 
-                        stdin: Optional[str] = None) -> str:
-```
-
-### Data Models
-- Use `@dataclass` for data structures
-- Provide `to_dict()` methods for serialization
-- Initialize list/dict defaults properly in `__post_init__`
-
-```python
-@dataclass
-class PostDataModel:
-    files: List[PostFile] = None
-    stdin: Optional[str] = None
-    
-    def __post_init__(self):
-        if self.files is None:
-            self.files = []
-    
-    def to_dict(self):
-        return {
-            "files": [f.to_dict() for f in self.files],
-            "stdin": self.stdin
-        }
-```
-
-### Error Handling
-- Use try-except blocks for API calls and I/O operations
-- Handle specific exceptions when possible
-- Return meaningful error messages to users
-- Log errors appropriately (logging not currently implemented)
-
-```python
-try:
-    async with aiohttp.ClientSession(timeout=self.timeout) as session:
-        async with session.post(url, json=data, headers=headers) as response:
-            # Handle response
-except asyncio.TimeoutError:
-    return "请求超时"
-except aiohttp.ClientError as ex:
-    return f"请求出错: {str(ex)}"
-except Exception as ex:
-    return f"请求出错: {str(ex)}"
-```
-
-### API Endpoints
-- Use Flask decorators for routing
-- Validate input parameters
-- Return JSON responses with appropriate HTTP status codes
-- Handle missing required fields gracefully
-
-```python
-@app.route('/run', methods=['POST'])
-async def post():
-    # Validate input
-    model = request.get_json()
-    if not model:
-        return jsonify({'error': '请求体不能为空'}), 400
-    
-    # Extract and validate parameters
-    code = model.get('code', '')
-    if not code or code.strip() == "":
-        return jsonify({'error': '代码不能为空'}), 400
-    
-    # Process and return response
-    result = await glot_service.run_glot_async(api_token, code, language, stdin)
-    return jsonify(result), 200
-```
-
-### Security Considerations
-- Escape output to prevent injection attacks
-- Validate API tokens from environment variables
-- Use HTTPS for external API calls
-- Never log sensitive information like API tokens
-
-```python
-@staticmethod
-def _escape(text: str) -> str:
-    if not text:
-        return ""
-    return (text
-            .replace("&", "&amp;")
-            .replace("<", "&lt;")
-            .replace(">", "&gt;"))
-```
-
-## Configuration
-
-### Environment Variables
-- `API_TOKEN`: Required Glot.io API token
-- Can be set via environment variable or Flask app config
-
-### Constants
-- Language mappings stored as class constant `LANGUAGES`
-- Default timeout: 30 seconds for HTTP requests
-
-## Patterns to Follow
-
-### Async/Await
-- Use async/await for all HTTP requests
-- Properly handle async context managers with `async with`
-
-### Service Layer Pattern
-- Business logic separated from Flask routes
-- Services should be reusable and testable
-- Use dependency injection for service instances
-
-### Data Transfer Objects
-- Use dataclasses for request/response models
-- Provide serialization methods
-- Validate data at service boundaries
-
-## Dependencies
-
-Key dependencies and their purposes:
-- `Flask`: Web framework
-- `aiohttp`: Async HTTP client for Glot.io API calls
-- `requests`: Alternative HTTP client (currently unused)
-- `dataclasses`: Built-in data modeling (Python 3.7+)
-
-## Common Tasks
-
-### Adding New Language Support
-1. Add language mapping to `LANGUAGES` dictionary in `GlotService`
-2. Update documentation in README.md
-3. Test the new language integration
-
-### Adding New API Endpoints
-1. Define route in `main.py` using `@app.route()`
-2. Validate request data
-3. Call appropriate service methods
-4. Return JSON response with proper status code
-
-### Modifying Service Logic
-1. Update methods in `GlotService` class
-2. Maintain async/await pattern
-3. Update data models if needed
-4. Test error scenarios
-
-## Future Considerations
-
-- Consider adding comprehensive test suite with pytest
-- Implement proper logging instead of return strings
-- Add API rate limiting
-- Implement caching for repeated requests
-- Consider using FastAPI instead of Flask for better async support
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/CLAUDE.md b/webapi/fastapi_of_letcoing/CLAUDE.md
deleted file mode 100644
index 33d48f6..0000000
--- a/webapi/fastapi_of_letcoing/CLAUDE.md
+++ /dev/null
@@ -1,536 +0,0 @@
-# CLAUDE.md
-
-**请使用中文回答和中文解释**
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is a **Flask-based code execution API service** (LetCoding API) that allows users to execute code in 30+ programming languages via the Glot.io API. The project features a sophisticated dependency injection architecture, JWT authentication with OAuth support (GitHub, custom OIDC), Redis caching, and PostgreSQL database integration using Peewee ORM.
-
-**Key Technologies:**
-- Flask 3.1.2 + Flask-RESTX for API documentation
-- aiohttp for async HTTP requests
-- PostgreSQL with Peewee ORM
-- Redis for caching and session management
-- JWT + OAuth (GitHub, OIDC)
-- Custom dependency injection container
-
-## Essential Commands
-
-### Development
-
-```bash
-# Install dependencies
-pip install -r requirements.txt
-
-# Run development server (port 6173)
-python main.py
-
-# API documentation available at:
-# http://localhost:6173/swagger/
-```
-
-### Database Operations
-
-```bash
-# Initialize database tables
-# Tables are created automatically on first run via Peewee ORM
-# Models defined in models/db_models.py
-
-# Test database connection (in Python)
-from services.database_service import DatabaseService
-from core.di_container import inject
-db = inject(DatabaseService)
-db.test_connection()
-```
-
-### Redis Operations
-
-```bash
-# Test Redis connection
-redis-cli ping
-
-# Monitor Redis operations
-redis-cli monitor
-
-# Clear Redis cache (use with caution)
-redis-cli FLUSHDB
-```
-
-### Testing
-
-```bash
-# Currently no formal test suite
-# Manual API testing:
-curl http://localhost:6173/auth/providers
-curl -X POST http://localhost:6173/code/run/public \
-  -H "Content-Type: application/json" \
-  -d '{"code": "console.log(\"Hello\")", "language": "javascript"}'
-```
-
-## Architecture Overview
-
-### Layered Architecture
-
-This project follows a strict layered architecture with dependency injection:
-
-```
-Request Flow:
-HTTP Request → Middleware (auth) → Controller → Service Layer → External APIs/Database/Redis
-
-Layer Responsibilities:
-- Controllers (controllers/): HTTP routing, request validation, response formatting
-- Services (services/): Business logic, external API calls, data processing
-- Middleware (middleware/): Authentication, rate limiting
-- Models (models/): Data structures (dataclasses for API models, Peewee for DB models)
-- Core (core/): DI container, service configuration, database configuration
-- Interfaces (interfaces/): Abstract service interfaces (ABC)
-```
-
-### Dependency Injection System
-
-**The project uses a custom DI container** (`core/di_container.py`) with three lifecycles:
-
-1. **Singleton**: One instance per application (ConfigService, LoggerService, RedisService, DatabaseService)
-2. **Scoped**: One instance per request (GlotService)
-3. **Transient**: New instance every time (rarely used)
-
-**How to use DI:**
-
-```python
-# Method 1: Constructor injection (preferred for services)
-from interfaces.service_interfaces import IConfigService, ILoggerService
-from core.di_container import Injectable
-
-class MyService(Injectable):
-    def __init__(self, config: IConfigService, logger: ILoggerService):
-        self._config = config
-        self._logger = logger
-
-# Method 2: Runtime injection (for controllers, one-off usage)
-from core.di_container import inject
-from services.user_service import UserService
-
-def my_function():
-    user_service = inject(UserService)
-    return user_service.get_user_by_id(123)
-```
-
-**Service Registration** happens in `core/service_config.py`:
-
-```python
-def service_configurator(container):
-    container.register_singleton(IConfigService, factory=lambda: ConfigService(app_config))
-    container.register_singleton(IRedisService, RedisService)
-    container.register_scoped(ICodeExecutionService, GlotService)
-```
-
-### Database Architecture
-
-The project uses **modular database services** built on Peewee ORM:
-
-- **Base Service**: `DatabaseService` provides generic CRUD operations
-- **Specialized Services**: `UserService`, `CodeExecutionService`, `APIService` inherit from `DatabaseService`
-- **Models**: Defined in `models/db_models.py`, all inherit from `BaseModel`
-
-**Key database services:**
-- `DatabaseService`: Generic CRUD, connection management
-- `UserService`: User-specific operations (create_user, get_user_by_username, etc.)
-- `UserService` and similar services inherit both `DatabaseService` and `Injectable`
-
-**Database configuration** is managed through environment variables (see main.py:26-33):
-- DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD
-- DB_MAX_CONNECTIONS, DB_STALE_TIMEOUT
-
-### Service Layer Patterns
-
-**Key Services and Their Purposes:**
-
-1. **ConfigService** (`services/config_service.py`): Centralized configuration management from environment variables
-2. **GlotService** (`services/glot_service.py`): Async code execution via Glot.io API
-3. **OIDCService** (`services/oidc_service.py`): OAuth/OIDC authentication (GitHub, custom providers)
-4. **JWTService** (`services/jwt_service.py`): JWT token generation, verification, refresh
-5. **RedisService** (`services/redis_service.py`): Caching, session management, rate limiting
-6. **DatabaseService** (`services/database_service.py`): Base database operations with Peewee
-7. **UserService** (`services/user_service.py`): User management (create, query, update users)
-8. **LoggerService** (`services/logger_service.py`): Structured logging
-
-### Authentication System
-
-The project implements **multi-provider OAuth + JWT**:
-
-1. **OIDC Flow**: User initiates login → redirected to OAuth provider → callback handles token exchange → JWT tokens issued
-2. **JWT Tokens**: Access token (short-lived, default 1h) + Refresh token (long-lived, default 7d)
-3. **Middleware**: `AuthMiddleware` provides decorators:
-   - `@AuthMiddleware.require_auth`: Protected endpoints
-   - `@AuthMiddleware.optional_auth`: Guest/authenticated access
-   - `@AuthMiddleware.rate_limit(max_requests, window_seconds)`: Rate limiting
-4. **Token Management**: Redis stores token blacklist, refresh tokens, user sessions
-
-**Supported OAuth Providers:**
-- GitHub OAuth (via GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET)
-- Custom OIDC providers (via OIDC_PROVIDERS JSON env var)
-
-### Redis Usage Patterns
-
-Redis is used for:
-1. **JWT Token Blacklist**: Revoked tokens stored with TTL matching token expiry
-2. **Rate Limiting**: Counter keys like `rate_limit:{user_id}:{endpoint}` with TTL
-3. **Code Execution Cache**: Cache results for identical code+language combinations
-4. **User Session Data**: Temporary user information with TTL
-
-**Key naming conventions:**
-- `user:profile:{user_id}` - User profile cache
-- `session:{session_id}` - User session data
-- `rate_limit:api:{user_id}:{endpoint}` - Rate limit counters
-- `blacklist:token:{jti}` - Revoked JWT tokens
-
-## Critical Implementation Details
-
-### Adding a New Service
-
-Complete workflow (follow this order):
-
-1. **Define interface** in `interfaces/service_interfaces.py`:
-```python
-class IMyService(ABC):
-    @abstractmethod
-    def my_method(self) -> str:
-        pass
-```
-
-2. **Implement service** in `services/my_service.py`:
-```python
-from interfaces.service_interfaces import IMyService, IConfigService
-from core.di_container import Injectable
-
-class MyService(IMyService, Injectable):
-    def __init__(self, config: IConfigService):
-        self._config = config
-
-    def my_method(self) -> str:
-        return "result"
-```
-
-3. **Register service** in `core/service_config.py`:
-```python
-def service_configurator(container):
-    # ... existing registrations ...
-    container.register_singleton(IMyService, MyService)
-```
-
-4. **Create controller** in `controllers/my_controller.py`:
-```python
-from flask_restx import Namespace, Resource
-from core.di_container import inject
-
-api = Namespace('my_module', description='My module')
-
-@api.route('/action')
-class MyController(Resource):
-    def get(self):
-        service = inject(IMyService)
-        return {'result': service.my_method()}
-```
-
-5. **Register namespace** in `main.py`:
-```python
-from controllers.my_controller import api as my_api
-api.add_namespace(my_api, path='/my-module')
-```
-
-### Database Service Pattern
-
-When creating a new database-backed service:
-
-1. **Define model** in `models/db_models.py`:
-```python
-class MyModel(BaseModel):
-    name = CharField(max_length=100, unique=True)
-    value = TextField()
-
-    class Meta:
-        table_name = "my_table"
-```
-
-2. **Create service** inheriting from `DatabaseService`:
-```python
-from services.database_service import DatabaseService
-from core.di_container import Injectable
-
-class MyTableService(DatabaseService, Injectable):
-    async def create_record(self, name: str, value: str) -> Dict[str, Any]:
-        return await self.create(MyModel, name=name, value=value)
-
-    async def get_by_name(self, name: str) -> Optional[Dict[str, Any]]:
-        try:
-            record = MyModel.get(MyModel.name == name)
-            return record.to_dict()
-        except DoesNotExist:
-            return None
-```
-
-3. **Register in service config** with factory function:
-```python
-def service_configurator(container):
-    def create_my_table_service():
-        config = container.resolve(IConfigService)
-        return MyTableService(config)
-
-    container.register_singleton(MyTableService, factory=create_my_table_service)
-```
-
-### Working with Async Code
-
-The project mixes **sync Flask with async services**:
-
-- Flask routes are sync, but services use `async/await`
-- Use `asyncio.run()` or `asyncio.create_task()` to call async services from sync controllers
-- GlotService uses `aiohttp` for async HTTP requests
-- All database operations are async (though Peewee itself is sync, the service layer wraps them)
-
-Example:
-```python
-import asyncio
-
-@api.route('/execute')
-class ExecuteController(Resource):
-    def post(self):
-        service = inject(ICodeExecutionService)
-        # Call async method from sync controller
-        result = asyncio.run(service.execute_code(request.get_json()))
-        return result
-```
-
-### Environment Configuration
-
-**Critical environment variables** (see main.py and README.md for complete list):
-
-**Required:**
-- `API_TOKEN`: Glot.io API token (required for code execution)
-
-**JWT (recommended for production):**
-- `JWT_SECRET_KEY`: Strong secret for JWT signing
-- `JWT_ACCESS_TOKEN_EXPIRE`: Access token TTL in seconds (default: 3600)
-- `JWT_REFRESH_TOKEN_EXPIRE`: Refresh token TTL in seconds (default: 604800)
-
-**Redis (recommended for production):**
-- `REDIS_HOST`, `REDIS_PORT`, `REDIS_DB`, `REDIS_PASSWORD`, `REDIS_TIMEOUT`
-
-**Database (required if using DB features):**
-- `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`
-- `DB_MAX_CONNECTIONS`, `DB_STALE_TIMEOUT`
-
-**OAuth (optional):**
-- `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`
-- `OIDC_PROVIDERS` (JSON string for custom providers)
-
-Configuration loading priority: Environment variables → `.env` file → defaults in main.py
-
-## Code Style and Conventions
-
-### Naming Conventions
-
-- **Interfaces**: `IServiceName` (e.g., `IConfigService`)
-- **Implementations**: `ServiceName` (e.g., `ConfigService`)
-- **Controllers**: `ResourceNameController` (e.g., `CodeExecutionController`)
-- **Models**: PascalCase for classes, snake_case for table names
-- **Service methods**: snake_case, descriptive verbs (get_user, create_record, execute_code)
-
-### File Organization
-
-- One service per file in `services/`
-- One controller namespace per file in `controllers/`
-- All interface definitions in `interfaces/service_interfaces.py`
-- Database models in `models/db_models.py`
-- API data models (dataclasses) in `models/` (e.g., `glot_models.py`, `auth_models.py`)
-
-### Error Handling Pattern
-
-Follow this pattern in services:
-```python
-try:
-    result = await self._perform_operation()
-    self._logger.info(f"Operation successful: {result}")
-    return result
-except SpecificException as e:
-    self._logger.error(f"Specific error: {e}")
-    raise ValueError(f"Business-friendly message: {e}")
-except Exception as e:
-    self._logger.error(f"Unexpected error: {e}")
-    raise RuntimeError(f"Internal error: {e}")
-```
-
-Controllers should catch service exceptions and return appropriate HTTP status codes:
-```python
-try:
-    result = service.my_method()
-    return {'data': result}, 200
-except ValueError as e:
-    return {'error': str(e)}, 400
-except RuntimeError as e:
-    return {'error': 'Internal server error'}, 500
-```
-
-### Dataclass Models
-
-Use `@dataclass` for API models with `to_dict()` methods:
-```python
-from dataclasses import dataclass, field
-from typing import Optional, List
-
-@dataclass
-class MyModel:
-    name: str
-    value: Optional[str] = None
-    items: List[str] = field(default_factory=list)
-
-    def to_dict(self) -> dict:
-        return {
-            'name': self.name,
-            'value': self.value,
-            'items': self.items
-        }
-```
-
-## Common Pitfalls and Solutions
-
-### Pitfall 1: Circular Dependencies
-
-**Problem**: Service A depends on Service B, which depends on Service A.
-
-**Solution**:
-- Redesign services to eliminate circular dependency
-- Use event-driven pattern instead of direct service calls
-- Extract common functionality into a third service
-
-### Pitfall 2: Forgetting to Register Services
-
-**Problem**: `ValueError: 服务 {service_type} 未注册`
-
-**Solution**: Always register new services in `core/service_config.py` before using them.
-
-### Pitfall 3: Redis Connection Failures
-
-**Problem**: Redis operations fail silently or with connection errors.
-
-**Solution**:
-- Use `redis_service.is_connected()` to check connection
-- Implement graceful degradation (continue without cache if Redis is down)
-- Use `redis_service.reconnect()` to attempt reconnection
-
-### Pitfall 4: Async/Sync Mixing Issues
-
-**Problem**: Calling async functions without `await` or `asyncio.run()`.
-
-**Solution**:
-- In async contexts: Use `await service.async_method()`
-- In sync contexts (controllers): Use `asyncio.run(service.async_method())`
-- Mark service methods with `async def` if they perform I/O operations
-
-### Pitfall 5: Database Model Changes
-
-**Problem**: Schema changes not reflected in database.
-
-**Solution**:
-- Peewee doesn't auto-migrate; modify database schema manually or recreate tables
-- For development: Delete tables and recreate with `create_tables()` in models/db_models.py
-- For production: Use migration tools or write migration scripts
-
-### Pitfall 6: Missing BaseModel.to_dict() for Sensitive Data
-
-**Problem**: Password hashes or secrets exposed in API responses.
-
-**Solution**: Override `to_dict()` in models to exclude sensitive fields:
-```python
-class User(BaseModel):
-    password_hash = CharField(max_length=255)
-
-    def to_dict(self) -> dict:
-        data = super().to_dict()
-        data.pop('password_hash', None)  # Remove sensitive field
-        return data
-```
-
-## Working with This Codebase
-
-### When modifying authentication
-
-- JWT token logic is in `services/jwt_service.py`
-- OAuth flow logic is in `services/oidc_service.py`
-- Middleware decorators are in `middleware/auth_middleware.py`
-- Token blacklist and refresh tokens are stored in Redis
-- Test token generation/verification independently before integration
-
-### When adding API endpoints
-
-1. Create or extend namespace in `controllers/`
-2. Use Flask-RESTX models for request/response documentation
-3. Apply `@AuthMiddleware.require_auth` if authentication is needed
-4. Use dependency injection to access services
-5. Return JSON with appropriate HTTP status codes
-6. Register namespace in `main.py` with URL prefix
-
-### When working with Redis
-
-- Always check connection with `is_connected()` before critical operations
-- Use meaningful key naming with namespaces (e.g., `user:profile:{id}`)
-- Set appropriate TTL for all cached data
-- Implement cache invalidation strategy for updated data
-- Use Redis CLI for debugging: `redis-cli --scan --pattern "user:*"`
-
-### When working with the database
-
-- Define models in `models/db_models.py` inheriting from `BaseModel`
-- Create specialized service classes inheriting from `DatabaseService`
-- Use async wrappers for database operations
-- Test connection with `database_service.test_connection()`
-- Use `to_dict()` to convert models to API responses
-- Add indexes to frequently queried fields
-
-## Language Support
-
-The service supports 30+ languages via Glot.io. Language mappings are in `services/glot_service.py` in the `LANGUAGES` dictionary. When adding support for new languages, update this dictionary and verify the language is supported by Glot.io API.
-
-## Troubleshooting
-
-**Issue: "服务 {type} 未注册"**
-→ Register the service in `core/service_config.py`
-
-**Issue: Redis connection errors**
-→ Check Redis is running (`redis-cli ping`), verify REDIS_* env vars, check `redis_service.is_connected()`
-
-**Issue: Database connection errors**
-→ Verify PostgreSQL is running, check DB_* env vars, test with `database_service.test_connection()`
-
-**Issue: "API_TOKEN 未配置"**
-→ Set API_TOKEN environment variable or in .env file
-
-**Issue: OAuth callback fails**
-→ Verify OAuth provider config, check redirect_uri matches provider settings, inspect logs from `oidc_service`
-
-**Issue: JWT tokens not working**
-→ Check JWT_SECRET_KEY is set and consistent, verify token expiry times, check Redis connection for blacklist
-
-## Additional Resources
-
-- Flask-RESTX documentation: For API documentation features
-- Peewee ORM documentation: For database model operations
-- Glot.io API documentation: For supported languages and execution limits
-- OAuth 2.0 / OIDC specs: For understanding authentication flows
-
-## Key Files to Understand the Architecture
-
-Reading these files in order will give you a complete understanding:
-
-1. `main.py` - Application entry point, configuration, namespace registration
-2. `core/di_container.py` - Dependency injection container implementation
-3. `core/service_config.py` - Service registration configuration
-4. `interfaces/service_interfaces.py` - All service interfaces
-5. `services/config_service.py` - Configuration management pattern
-6. `services/glot_service.py` - Async service pattern, external API integration
-7. `services/database_service.py` - Database service base class with CRUD operations
-8. `services/user_service.py` - Example of specialized database service
-9. `middleware/auth_middleware.py` - Authentication and authorization decorators
-10. `controllers/code_controller.py` - Controller pattern, dependency injection in action
diff --git a/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md b/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
deleted file mode 100644
index 6507deb..0000000
--- a/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
+++ /dev/null
@@ -1,1528 +0,0 @@
-# LetCoding API 开发新手教程
-
-本教程将指导新手如何在 LetCoding API 项目中进行服务开发，包括依赖注入、控制器编写、Redis缓存使用和路由注册等核心概念。
-
-## 📚 目录
-
-1. [项目架构概览](#项目架构概览)
-2. [依赖注入详解](#依赖注入详解)
-3. [服务开发](#服务开发)
-4. [数据库服务使用](#数据库服务使用)
-5. [Redis 缓存服务使用](#redis-缓存服务使用)
-6. [认证和授权开发](#认证和授权开发)
-7. [控制器编写](#控制器编写)
-8. [路由注册](#路由注册)
-9. [完整开发流程示例](#完整开发流程示例)
-10. [常见问题和最佳实践](#常见问题和最佳实践)
-
-## 🏗️ 项目架构概览
-
-### 目录结构
-```
-fastapi_of_letcoing/
-├── core/                    # 核心模块
-│   ├── di_container.py      # 依赖注入容器
-│   └── service_config.py    # 服务配置
-├── interfaces/              # 服务接口定义
-│   ├── __init__.py
-│   └── service_interfaces.py # 抽象接口
-├── models/                  # 数据模型定义
-│   ├── __init__.py
-│   ├── glot_models.py      # Glot API 数据模型
-│   ├── auth_models.py      # 认证相关数据模型
-│   └── db_models.py        # 数据库模型（Peewee ORM）
-├── services/               # 业务服务层
-│   ├── config_service.py   # 配置服务
-│   ├── glot_service.py     # 代码执行服务
-│   ├── logger_service.py   # 日志服务
-│   ├── oidc_service.py     # OIDC 认证服务
-│   ├── jwt_service.py      # JWT 认证服务
-│   ├── redis_service.py    # Redis 缓存服务
-│   ├── database_service.py # 数据库基础服务
-│   ├── user_service.py     # 用户服务
-│   ├── code_execution_service.py # 代码执行记录服务
-│   └── api_service.py      # API 密钥服务
-├── middleware/             # 中间件层
-│   └── auth_middleware.py  # JWT 认证中间件
-├── controllers/            # 控制器层
-│   ├── __init__.py
-│   ├── code_controller.py  # 代码执行控制器
-│   └── auth_controller.py  # 认证控制器
-├── main.py                 # 应用入口
-└── requirements.txt        # 依赖管理
-```
-
-### 架构层次
-```
-请求 → 中间件 → 控制器 → 服务层 → 数据库/Redis/外部API
-```
-
-## 🔄 依赖注入详解
-
-### 什么是依赖注入？
-依赖注入（Dependency Injection, DI）是一种设计模式，它将对象的依赖关系从内部创建转移到外部注入，提高代码的可测试性和解耦性。
-
-### 生命周期类型
-
-#### 1. Singleton（单例）
-- **特点**: 整个应用生命周期内只有一个实例
-- **适用场景**: 配置服务、日志服务等无状态服务
-- **注册方式**:
-```python
-container.register_singleton(IConfigService, ConfigService)
-# 或使用工厂方法
-container.register_singleton(IConfigService, factory=lambda: ConfigService(app_config))
-```
-
-#### 2. Transient（瞬态）
-- **特点**: 每次请求都创建新实例
-- **适用场景**: 需要状态隔离的服务
-- **注册方式**:
-```python
-container.register_transient(IMyService, MyService)
-```
-
-#### 3. Scoped（作用域）
-- **特点**: 在单个请求周期内保持单例
-- **适用场景**: Web应用中的请求相关服务
-- **注册方式**:
-```python
-container.register_scoped(ICodeExecutionService, GlotService)
-```
-
-### 如何使用依赖注入
-
-#### 方法1：构造函数注入（推荐）
-```python
-from interfaces.service_interfaces import IConfigService, ILoggerService
-from core.di_container import Injectable
-
-class MyService(Injectable):
-    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
-        self._config = config_service
-        self._logger = logger_service
-    
-    def do_something(self):
-        api_token = self._config.get_api_token()
-        self._logger.info(f"使用token: {api_token[:8]}...")
-```
-
-#### 方法2：运行时注入
-```python
-from core.di_container import inject
-from interfaces.service_interfaces import ICodeExecutionService
-
-def my_function():
-    code_service = inject(ICodeExecutionService)
-    # 使用服务...
-```
-
-## 🛠️ 服务开发
-
-### 步骤1：定义服务接口
-
-在 `interfaces/service_interfaces.py` 中添加新的服务接口：
-
-```python
-class IMyService(ABC):
-    """我的服务接口"""
-    
-    @abstractmethod
-    def process_data(self, data: str) -> str:
-        """处理数据"""
-        pass
-    
-    @abstractmethod
-    def get_status(self) -> bool:
-        """获取服务状态"""
-        pass
-```
-
-### 步骤2：实现服务类
-
-在 `services/` 目录下创建新文件：
-
-```python
-# services/my_service.py
-from typing import Optional
-from interfaces.service_interfaces import IMyService, IConfigService, ILoggerService
-from core.di_container import Injectable
-
-class MyService(IMyService, Injectable):
-    """我的服务实现"""
-    
-    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
-        self._config_service = config_service
-        self._logger_service = logger_service
-    
-    def process_data(self, data: str) -> str:
-        """处理数据"""
-        self._logger_service.info(f"开始处理数据: {data}")
-        
-        # 业务逻辑
-        processed_data = data.upper()
-        
-        self._logger_service.info(f"数据处理完成: {processed_data}")
-        return processed_data
-    
-    def get_status(self) -> bool:
-        """获取服务状态"""
-        try:
-            # 检查配置
-            token = self._config_service.get_api_token()
-            return bool(token)
-        except Exception as ex:
-            self._logger_service.error("获取服务状态失败", ex)
-            return False
-```
-
-### 步骤3：注册服务
-
-在 `core/service_config.py` 中注册新服务：
-
-```python
-from services.my_service import MyService
-from interfaces.service_interfaces import IMyService
-
-def service_configurator(container):
-    # ... 其他服务注册 ...
-    
-    # 注册我的服务
-    container.register_singleton(IMyService, MyService)
-```
-
-### 服务开发最佳实践
-
-1. **接口优先**: 先定义接口，再实现具体类
-2. **单一职责**: 每个服务只负责一个具体功能
-3. **依赖最小化**: 只注入真正需要的依赖
-4. **数据持久化**: 合理使用数据库服务存储业务数据
-5. **缓存策略**: 合理使用 Redis 缓存提高性能
-6. **异常处理**: 在服务层统一处理异常
-7. **日志记录**: 重要操作都要记录日志
-8. **连接管理**: 数据库、Redis 等外部服务的连接状态管理
-
-#### 缓存服务最佳实践
-
-1. **键命名规范**: 使用有意义的键名和命名空间
-   ```python
-   # 好的命名
-   user_cache_key = f"user:profile:{user_id}"
-   rate_limit_key = f"rate_limit:api:{user_id}:{endpoint}"
-   
-   # 避免的命名
-   key = "data123"
-   ```
-
-2. **TTL 设置**: 根据数据特性设置合理的过期时间
-   ```python
-   # 用户会话信息：短时间过期
-   redis_service.set(f"session:{session_id}", session_data, ttl=1800)  # 30分钟
-   
-   # 用户基本信息：较长时间过期
-   redis_service.set(f"user:profile:{user_id}", profile, ttl=3600)  # 1小时
-   
-   # 系统配置：长时间过期
-   redis_service.set("system:config", config_data, ttl=86400)  # 24小时
-   ```
-
-3. **缓存穿透保护**: 使用空值缓存防止缓存穿透
-   ```python
-   def get_user_with_cache(user_id: str):
-       cache_key = f"user:profile:{user_id}"
-       
-       # 尝试从缓存获取
-       user = redis_service.get(cache_key)
-       if user is not None:
-           return user if user != "null" else None
-       
-       # 从数据库获取
-       user = database_service.get_user(user_id)
-       
-       # 缓存结果（包括空值）
-       cache_value = user.to_dict() if user else "null"
-       redis_service.set(cache_key, cache_value, ttl=300)  # 空值缓存5分钟
-       
-       return user
-   ```
-
-4. **批量操作优化**: 使用 Redis 管道或批量操作
-   ```python
-   # 避免循环单个操作
-   for user_id in user_ids:
-       profile = redis_service.get(f"user:profile:{user_id}")
-   
-   # 推荐使用批量操作
-   cache_keys = [f"user:profile:{uid}" for uid in user_ids]
-   profiles = [redis_service.get(key) for key in cache_keys]
-   ```
-
-#### 认证服务最佳实践
-
-1. **令牌安全**: 设置合理的令牌过期时间和强密钥
-2. **刷新策略**: 实现令牌刷新机制，避免频繁重新登录
-3. **权限控制**: 基于角色的访问控制
-4. **会话管理**: 使用 Redis 管理用户会话状态
-
-## 🗄️ 数据库服务使用
-
-### 数据库服务概述
-
-项目使用 PostgreSQL 数据库和 Peewee ORM 框架，采用模块化的数据库服务架构：
-
-- **DatabaseService**: 基础数据库服务，提供通用 CRUD 操作和连接管理
-- **UserService**: 用户相关数据库操作
-- **CodeExecutionService**: 代码执行记录相关操作
-- **APIService**: API 密钥管理相关操作
-
-每个表都有专门的服务类继承自 DatabaseService，实现了更好的解耦和可维护性。数据库配置通过 ConfigService 统一管理，支持环境变量配置。
-
-### 数据库模型设计
-
-#### 基础模型类
-```python
-# models/db_models.py
-from peewee import Model, CharField, TextField, DateTimeField, BooleanField, IntegerField, AutoField
-from datetime import datetime
-
-class BaseModel(Model):
-    """基础模型类"""
-    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
-    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
-    
-    class Meta:
-        database = get_database()
-    
-    def save(self, force_insert=False, only=None):
-        """保存时更新 updated_at 字段"""
-        self.updated_at = datetime.now()
-        return super().save(force_insert, only)
-    
-    def to_dict(self) -> dict:
-        """转换为字典"""
-        data = {}
-        for field_name in self._meta.fields.keys():
-            value = getattr(self, field_name)
-            if isinstance(value, datetime):
-                value = value.isoformat()
-            data[field_name] = value
-        return data
-```
-
-#### 具体模型示例
-```python
-# 用户模型
-class User(BaseModel):
-    """用户模型"""
-    id = AutoField(primary_key=True, verbose_name="用户ID")
-    username = CharField(max_length=50, unique=True, null=False, verbose_name="用户名")
-    email = CharField(max_length=100, unique=True, null=True, verbose_name="邮箱")
-    password_hash = CharField(max_length=255, null=False, verbose_name="密码哈希")
-    is_active = BooleanField(default=True, verbose_name="是否激活")
-    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
-    
-    class Meta:
-        table_name = "users"
-    
-    def to_dict(self) -> dict:
-        """转换为字典，排除敏感信息"""
-        data = super().to_dict()
-        data.pop("password_hash", None)
-        return data
-```
-
-### 数据库服务架构
-
-#### 基础数据库服务 (DatabaseService)
-DatabaseService 提供通用的 CRUD 操作和数据库连接管理：
-
-```python
-# 基础 CRUD 操作
-async def create(self, model_class: type, **kwargs) -> Dict[str, Any]
-async def get_by_id(self, model_class: type, record_id: int) -> Optional[Dict[str, Any]]
-async def update(self, model_class: type, record_id: int, **kwargs) -> bool
-async def delete(self, model_class: type, record_id: int) -> bool
-async def list_all(self, model_class: type, limit: int = 50, offset: int = 0) -> List[Dict[str, Any]]
-async def count(self, model_class: type) -> int
-
-# 数据库管理
-def test_connection() -> bool
-def get_database_info() -> Dict[str, Any]
-def close()
-```
-
-#### 专门服务类继承 DatabaseService
-
-##### UserService - 用户服务
-```python
-from services.user_service import UserService
-from core.di_container import inject
-
-# 使用用户服务
-user_service = inject(UserService)
-
-# 创建用户
-user = await user_service.create_user("username", "password_hash", "email@example.com")
-
-# 根据用户名获取用户
-user = await user_service.get_user_by_username("username")
-
-# 更新用户最后登录时间
-await user_service.update_user_last_login(user_id)
-
-# 获取用户列表
-users = await user_service.list_users(limit=20, active_only=True)
-
-# 搜索用户
-results = await user_service.search_users("john")
-```
-
-#### 运行时注入方式
-```python
-from core.di_container import inject
-from services.user_service import UserService
-from services.code_execution_service import CodeExecutionService
-
-async def analyze_user_activity(user_id: int):
-    """分析用户活动"""
-    user_service = inject(UserService)
-    exec_service = inject(CodeExecutionService)
-    
-    # 获取用户信息
-    user = await user_service.get_user_by_id(user_id)
-    if not user:
-        return {"error": "用户不存在"}
-    
-    # 获取执行统计信息
-    stats = await exec_service.get_execution_statistics(user_id)
-    
-    return {
-        "user": user,
-        "statistics": stats,
-        "total_executions": stats["total_executions"],
-        "success_rate": stats["success_rate"],
-        "favorite_languages": stats["language_distribution"]
-    }
-```
-
-### 创建新的数据库服务
-
-#### 步骤1：创建服务类
-```python
-# services/my_table_service.py
-from datetime import datetime
-from typing import List, Optional, Dict, Any
-
-from services.database_service import DatabaseService
-from models.db_models import MyModel
-from core.di_container import Injectable
-
-class MyTableService(DatabaseService, Injectable):
-    """我的表服务类"""
-    
-    async def create_my_record(self, name: str, value: str) -> Dict[str, Any]:
-        """创建记录"""
-        try:
-            record_data = await self.create(
-                MyModel,
-                name=name,
-                value=value,
-                is_active=True
-            )
-            return record_data
-        except Exception as e:
-            raise RuntimeError(f"创建记录时发生错误: {e}")
-    
-    async def get_by_name(self, name: str) -> Optional[Dict[str, Any]]:
-        """根据名称获取记录"""
-        try:
-            record = MyModel.get(MyModel.name == name)
-            return record.to_dict()
-        except DoesNotExist:
-            return None
-        except Exception as e:
-            raise RuntimeError(f"获取记录时发生错误: {e}")
-    
-    async def list_active_records(self, limit: int = 50) -> List[Dict[str, Any]]:
-        """获取活跃记录列表"""
-        try:
-            query = (MyModel
-                    .select()
-                    .where(MyModel.is_active == True)
-                    .order_by(MyModel.created_at.desc())
-                    .limit(limit))
-            
-            return [record.to_dict() for record in query]
-        except Exception as e:
-            raise RuntimeError(f"获取活跃记录时发生错误: {e}")
-    
-    async def deactivate_record(self, record_id: int) -> bool:
-        """停用记录"""
-        return await self.update(MyModel, record_id, is_active=False)
-    
-    async def get_statistics(self) -> Dict[str, Any]:
-        """获取统计信息"""
-        try:
-            total_records = MyModel.select().count()
-            active_records = MyModel.select().where(MyModel.is_active == True).count()
-            
-            return {
-                "total_records": total_records,
-                "active_records": active_records,
-                "inactive_records": total_records - active_records,
-                "active_rate": active_records / total_records if total_records > 0 else 0
-            }
-        except Exception as e:
-            raise RuntimeError(f"获取统计信息时发生错误: {e}")
-```
-
-#### 步骤2：注册服务
-```python
-# core/service_config.py
-def create_my_table_service():
-    config_service = container.resolve(IConfigService)
-    return MyTableService(config_service)
-
-def service_configurator(container):
-    # ... 其他服务注册 ...
-    container.register_singleton(MyTableService, factory=create_my_table_service)
-```
-
-#### 步骤3：使用服务
-```python
-from services.my_table_service import MyTableService
-
-my_service = inject(MyTableService)
-
-# 创建记录
-record = await my_service.create_my_record("test", "value")
-
-# 获取记录
-record = await my_service.get_by_name("test")
-
-# 获取统计信息
-stats = await my_service.get_statistics()
-```
-
-### 数据库配置和环境变量
-
-#### 环境变量配置
-```bash
-# 数据库配置（在 main.py 中读取）
-DB_HOST=localhost
-DB_PORT=5432
-DB_NAME=letcoding
-DB_USER=postgres
-DB_PASSWORD=your_password
-DB_MAX_CONNECTIONS=20
-DB_STALE_TIMEOUT=300
-```
-
-#### 配置服务使用
-```python
-# 在服务中获取数据库配置
-from interfaces.service_interfaces import IConfigService
-
-class MyService(Injectable):
-    def __init__(self, config_service: IConfigService):
-        self._config = config_service
-    
-    def get_database_info(self):
-        """获取数据库配置信息"""
-        db_config = self._config.get_database_config()
-        database_url = self._config.get_database_url()
-        
-        return {
-            "config": db_config,
-            "connection_url": database_url.replace(db_config["password"], "***")
-        }
-```
-
-### 数据库连接管理
-
-#### 连接状态检查
-```python
-class DatabaseHealthService(Injectable):
-    def __init__(self, database_service: DatabaseService):
-        self._db = database_service
-    
-    def check_database_health(self):
-        """检查数据库健康状态"""
-        is_connected = self._db.test_connection()
-        db_info = self._db.get_database_info()
-        
-        return {
-            "status": "healthy" if is_connected else "unhealthy",
-            "connection_details": db_info,
-            "timestamp": datetime.now().isoformat()
-        }
-```
-
-#### 连接池配置
-```python
-# 数据库服务自动管理连接池
-# 通过环境变量配置：
-# DB_MAX_CONNECTIONS=20  # 最大连接数
-# DB_STALE_TIMEOUT=300    # 连接超时时间
-```
-
-### 数据库迁移和表管理
-
-#### 创建表
-```python
-# 在应用启动时或部署脚本中
-from models.db_models import create_tables
-
-def initialize_database():
-    """初始化数据库表"""
-    try:
-        create_tables()
-        print("数据库表创建成功")
-    except Exception as e:
-        print(f"创建表失败: {e}")
-
-# 在 main.py 中调用
-if __name__ == '__main__':
-    initialize_database()
-    app.run(debug=True, host='0.0.0.0', port=6173)
-```
-
-#### 删除表（开发环境）
-```python
-from models.db_models import drop_tables
-
-def cleanup_database():
-    """清理数据库表（仅开发环境）"""
-    if os.getenv('ENVIRONMENT') == 'development':
-        drop_tables()
-        print("开发环境：数据库表已删除")
-```
-
-### 数据库操作最佳实践
-
-#### 1. 异常处理
-```python
-async def safe_user_creation(username: str, email: str, password_hash: str):
-    """安全的用户创建操作"""
-    try:
-        user = await self._db.create_user(username, email, password_hash)
-        return {"success": True, "user": user}
-    except ValueError as e:
-        # 业务逻辑错误
-        return {"success": False, "error": str(e)}
-    except RuntimeError as e:
-        # 数据库运行时错误
-        logger.error(f"数据库错误: {e}")
-        return {"success": False, "error": "服务器内部错误"}
-    except Exception as e:
-        # 未预期错误
-        logger.error(f"未预期错误: {e}")
-        return {"success": False, "error": "系统异常"}
-```
-
-#### 2. 事务处理
-```python
-# DatabaseService 内部自动处理事务
-# 使用 with database.atomic(): 确保操作原子性
-```
-
-#### 3. 数据验证
-```python
-async def create_user_with_validation(username: str, email: str, password_hash: str):
-    """带验证的用户创建"""
-    # 输入验证
-    if not username or len(username) < 3:
-        raise ValueError("用户名长度至少3个字符")
-    
-    if not email or "@" not in email:
-        raise ValueError("邮箱格式无效")
-    
-    if not password_hash or len(password_hash) < 8:
-        raise ValueError("密码哈希无效")
-    
-    # 调用数据库服务
-    return await self._db.create_user(username, email, password_hash)
-```
-
-#### 4. 分页查询
-```python
-async def get_user_executions_paginated(user_id: int, page: int = 1, page_size: int = 20):
-    """分页获取用户执行记录"""
-    offset = (page - 1) * page_size
-    
-    executions = await self._db.get_user_executions(
-        user_id=user_id,
-        limit=page_size,
-        offset=offset
-    )
-    
-    return {
-        "executions": executions,
-        "page": page,
-        "page_size": page_size,
-        "has_more": len(executions) == page_size
-    }
-```
-
-### 性能优化建议
-
-#### 1. 索引优化
-```python
-# 在模型中定义索引
-class User(BaseModel):
-    username = CharField(max_length=50, unique=True, index=True)
-    email = CharField(max_length=100, unique=True, index=True)
-    created_at = DateTimeField(index=True)  # 用于时间范围查询
-```
-
-#### 2. 查询优化
-```python
-# 使用 select_related 避免N+1查询
-executions = (CodeExecution
-             .select(CodeExecution, User)
-             .join(User)
-             .where(User.id == user_id))
-
-# 使用只查询需要的字段
-users = User.select(User.id, User.username, User.email)
-```
-
-#### 3. 批量操作
-```python
-# 批量插入
-with database.atomic():
-    for i in range(1000):
-        User.create(username=f"user_{i}", email=f"user_{i}@example.com")
-```
-
-## 🔄 Redis 缓存服务使用
-
-### Redis 服务概述
-
-项目中使用独立的 Redis 服务来处理所有缓存需求，包括用户信息缓存、JWT 令牌管理、速率限制等。
-
-### 基本使用方法
-
-#### 依赖注入方式
-```python
-from interfaces.service_interfaces import IRedisService
-from core.di_container import Injectable
-
-class MyService(Injectable):
-    def __init__(self, redis_service: IRedisService):
-        self._redis = redis_service
-    
-    def cache_data(self, key: str, value: dict):
-        # 设置缓存，1小时过期
-        self._redis.set(key, value, ttl=3600)
-    
-    def get_cached_data(self, key: str):
-        return self._redis.get(key)
-```
-
-#### 运行时注入方式
-```python
-from core.di_container import inject
-from interfaces.service_interfaces import IRedisService
-
-def my_function():
-    redis_service = inject(IRedisService)
-    
-    # 检查连接状态
-    if not redis_service.is_connected():
-        redis_service.reconnect()
-    
-    # 使用缓存
-    result = redis_service.get('my_key', default='default_value')
-    return result
-```
-
-### 常用操作示例
-
-#### 1. 基本键值操作
-```python
-# 设置字符串值（自动JSON序列化）
-redis_service.set('user:123', {
-    'id': 123,
-    'name': '张三',
-    'email': 'zhangsan@example.com'
-}, ttl=3600)
-
-# 获取值（自动JSON反序列化）
-user_data = redis_service.get('user:123')
-
-# 删除键
-redis_service.delete('user:123')
-
-# 检查键是否存在
-if redis_service.exists('user:123'):
-    print('用户数据存在')
-```
-
-#### 2. 计数器操作
-```python
-# 递增计数器（用户访问次数）
-visit_count = redis_service.increment(f'visits:user:{user_id}')
-print(f'用户 {user_id} 访问了 {visit_count} 次')
-
-# 递减计数器
-remaining_requests = redis_service.decrement(f'rate_limit:user:{user_id}')
-```
-
-#### 3. 集合操作
-```python
-# 添加用户到白名单
-redis_service.set_add('whitelist', 'user_123', 'user_456')
-
-# 检查用户是否在白名单中
-if redis_service.set_is_member('whitelist', 'user_123'):
-    print('用户在白名单中')
-
-# 获取所有白名单用户
-whitelist_users = redis_service.set_members('whitelist')
-
-# 从白名单移除用户
-redis_service.set_remove('whitelist', 'user_123')
-```
-
-#### 4. 列表操作
-```python
-# 添加日志到队列
-redis_service.list_push('logs', {
-    'timestamp': '2024-01-01T10:00:00',
-    'level': 'INFO',
-    'message': '用户登录'
-})
-
-# 获取最近的日志（FIFO）
-recent_log = redis_service.list_pop('logs')
-
-# 获取队列长度
-log_count = redis_service.list_length('logs')
-
-# 获取指定范围的日志
-all_logs = redis_service.list_range('logs', 0, -1)
-```
-
-#### 5. TTL 管理
-```python
-# 设置键的过期时间
-redis_service.expire('user:123', 1800)  # 30分钟后过期
-
-# 检查键的剩余生存时间
-remaining_seconds = redis_service.ttl('user:123')
-if remaining_seconds > 0:
-    print(f'键将在 {remaining_seconds} 秒后过期')
-elif remaining_seconds == -1:
-    print('键永不过期')
-else:
-    print('键不存在')
-```
-
-### 缓存设计模式
-
-#### 1. Cache-Aside 模式
-```python
-def get_user_profile(user_id: str):
-    cache_key = f'user_profile:{user_id}'
-    
-    # 先从缓存获取
-    profile = redis_service.get(cache_key)
-    if profile:
-        return profile
-    
-    # 缓存未命中，从数据库获取
-    profile = database_service.get_user_profile(user_id)
-    
-    # 写入缓存
-    if profile:
-        redis_service.set(cache_key, profile, ttl=3600)
-    
-    return profile
-```
-
-#### 2. Write-Through 模式
-```python
-def update_user_profile(user_id: str, profile_data: dict):
-    # 更新数据库
-    database_service.update_user_profile(user_id, profile_data)
-    
-    # 同时更新缓存
-    cache_key = f'user_profile:{user_id}'
-    redis_service.set(cache_key, profile_data, ttl=3600)
-```
-
-#### 3. 分布式锁
-```python
-def with_lock(lock_key: str, expire_time: int = 10):
-    """分布式锁装饰器"""
-    def decorator(func):
-        def wrapper(*args, **kwargs):
-            # 尝试获取锁
-            lock_acquired = redis_service.set(
-                lock_key, 
-                'locked', 
-                ttl=expire_time
-            )
-            
-            if not lock_acquired:
-                raise Exception('无法获取锁，请稍后重试')
-            
-            try:
-                return func(*args, **kwargs)
-            finally:
-                # 释放锁
-                redis_service.delete(lock_key)
-        
-        return wrapper
-    return decorator
-
-# 使用示例
-@with_lock('user_update:123')
-def update_user_data():
-    # 执行需要加锁的操作
-    pass
-```
-
-### 错误处理和重连
-
-```python
-class RobustCacheService:
-    def __init__(self, redis_service: IRedisService):
-        self._redis = redis_service
-    
-    def safe_get(self, key: str, default=None):
-        """安全的获取操作，包含重连逻辑"""
-        try:
-            result = self._redis.get(key, default)
-            return result
-        except Exception as ex:
-            logger.error(f"Redis 获取失败: {key}", ex)
-            
-            # 尝试重连
-            if self._redis.reconnect():
-                return self._redis.get(key, default)
-            
-            return default
-    
-    def safe_set(self, key: str, value, ttl=None):
-        """安全的设置操作"""
-        try:
-            return self._redis.set(key, value, ttl)
-        except Exception as ex:
-            logger.error(f"Redis 设置失败: {key}", ex)
-            return False
-```
-
-### Redis 配置和监控
-
-#### 环境变量配置
-```bash
-# Redis 基本配置
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_DB=0
-REDIS_PASSWORD=your_redis_password
-REDIS_TIMEOUT=5  # 连接超时时间
-```
-
-#### 连接状态监控
-```python
-# 获取 Redis 服务器信息
-redis_info = redis_service.info()
-if redis_info:
-    print(f"Redis 版本: {redis_info.get('redis_version')}")
-    print(f"已用内存: {redis_info.get('used_memory_human')}")
-
-# 检查连接状态
-if redis_service.is_connected():
-    print("Redis 连接正常")
-else:
-    print("Redis 连接断开，尝试重连...")
-    redis_service.reconnect()
-```
-
-## 🔐 认证和授权开发
-
-### 认证架构概述
-
-项目实现了基于 OIDC 的第三方认证和 JWT 令牌认证系统，支持 GitHub OAuth 和自定义 OIDC 提供商。
-
-### JWT 服务使用
-
-#### 生成和验证令牌
-```python
-from services.jwt_service import JWTService
-from models.auth_models import UserInfo
-
-# 在服务中使用 JWT
-class MyProtectedService(Injectable):
-    def __init__(self, jwt_service: JWTService, redis_service: IRedisService):
-        self._jwt = jwt_service
-        self._redis = redis_service
-    
-    def authenticate_user(self, user_info: dict):
-        """生成 JWT 令牌"""
-        # 创建用户信息对象
-        user = UserInfo(
-            id=user_info['id'],
-            username=user_info['username'],
-            email=user_info['email'],
-            provider=user_info['provider']
-        )
-        
-        # 生成令牌
-        tokens = self._jwt.generate_tokens(user.to_dict())
-        return tokens.to_dict()
-    
-    def verify_token(self, token: str):
-        """验证 JWT 令牌"""
-        user_info = self._jwt.verify_access_token(token)
-        return user_info
-    
-    def refresh_token(self, refresh_token: str):
-        """刷新访问令牌"""
-        new_tokens = self._jwt.refresh_access_token(refresh_token)
-        return new_tokens.to_dict() if new_tokens else None
-```
-
-### 认证中间件使用
-
-#### 在控制器中使用认证
-```python
-from flask import g
-from middleware.auth_middleware import AuthMiddleware
-
-@api.route('/protected')
-class ProtectedController(Resource):
-    @AuthMiddleware.require_auth
-    def get(self):
-        """需要认证的接口"""
-        # 从 g 对象获取当前用户信息
-        current_user = getattr(g, 'current_user', None)
-        
-        return {
-            'message': f'你好，{current_user["username"]}!',
-            'user_id': current_user['id']
-        }
-
-@api.route('/optional')
-class OptionalAuthController(Resource):
-    @AuthMiddleware.optional_auth
-    def get(self):
-        """可选认证的接口"""
-        current_user = getattr(g, 'current_user', None)
-        
-        if current_user:
-            return {'message': f'已登录用户：{current_user["username"]}'}
-        else:
-            return {'message': '游客访问'}
-
-@api.route('/admin')
-class AdminController(Resource):
-    @AuthMiddleware.require_auth
-    @AuthMiddleware.require_admin
-    def get(self):
-        """需要管理员权限的接口"""
-        return {'message': '管理员专用接口'}
-```
-
-#### 速率限制中间件
-```python
-@api.route('/rate-limited')
-class RateLimitedController(Resource):
-    @AuthMiddleware.require_auth
-    @AuthMiddleware.rate_limit(max_requests=100, window_seconds=3600)
-    def post(self):
-        """带速率限制的接口"""
-        return {'message': '请求成功'}
-```
-
-### OIDC 服务集成
-
-#### 支持的认证提供商
-```python
-from services.oidc_service import OIDCService
-
-class MyAuthService(Injectable):
-    def __init__(self, oidc_service: OIDCService):
-        self._oidc = oidc_service
-    
-    def get_supported_providers(self):
-        """获取支持的认证提供商"""
-        return self._oidc.get_supported_providers()
-    
-    def initiate_oauth(self, provider: str, redirect_uri: str):
-        """开始 OAuth 认证流程"""
-        if not self._oidc.validate_provider(provider):
-            raise ValueError(f'不支持的提供商: {provider}')
-        
-        auth_url = self._oidc.get_authorization_url(provider, redirect_uri)
-        return auth_url
-    
-    def handle_callback(self, provider: str, code: str):
-        """处理 OAuth 回调"""
-        auth_result = self._oidc.authorize_callback(provider)
-        
-        if not auth_result:
-            raise Exception('认证失败')
-        
-        return auth_result['user_info']
-```
-
-### 用户信息管理
-
-#### 数据模型使用
-```python
-from models.auth_models import UserInfo, TokenResponse
-
-# 创建用户信息
-user = UserInfo(
-    id='github_123456',
-    username='john_doe',
-    email='john@example.com',
-    name='John Doe',
-    avatar_url='https://avatars.githubusercontent.com/u/123456',
-    provider='github'
-)
-
-# 转换为字典
-user_dict = user.to_dict()
-
-# 创建令牌响应
-tokens = TokenResponse(
-    access_token='eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...',
-    refresh_token='eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...',
-    expires_in=3600,
-    user_info=user
-)
-```
-
-## 🎮 控制器编写
-
-### 控制器基本结构
-
-```python
-# controllers/my_controller.py
-from flask import request
-from flask_restx import Resource, Namespace, fields
-from core.di_container import inject
-from interfaces.service_interfaces import IMyService
-
-# 创建命名空间
-api = Namespace('my_module', description='我的模块相关操作')
-
-# 定义请求模型
-request_model = api.model('MyRequest', {
-    'data': fields.String(required=True, description='要处理的数据'),
-})
-
-# 定义响应模型
-response_model = api.model('MyResponse', {
-    'result': fields.String(description='处理结果'),
-    'success': fields.Boolean(description='是否成功'),
-})
-
-@api.route('/process')
-class MyController(Resource):
-    @api.expect(request_model)
-    @api.doc('process_data')
-    @api.response(200, 'Success', response_model)
-    @api.response(400, 'Bad Request')
-    def post(self):
-        """处理数据"""
-        # 注入服务
-        my_service = inject(IMyService)
-        
-        # 获取请求数据
-        data = request.get_json()
-        if not data:
-            return {'error': '请求体不能为空'}, 400
-        
-        input_data = data.get('data', '')
-        if not input_data:
-            return {'error': 'data参数不能为空'}, 400
-        
-        try:
-            # 调用服务
-            result = my_service.process_data(input_data)
-            
-            return {
-                'result': result,
-                'success': True
-            }, 200
-            
-        except Exception as ex:
-            return {
-                'error': f'处理失败: {str(ex)}',
-                'success': False
-            }, 500
-
-@api.route('/status')
-class StatusController(Resource):
-    @api.doc('get_service_status')
-    @api.response(200, 'Success')
-    def get(self):
-        """获取服务状态"""
-        my_service = inject(IMyService)
-        status = my_service.get_status()
-        
-        return {
-            'status': 'healthy' if status else 'unhealthy',
-            'timestamp': datetime.now().isoformat()
-        }, 200
-```
-
-### 控制器编写要点
-
-1. **依赖注入**: 使用 `inject()` 函数获取服务
-2. **参数验证**: 始终验证输入参数
-3. **错误处理**: 统一的错误响应格式
-4. **API文档**: 使用 flask-restx 的装饰器
-5. **HTTP状态码**: 返回正确的状态码
-
-## 🛣️ 路由注册
-
-### 步骤1：在控制器中定义命名空间
-
-```python
-# 在控制器文件顶部
-from flask_restx import Namespace
-
-api = Namespace('module_name', description='模块描述')
-```
-
-### 步骤2：在主应用中注册
-
-```python
-# 在 main.py 中
-from controllers.my_controller import api as my_api
-
-# 注册命名空间
-api.add_namespace(my_api, path='/my-module')
-```
-
-### 路由设计原则
-
-1. **RESTful风格**: 使用标准HTTP方法
-2. **资源导向**: URL应该表示资源
-3. **版本控制**: 可考虑添加版本前缀
-4. **清晰简洁**: 避免过深的路径嵌套
-
-## 🚀 完整开发流程示例
-
-### 需求：添加一个用户信息服务
-
-#### 1. 定义接口
-```python
-# interfaces/service_interfaces.py 添加
-@dataclass
-class UserProfile:
-    id: int
-    name: str
-    email: str
-
-class IUserService(ABC):
-    @abstractmethod
-    def get_user(self, user_id: int) -> Optional[UserProfile]:
-        pass
-    
-    @abstractmethod
-    def create_user(self, name: str, email: str) -> UserProfile:
-        pass
-```
-
-#### 2. 实现服务
-```python
-# services/user_service.py
-from typing import Optional, Dict
-from interfaces.service_interfaces import IUserService, UserProfile
-from core.di_container import Injectable
-
-class UserService(IUserService, Injectable):
-    def __init__(self, logger_service):
-        self._logger = logger_service
-        self._users: Dict[int, UserProfile] = {}
-        self._next_id = 1
-    
-    def get_user(self, user_id: int) -> Optional[UserProfile]:
-        return self._users.get(user_id)
-    
-    def create_user(self, name: str, email: str) -> UserProfile:
-        user = UserProfile(
-            id=self._next_id,
-            name=name,
-            email=email
-        )
-        self._users[self._next_id] = user
-        self._next_id += 1
-        
-        self._logger.info(f"创建用户: {user}")
-        return user
-```
-
-#### 3. 注册服务
-```python
-# core/service_config.py
-from services.user_service import UserService
-from interfaces.service_interfaces import IUserService
-
-def service_configurator(container):
-    # ... 其他注册 ...
-    container.register_singleton(IUserService, UserService)
-```
-
-#### 4. 创建控制器
-```python
-# controllers/user_controller.py
-from flask import request
-from flask_restx import Resource, Namespace, fields
-from core.di_container import inject
-from interfaces.service_interfaces import IUserService
-
-api = Namespace('users', description='用户管理')
-
-user_model = api.model('User', {
-    'name': fields.String(required=True, description='用户名'),
-    'email': fields.String(required=True, description='邮箱'),
-})
-
-@api.route('')
-class UserController(Resource):
-    @api.expect(user_model)
-    def post(self):
-        """创建用户"""
-        user_service = inject(IUserService)
-        data = request.get_json()
-        
-        user = user_service.create_user(data['name'], data['email'])
-        return user.__dict__, 201
-
-@api.route('/<int:user_id>')
-class UserDetailController(Resource):
-    def get(self, user_id):
-        """获取用户详情"""
-        user_service = inject(IUserService)
-        user = user_service.get_user(user_id)
-        
-        if not user:
-            return {'error': '用户不存在'}, 404
-        
-        return user.__dict__
-```
-
-#### 5. 注册路由
-```python
-# main.py 添加
-from controllers.user_controller import api as user_api
-
-api.add_namespace(user_api, path='/api/v1/users')
-```
-
-## ❓ 常见问题和最佳实践
-
-### 常见问题
-
-#### Q: 如何选择服务的生命周期？
-**A**: 
-- 配置服务、日志服务、Redis服务 → Singleton
-- 数据库上下文、请求会话 → Scoped  
-- 临时计算服务 → Transient
-
-#### Q: 如何处理循环依赖？
-**A**: 
-- 重新设计服务职责，避免循环依赖
-- 使用事件驱动模式
-- 提取共同依赖到第三方服务
-
-#### Q: Redis 连接失败怎么办？
-**A**: 
-- Redis 服务内置了自动重连机制
-- 使用 `redis_service.is_connected()` 检查连接状态
-- 使用 `redis_service.reconnect()` 手动重连
-- 对于非关键缓存，考虑降级处理
-
-#### Q: 如何处理 Redis 中的敏感数据？
-**A**: 
-- 对敏感数据进行加密后再存储
-- 使用合适的键命名避免敏感信息泄露
-- 设置适当的 TTL 确保数据及时过期
-- 定期清理不再需要的数据
-
-#### Q: 数据库连接失败怎么办？
-**A**: 
-- DatabaseService 内置了连接检查机制
-- 使用 `database_service.test_connection()` 测试连接
-- 检查数据库配置是否正确（环境变量）
-- 确保数据库服务正在运行
-- 查看数据库日志排查问题
-
-#### Q: 如何进行数据库迁移？
-**A**: 
-- 使用 Peewee 的 `pwiz` 工具生成迁移脚本
-- 在开发环境中谨慎使用 `drop_tables()`
-- 生产环境建议使用专业的数据库迁移工具
-- 备份重要数据后再执行迁移操作
-
-#### Q: 如何创建新的数据库服务？
-**A**: 
-- 创建新的服务类继承 DatabaseService 和 Injectable
-- 实现特定表的业务逻辑方法
-- 在 service_config.py 中注册新服务
-- 使用依赖注入获取服务实例
-
-#### Q: 数据库服务之间如何协作？
-**A**: 
-- 通过依赖注入获取其他服务实例
-- 使用统一的事务管理
-- 避免循环依赖，必要时通过事件或共享服务解耦
-- 利用 DatabaseService 提供的基础 CRUD 操作
-
-#### Q: 如何处理数据库中的敏感信息？
-**A**: 
-- 密码等敏感字段使用哈希存储
-- 在 `to_dict()` 方法中排除敏感字段
-- 数据库连接字符串中的密码使用环境变量
-- 限制数据库访问权限，使用最小权限原则
-
-#### Q: 数据库性能优化有哪些方法？
-**A**: 
-- 为经常查询的字段添加索引
-- 使用 `select_related()` 避免N+1查询
-- 合理使用分页查询
-- 考虑使用数据库连接池
-- 定期分析和优化慢查询
-- 使用专门的表服务减少不必要的字段查询
-- 在服务层实现查询优化和缓存策略
-
-#### Q: 模块化数据库服务有什么优势？
-**A**: 
-- **单一职责**: 每个服务专注于一个表的业务逻辑
-- **易于维护**: 修改某个表的业务逻辑不会影响其他服务
-- **便于测试**: 可以独立测试每个服务
-- **代码复用**: DatabaseService 提供通用 CRUD 操作
-- **团队协作**: 不同开发者可以并行开发不同的表服务
-- **扩展性**: 新增表只需创建对应的服务类
-
-#### Q: JWT 令牌被盗用怎么办？
-**A**: 
-- 实现令牌黑名单机制（项目中已实现）
-- 使用较短的访问令牌过期时间
-- 监控异常的令牌使用模式
-- 支持强制用户重新登录
-
-#### Q: 如何进行单元测试？
-**A**: 
-```python
-# 测试 Redis 服务
-def test_my_service_with_redis():
-    # 创建模拟 Redis 服务
-    mock_redis = Mock(spec=IRedisService)
-    mock_redis.get.return_value = "cached_value"
-    
-    # 创建测试服务
-    service = MyService(mock_redis, mock_config, mock_logger)
-    
-    # 测试方法
-    result = service.get_cached_data("test_key")
-    
-    # 验证调用
-    mock_redis.get.assert_called_once_with("test_key")
-    assert result == "cached_value"
-
-# 集成测试使用真实 Redis
-def test_integration_with_redis():
-    # 使用测试 Redis 数据库
-    redis_service = RedisService(test_config, test_logger)
-    redis_service.flushdb()  # 清空测试数据库
-    
-    # 测试缓存操作
-    redis_service.set("test_key", "test_value", ttl=60)
-    result = redis_service.get("test_key")
-    
-    assert result == "test_value"
-```
-
-### 最佳实践
-
-1. **命名规范**
-   - 接口: `IServiceName`
-   - 实现: `ServiceName`
-   - 控制器: `ServiceNameController`
-   
-2. **模块组织**
-   - 抽象接口放在 `interfaces/` 目录
-   - 数据模型放在 `models/` 目录
-   - 服务实现放在 `services/` 目录
-   - 控制器放在 `controllers/` 目录
-   - 数据库模型继承 BaseModel，使用 Peewee ORM 规范
-
-2. **错误处理**
-   ```python
-   try:
-       result = service.process(data)
-       return {'success': True, 'data': result}
-   except BusinessException as ex:
-       return {'error': str(ex)}, 400
-   except Exception as ex:
-       logger.error("未预期错误", ex)
-       return {'error': '内部服务器错误'}, 500
-   ```
-
-3. **配置管理**
-   ```python
-   # 使用配置服务而不是直接访问环境变量
-   timeout = config_service.get_config('TIMEOUT', 30)
-   ```
-
-4. **日志记录**
-   ```python
-   # 在关键操作前后记录日志
-   logger.info("开始处理请求")
-   try:
-       result = service.process()
-       logger.info(f"处理成功: {result}")
-       return result
-   except Exception as ex:
-       logger.error("处理失败", ex)
-       raise
-   ```
-
-5. **数据库设计**
-   ```python
-   # 使用 BaseModel 提供统一的基础字段
-   # 在 to_dict() 中排除敏感信息
-   # 为经常查询的字段添加索引
-   # 使用合适的字段类型和约束
-   # 为每个表创建专门的服务类继承 DatabaseService
-   # 在服务层实现业务逻辑，保持模型类简洁
-   ```
-
-6. **API设计**
-   - 使用复数名词表示资源集合
-   - 使用HTTP状态码表示操作结果
-   - 提供清晰的错误信息
-
-## 📝 总结
-
-通过本教程，你应该掌握了：
-- 依赖注入的概念和使用方法
-- 服务开发的完整流程
-- 数据库服务的设计和使用
-- Redis 缓存服务的使用和最佳实践
-- 认证和授权系统的开发
-- 控制器的编写规范
-- 路由注册的方式
-
-### 🎯 下一步学习建议
-
-1. **实践项目**: 尝试添加一个新的业务模块，完整地走一遍开发流程
-2. **数据库进阶**: 学习数据库高级特性，如事务处理、索引优化、分表分库等
-3. **性能优化**: 学习 Redis 高级特性，如管道、发布订阅等
-4. **安全加固**: 了解更多认证安全知识，如 CSRF 防护、令牌刷新策略、数据库安全
-5. **监控部署**: 学习如何监控数据库、Redis 和应用的性能指标
-6. **测试完善**: 为现有代码编写完整的单元测试和集成测试
-
-记住，好的代码架构需要持续的实践和改进。建议从小功能开始练习，逐步掌握这些概念。
-
-祝你编码愉快！🎉
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/README.md b/webapi/fastapi_of_letcoing/README.md
deleted file mode 100644
index de08800..0000000
--- a/webapi/fastapi_of_letcoing/README.md
+++ /dev/null
@@ -1,455 +0,0 @@
-# 代码运行 API 服务
-
-## 介绍
-
-这是一个基于 Flask + Flask-RESTX 框架开发的代码运行 API 服务，通过调用 Glot API 实现多种编程语言的代码在线执行功能。该服务采用分层架构设计，具有完整的 API 文档和 Swagger UI，为前端应用提供了稳定、高效的代码运行支持。
-
-## 功能特点
-
-- **多语言支持**: 支持 30+ 种编程语言，包括 Python、JavaScript、Java、C++ 等
-- **用户认证**: 支持第三方 OIDC 登录（GitHub、自定义 OIDC 提供商）
-- **JWT 鉴权**: 基于 JWT 的令牌认证和 Redis 缓存支持
-- **API 文档生成**: 集成 Flask-RESTX，自动生成 Swagger 文档和交互式 UI
-- **异步执行**: 使用 aiohttp 实现异步 HTTP 请求，提高并发处理能力
-- **分层架构**: 控制器和服务层分离，提高代码可维护性
-- **数据模型化**: 使用 dataclass 定义清晰的数据模型，提供 API 参数验证
-- **错误处理**: 完善的错误处理机制，返回友好的错误信息
-- **安全设计**: 实现了基本的输出转义，防止注入攻击
-- **速率限制**: 基于用户的请求速率限制功能
-- **环境配置**: 支持通过环境变量设置 API Token 和认证配置
-
-## 技术栈
-
-- **框架**: Flask 3.1.2
-- **API 文档**: Flask-RESTX 1.3.2
-- **异步支持**: aiohttp 3.13.2
-- **数据处理**: Python 内置 dataclass
-- **HTTP 客户端**: requests 2.32.5
-- **认证授权**: Authlib 1.3.1, PyJWT 2.9.0
-- **缓存**: Redis 5.2.1
-- **外部服务**: Glot API (https://glot.io/)
-
-## 支持的编程语言
-
-| 语言 | 关键字 | 语言 | 关键字 | 语言 | 关键字 |
-|------|--------|------|--------|------|--------|
-| Assembly | assembly | C | c | C++ | cpp |
-| C# | csharp | Clojure | clojure | CoffeeScript | coffeescript |
-| Crystal | crystal | D | d | Elixir | elixir |
-| Elm | elm | Erlang | erlang | F# | fsharp |
-| Go | go | Groovy | groovy | Hare | hare |
-| Haskell | haskell | Idris | idris | Java | java |
-| JavaScript | javascript | Julia | julia | Kotlin | kotlin |
-| Lua | lua | Mercury | mercury | Nim | nim |
-| Nix | nix | OCaml | ocaml | Perl | perl |
-| PHP | php | Python | python | Raku | raku |
-| Ruby | ruby | Rust | rust | Scala | scala |
-| Swift | swift | TypeScript | typescript | Zig | zig |
-
-## 快速开始
-
-### 1. 安装依赖
-
-```bash
-pip install -r requirements.txt
-```
-
-### 2. 配置环境变量
-
-#### 基本配置
-
-```bash
-# Glot API Token（必需）
-export API_TOKEN=your_glot_api_token
-
-# JWT 配置（推荐设置）
-export JWT_SECRET_KEY=your-very-secure-secret-key-here
-export JWT_ACCESS_TOKEN_EXPIRE=3600  # 1小时
-export JWT_REFRESH_TOKEN_EXPIRE=604800  # 7天
-
-# Redis 配置（推荐用于生产环境）
-export REDIS_HOST=localhost
-export REDIS_PORT=6379
-export REDIS_DB=0
-export REDIS_PASSWORD=your-redis-password
-export REDIS_TIMEOUT=5
-```
-
-#### OAuth 认证配置
-
-```bash
-# GitHub OAuth
-export GITHUB_CLIENT_ID=your_github_client_id
-export GITHUB_CLIENT_SECRET=your_github_client_secret
-
-# 自定义 OIDC 提供商（JSON格式）
-export OIDC_PROVIDERS='{
-  "my_provider": {
-    "client_id": "your_client_id",
-    "client_secret": "your_client_secret",
-    "server_metadata_url": "https://your-provider.com/.well-known/openid-configuration"
-  }
-}'
-```
-
-#### 配置文件方式
-
-在项目根目录创建 `.env` 文件：
-
-```
-API_TOKEN=your_glot_api_token
-JWT_SECRET_KEY=your-very-secure-secret-key-here
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=your-redis-password
-REDIS_TIMEOUT=5
-GITHUB_CLIENT_ID=your_github_client_id
-GITHUB_CLIENT_SECRET=your_github_client_secret
-```
-
-### 3. 启动服务
-
-```bash
-python main.py
-```
-
-服务将在 `http://localhost:6173` 启动。
-
-## API 文档
-
-### 🌐 Swagger 文档
-
-- **Swagger UI**: `http://localhost:6173/swagger/`
-- **API JSON**: `http://localhost:6173/swagger.json`
-
-### 📋 API 端点
-
-#### 认证相关 API
-
-##### POST /auth/login
-
-获取认证授权URL。
-
-**请求参数:**
-| 参数 | 类型 | 必填 | 描述 | 示例 |
-|------|------|------|------|------|
-| provider | string | 是 | 认证提供商 | `github` |
-| redirect_uri | string | 否 | 回调地址 | `http://localhost:3000/callback` |
-
-**请求示例:**
-```json
-{
-  "provider": "github"
-}
-```
-
-**成功响应 (200):**
-```json
-{
-  "success": true,
-  "authorization_url": "https://github.com/login/oauth/authorize?client_id=..."
-}
-```
-
-##### GET /auth/callback/{provider}
-
-处理认证回调。
-
-**响应示例:**
-```json
-{
-  "success": true,
-  "user_info": {
-    "id": "123456",
-    "username": "username",
-    "email": "user@example.com",
-    "provider": "github"
-  },
-  "tokens": {
-    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
-    "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
-    "expires_in": 3600,
-    "token_type": "Bearer"
-  }
-}
-```
-
-##### POST /auth/refresh
-
-刷新访问令牌。
-
-**请求参数:**
-| 参数 | 类型 | 必填 | 描述 |
-|------|------|------|------|
-| refresh_token | string | 是 | 刷新令牌 |
-
-##### POST /auth/logout
-
-登出（撤销令牌）。
-
-**请求头:**
-```
-Authorization: Bearer <access_token>
-```
-
-##### GET /auth/verify
-
-验证访问令牌有效性。
-
-##### GET /auth/providers
-
-获取支持的认证提供商列表。
-
-#### 代码执行 API
-
-##### POST /code/run
-
-运行指定语言的代码（需要认证）。
-
-**请求参数:**
-
-| 参数 | 类型 | 必填 | 描述 | 示例 |
-|------|------|------|------|------|
-| code | string | 是 | 要运行的代码 | `print("Hello World")` |
-| language | string | 否 | 编程语言，默认为 javascript | `python` |
-| stdin | string | 否 | 标准输入 | `input data` |
-
-**请求示例:**
-
-```json
-{
-  "code": "console.log(\"Hello, World!\")",
-  "language": "javascript",
-  "stdin": ""
-}
-```
-
-**成功响应 (200):**
-
-```json
-{
-  "message": "代码执行成功",
-  "stdout": "Hello, World!\n"
-}
-```
-
-**错误响应 (400):**
-
-```json
-{
-  "error": "请配置API_TOKEN环境变量或ApiToken配置项。"
-}
-```
-
-#### GET /api/v1/
-
-服务健康检查端点。
-
-**响应示例:**
-
-```json
-{
-  "message": "Hello World"
-}
-```
-
-### 🔍 使用示例
-
-```bash
-# 认证登录
-curl -X POST http://localhost:6173/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"provider": "github"}'
-
-# 使用认证后的 token 调用代码执行 API
-curl -X POST http://localhost:6173/code/run \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer <your_access_token>" \
-  -d '{
-    "code": "print(\"Hello, World!\")",
-    "language": "python"
-  }'
-
-# 查看 Redis 服务器状态
-redis-cli ping
-
-# 测试代码执行接口（会使用 Redis 缓存）
-curl -X POST http://localhost:6173/code/run/public \
-  -H "Content-Type: application/json" \
-  -d '{
-    "code": "console.log(\"Hello, World!\")",
-    "language": "javascript"
-  }'
-
-# 查看完整 API 文档
-open http://localhost:6173/swagger/
-```
-
-## 项目架构
-
-### 目录结构
-
-```
-fastapi_of_letcoing/
-├── controllers/           # 控制器层
-│   ├── __init__.py
-│   ├── code_controller.py    # 代码执行控制器，API 路由和参数验证
-│   └── auth_controller.py    # 认证控制器，OAuth 和 JWT 相关接口
-├── core/                  # 核心模块
-│   ├── di_container.py        # 依赖注入容器
-│   └── service_config.py     # 服务配置
-├── interfaces/            # 接口定义
-│   ├── __init__.py
-│   └── service_interfaces.py # 服务接口定义
-├── middleware/            # 中间件
-│   └── auth_middleware.py     # JWT 认证中间件
-├── models/                # 数据模型
-│   ├── __init__.py
-│   ├── auth_models.py         # 认证相关数据模型
-│   └── glot_models.py         # Glot API 数据模型
-├── services/              # 服务层
-│   ├── config_service.py      # 配置服务
-│   ├── glot_service.py        # Glot API 调用服务，业务逻辑
-│   ├── jwt_service.py         # JWT 认证服务
-│   ├── logger_service.py      # 日志服务
-│   ├── oidc_service.py        # OIDC 认证服务
-│   └── redis_service.py       # Redis 缓存服务
-├── main.py               # Flask 应用入口，API 配置
-├── requirements.txt       # 项目依赖列表
-├── .gitignore            # Git 忽略文件配置
-└── README.md             # 项目说明文档
-```
-
-### 架构设计
-
-#### 分层架构
-
-1. **控制器层 (Controllers)**
-   - 处理 HTTP 请求和响应
-   - 参数验证和序列化
-   - API 文档注解
-   - 错误处理
-   - 认证相关的路由处理
-
-2. **服务层 (Services)**
-   - 业务逻辑实现
-   - 外部 API 调用
-   - 数据转换和处理
-   - JWT 和 OIDC 认证服务
-   - Redis 缓存服务
-   - 日志和配置管理
-
-3. **数据层 (Models)**
-   - 使用 dataclass 定义数据结构
-   - 类型提示和验证
-   - 认证和业务数据模型
-
-4. **中间件层 (Middleware)**
-   - JWT 认证中间件
-   - 速率限制中间件
-   - 权限控制中间件
-
-5. **核心层 (Core)**
-   - 依赖注入容器
-   - 服务配置管理
-
-6. **接口层 (Interfaces)**
-   - 服务接口抽象
-   - 提高可测试性和可扩展性
-
-### 核心代码说明
-
-#### CodeExecutionController 类
-
-控制器类，负责：
-- API 路由定义 (`/api/v1/code/run`)
-- 请求参数验证 (使用 Flask-RESTX 模型)
-- 响应格式化
-- Swagger 文档生成
-
-#### GlotService 类
-
-核心服务类，负责：
-- 与 Glot API 异步交互
-- 代码执行逻辑
-- 错误处理和转义
-- 语言映射管理
-
-#### 数据模型
-
-- `PostFile`: 表示代码文件的数据模型
-- `PostDataModel`: 表示发送给 Glot API 的请求数据模型
-- `RunResult`: 表示代码执行结果的数据模型
-
-## 环境要求
-
-- Python 3.7+
-- 网络连接（需要访问 Glot API）
-
-## 开发指南
-
-### 添加新的 API 端点
-
-1. 在 `controllers/` 目录下创建新的控制器文件
-2. 定义命名空间和数据模型
-3. 实现资源类和业务逻辑
-4. 在 `main.py` 中注册命名空间
-
-```python
-# 示例：新增控制器
-from flask_restx import Namespace, Resource, fields
-
-api = Namespace('new_feature', description='新功能')
-
-@api.route('/action')
-class NewController(Resource):
-    def get(self):
-        return {'message': 'Hello from new feature'}
-```
-
-### 代码规范
-
-- 使用 4 空格缩进
-- 遵循 PEP 8 代码风格
-- 使用类型提示
-- 编写完整的文档字符串
-- 控制器只处理 HTTP 逻辑，业务逻辑放在服务层
-
-### 测试
-
-```bash
-# 运行应用
-python main.py
-
-# 测试 API 端点
-curl http://localhost:6173/
-
-# 测试认证提供商列表
-curl http://localhost:6173/auth/providers
-
-# 查看 Swagger 文档
-open http://localhost:6173/swagger/
-
-# 测试 Redis 连接
-redis-cli ping
-
-# 测试公共代码执行接口（无需认证，使用 Redis 缓存）
-curl -X POST http://localhost:6173/code/run/public \
-  -H "Content-Type: application/json" \
-  -d '{
-    "code": "console.log(\"Hello, World!\")",
-    "language": "javascript"
-  }'
-```
-
-## 贡献指南
-
-1. Fork 本仓库
-2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
-3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
-4. 推送到分支 (`git push origin feature/AmazingFeature`)
-5. 开启 Pull Request
-
-## 许可证
-
-本项目采用 MIT 许可证 - 查看 [LICENSE](../../../LICENSE) 文件了解详情。
diff --git a/webapi/fastapi_of_letcoing/controllers/__init__.py b/webapi/fastapi_of_letcoing/controllers/__init__.py
deleted file mode 100644
index 6ca5193..0000000
--- a/webapi/fastapi_of_letcoing/controllers/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# 控制器包
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/code_controller.py b/webapi/fastapi_of_letcoing/controllers/code_controller.py
deleted file mode 100644
index 2c6a1d1..0000000
--- a/webapi/fastapi_of_letcoing/controllers/code_controller.py
+++ /dev/null
@@ -1,130 +0,0 @@
-from flask import request, g
-from flask_restx import Resource, Namespace, fields
-from interfaces.service_interfaces import ICodeExecutionService
-from core.di_container import inject
-from models.glot_models import CodeExecutionRequest
-from middleware.auth_middleware import AuthMiddleware, RateLimitMiddleware
-
-# 创建命名空间
-api = Namespace('code', description='代码执行相关操作')
-
-# 定义数据模型
-code_execution_model = api.model('CodeExecution', {
-    'code': fields.String(required=True, description='要执行的代码'),
-    'language': fields.String(default='javascript', description='编程语言'),
-    'stdin': fields.String(description='标准输入'),
-})
-
-# 定义响应模型
-response_model = api.model('CodeExecutionResponse', {
-    'stdout': fields.String(description='标准输出'),
-    'stderr': fields.String(description='标准错误'),
-    'message': fields.String(description='执行结果信息'),
-})
-
-# 定义错误响应模型
-error_model = api.model('ErrorResponse', {
-    'error': fields.String(description='错误信息'),
-})
-
-@api.route('/run')
-class CodeExecutionController(Resource):
-    @api.expect(code_execution_model)
-    @api.doc('execute_code')
-    @api.response(200, 'Success', response_model)
-    @api.response(400, 'Bad Request', error_model)
-    @api.response(401, 'Unauthorized')
-    @AuthMiddleware.require_auth
-    @RateLimitMiddleware.rate_limit(max_requests=100, window_seconds=3600)
-    def post(self):
-        """执行代码（需要认证）"""
-        # 注入服务
-        code_service = inject(ICodeExecutionService)
-        
-        # 获取当前用户信息
-        current_user = getattr(g, 'current_user', None)
-        
-        # 获取请求数据
-        model = request.get_json()
-        if not model:
-            return {'error': '请求体不能为空'}, 400
-        
-        code = model.get('code', '')
-        language = model.get('language', 'javascript')
-        stdin = model.get('stdin', '')
-        
-        # 验证代码
-        if not code or code.strip() == "":
-            return {'error': '代码不能为空'}, 400
-        
-        # 构建请求对象
-        execution_request = CodeExecutionRequest(
-            code=code,
-            language=language,
-            stdin=stdin if stdin else None
-        )
-        
-        # 调用服务
-        import asyncio
-        result = asyncio.run(code_service.execute_code(execution_request))
-        
-        # 处理结果并格式化响应
-        if not result.success:
-            return {'error': result.stderr}, 400
-        
-        response_data = {
-            'message': '代码执行成功', 
-            'stdout': result.stdout
-        }
-        
-        # 添加用户信息到响应中（可选）
-        if current_user:
-            response_data['user'] = {
-                'id': current_user.get('id'),
-                'username': current_user.get('username')
-            }
-        
-        return response_data, 200
-
-
-@api.route('/run/public')
-class PublicCodeExecutionController(Resource):
-    @api.expect(code_execution_model)
-    @api.doc('execute_code_public')
-    @api.response(200, 'Success', response_model)
-    @api.response(400, 'Bad Request', error_model)
-    @RateLimitMiddleware.rate_limit(max_requests=20, window_seconds=3600)
-    def post(self):
-        """执行代码（公共接口，无需认证，限制较严）"""
-        # 注入服务
-        code_service = inject(ICodeExecutionService)
-        
-        # 获取请求数据
-        model = request.get_json()
-        if not model:
-            return {'error': '请求体不能为空'}, 400
-        
-        code = model.get('code', '')
-        language = model.get('language', 'javascript')
-        stdin = model.get('stdin', '')
-        
-        # 验证代码
-        if not code or code.strip() == "":
-            return {'error': '代码不能为空'}, 400
-        
-        # 构建请求对象
-        execution_request = CodeExecutionRequest(
-            code=code,
-            language=language,
-            stdin=stdin if stdin else None
-        )
-        
-        # 调用服务
-        import asyncio
-        result = asyncio.run(code_service.execute_code(execution_request))
-        
-        # 处理结果并格式化响应
-        if not result.success:
-            return {'error': result.stderr}, 400
-        
-        return {'message': '代码执行成功', 'stdout': result.stdout}, 200
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/db_config.py b/webapi/fastapi_of_letcoing/core/db_config.py
deleted file mode 100644
index 29c6ee3..0000000
--- a/webapi/fastapi_of_letcoing/core/db_config.py
+++ /dev/null
@@ -1,58 +0,0 @@
-"""
-数据库配置文件
-PostgreSQL 数据库连接配置管理
-"""
-from dataclasses import dataclass
-from typing import Optional
-
-from core.di_container import get_container
-from interfaces.service_interfaces import IConfigService
-
-
-@dataclass
-class DatabaseConfig:
-    """数据库配置类"""
-    
-    # 数据库连接参数
-    host: str = "localhost"
-    port: int = 5432
-    database: str = "letcoding"
-    username: str = "postgres"
-    password: str = ""
-    
-    # 连接池配置
-    max_connections: int = 20
-    stale_timeout: int = 300
-    
-    def __post_init__(self):
-        """初始化时从 ConfigService 读取配置"""
-        try:
-            config_service = get_container().resolve(IConfigService)
-            db_config = config_service.get_database_config()
-            
-            self.host = db_config["host"]
-            self.port = db_config["port"]
-            self.database = db_config["database"]
-            self.username = db_config["username"]
-            self.password = db_config["password"]
-            self.max_connections = db_config["max_connections"]
-            self.stale_timeout = db_config["stale_timeout"]
-        except Exception:
-            # 如果依赖注入不可用，使用默认值
-            pass
-    
-    @property
-    def database_url(self) -> str:
-        """获取数据库连接 URL"""
-        return f"postgresql://{self.username}:{self.password}@{self.host}:{self.port}/{self.database}"
-    
-    def to_dict(self) -> dict:
-        """转换为字典格式"""
-        return {
-            "host": self.host,
-            "port": self.port,
-            "database": self.database,
-            "username": self.username,
-            "max_connections": self.max_connections,
-            "stale_timeout": self.stale_timeout
-        }
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/di_container.py b/webapi/fastapi_of_letcoing/core/di_container.py
deleted file mode 100644
index f628bde..0000000
--- a/webapi/fastapi_of_letcoing/core/di_container.py
+++ /dev/null
@@ -1,216 +0,0 @@
-"""
-依赖注入容器模块
-
-提供简单的依赖注入功能，支持服务注册、解析和生命周期管理。
-"""
-
-import inspect
-from typing import Any, Dict, Type, TypeVar, Callable, Optional, Union
-from abc import ABC, abstractmethod
-from enum import Enum
-
-T = TypeVar('T')
-
-
-class ServiceLifetime(Enum):
-    """服务生命周期枚举"""
-    SINGLETON = "singleton"  # 单例模式
-    TRANSIENT = "transient"  # 每次请求都创建新实例
-    SCOPED = "scoped"       # 作用域内单例（Flask请求级别）
-
-
-class ServiceDescriptor:
-    """服务描述符"""
-    
-    def __init__(
-        self,
-        service_type: Type,
-        implementation_type: Optional[Type] = None,
-        factory: Optional[Callable] = None,
-        instance: Optional[Any] = None,
-        lifetime: ServiceLifetime = ServiceLifetime.TRANSIENT
-    ):
-        self.service_type = service_type
-        self.implementation_type = implementation_type
-        self.factory = factory
-        self.instance = instance
-        self.lifetime = lifetime
-        
-        # 验证参数
-        if sum(bool(x) for x in [implementation_type, factory, instance]) != 1:
-            raise ValueError("必须且只能提供 implementation_type, factory, 或 instance 中的一个")
-
-
-class DIContainer:
-    """依赖注入容器"""
-    
-    def __init__(self):
-        self._services: Dict[Type, ServiceDescriptor] = {}
-        self._singleton_instances: Dict[Type, Any] = {}
-        self._scoped_instances: Dict[Type, Any] = {}
-    
-    def register_singleton(
-        self, 
-        service_type: Type[T], 
-        implementation_type: Optional[Type] = None,
-        factory: Optional[Callable[[], T]] = None,
-        instance: Optional[T] = None
-    ) -> 'DIContainer':
-        """注册单例服务"""
-        descriptor = ServiceDescriptor(
-            service_type=service_type,
-            implementation_type=implementation_type,
-            factory=factory,
-            instance=instance,
-            lifetime=ServiceLifetime.SINGLETON
-        )
-        self._services[service_type] = descriptor
-        return self
-    
-    def register_transient(
-        self,
-        service_type: Type[T],
-        implementation_type: Optional[Type] = None,
-        factory: Optional[Callable[[], T]] = None
-    ) -> 'DIContainer':
-        """注册瞬态服务"""
-        descriptor = ServiceDescriptor(
-            service_type=service_type,
-            implementation_type=implementation_type,
-            factory=factory,
-            instance=None,
-            lifetime=ServiceLifetime.TRANSIENT
-        )
-        self._services[service_type] = descriptor
-        return self
-    
-    def register_scoped(
-        self,
-        service_type: Type[T],
-        implementation_type: Optional[Type] = None,
-        factory: Optional[Callable[[], T]] = None
-    ) -> 'DIContainer':
-        """注册作用域服务"""
-        descriptor = ServiceDescriptor(
-            service_type=service_type,
-            implementation_type=implementation_type,
-            factory=factory,
-            instance=None,
-            lifetime=ServiceLifetime.SCOPED
-        )
-        self._services[service_type] = descriptor
-        return self
-    
-    def resolve(self, service_type: Type[T]) -> T:
-        """解析服务"""
-        if service_type not in self._services:
-            raise ValueError(f"服务 {service_type} 未注册")
-        
-        descriptor = self._services[service_type]
-        
-        # 处理单例
-        if descriptor.lifetime == ServiceLifetime.SINGLETON:
-            if service_type in self._singleton_instances:
-                return self._singleton_instances[service_type]
-            
-            instance = self._create_instance(descriptor)
-            self._singleton_instances[service_type] = instance
-            return instance
-        
-        # 处理作用域
-        elif descriptor.lifetime == ServiceLifetime.SCOPED:
-            if service_type in self._scoped_instances:
-                return self._scoped_instances[service_type]
-            
-            instance = self._create_instance(descriptor)
-            self._scoped_instances[service_type] = instance
-            return instance
-        
-        # 处理瞬态
-        else:
-            return self._create_instance(descriptor)
-    
-    def _create_instance(self, descriptor: ServiceDescriptor) -> Any:
-        """创建服务实例"""
-        # 如果有预定义实例
-        if descriptor.instance is not None:
-            return descriptor.instance
-        
-        # 如果有工厂方法
-        if descriptor.factory is not None:
-            return descriptor.factory()
-        
-        # 如果有实现类型
-        if descriptor.implementation_type is not None:
-            return self._create_with_injection(descriptor.implementation_type)
-        
-        raise ValueError(f"无法创建服务 {descriptor.service_type} 的实例")
-    
-    def _create_with_injection(self, implementation_type: Type) -> Any:
-        """通过构造函数注入创建实例"""
-        # 获取构造函数参数
-        sig = inspect.signature(implementation_type.__init__)
-        
-        # 准备参数
-        kwargs = {}
-        for param_name, param in sig.parameters.items():
-            if param_name == 'self':
-                continue
-            
-            # 尝试解析参数类型
-            if param.annotation != inspect.Parameter.empty:
-                param_type = param.annotation
-                if param_type in self._services:
-                    kwargs[param_name] = self.resolve(param_type)
-            # 如果有默认值，使用默认值
-            elif param.default != inspect.Parameter.empty:
-                kwargs[param_name] = param.default
-        
-        return implementation_type(**kwargs)
-    
-    def clear_scope(self):
-        """清除作用域实例（通常在请求结束时调用）"""
-        self._scoped_instances.clear()
-    
-    def is_registered(self, service_type: Type) -> bool:
-        """检查服务是否已注册"""
-        return service_type in self._services
-
-
-# 全局容器实例
-_container: Optional[DIContainer] = None
-
-
-def get_container() -> DIContainer:
-    """获取全局容器实例"""
-    global _container
-    if _container is None:
-        _container = DIContainer()
-        _register_default_services(_container)
-    return _container
-
-
-def _register_default_services(container: DIContainer) -> None:
-    """注册默认服务"""
-    # 注册数据库配置
-    from core.db_config import DatabaseConfig
-    container.register_singleton(DatabaseConfig)
-    
-    # 注意：DatabaseService 在 setup_services 中注册，因为它依赖于 IConfigService
-
-
-def configure_services(configurator: Callable[[DIContainer], None]) -> None:
-    """配置服务"""
-    container = get_container()
-    configurator(container)
-
-
-def inject(service_type: Type[T]) -> T:
-    """依赖注入装饰器辅助函数"""
-    container = get_container()
-    return container.resolve(service_type)
-
-
-class Injectable(ABC):
-    """可注入服务的抽象基类"""
-    pass
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/service_config.py b/webapi/fastapi_of_letcoing/core/service_config.py
deleted file mode 100644
index 3dbd17b..0000000
--- a/webapi/fastapi_of_letcoing/core/service_config.py
+++ /dev/null
@@ -1,51 +0,0 @@
-"""
-服务配置模块
-
-集中管理依赖注入的配置。
-"""
-
-from core.di_container import configure_services, get_container
-from services.config_service import ConfigService
-from services.logger_service import LoggerService
-from services.glot_service import GlotService
-from services.oidc_service import OIDCService
-from services.jwt_service import JWTService
-from services.redis_service import RedisService
-from services.database_service import DatabaseService
-from services.user_service import UserService
-from interfaces.service_interfaces import IConfigService, ILoggerService, ICodeExecutionService, IRedisService, IOIDCService, IJWTService
-
-
-def setup_services(app_config: dict) -> None:
-    """设置依赖注入服务"""
-    
-    def service_configurator(container):
-        # 配置服务
-        container.register_singleton(IConfigService, 
-                                  factory=lambda: ConfigService(app_config))
-        container.register_singleton(ILoggerService,
-                                  factory=lambda: LoggerService())
-        container.register_singleton(IRedisService, RedisService)
-        container.register_scoped(ICodeExecutionService, GlotService)
-        container.register_singleton(IOIDCService, OIDCService)
-        container.register_singleton(IJWTService, JWTService)
-        
-        # 数据库服务（依赖于ConfigService）
-        def create_database_service():
-            config_service = container.resolve(IConfigService)
-            return DatabaseService(config_service)
-        
-        def create_user_service():
-            config_service = container.resolve(IConfigService)
-            return UserService(config_service)
-        
-        container.register_singleton(DatabaseService, factory=create_database_service)
-        container.register_singleton(UserService, factory=create_user_service)
-    
-    configure_services(service_configurator)
-
-
-def get_service(service_type):
-    """获取指定类型的服务实例"""
-    container = get_container()
-    return container.resolve(service_type)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/interfaces/__init__.py b/webapi/fastapi_of_letcoing/interfaces/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/webapi/fastapi_of_letcoing/middleware/auth_middleware.py b/webapi/fastapi_of_letcoing/middleware/auth_middleware.py
deleted file mode 100644
index 509f8f5..0000000
--- a/webapi/fastapi_of_letcoing/middleware/auth_middleware.py
+++ /dev/null
@@ -1,200 +0,0 @@
-"""
-JWT 认证中间件
-
-提供 JWT 令牌验证功能，用于保护 API 端点
-"""
-
-from functools import wraps
-from flask import request, jsonify, g
-from services.jwt_service import JWTService
-from core.di_container import inject
-
-
-class AuthMiddleware:
-    """认证中间件类"""
-    
-    @staticmethod
-    def require_auth(f):
-        """
-        装饰器：要求有效的JWT令牌
-        
-        Args:
-            f: 被装饰的函数
-            
-        Returns:
-            装饰后的函数
-        """
-        @wraps(f)
-        def decorated_function(*args, **kwargs):
-            # 注入JWT服务
-            jwt_service = inject(JWTService)
-            
-            # 从请求头获取令牌
-            auth_header = request.headers.get('Authorization', '')
-            
-            if not auth_header:
-                return jsonify({'error': '缺少Authorization头'}), 401
-            
-            if not auth_header.startswith('Bearer '):
-                return jsonify({'error': '无效的Authorization格式'}), 401
-            
-            token = auth_header[7:]  # 移除 'Bearer ' 前缀
-            
-            # 验证令牌
-            user_info = jwt_service.verify_access_token(token)
-            
-            if not user_info:
-                return jsonify({'error': '令牌无效或已过期'}), 401
-            
-            # 将用户信息存储到g对象中
-            g.current_user = user_info
-            
-            return f(*args, **kwargs)
-        
-        return decorated_function
-    
-    @staticmethod
-    def optional_auth(f):
-        """
-        装饰器：可选的JWT令牌验证
-        
-        如果令牌有效，会将用户信息存储到g对象中
-        如果令牌无效或缺失，仍继续执行函数
-        
-        Args:
-            f: 被装饰的函数
-            
-        Returns:
-            装饰后的函数
-        """
-        @wraps(f)
-        def decorated_function(*args, **kwargs):
-            # 注入JWT服务
-            jwt_service = inject(JWTService)
-            
-            # 从请求头获取令牌
-            auth_header = request.headers.get('Authorization', '')
-            
-            if auth_header and auth_header.startswith('Bearer '):
-                token = auth_header[7:]  # 移除 'Bearer ' 前缀
-                
-                # 验证令牌
-                user_info = jwt_service.verify_access_token(token)
-                
-                # 如果令牌有效，存储用户信息
-                if user_info:
-                    g.current_user = user_info
-            
-            return f(*args, **kwargs)
-        
-        return decorated_function
-
-
-class RateLimitMiddleware:
-    """基于用户的速率限制中间件"""
-    
-    @staticmethod
-    def rate_limit(max_requests: int = 1000, window_seconds: int = 3600):
-        """
-        装饰器：基于用户的速率限制
-        
-        Args:
-            max_requests: 最大请求数
-            window_seconds: 时间窗口（秒）
-            
-        Returns:
-            装饰器函数
-        """
-        def decorator(f):
-            @wraps(f)
-            def decorated_function(*args, **kwargs):
-                # 检查是否有用户信息
-                user_info = getattr(g, 'current_user', None)
-                
-                if user_info:
-                    # 注入JWT服务获取Redis客户端
-                    jwt_service = inject(JWTService)
-                    redis_client = jwt_service._redis_client
-                    
-                    if redis_client:
-                        user_id = user_info.get('id')
-                        key = f"rate_limit:{user_id}"
-                        
-                        try:
-                            # 获取当前计数
-                            current_count = redis_client.get(key)
-                            
-                            if current_count is None:
-                                # 首次请求，设置计数
-                                redis_client.setex(key, window_seconds, 1)
-                            else:
-                                current_count = int(current_count)
-                                
-                                if current_count >= max_requests:
-                                    # 超过限制
-                                    return jsonify({
-                                        'error': '请求过于频繁，请稍后再试',
-                                        'limit': max_requests,
-                                        'window': window_seconds
-                                    }), 429
-                                
-                                # 增加计数
-                                redis_client.incr(key)
-                        except Exception:
-                            # Redis错误时不限制请求
-                            pass
-                
-                return f(*args, **kwargs)
-            
-            return decorated_function
-        
-        return decorator
-
-
-class RoleBasedAuth:
-    """基于角色的访问控制"""
-    
-    @staticmethod
-    def require_role(required_role: str):
-        """
-        装饰器：要求特定角色
-        
-        Args:
-            required_role: 必需的角色
-            
-        Returns:
-            装饰器函数
-        """
-        def decorator(f):
-            @wraps(f)
-            def decorated_function(*args, **kwargs):
-                # 检查用户认证
-                user_info = getattr(g, 'current_user', None)
-                
-                if not user_info:
-                    return jsonify({'error': '需要认证'}), 401
-                
-                # 检查角色（这里简化处理，可以根据实际情况扩展）
-                user_role = user_info.get('role', 'user')
-                
-                if user_role != required_role and user_role != 'admin':
-                    return jsonify({'error': '权限不足'}), 403
-                
-                return f(*args, **kwargs)
-            
-            return decorated_function
-        
-        return decorator
-    
-    @staticmethod
-    def require_admin(f):
-        """
-        装饰器：要求管理员权限
-        
-        Args:
-            f: 被装饰的函数
-            
-        Returns:
-            装饰后的函数
-        """
-        return RoleBasedAuth.require_role('admin')(f)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/__init__.py b/webapi/fastapi_of_letcoing/models/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/webapi/fastapi_of_letcoing/models/auth_models.py b/webapi/fastapi_of_letcoing/models/auth_models.py
deleted file mode 100644
index c106521..0000000
--- a/webapi/fastapi_of_letcoing/models/auth_models.py
+++ /dev/null
@@ -1,182 +0,0 @@
-"""
-认证相关的数据模型
-"""
-
-from dataclasses import dataclass, field
-import time
-from typing import Optional, Dict, List, Any
-from datetime import datetime
-
-class JWTToken:
-    """JWT 令牌数据模型"""
-    
-    def __init__(self, access_token: str, refresh_token: str, 
-                 expires_in: int, token_type: str = "Bearer"):
-        self.access_token = access_token
-        self.refresh_token = refresh_token
-        self.expires_in = expires_in
-        self.token_type = token_type
-        self.created_at = time.time()
-    
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            'access_token': self.access_token,
-            'refresh_token': self.refresh_token,
-            'expires_in': self.expires_in,
-            'token_type': self.token_type
-        }
-
-@dataclass
-class UserInfo:
-    """用户信息模型"""
-    id: str
-    username: str
-    email: str
-    name: str = ""
-    avatar_url: str = ""
-    provider: str = ""
-    created_at: datetime = field(default_factory=datetime.now)
-    
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            'id': self.id,
-            'username': self.username,
-            'email': self.email,
-            'name': self.name,
-            'avatar_url': self.avatar_url,
-            'provider': self.provider,
-            'created_at': self.created_at.isoformat()
-        }
-
-
-@dataclass
-class LoginRequest:
-    """登录请求模型"""
-    provider: str
-    redirect_uri: Optional[str] = None
-    
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            'provider': self.provider,
-            'redirect_uri': self.redirect_uri
-        }
-
-
-@dataclass
-class LoginResponse:
-    """登录响应模型"""
-    success: bool
-    authorization_url: Optional[str] = None
-    error: Optional[str] = None
-    
-    def to_dict(self) -> Dict[str, Any]:
-        result = {'success': self.success}
-        if self.authorization_url:
-            result['authorization_url'] = self.authorization_url
-        if self.error:
-            result['error'] = self.error
-        return result
-
-
-@dataclass
-class TokenResponse:
-    """令牌响应模型"""
-    access_token: str
-    refresh_token: str
-    expires_in: int
-    token_type: str = "Bearer"
-    user_info: Optional[UserInfo] = None
-    
-    def to_dict(self) -> Dict[str, Any]:
-        result = {
-            'access_token': self.access_token,
-            'refresh_token': self.refresh_token,
-            'expires_in': self.expires_in,
-            'token_type': self.token_type
-        }
-        if self.user_info:
-            result['user_info'] = self.user_info.to_dict()
-        return result
-
-
-@dataclass
-class RefreshTokenRequest:
-    """刷新令牌请求模型"""
-    refresh_token: str
-    
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            'refresh_token': self.refresh_token
-        }
-
-
-@dataclass
-class AuthCallbackRequest:
-    """认证回调请求模型"""
-    provider: str
-    code: Optional[str] = None
-    state: Optional[str] = None
-    error: Optional[str] = None
-    error_description: Optional[str] = None
-    
-    def to_dict(self) -> Dict[str, Any]:
-        result = {'provider': self.provider}
-        if self.code:
-            result['code'] = self.code
-        if self.state:
-            result['state'] = self.state
-        if self.error:
-            result['error'] = self.error
-        if self.error_description:
-            result['error_description'] = self.error_description
-        return result
-
-
-@dataclass
-class AuthResult:
-    """认证结果模型"""
-    success: bool
-    user_info: Optional[UserInfo] = None
-    tokens: Optional[TokenResponse] = None
-    error: Optional[str] = None
-    
-    def to_dict(self) -> Dict[str, Any]:
-        result = {'success': self.success}
-        if self.user_info:
-            result['user_info'] = self.user_info.to_dict()
-        if self.tokens:
-            result['tokens'] = self.tokens.to_dict()
-        if self.error:
-            result['error'] = self.error
-        return result
-
-
-@dataclass
-class OIDCProviderConfig:
-    """OIDC 提供商配置模型"""
-    name: str
-    client_id: str
-    client_secret: str
-    server_metadata_url: Optional[str] = None
-    access_token_url: Optional[str] = None
-    authorize_url: Optional[str] = None
-    api_base_url: Optional[str] = None
-    client_kwargs: Dict[str, Any] = field(default_factory=dict)
-    
-    def to_dict(self) -> Dict[str, Any]:
-        result = {
-            'name': self.name,
-            'client_id': self.client_id,
-            'client_secret': self.client_secret
-        }
-        if self.server_metadata_url:
-            result['server_metadata_url'] = self.server_metadata_url
-        if self.access_token_url:
-            result['access_token_url'] = self.access_token_url
-        if self.authorize_url:
-            result['authorize_url'] = self.authorize_url
-        if self.api_base_url:
-            result['api_base_url'] = self.api_base_url
-        if self.client_kwargs:
-            result['client_kwargs'] = self.client_kwargs
-        return result
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/glot_models.py b/webapi/fastapi_of_letcoing/models/glot_models.py
deleted file mode 100644
index d448ade..0000000
--- a/webapi/fastapi_of_letcoing/models/glot_models.py
+++ /dev/null
@@ -1,67 +0,0 @@
-from dataclasses import dataclass, field
-from typing import Optional, Dict, List, Any
-
-
-@dataclass
-class PostFile:
-    """文件数据模型"""
-    name: str = ""
-    content: str = ""
-    
-    def to_dict(self):
-        return {
-            "name": self.name,
-            "content": self.content
-        }
-
-
-@dataclass
-class PostDataModel:
-    """POST 请求数据模型"""
-    files: List[PostFile] = field(default_factory=list)
-    stdin: Optional[str] = None
-    
-    def __post_init__(self):
-        pass
-    
-    def to_dict(self):
-        return {
-            "files": [f.to_dict() for f in self.files],
-            "stdin": self.stdin
-        }
-
-
-@dataclass
-class RunResult:
-    """运行结果模型"""
-    stdout: str = ""
-    stderr: str = ""
-    
-    def to_dict(self):
-        return {
-            "stdout": self.stdout,
-            "stderr": self.stderr
-        }
-
-
-@dataclass
-class CodeExecutionRequest:
-    """代码执行请求模型"""
-    code: str
-    language: str = "javascript"
-    stdin: Optional[str] = None
-
-
-@dataclass
-class CodeExecutionResponse:
-    """代码执行响应模型"""
-    stdout: str
-    stderr: str = ""
-    success: bool = True
-    
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "stdout": self.stdout,
-            "stderr": self.stderr,
-            "success": self.success
-        }
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/config_service.py b/webapi/fastapi_of_letcoing/services/config_service.py
deleted file mode 100644
index 7b63336..0000000
--- a/webapi/fastapi_of_letcoing/services/config_service.py
+++ /dev/null
@@ -1,50 +0,0 @@
-"""
-配置服务实现
-
-提供配置管理功能，支持环境变量和应用配置。
-"""
-
-from typing import Any, Optional
-from interfaces.service_interfaces import IConfigService
-
-
-class ConfigService(IConfigService):
-    """配置服务实现"""
-    
-    def __init__(self, app_config: Optional[dict] = None):
-        """
-        初始化配置服务
-        
-        Args:
-            app_config: Flask应用配置字典
-        """
-        self._app_config = app_config or {}
-    
-    def get_api_token(self) -> str:
-        """获取API Token"""
-        return self._app_config.get('API_TOKEN', '')
-    
-    def get_timeout(self) -> int:
-        """获取请求超时时间"""
-        return int(self._app_config.get('REQUEST_TIMEOUT', '30'))
-    
-    def get_config(self, key: str, default: Any = None) -> Any:
-        """获取配置值"""
-        return self._app_config.get(key, default)
-    
-    def get_database_config(self) -> dict:
-        """获取数据库配置"""
-        return {
-            "host": self.get_config("DB_HOST", "localhost"),
-            "port": self.get_config("DB_PORT", 5432),
-            "database": self.get_config("DB_NAME", "letcoding"),
-            "username": self.get_config("DB_USER", "postgres"),
-            "password": self.get_config("DB_PASSWORD", ""),
-            "max_connections": self.get_config("DB_MAX_CONNECTIONS", 20),
-            "stale_timeout": self.get_config("DB_STALE_TIMEOUT", 300)
-        }
-    
-    def get_database_url(self) -> str:
-        """获取数据库连接 URL"""
-        config = self.get_database_config()
-        return f"postgresql://{config['username']}:{config['password']}@{config['host']}:{config['port']}/{config['database']}"
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/database_service.py b/webapi/fastapi_of_letcoing/services/database_service.py
deleted file mode 100644
index ccfffdd..0000000
--- a/webapi/fastapi_of_letcoing/services/database_service.py
+++ /dev/null
@@ -1,134 +0,0 @@
-"""
-数据库服务基类
-提供数据库连接和基础操作
-"""
-from datetime import datetime
-from typing import List, Optional, Dict, Any
-
-from peewee import DoesNotExist, IntegrityError, fn, Model, Database
-from playhouse.postgres_ext import PostgresqlExtDatabase
-from core.di_container import Injectable
-from interfaces.service_interfaces import IConfigService
-
-
-class DatabaseService(Injectable):
-    """数据库服务基类"""
-    
-    def __init__(self, config_service: IConfigService):
-        """初始化数据库服务"""
-        self._config_service = config_service
-        self._database = None
-        self._ensure_connection()
-    
-    def _get_database(self) -> PostgresqlExtDatabase:
-        """获取数据库连接实例"""
-        if self._database is None:
-            db_config = self._config_service.get_database_config()
-            self._database = PostgresqlExtDatabase(
-                db_config["database"],
-                user=db_config["username"],
-                password=db_config["password"],
-                host=db_config["host"],
-                port=db_config["port"],
-                max_connections=db_config["max_connections"],
-                stale_timeout=db_config["stale_timeout"]
-            )
-        return self._database
-    
-    def _ensure_connection(self):
-        """确保数据库连接正常"""
-        try:
-            db = self._get_database()
-            if not db.is_connection_usable():
-                db.connect()
-        except Exception as e:
-            print(f"数据库连接失败: {e}")
-            raise
-    
-    # 通用CRUD操作
-    async def create(self, model_class: type, **kwargs) -> Dict[str, Any]:
-        """通用创建操作"""
-        try:
-            with self._get_database().atomic():
-                instance = model_class.create(**kwargs)
-                return instance.to_dict()
-        except IntegrityError as e:
-            raise ValueError(f"创建失败: {str(e)}")
-        except Exception as e:
-            raise RuntimeError(f"创建记录时发生错误: {e}")
-    
-    async def get_by_id(self, model_class: type, record_id: int) -> Optional[Dict[str, Any]]:
-        """通用根据ID获取记录"""
-        try:
-            instance = model_class.get_by_id(record_id)
-            return instance.to_dict()
-        except DoesNotExist:
-            return None
-        except Exception as e:
-            raise RuntimeError(f"获取记录时发生错误: {e}")
-    
-    async def update(self, model_class: type, record_id: int, **kwargs) -> bool:
-        """通用更新操作"""
-        try:
-            with self._get_database().atomic():
-                query = model_class.update(**kwargs).where(model_class.id == record_id)
-                return query.execute() > 0
-        except Exception as e:
-            raise RuntimeError(f"更新记录时发生错误: {e}")
-    
-    async def delete(self, model_class: type, record_id: int) -> bool:
-        """通用删除操作"""
-        try:
-            with self._get_database().atomic():
-                query = model_class.delete().where(model_class.id == record_id)
-                return query.execute() > 0
-        except Exception as e:
-            raise RuntimeError(f"删除记录时发生错误: {e}")
-    
-    async def list_all(self, model_class: type, limit: int = 50, offset: int = 0, order_by=None) -> List[Dict[str, Any]]:
-        """通用列表查询"""
-        try:
-            query = model_class.select()
-            if order_by:
-                query = query.order_by(order_by)
-            query = query.limit(limit).offset(offset)
-            
-            return [instance.to_dict() for instance in query]
-        except Exception as e:
-            raise RuntimeError(f"查询列表时发生错误: {e}")
-    
-    async def count(self, model_class: type) -> int:
-        """通用计数操作"""
-        try:
-            return model_class.select().count()
-        except Exception as e:
-            raise RuntimeError(f"计数时发生错误: {e}")
-    
-    # 数据库管理操作
-    def test_connection(self) -> bool:
-        """测试数据库连接"""
-        try:
-            db = self._get_database()
-            db.execute_sql("SELECT 1")
-            return True
-        except Exception:
-            return False
-    
-    def get_database_info(self) -> Dict[str, Any]:
-        """获取数据库信息"""
-        try:
-            db = self._get_database()
-            return {
-                "database": db.database,
-                "host": db.connect_kwargs.get("host", "localhost"),
-                "port": db.connect_kwargs.get("port", 5432),
-                "is_connected": not db.is_closed() and db.is_connection_usable()
-            }
-        except Exception as e:
-            return {"error": str(e)}
-    
-    def close(self):
-        """关闭数据库连接"""
-        db = self._get_database()
-        if not db.is_closed():
-            db.close()
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/glot_service.py b/webapi/fastapi_of_letcoing/services/glot_service.py
deleted file mode 100644
index e9d9581..0000000
--- a/webapi/fastapi_of_letcoing/services/glot_service.py
+++ /dev/null
@@ -1,187 +0,0 @@
-import aiohttp
-import asyncio
-from typing import Optional, Dict, List
-from dataclasses import dataclass, field
-import json
-from interfaces.service_interfaces import ICodeExecutionService, IConfigService, ILoggerService
-from models.glot_models import PostFile, PostDataModel, RunResult, CodeExecutionRequest, CodeExecutionResponse
-from core.di_container import Injectable
-
-
-
-class GlotService(ICodeExecutionService, Injectable):
-    """Glot.io 代码运行服务（异步版本）"""
-    
-    # 语言映射字典
-    LANGUAGES: Dict[str, str] = {
-        "assembly": "asm", "ats": "dats", "bash": "sh", "c": "c", "clojure": "clj",
-        "cobol": "cob", "coffeescript": "coffee", "cpp": "cpp", "crystal": "cr",
-        "csharp": "cs", "d": "d", "elixir": "ex", "elm": "elm", "erlang": "erl",
-        "fsharp": "fs", "go": "go", "groovy": "groovy", "hare": "hare", "haskell": "hs",
-        "idris": "idr", "java": "java", "javascript": "js", "julia": "jl", "kotlin": "kt",
-        "lua": "lua", "mercury": "m", "nim": "nim", "nix": "nix", "ocaml": "ml",
-        "perl": "pl", "php": "php", "python": "py", "raku": "raku", "ruby": "rb",
-        "rust": "rs", "sac": "sac", "scala": "scala", "swift": "swift", "typescript": "ts",
-        "zig": "zig"
-    }
-    
-    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
-        """
-        初始化服务
-        
-        Args:
-            config_service: 配置服务
-            logger_service: 日志服务
-        """
-        self._config_service = config_service
-        self._logger_service = logger_service
-        self.timeout = aiohttp.ClientTimeout(total=config_service.get_timeout())
-    
-    async def execute_code(self, request: CodeExecutionRequest) -> CodeExecutionResponse:
-        """
-        执行代码（实现接口方法）
-        
-        Args:
-            request: 代码执行请求
-            
-        Returns:
-            代码执行响应
-        """
-        try:
-            self._logger_service.info(f"开始执行代码，语言: {request.language}")
-            
-            # 获取API Token
-            api_token = self._config_service.get_api_token()
-            if not api_token:
-                return CodeExecutionResponse(
-                    stdout="",
-                    stderr="API Token未配置",
-                    success=False
-                )
-            
-            # 调用原有方法
-            result = await self._run_glot_async(api_token, request.code, request.language, request.stdin)
-            
-            # 检查结果
-            if (result.startswith("请求出错:") or 
-                result.startswith("运行出错:") or 
-                result in ["请输入代码", "不支持的语言", "请求超时"]):
-                return CodeExecutionResponse(
-                    stdout="",
-                    stderr=result,
-                    success=False
-                )
-            
-            return CodeExecutionResponse(
-                stdout=result,
-                stderr="",
-                success=True
-            )
-            
-        except Exception as ex:
-            self._logger_service.error("代码执行过程中发生异常", ex)
-            return CodeExecutionResponse(
-                stdout="",
-                stderr=f"执行异常: {str(ex)}",
-                success=False
-            )
-    
-    async def _run_glot_async(self, api_token: str, code: str, 
-                            language: str = "javascript", 
-                            stdin: Optional[str] = None) -> str:
-        """
-        使用 glot.io 运行在线代码（异步）
-        
-        Args:
-            api_token: API Token
-            code: 要运行的代码
-            language: 语言（如 "javascript"，默认为 "javascript"）
-            stdin: 标准输入（可选）
-            
-        Returns:
-            结果字符串
-        """
-        # 验证代码
-        if not code or code.strip() == "":
-            return "请输入代码"
-        
-        # 设置默认语言
-        if not language or language.strip() == "":
-            language = "javascript"
-        
-        # 查找对应后缀（不区分大小写）
-        language_lower = language.lower()
-        extension = self.LANGUAGES.get(language_lower)
-        
-        if not extension:
-            return "不支持的语言"
-        
-        # 构建 URL
-        url = f"https://glot.io/api/run/{language_lower}/latest"
-        
-        # 构建 POST 数据
-        post_file = PostFile(
-            name=f"main.{extension}",
-            content=code
-        )
-        
-        data = PostDataModel(
-            files=[post_file],
-            stdin=stdin
-        )
-        
-        # 设置请求头
-        headers = {
-            "Authorization": f"Token {api_token}",
-            "Content-Type": "application/json"
-        }
-        
-        try:
-            # 发送异步 POST 请求
-            async with aiohttp.ClientSession(timeout=self.timeout) as session:
-                async with session.post(url, json=data.to_dict(), headers=headers) as response:
-                    resp_text = await response.text()
-                    
-                    # 检查响应状态
-                    if not response.ok:
-                        return f"请求出错: HTTP {response.status}"
-                    
-                    # 解析响应
-                    resp_json = json.loads(resp_text)
-                    
-                    result = RunResult(
-                        stdout=resp_json.get("stdout", ""),
-                        stderr=resp_json.get("stderr", "")
-                    )
-                    
-                    # 兼容接口结构
-                    if result.stderr:
-                        return f"运行出错: {self._escape(result.stderr)}\n{self._escape(result.stderr)}"
-                    else:
-                        return self._escape(result.stdout + result.stderr)
-                    
-        except asyncio.TimeoutError:
-            return "请求超时"
-        except aiohttp.ClientError as ex:
-            return f"请求出错: {str(ex)}"
-        except Exception as ex:
-            return f"请求出错: {str(ex)}"
-    
-    @staticmethod
-    def _escape(text: str) -> str:
-        """
-        转义输出，防注入（简单实现）
-        
-        Args:
-            text: 要转义的文本
-            
-        Returns:
-            转义后的文本
-        """
-        if not text:
-            return ""
-        
-        return (text
-                .replace("&", "&amp;")
-                .replace("<", "&lt;")
-                .replace(">", "&gt;"))
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/jwt_service.py b/webapi/fastapi_of_letcoing/services/jwt_service.py
deleted file mode 100644
index 17c444b..0000000
--- a/webapi/fastapi_of_letcoing/services/jwt_service.py
+++ /dev/null
@@ -1,251 +0,0 @@
-"""
-JWT 认证服务
-
-提供 JWT 令牌生成、验证和缓存功能（使用独立的 Redis 服务）
-"""
-
-import jwt
-import json
-import time
-from datetime import datetime, timedelta
-from typing import Optional, Dict, Any, List
-from interfaces.service_interfaces import IConfigService, ILoggerService, IRedisService, IJWTService
-from core.di_container import Injectable
-from models.auth_models import JWTToken
-
-
-class JWTService(Injectable, IJWTService):
-    """JWT 认证服务"""
-    
-    def __init__(self, config_service: IConfigService, logger_service: ILoggerService, redis_service: IRedisService):
-        self._config_service = config_service
-        self._logger_service = logger_service
-        self._redis_service = redis_service
-        self._secret_key = self._config_service.get_config('JWT_SECRET_KEY', 'default-secret-key')
-        self._algorithm = self._config_service.get_config('JWT_ALGORITHM', 'HS256')
-        self._access_token_expire = self._config_service.get_config('JWT_ACCESS_TOKEN_EXPIRE', 3600)  # 1小时
-        self._refresh_token_expire = self._config_service.get_config('JWT_REFRESH_TOKEN_EXPIRE', 86400 * 7)  # 7天
-    
-
-    
-    def generate_tokens(self, user_info: Dict[str, Any]) -> JWTToken:
-        """
-        生成 JWT 令牌对
-        
-        Args:
-            user_info: 用户信息字典
-            
-        Returns:
-            JWT 令牌对象
-        """
-        now = datetime.utcnow()
-        access_expire = now + timedelta(seconds=self._access_token_expire)
-        refresh_expire = now + timedelta(seconds=self._refresh_token_expire)
-        
-        # 生成访问令牌
-        access_payload = {
-            'user_id': user_info['id'],
-            'username': user_info.get('username', ''),
-            'email': user_info.get('email', ''),
-            'provider': user_info.get('provider', ''),
-            'exp': access_expire,
-            'iat': now,
-            'type': 'access'
-        }
-        
-        access_token = jwt.encode(access_payload, self._secret_key, algorithm=self._algorithm)
-        
-        # 生成刷新令牌
-        refresh_payload = {
-            'user_id': user_info['id'],
-            'exp': refresh_expire,
-            'iat': now,
-            'type': 'refresh'
-        }
-        
-        refresh_token = jwt.encode(refresh_payload, self._secret_key, algorithm=self._algorithm)
-        
-        # 缓存用户信息
-        self._cache_user_info(user_info['id'], user_info)
-        
-        # 缓存刷新令牌
-        self._cache_refresh_token(user_info['id'], refresh_token)
-        
-        return JWTToken(
-            access_token=access_token,
-            refresh_token=refresh_token,
-            expires_in=self._access_token_expire
-        )
-    
-    def verify_access_token(self, token: str) -> Optional[Dict[str, Any]]:
-        """
-        验证访问令牌
-        
-        Args:
-            token: JWT 访问令牌
-            
-        Returns:
-            用户信息或None
-        """
-        try:
-            payload = jwt.decode(token, self._secret_key, algorithms=[self._algorithm])
-            
-            # 检查令牌类型
-            if payload.get('type') != 'access':
-                self._logger_service.warning("令牌类型不匹配")
-                return None
-            
-            # 检查是否在黑名单中
-            if self._is_token_blacklisted(token):
-                self._logger_service.warning("令牌已被撤销")
-                return None
-            
-            # 从缓存获取用户信息
-            user_info = self._get_cached_user_info(payload['user_id'])
-            if user_info:
-                return user_info
-            
-            # 如果缓存中没有，返回基本信息
-            return {
-                'id': payload['user_id'],
-                'username': payload.get('username', ''),
-                'email': payload.get('email', ''),
-                'provider': payload.get('provider', '')
-            }
-            
-        except jwt.ExpiredSignatureError:
-            self._logger_service.warning("访问令牌已过期")
-            return None
-        except jwt.InvalidTokenError as ex:
-            self._logger_service.warning(f"无效的访问令牌: {ex}")
-            return None
-        except Exception as ex:
-            self._logger_service.error("验证访问令牌时发生异常", ex)
-            return None
-    
-    def refresh_access_token(self, refresh_token: str) -> Optional[JWTToken]:
-        """
-        使用刷新令牌生成新的访问令牌
-        
-        Args:
-            refresh_token: 刷新令牌
-            
-        Returns:
-            新的JWT令牌对象或None
-        """
-        try:
-            payload = jwt.decode(refresh_token, self._secret_key, algorithms=[self._algorithm])
-            
-            # 检查令牌类型
-            if payload.get('type') != 'refresh':
-                self._logger_service.warning("令牌类型不匹配")
-                return None
-            
-            user_id = payload['user_id']
-            
-            # 检查刷新令牌是否有效
-            if not self._is_valid_refresh_token(user_id, refresh_token):
-                self._logger_service.warning("无效的刷新令牌")
-                return None
-            
-            # 获取用户信息
-            user_info = self._get_cached_user_info(user_id)
-            if not user_info:
-                self._logger_service.warning("用户信息不存在")
-                return None
-            
-            # 生成新的令牌对
-            return self.generate_tokens(user_info)
-            
-        except jwt.ExpiredSignatureError:
-            self._logger_service.warning("刷新令牌已过期")
-            return None
-        except jwt.InvalidTokenError as ex:
-            self._logger_service.warning(f"无效的刷新令牌: {ex}")
-            return None
-        except Exception as ex:
-            self._logger_service.error("刷新访问令牌时发生异常", ex)
-            return None
-    
-    def revoke_token(self, token: str) -> bool:
-        """
-        撤销令牌（加入黑名单）
-        
-        Args:
-            token: 要撤销的令牌
-            
-        Returns:
-            是否成功
-        """
-        try:
-            payload = jwt.decode(token, self._secret_key, algorithms=[self._algorithm])
-            exp = payload.get('exp', 0)
-            remaining_time = int(exp - time.time())
-            
-            if remaining_time > 0:
-                # 将令牌加入黑名单
-                self._blacklist_token(token, remaining_time)
-                return True
-            
-            return False
-            
-        except jwt.ExpiredSignatureError:
-            return True  # 已过期的令牌无需撤销
-        except jwt.InvalidTokenError as ex:
-            self._logger_service.warning(f"无效的令牌无法撤销: {ex}")
-            return False
-        except Exception as ex:
-            self._logger_service.error("撤销令牌时发生异常", ex)
-            return False
-    
-    def _cache_user_info(self, user_id: str, user_info: Dict[str, Any]) -> None:
-        """缓存用户信息"""
-        try:
-            key = f"user:{user_id}"
-            self._redis_service.set(key, user_info, self._refresh_token_expire)
-        except Exception as ex:
-            self._logger_service.warning("缓存用户信息失败", ex)
-    
-    def _get_cached_user_info(self, user_id: str) -> Optional[Dict[str, Any]]:
-        """获取缓存的用户信息"""
-        try:
-            key = f"user:{user_id}"
-            return self._redis_service.get(key)
-        except Exception as ex:
-            self._logger_service.warning("获取缓存的用户信息失败", ex)
-            return None
-    
-    def _cache_refresh_token(self, user_id: str, refresh_token: str) -> None:
-        """缓存刷新令牌"""
-        try:
-            key = f"refresh_token:{user_id}"
-            self._redis_service.set(key, refresh_token, self._refresh_token_expire)
-        except Exception as ex:
-            self._logger_service.warning("缓存刷新令牌失败", ex)
-    
-    def _is_valid_refresh_token(self, user_id: str, refresh_token: str) -> bool:
-        """检查刷新令牌是否有效"""
-        try:
-            key = f"refresh_token:{user_id}"
-            cached_token = self._redis_service.get(key)
-            return cached_token == refresh_token
-        except Exception as ex:
-            self._logger_service.warning("检查刷新令牌失败", ex)
-            return False
-    
-    def _blacklist_token(self, token: str, expire_time: int) -> None:
-        """将令牌加入黑名单"""
-        try:
-            key = f"blacklist:{token}"
-            self._redis_service.set(key, "1", expire_time)
-        except Exception as ex:
-            self._logger_service.warning("将令牌加入黑名单失败", ex)
-    
-    def _is_token_blacklisted(self, token: str) -> bool:
-        """检查令牌是否在黑名单中"""
-        try:
-            key = f"blacklist:{token}"
-            return self._redis_service.exists(key)
-        except Exception as ex:
-            self._logger_service.warning("检查令牌黑名单失败", ex)
-            return False
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/logger_service.py b/webapi/fastapi_of_letcoing/services/logger_service.py
deleted file mode 100644
index 0d984dc..0000000
--- a/webapi/fastapi_of_letcoing/services/logger_service.py
+++ /dev/null
@@ -1,58 +0,0 @@
-"""
-日志服务实现
-
-提供简单的日志记录功能。
-"""
-
-import logging
-from typing import Optional
-from interfaces.service_interfaces import ILoggerService
-
-
-class LoggerService(ILoggerService):
-    """日志服务实现"""
-    
-    def __init__(self, name: str = "letcoding", level: int = logging.INFO):
-        """
-        初始化日志服务
-        
-        Args:
-            name: 日志记录器名称
-            level: 日志级别
-        """
-        self._logger = logging.getLogger(name)
-        
-        # 避免重复添加处理器
-        if not self._logger.handlers:
-            # 创建控制台处理器
-            handler = logging.StreamHandler()
-            
-            # 创建格式化器
-            formatter = logging.Formatter(
-                '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
-            )
-            handler.setFormatter(formatter)
-            
-            # 添加处理器
-            self._logger.addHandler(handler)
-        
-        self._logger.setLevel(level)
-    
-    def info(self, message: str) -> None:
-        """记录信息日志"""
-        self._logger.info(message)
-    
-    def error(self, message: str, exception: Optional[Exception] = None) -> None:
-        """记录错误日志"""
-        if exception:
-            self._logger.error(f"{message}: {str(exception)}", exc_info=True)
-        else:
-            self._logger.error(message)
-    
-    def warning(self, message: str) -> None:
-        """记录警告日志"""
-        self._logger.warning(message)
-    
-    def debug(self, message: str) -> None:
-        """记录调试日志"""
-        self._logger.debug(message)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/redis_service.py b/webapi/fastapi_of_letcoing/services/redis_service.py
deleted file mode 100644
index dc49334..0000000
--- a/webapi/fastapi_of_letcoing/services/redis_service.py
+++ /dev/null
@@ -1,448 +0,0 @@
-"""
-Redis 缓存服务
-
-提供统一的 Redis 操作接口，支持缓存、会话管理和速率限制等功能
-"""
-
-import redis
-import json
-import time
-from typing import Optional, Any, Dict, List, Union
-from datetime import timedelta
-from interfaces.service_interfaces import IConfigService, ILoggerService, IRedisService
-from core.di_container import Injectable
-
-
-class RedisService(IRedisService, Injectable):
-    """Redis 服务实现类"""
-    
-    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
-        self._config_service = config_service
-        self._logger_service = logger_service
-        self._client = None
-        self._connected = False
-        self._connect()
-    
-    def _connect(self) -> bool:
-        """连接到 Redis 服务器"""
-        try:
-            redis_host = self._config_service.get_config('REDIS_HOST', 'localhost')
-            redis_port = self._config_service.get_config('REDIS_PORT', 6379)
-            redis_db = self._config_service.get_config('REDIS_DB', 0)
-            redis_password = self._config_service.get_config('REDIS_PASSWORD')
-            redis_timeout = self._config_service.get_config('REDIS_TIMEOUT', 5)
-            
-            self._client = redis.Redis(
-                host=redis_host,
-                port=redis_port,
-                db=redis_db,
-                password=redis_password,
-                decode_responses=True,
-                socket_timeout=redis_timeout,
-                socket_connect_timeout=redis_timeout
-            )
-            
-            # 测试连接
-            self._client.ping()
-            self._connected = True
-            self._logger_service.info(f"Redis 连接成功: {redis_host}:{redis_port}")
-            return True
-            
-        except Exception as ex:
-            self._connected = False
-            self._logger_service.error("Redis 连接失败", ex)
-            self._client = None
-            return False
-    
-    def is_connected(self) -> bool:
-        """检查是否连接到 Redis"""
-        return self._connected and self._client is not None
-    
-    def reconnect(self) -> bool:
-        """重新连接到 Redis"""
-        return self._connect()
-    
-    def set(self, key: str, value: Any, ttl: Optional[int] = None) -> bool:
-        """
-        设置键值对
-        
-        Args:
-            key: 键名
-            value: 值（会自动序列化为JSON字符串）
-            ttl: 过期时间（秒）
-            
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            serialized_value = json.dumps(value, ensure_ascii=False)
-            
-            if ttl:
-                return self._client.setex(key, ttl, serialized_value)
-            else:
-                return self._client.set(key, serialized_value)
-                
-        except Exception as ex:
-            self._logger_service.error(f"Redis 设置失败: {key}", ex)
-            return False
-    
-    def get(self, key: str, default: Any = None) -> Any:
-        """
-        获取键值
-        
-        Args:
-            key: 键名
-            default: 默认值
-            
-        Returns:
-            值（自动反序列化JSON）或默认值
-        """
-        if not self.is_connected():
-            return default
-        
-        try:
-            value = self._client.get(key)
-            if value is None:
-                return default
-            
-            return json.loads(value)
-            
-        except (json.JSONDecodeError, Exception) as ex:
-            self._logger_service.error(f"Redis 获取失败: {key}", ex)
-            return default
-    
-    def delete(self, key: str) -> bool:
-        """
-        删除键
-        
-        Args:
-            key: 键名
-            
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            return self._client.delete(key) > 0
-        except Exception as ex:
-            self._logger_service.error(f"Redis 删除失败: {key}", ex)
-            return False
-    
-    def exists(self, key: str) -> bool:
-        """
-        检查键是否存在
-        
-        Args:
-            key: 键名
-            
-        Returns:
-            是否存在
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            return self._client.exists(key) > 0
-        except Exception as ex:
-            self._logger_service.error(f"Redis 检查存在性失败: {key}", ex)
-            return False
-    
-    def expire(self, key: str, ttl: int) -> bool:
-        """
-        设置键的过期时间
-        
-        Args:
-            key: 键名
-            ttl: 过期时间（秒）
-            
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            return self._client.expire(key, ttl)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 设置过期时间失败: {key}", ex)
-            return False
-    
-    def ttl(self, key: str) -> int:
-        """
-        获取键的剩余过期时间
-        
-        Args:
-            key: 键名
-            
-        Returns:
-            剩余时间（秒），-1表示永不过期，-2表示键不存在
-        """
-        if not self.is_connected():
-            return -2
-        
-        try:
-            return self._client.ttl(key)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 获取TTL失败: {key}", ex)
-            return -2
-    
-    def increment(self, key: str, amount: int = 1) -> Optional[int]:
-        """
-        递增计数器
-        
-        Args:
-            key: 键名
-            amount: 递增量
-            
-        Returns:
-            递增后的值，失败返回None
-        """
-        if not self.is_connected():
-            return None
-        
-        try:
-            return self._client.incrby(key, amount)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 递增失败: {key}", ex)
-            return None
-    
-    def decrement(self, key: str, amount: int = 1) -> Optional[int]:
-        """
-        递减计数器
-        
-        Args:
-            key: 键名
-            amount: 递减量
-            
-        Returns:
-            递减后的值，失败返回None
-        """
-        if not self.is_connected():
-            return None
-        
-        try:
-            return self._client.decrby(key, amount)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 递减失败: {key}", ex)
-            return None
-    
-    def set_add(self, key: str, *members: Any) -> bool:
-        """
-        向集合添加成员
-        
-        Args:
-            key: 集合键名
-            members: 成员列表
-            
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            serialized_members = [json.dumps(member, ensure_ascii=False) for member in members]
-            return self._client.sadd(key, *serialized_members) > 0
-        except Exception as ex:
-            self._logger_service.error(f"Redis 集合添加失败: {key}", ex)
-            return False
-    
-    def set_remove(self, key: str, *members: Any) -> bool:
-        """
-        从集合移除成员
-        
-        Args:
-            key: 集合键名
-            members: 成员列表
-            
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            serialized_members = [json.dumps(member, ensure_ascii=False) for member in members]
-            return self._client.srem(key, *serialized_members) > 0
-        except Exception as ex:
-            self._logger_service.error(f"Redis 集合移除失败: {key}", ex)
-            return False
-    
-    def set_members(self, key: str) -> List[Any]:
-        """
-        获取集合所有成员
-        
-        Args:
-            key: 集合键名
-            
-        Returns:
-            成员列表
-        """
-        if not self.is_connected():
-            return []
-        
-        try:
-            members = self._client.smembers(key)
-            return [json.loads(member) for member in members]
-        except Exception as ex:
-            self._logger_service.error(f"Redis 获取集合成员失败: {key}", ex)
-            return []
-    
-    def set_is_member(self, key: str, member: Any) -> bool:
-        """
-        检查成员是否在集合中
-        
-        Args:
-            key: 集合键名
-            member: 成员
-            
-        Returns:
-            是否在集合中
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            serialized_member = json.dumps(member, ensure_ascii=False)
-            return self._client.sismember(key, serialized_member)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 检查集合成员失败: {key}", ex)
-            return False
-    
-    def list_push(self, key: str, *values: Any) -> Optional[int]:
-        """
-        向列表左侧推送元素
-        
-        Args:
-            key: 列表键名
-            values: 值列表
-            
-        Returns:
-            推送后的列表长度，失败返回None
-        """
-        if not self.is_connected():
-            return None
-        
-        try:
-            serialized_values = [json.dumps(value, ensure_ascii=False) for value in values]
-            return self._client.lpush(key, *serialized_values)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 列表推送失败: {key}", ex)
-            return None
-    
-    def list_pop(self, key: str) -> Any:
-        """
-        从列表右侧弹出元素
-        
-        Args:
-            key: 列表键名
-            
-        Returns:
-            弹出的元素，失败返回None
-        """
-        if not self.is_connected():
-            return None
-        
-        try:
-            value = self._client.rpop(key)
-            return json.loads(value) if value else None
-        except Exception as ex:
-            self._logger_service.error(f"Redis 列表弹出失败: {key}", ex)
-            return None
-    
-    def list_length(self, key: str) -> int:
-        """
-        获取列表长度
-        
-        Args:
-            key: 列表键名
-            
-        Returns:
-            列表长度
-        """
-        if not self.is_connected():
-            return 0
-        
-        try:
-            return self._client.llen(key)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 获取列表长度失败: {key}", ex)
-            return 0
-    
-    def list_range(self, key: str, start: int = 0, end: int = -1) -> List[Any]:
-        """
-        获取列表范围内的元素
-        
-        Args:
-            key: 列表键名
-            start: 起始索引
-            end: 结束索引
-            
-        Returns:
-            元素列表
-        """
-        if not self.is_connected():
-            return []
-        
-        try:
-            values = self._client.lrange(key, start, end)
-            return [json.loads(value) for value in values]
-        except Exception as ex:
-            self._logger_service.error(f"Redis 获取列表范围失败: {key}", ex)
-            return []
-    
-    def keys(self, pattern: str = "*") -> List[str]:
-        """
-        获取匹配模式的所有键
-        
-        Args:
-            pattern: 匹配模式
-            
-        Returns:
-            键列表
-        """
-        if not self.is_connected():
-            return []
-        
-        try:
-            return self._client.keys(pattern)
-        except Exception as ex:
-            self._logger_service.error(f"Redis 获取键列表失败: {pattern}", ex)
-            return []
-    
-    def flushdb(self) -> bool:
-        """
-        清空当前数据库
-        
-        Returns:
-            是否成功
-        """
-        if not self.is_connected():
-            return False
-        
-        try:
-            return self._client.flushdb()
-        except Exception as ex:
-            self._logger_service.error("Redis 清空数据库失败", ex)
-            return False
-    
-    def info(self) -> Optional[Dict[str, Any]]:
-        """
-        获取 Redis 服务器信息
-        
-        Returns:
-            服务器信息字典
-        """
-        if not self.is_connected():
-            return None
-        
-        try:
-            return self._client.info()
-        except Exception as ex:
-            self._logger_service.error("Redis 获取服务器信息失败", ex)
-            return None
\ No newline at end of file
-- 
Gitee


From 0a0c534a3f7ba9d1c2b6b4ceb8a925aa82bb007e Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 00:41:54 +0800
Subject: [PATCH 16/22] merge luckyfish and rain branches

-- 
Gitee


From c964a66def6ef2c1f00c6fdbeac839221ccc956b Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 00:53:35 +0800
Subject: [PATCH 17/22] merge xxy/oj-python branch

-- 
Gitee


From 3912e93aebf27b83a37879a8a09d9c3e943942c5 Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 00:58:50 +0800
Subject: [PATCH 18/22] merge czx branch

-- 
Gitee


From d38bdf25df77b24fe11723439cddf46991663cd4 Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 01:15:44 +0800
Subject: [PATCH 19/22] =?UTF-8?q?fix(Playground):=20=E7=A7=BB=E9=99=A4?=
 =?UTF-8?q?=E9=87=8D=E5=A4=8D=E7=9A=84=E4=BB=A3=E7=A0=81=E5=AF=BC=E5=85=A5?=
 =?UTF-8?q?=E5=8A=9F=E8=83=BD=E5=B9=B6=E4=BF=AE=E5=A4=8D=E6=A8=A1=E6=9D=BF?=
 =?UTF-8?q?=E7=BB=93=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

移除HEAD分支中重复的代码导入功能实现，保持代码简洁性。同时修复模板中未闭合的div标签，确保页面结构正确。
---
 webapp/letapp/src/pages/Playground.vue | 87 +-------------------------
 1 file changed, 1 insertion(+), 86 deletions(-)

diff --git a/webapp/letapp/src/pages/Playground.vue b/webapp/letapp/src/pages/Playground.vue
index 851cb65..4cfc168 100644
--- a/webapp/letapp/src/pages/Playground.vue
+++ b/webapp/letapp/src/pages/Playground.vue
@@ -148,92 +148,6 @@ const resetCode = () => {
   message.info('已重置所有内容');
 };
 
-<<<<<<< HEAD
-// 导入代码
-const importCode = () => {
-  // 创建隐藏的文件输入框
-  const fileInput = document.createElement('input');
-  fileInput.type = 'file';
-  fileInput.accept = '.js,.py,.java,.cpp,.go,.rs,.swift,.kt,.txt';
-  
-  // 文件选择事件处理
-  fileInput.onchange = (e) => {
-    const target = e.target as HTMLInputElement;
-    const file = target.files?.[0];
-    if (file) {
-      const reader = new FileReader();
-      
-      // 文件读取成功事件
-      reader.onload = (event) => {
-        const content = event.target?.result as string;
-        code.value = content;
-        
-        // 根据文件扩展名自动识别语言
-        const ext = file.name.split('.').pop()?.toLowerCase() || '';
-        const extToLanguage: { [key: string]: string } = {
-          js: 'javascript',
-          py: 'python',
-          java: 'java',
-          cpp: 'cpp',
-          go: 'go',
-          rs: 'rust',
-          swift: 'swift',
-          kt: 'kotlin'
-        };
-        
-        const detectedLanguage = extToLanguage[ext] || 'javascript';
-        selectedLanguage.value = detectedLanguage;
-        
-        // 显示成功提示
-        alert('代码已成功导入！');
-      };
-      
-      // 文件读取失败事件
-      reader.onerror = () => {
-        alert('读取文件失败！');
-      };
-      
-      // 开始读取文件
-      reader.readAsText(file);
-    }
-  };
-  
-  // 触发文件选择对话框
-  fileInput.click();
-};
-</script>
-
-<template>
-  <div class="min-h-screen bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
-    <!-- 页面标题栏 -->
-    <div class="bg-white dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700 sticky top-16 z-40">
-      <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4 flex flex-wrap items-center justify-between gap-4">
-        <div class="flex items-center gap-4">
-          <button 
-            class="p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors" 
-            @click="router.back()"
-          >
-            <Icon icon="material-symbols:arrow-back" class="w-5 h-5" />
-          </button>
-          <h1 class="text-2xl font-bold">在线代码编辑器</h1>
-        </div>
-        
-        <div class="flex items-center gap-3 flex-wrap">
-          <!-- 语言选择 -->
-          <div class="relative group">
-            <button 
-              class="flex items-center gap-2 px-4 py-2 bg-gray-100 dark:bg-gray-700 rounded-lg hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors border border-gray-200 dark:border-gray-600"
-              :title="currentLanguageInfo?.name || ''"
-              @click="isLanguageMenuOpen = !isLanguageMenuOpen"
-            >
-              <Icon :icon="currentLanguageInfo?.icon || ''" class="w-4 h-4" :style="{ color: currentLanguageInfo?.color || '#6B7280' }" />
-              <span class="hidden sm:inline">{{ currentLanguageInfo?.name || '' }}</span>
-              <Icon 
-                icon="material-symbols:arrow-drop-down" 
-                class="w-4 h-4 transition-transform duration-200"
-                :class="{ 'rotate-180': isLanguageMenuOpen }"
-              />
-=======
 // 导入代码
 const importCode = () => {
   // 创建隐藏的文件输入框
@@ -395,6 +309,7 @@ onUnmounted(() => {
               />
               <span>{{ isExecuting ? '执行中' : '运行' }}</span>
             </button>
+          </div>
         </div>
       </div>
     </div>
-- 
Gitee


From 7ce39f635378058e92964cf664daa3739c85df46 Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 12:22:52 +0800
Subject: [PATCH 20/22] =?UTF-8?q?feat(=E8=AE=A4=E8=AF=81):=20=E6=B7=BB?=
 =?UTF-8?q?=E5=8A=A0=E5=BF=98=E8=AE=B0=E5=AF=86=E7=A0=81=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

添加忘记密码页面及路由配置，修改登录页面的忘记密码链接指向新页面
---
 webapp/letapp/src/pages/ForgotPassword.vue | 162 +++++++++++++++++++++
 webapp/letapp/src/pages/Login.vue          |   4 +-
 webapp/letapp/src/router.ts                |   6 +
 3 files changed, 170 insertions(+), 2 deletions(-)
 create mode 100644 webapp/letapp/src/pages/ForgotPassword.vue

diff --git a/webapp/letapp/src/pages/ForgotPassword.vue b/webapp/letapp/src/pages/ForgotPassword.vue
new file mode 100644
index 0000000..8641f6c
--- /dev/null
+++ b/webapp/letapp/src/pages/ForgotPassword.vue
@@ -0,0 +1,162 @@
+<script setup lang="ts">
+import { ref } from 'vue';
+import { useRouter } from 'vue-router';
+import { Icon } from '@iconify/vue';
+import { NInput, NButton, useMessage } from 'naive-ui';
+
+const router = useRouter();
+const message = useMessage();
+
+// 表单数据
+const formData = ref({
+  studentId: ''
+});
+
+// 加载状态
+const isLoading = ref(false);
+
+// 表单错误信息
+const errors = ref({
+  studentId: ''
+});
+
+// 处理找回密码
+const handleRecoverPassword = async () => {
+  // 重置错误信息
+  errors.value = {
+    studentId: ''
+  };
+  
+  // 表单验证
+  let isValid = true;
+  
+  if (!formData.value.studentId.trim()) {
+    errors.value.studentId = '请输入学号';
+    isValid = false;
+  }
+  
+  if (!isValid) {
+    return;
+  }
+  
+  isLoading.value = true;
+  
+  try {
+    // 模拟处理
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    
+    message.info('请联系管理员进行密码更改');
+    // 跳转回登录页面
+    router.push('/login');
+  } catch (error) {
+    message.error(`操作失败: ${error instanceof Error ? error.message : '未知错误'}`);
+  } finally {
+    isLoading.value = false;
+  }
+};
+
+// 跳转到登录页面
+const goToLogin = () => {
+  router.push('/login');
+};
+</script>
+
+<template>
+  <div class="min-h-screen flex items-center justify-center bg-gray-100 dark:bg-gray-900 py-12 px-4 sm:px-6 lg:px-8">
+    <div class="w-full max-w-md">
+      <!-- Logo 和标题 -->
+      <div class="text-center mb-8">
+        <div class="flex justify-center mb-4">
+          <img src="/assets/logo.png" alt="Let Coding" class="w-16 h-16" />
+        </div>
+        <h1 class="text-2xl font-bold text-gray-900 dark:text-white">找回密码</h1>
+        <p class="mt-2 text-sm text-gray-600 dark:text-gray-300">
+          输入您的学号，我们将协助您找回密码
+        </p>
+      </div>
+      
+      <!-- 忘记密码表单 -->
+      <div class="bg-white dark:bg-gray-800 rounded-lg shadow-md overflow-hidden border border-gray-200 dark:border-gray-700 p-6">
+        <!-- 锁图标 -->
+        <div class="flex justify-center mb-4">
+          <div class="w-12 h-12 rounded-full bg-blue-100 dark:bg-blue-900 flex items-center justify-center">
+            <Icon icon="material-symbols:lock" class="w-6 h-6 text-blue-600 dark:text-blue-400" />
+          </div>
+        </div>
+        
+        <!-- 学号输入 -->
+        <div class="space-y-4">
+          <div class="space-y-2">
+            <label for="studentId" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
+              学号
+            </label>
+            <NInput
+              v-model:value="formData.studentId"
+              placeholder="输入您的学号"
+              id="studentId"
+              :bordered="true"
+              :class="[
+                'w-full rounded-lg',
+                errors.studentId ? 'border-red-500 dark:border-red-400' : 'border-gray-300 dark:border-gray-600'
+              ]"
+            />
+            <!-- 错误信息 -->
+            <p v-if="errors.studentId" class="text-xs text-red-600 dark:text-red-400 mt-1">{{ errors.studentId }}</p>
+          </div>
+          
+          <!-- 继续按钮 -->
+          <NButton
+            type="primary"
+            block
+            :loading="isLoading"
+            @click="handleRecoverPassword"
+            :class="[
+              'w-full py-3 px-4 rounded-lg font-medium',
+              'bg-blue-600 text-white hover:bg-blue-700 active:bg-blue-800',
+              'transition-colors'
+            ]"
+          >
+            继续
+          </NButton>
+          
+          <!-- 回到登录 -->
+          <div class="text-center">
+            <button
+              @click="goToLogin"
+              class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors"
+            >
+              ← 返回登录
+            </button>
+          </div>
+        </div>
+      </div>
+      
+      <!-- 页脚 -->
+      <div class="mt-8 text-center text-sm text-gray-500 dark:text-gray-400">
+        <p>© {{ new Date().getFullYear() }} Let Coding. 保留所有权利。</p>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+/* 自定义滚动条样式 */
+::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: #f1f1f1;
+  dark:bg-gray-800;
+}
+
+::-webkit-scrollbar-thumb {
+  background: #888;
+  border-radius: 3px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: #555;
+}
+</style>
\ No newline at end of file
diff --git a/webapp/letapp/src/pages/Login.vue b/webapp/letapp/src/pages/Login.vue
index 7e2a3c0..7222681 100644
--- a/webapp/letapp/src/pages/Login.vue
+++ b/webapp/letapp/src/pages/Login.vue
@@ -135,9 +135,9 @@ const handleRegister = () => {
               <label for="password" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
                 密码
               </label>
-              <a href="#" class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">
+              <router-link to="/forgot-password" class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">
                 忘记密码？
-              </a>
+              </router-link>
             </div>
             <div class="relative h-12">
               <div class="absolute left-0 top-0 bottom-0 w-12 flex items-center justify-center z-10">
diff --git a/webapp/letapp/src/router.ts b/webapp/letapp/src/router.ts
index 27edb08..0d101ad 100644
--- a/webapp/letapp/src/router.ts
+++ b/webapp/letapp/src/router.ts
@@ -41,6 +41,12 @@ const routes = [
         meta: {title: "登录 - Let Coding"},
         component: () => import('./pages/Login.vue'),
     },
+    {
+        path: "/forgot-password",
+        name: "forgotPassword",
+        meta: {title: "忘记密码 - Let Coding"},
+        component: () => import('./pages/ForgotPassword.vue'),
+    },
     {
         path: "/admin",
         name: "admin",
-- 
Gitee


From 2cc8da26f13c2bb790f2b752f9a3e2754f8a54b1 Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Thu, 12 Mar 2026 12:29:17 +0800
Subject: [PATCH 21/22] =?UTF-8?q?fix(Home):=20=E6=9B=B4=E6=96=B0B=E7=AB=99?=
 =?UTF-8?q?=E9=93=BE=E6=8E=A5=E4=B8=BA=E7=AE=80=E6=B4=81=E7=89=88=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapp/letapp/src/pages/Home.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webapp/letapp/src/pages/Home.vue b/webapp/letapp/src/pages/Home.vue
index 9d9e6d8..36bf669 100644
--- a/webapp/letapp/src/pages/Home.vue
+++ b/webapp/letapp/src/pages/Home.vue
@@ -216,7 +216,7 @@ const features = readonly([
               <a href="https://gitee.com/XAUATiOSClub" target="_blank" rel="noopener noreferrer" class="text-gray-400 hover:text-white transition-colors" title="Gitee">
                 <Icon icon="simple-icons:gitee" class="w-5 h-5" />
               </a>
-              <a href="https://space.bilibili.com/1283819651?spm_id_from=333.337.search-card.all.click" target="_blank" rel="noopener noreferrer" class="text-gray-400 hover:text-white transition-colors" title="B站">
+              <a href="https://space.bilibili.com/1283819651" target="_blank" rel="noopener noreferrer" class="text-gray-400 hover:text-white transition-colors" title="B站">
                 <Icon icon="simple-icons:bilibili" class="w-5 h-5" />
               </a>
               <a href="https://www.douyin.com/user/MS4wLjABAAAA042crZROwmNV69KtvhQSGtyLEZZATt4z1ewoXk-dLxCmt2S_DNus5c2KP_5S2CTY?_sw=4167573395234171&enter_from=general_search&enter_method=general_search&extra_params=%7B%22search_params%22%3A%7B%22search_result_id%22%3A%221612337042431609%22%2C%22relation_tag%22%3A0%2C%22log_pb%22%3A%7B%22impr_id%22%3A%2220241107211419AA5B58FD61D13326A614%22%7D%2C%22search_type%22%3A%22general%22%2C%22impr_id%22%3A%2220241107211419AA5B58FD61D13326A614%22%2C%22search_id%22%3A%2220241107211419AA5B58FD61D13326A614%22%2C%22search_keyword%22%3A%22%20%E8%A5%BF%E5%BB%BA%E5%A4%A7iOS%20Club%22%2C%22token_type%22%3A%22discover_list%22%7D%7D&from_tab_name=main" target="_blank" rel="noopener noreferrer" class="text-gray-400 hover:text-white transition-colors" title="抖音">
-- 
Gitee


From b586a1fbcd8dadddf23d7bbdb6f73679aeca976c Mon Sep 17 00:00:00 2001
From: huang15963 <599493321@qq.com>
Date: Sat, 28 Mar 2026 13:44:55 +0800
Subject: [PATCH 22/22] =?UTF-8?q?=E6=8E=A5=E9=80=9A=E5=89=8D=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E6=8E=A5=E5=8F=A3=E5=B9=B6=E5=AE=8C=E5=96=84=E9=A1=B5?=
 =?UTF-8?q?=E9=9D=A2=E8=81=94=E8=B0=83?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 webapi/.DS_Store                              |  Bin 0 -> 8196 bytes
 webapi/fastapi_of_letcoing/.gitignore         |   47 +
 webapi/fastapi_of_letcoing/AGENTS.md          |  234 +++
 webapi/fastapi_of_letcoing/CLAUDE.md          |  536 ++++++
 .../fastapi_of_letcoing/DEVELOPMENT_GUIDE.md  | 1528 +++++++++++++++++
 webapi/fastapi_of_letcoing/README.md          |  455 +++++
 .../controllers/__init__.py                   |    1 +
 .../controllers/auth_controller.py            |  264 +++
 .../controllers/code_controller.py            |  130 ++
 .../controllers/course_controller.py          |  200 +++
 .../controllers/question_controller.py        |   87 +
 .../controllers/user_controller.py            |  189 ++
 webapi/fastapi_of_letcoing/core/db_config.py  |   58 +
 .../fastapi_of_letcoing/core/db_container.py  |   67 +
 .../fastapi_of_letcoing/core/di_container.py  |  216 +++
 .../core/service_config.py                    |   59 +
 .../interfaces/__init__.py                    |    0
 .../interfaces/course_interfaces.py           |   55 +
 .../interfaces/service_interfaces.py          |  303 ++++
 .../interfaces/user_interfaces.py             |   32 +
 webapi/fastapi_of_letcoing/main.py            |  105 ++
 .../middleware/auth_middleware.py             |  200 +++
 webapi/fastapi_of_letcoing/models/__init__.py |    0
 .../fastapi_of_letcoing/models/auth_models.py |  182 ++
 .../models/course_models.py                   |   49 +
 .../fastapi_of_letcoing/models/db_models.py   |  145 ++
 .../fastapi_of_letcoing/models/glot_models.py |   67 +
 .../models/question_models.py                 |   33 +
 .../fastapi_of_letcoing/models/user_models.py |    6 +
 .../fastapi_of_letcoing/models/user_modles.py |   28 +
 webapi/fastapi_of_letcoing/requirements.txt   |   37 +
 .../services/config_service.py                |   50 +
 .../services/course_service.py                |  119 ++
 .../services/database_service.py              |  134 ++
 .../services/glot_service.py                  |  187 ++
 .../services/jwt_service.py                   |  251 +++
 .../services/logger_service.py                |   58 +
 .../services/oidc_service.py                  |  206 +++
 .../services/question_service.py              |   56 +
 .../services/redis_service.py                 |  448 +++++
 .../services/user_service.py                  |  137 ++
 webapp/letapp/package.json                    |    1 +
 webapp/letapp/src/pages/About.vue             |    4 +-
 webapp/letapp/src/pages/Learn.vue             |  468 +++--
 webapp/letapp/src/pages/Login.vue             |  485 +++---
 webapp/letapp/src/pages/Playground.vue        |  686 +++-----
 webapp/letapp/src/pages/admin/Dashboard.vue   |  417 ++---
 webapp/letapp/src/pages/admin/Users.vue       |  881 +++++-----
 webapp/letapp/src/services/api.ts             |  205 +++
 webapp/letapp/vite.config.ts                  |    9 +
 50 files changed, 8568 insertions(+), 1547 deletions(-)
 create mode 100644 webapi/.DS_Store
 create mode 100644 webapi/fastapi_of_letcoing/.gitignore
 create mode 100644 webapi/fastapi_of_letcoing/AGENTS.md
 create mode 100644 webapi/fastapi_of_letcoing/CLAUDE.md
 create mode 100644 webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
 create mode 100644 webapi/fastapi_of_letcoing/README.md
 create mode 100644 webapi/fastapi_of_letcoing/controllers/__init__.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/auth_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/code_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/course_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/question_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/controllers/user_controller.py
 create mode 100644 webapi/fastapi_of_letcoing/core/db_config.py
 create mode 100644 webapi/fastapi_of_letcoing/core/db_container.py
 create mode 100644 webapi/fastapi_of_letcoing/core/di_container.py
 create mode 100644 webapi/fastapi_of_letcoing/core/service_config.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/__init__.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
 create mode 100644 webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
 create mode 100644 webapi/fastapi_of_letcoing/main.py
 create mode 100644 webapi/fastapi_of_letcoing/middleware/auth_middleware.py
 create mode 100644 webapi/fastapi_of_letcoing/models/__init__.py
 create mode 100644 webapi/fastapi_of_letcoing/models/auth_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/course_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/db_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/glot_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/question_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/user_models.py
 create mode 100644 webapi/fastapi_of_letcoing/models/user_modles.py
 create mode 100644 webapi/fastapi_of_letcoing/requirements.txt
 create mode 100644 webapi/fastapi_of_letcoing/services/config_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/course_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/database_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/glot_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/jwt_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/logger_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/oidc_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/question_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/redis_service.py
 create mode 100644 webapi/fastapi_of_letcoing/services/user_service.py
 create mode 100644 webapp/letapp/src/services/api.ts

diff --git a/webapi/.DS_Store b/webapi/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..0b57f5e4d8ceb12f3efcdf531ea44806d12a461a
GIT binary patch
literal 8196
zcmeHMU2GLa6rOKd%3fI8g;v|*-Eg5LNK;DrF)aw@_D}gQ(AM4-<Z|!brCr?amb-gz
zOTpNf_@aXGN#j3H8jU;{P~(dxDx!~CA27xTqDFneL|;@MJhQVUwxtOV#;EKhJKvs}
zIWs%oo^Pk;mNAC*g0Y^l8pfDHmq2YXRW~T2UtDtv4_itJLH>+o*eJ7Dnz`)goY7H3
z#6ZMA#6ZMA#6ZNrzkvZdvqe$nIrn96R7VU%4BV0oi0?y!E`iAqCnW}-4yu9_fKa3W
zL7{uf0|K8!h{+HqB?hiEr_3G@x*|+5Al<1yA%+tsL!6W--5I1iL%1@+3<bgJ<d+DB
zGbANOb;Ll#z+47|d@3nh&oGbqGxGN|vzbY4Im+fO=CC2d%h_4iwZ$Yi>0*1uj;!rw
z87t|@j@p*zH#dI;UQ)WCY@rfcv{=1O?@tX39#qrX(xPRKb&vX%>v#{Cd5<uyRd~bh
z*p8g*?8}>?zdz^Ng%QU~YfEw&J6EtXzS(BmJ=TOtZ53WF@7nf0*R#Yl11aAe_eI~F
zuGFCC=KYRfvXn*h%TZdvGY^<FsZ}&PX=<-(7Ga2;E3aN&f7jX#EnAaaJNE3Ks?e4!
zt*lbjLCY{5-#TiU`MxpB@P`L7Ue0t3%Ngn~TAr1)&0Z%nVlF{rEH+h9Q@iZWxUSDP
zG*!r2#|xH!LaS4hV2#8IT|H#bGwpE=v5KKxP-q@nebowGKPY-S@+Q?r=&+_iS9?9$
zyp{<EHmy_D-iIv5&^+-7<hpT_s`uHMtZ8dTOs><qS=IZCl7DSi*to4q)l)flWQ4Zp
zg>7x^x_($JyF26g-J_;Mk8~+q`#$O$^oBEevwO@j^I_{wY7Jf~wF{>%!}8srli1ix
zyBHADwHZdRhh;Uj6?%`}r)ZxmX-%`7qUF<zp;tvv@RYjgS5ud4khgUo49S~-=(=RH
zv|@C!=xhV)WV_iBmS-o~Y4$8T%g(cp*+upx`-c6<uCm_%lp%&iSd1zxLp>UCH(Jn&
z&1gqA_TvD0a0tV&a10*CF@cjfg~#wXp2TUK!83RfFXI)Q#p`$r=WzjV<9%Ghr}zwC
z;0nIQclaJx@jL#&HNJpX^BP{uSMo-_mN)Sh-paS|d-z`7%~L$Xk8zie%MI}G$YT#m
zd%ET)=<eo)I4Xt6&)ryv@%y*$*tzS!BgD()QhK-FQJq-Tux?Z9wzlgbDr0&&jQ=W*
zKoK)^6euEym|4+0B{ixppVseevG$Ra%yC61T3aYbuT<+5l9IMSnyb|{3W-Q7lV)SQ
zNg>&4JTTSu@r^MOr&c1(#&}Ci(IAa2>ed*^R4bLHt|ntKjRi)$Bi^Nu)HLPq(!gbQ
zh5f*OX4gmq<)}mrR->6B|6XjzUW$DY`F%KyG&0D-zz7_S;y9_`6duMSn8c%af>dw@
zPvL1ihv)GEUc#$*jg;^P-XtBogLm;BKEy}3h)+UAd`)`z3BSyW@jcVgEfK%oe2f=+
z@{a8~;v+Dvn3<DB)=UOUq*){K|E~Fe|DWj;SrG#f1OF=qP}<qk*-l%U@3Sd#?F3y%
z=n_SYo0J&1P!*)(gh4t^c>N!Sbf2K1!Y3Kxq(o|=@{j)zFkwdL|IELEqw_zA#9OQS
E6I6*g9{>OV

literal 0
HcmV?d00001

diff --git a/webapi/fastapi_of_letcoing/.gitignore b/webapi/fastapi_of_letcoing/.gitignore
new file mode 100644
index 0000000..f436353
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/.gitignore
@@ -0,0 +1,47 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+.env
+.env.local
+.env.development.local
+.env.production.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea/
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+bin/
+obj/
+/packages/
+riderModule.iml
+/_ReSharper.Caches/
+*.db
+*.db-shm
+*.db-wal
+
+keys/
+logs/
+
+appsettings.Development.json
+
+.venv/
+venv/
+
+*.pyc
diff --git a/webapi/fastapi_of_letcoing/AGENTS.md b/webapi/fastapi_of_letcoing/AGENTS.md
new file mode 100644
index 0000000..fb63080
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/AGENTS.md
@@ -0,0 +1,234 @@
+# AGENTS.md
+
+**请使用中文回答和中文解释**
+
+This document provides guidelines for agentic coding agents working on this Flask-based code execution API service.
+
+## Project Overview
+
+This is a Flask web API service that provides code execution capabilities by integrating with the Glot.io API. The service supports 30+ programming languages and uses asynchronous HTTP requests for better performance.
+
+**Architecture:**
+- `main.py` - Flask application entry point with API routes
+- `services/glot_service.py` - Core service for Glot.io API integration
+- `controller/` - Directory for future controller implementations
+
+## Development Commands
+
+### Running the Application
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Start development server
+python3 main.py
+```
+
+The application runs on `http://localhost:5000` by default.
+
+### Testing
+This project currently does not have a formal test suite. When implementing tests:
+
+```bash
+# Run pytest (if added)
+python3 -m pytest
+
+# Run specific test file
+python3 -m pytest tests/test_service.py
+
+# Run with coverage
+python3 -m pytest --cov=services
+```
+
+### Code Quality
+```bash
+# Check syntax
+python3 -m py_compile main.py services/glot_service.py
+
+# Format code (if black is added)
+black main.py services/
+
+# Lint (if flake8 is added)
+flake8 main.py services/
+```
+
+## Code Style Guidelines
+
+### Imports
+- Standard library imports first, then third-party, then local imports
+- Use absolute imports for local modules
+- Keep imports sorted alphabetically within each section
+```python
+import asyncio
+import os
+from typing import Dict, List, Optional
+
+import aiohttp
+from flask import Flask, request, jsonify
+
+from services.glot_service import GlotService
+```
+
+### Formatting and Naming
+- **PEP 8 compliant** - Use 4 spaces for indentation
+- **Line length**: Maximum 88-100 characters
+- **Variable names**: `snake_case` for functions and variables
+- **Class names**: `PascalCase` for classes
+- **Constants**: `UPPER_SNAKE_CASE` for module-level constants
+- **Private methods**: Prefix with underscore `_`
+
+### Type Hints
+- Use type hints for all function parameters and return values
+- Import from `typing` module for complex types
+- Use `Optional[T]` for nullable types
+
+```python
+async def run_glot_async(self, 
+                        api_token: str, 
+                        code: str, 
+                        language: str = "javascript", 
+                        stdin: Optional[str] = None) -> str:
+```
+
+### Data Models
+- Use `@dataclass` for data structures
+- Provide `to_dict()` methods for serialization
+- Initialize list/dict defaults properly in `__post_init__`
+
+```python
+@dataclass
+class PostDataModel:
+    files: List[PostFile] = None
+    stdin: Optional[str] = None
+    
+    def __post_init__(self):
+        if self.files is None:
+            self.files = []
+    
+    def to_dict(self):
+        return {
+            "files": [f.to_dict() for f in self.files],
+            "stdin": self.stdin
+        }
+```
+
+### Error Handling
+- Use try-except blocks for API calls and I/O operations
+- Handle specific exceptions when possible
+- Return meaningful error messages to users
+- Log errors appropriately (logging not currently implemented)
+
+```python
+try:
+    async with aiohttp.ClientSession(timeout=self.timeout) as session:
+        async with session.post(url, json=data, headers=headers) as response:
+            # Handle response
+except asyncio.TimeoutError:
+    return "请求超时"
+except aiohttp.ClientError as ex:
+    return f"请求出错: {str(ex)}"
+except Exception as ex:
+    return f"请求出错: {str(ex)}"
+```
+
+### API Endpoints
+- Use Flask decorators for routing
+- Validate input parameters
+- Return JSON responses with appropriate HTTP status codes
+- Handle missing required fields gracefully
+
+```python
+@app.route('/run', methods=['POST'])
+async def post():
+    # Validate input
+    model = request.get_json()
+    if not model:
+        return jsonify({'error': '请求体不能为空'}), 400
+    
+    # Extract and validate parameters
+    code = model.get('code', '')
+    if not code or code.strip() == "":
+        return jsonify({'error': '代码不能为空'}), 400
+    
+    # Process and return response
+    result = await glot_service.run_glot_async(api_token, code, language, stdin)
+    return jsonify(result), 200
+```
+
+### Security Considerations
+- Escape output to prevent injection attacks
+- Validate API tokens from environment variables
+- Use HTTPS for external API calls
+- Never log sensitive information like API tokens
+
+```python
+@staticmethod
+def _escape(text: str) -> str:
+    if not text:
+        return ""
+    return (text
+            .replace("&", "&amp;")
+            .replace("<", "&lt;")
+            .replace(">", "&gt;"))
+```
+
+## Configuration
+
+### Environment Variables
+- `API_TOKEN`: Required Glot.io API token
+- Can be set via environment variable or Flask app config
+
+### Constants
+- Language mappings stored as class constant `LANGUAGES`
+- Default timeout: 30 seconds for HTTP requests
+
+## Patterns to Follow
+
+### Async/Await
+- Use async/await for all HTTP requests
+- Properly handle async context managers with `async with`
+
+### Service Layer Pattern
+- Business logic separated from Flask routes
+- Services should be reusable and testable
+- Use dependency injection for service instances
+
+### Data Transfer Objects
+- Use dataclasses for request/response models
+- Provide serialization methods
+- Validate data at service boundaries
+
+## Dependencies
+
+Key dependencies and their purposes:
+- `Flask`: Web framework
+- `aiohttp`: Async HTTP client for Glot.io API calls
+- `requests`: Alternative HTTP client (currently unused)
+- `dataclasses`: Built-in data modeling (Python 3.7+)
+
+## Common Tasks
+
+### Adding New Language Support
+1. Add language mapping to `LANGUAGES` dictionary in `GlotService`
+2. Update documentation in README.md
+3. Test the new language integration
+
+### Adding New API Endpoints
+1. Define route in `main.py` using `@app.route()`
+2. Validate request data
+3. Call appropriate service methods
+4. Return JSON response with proper status code
+
+### Modifying Service Logic
+1. Update methods in `GlotService` class
+2. Maintain async/await pattern
+3. Update data models if needed
+4. Test error scenarios
+
+## Future Considerations
+
+- Consider adding comprehensive test suite with pytest
+- Implement proper logging instead of return strings
+- Add API rate limiting
+- Implement caching for repeated requests
+- Consider using FastAPI instead of Flask for better async support
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/CLAUDE.md b/webapi/fastapi_of_letcoing/CLAUDE.md
new file mode 100644
index 0000000..33d48f6
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/CLAUDE.md
@@ -0,0 +1,536 @@
+# CLAUDE.md
+
+**请使用中文回答和中文解释**
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a **Flask-based code execution API service** (LetCoding API) that allows users to execute code in 30+ programming languages via the Glot.io API. The project features a sophisticated dependency injection architecture, JWT authentication with OAuth support (GitHub, custom OIDC), Redis caching, and PostgreSQL database integration using Peewee ORM.
+
+**Key Technologies:**
+- Flask 3.1.2 + Flask-RESTX for API documentation
+- aiohttp for async HTTP requests
+- PostgreSQL with Peewee ORM
+- Redis for caching and session management
+- JWT + OAuth (GitHub, OIDC)
+- Custom dependency injection container
+
+## Essential Commands
+
+### Development
+
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Run development server (port 6173)
+python main.py
+
+# API documentation available at:
+# http://localhost:6173/swagger/
+```
+
+### Database Operations
+
+```bash
+# Initialize database tables
+# Tables are created automatically on first run via Peewee ORM
+# Models defined in models/db_models.py
+
+# Test database connection (in Python)
+from services.database_service import DatabaseService
+from core.di_container import inject
+db = inject(DatabaseService)
+db.test_connection()
+```
+
+### Redis Operations
+
+```bash
+# Test Redis connection
+redis-cli ping
+
+# Monitor Redis operations
+redis-cli monitor
+
+# Clear Redis cache (use with caution)
+redis-cli FLUSHDB
+```
+
+### Testing
+
+```bash
+# Currently no formal test suite
+# Manual API testing:
+curl http://localhost:6173/auth/providers
+curl -X POST http://localhost:6173/code/run/public \
+  -H "Content-Type: application/json" \
+  -d '{"code": "console.log(\"Hello\")", "language": "javascript"}'
+```
+
+## Architecture Overview
+
+### Layered Architecture
+
+This project follows a strict layered architecture with dependency injection:
+
+```
+Request Flow:
+HTTP Request → Middleware (auth) → Controller → Service Layer → External APIs/Database/Redis
+
+Layer Responsibilities:
+- Controllers (controllers/): HTTP routing, request validation, response formatting
+- Services (services/): Business logic, external API calls, data processing
+- Middleware (middleware/): Authentication, rate limiting
+- Models (models/): Data structures (dataclasses for API models, Peewee for DB models)
+- Core (core/): DI container, service configuration, database configuration
+- Interfaces (interfaces/): Abstract service interfaces (ABC)
+```
+
+### Dependency Injection System
+
+**The project uses a custom DI container** (`core/di_container.py`) with three lifecycles:
+
+1. **Singleton**: One instance per application (ConfigService, LoggerService, RedisService, DatabaseService)
+2. **Scoped**: One instance per request (GlotService)
+3. **Transient**: New instance every time (rarely used)
+
+**How to use DI:**
+
+```python
+# Method 1: Constructor injection (preferred for services)
+from interfaces.service_interfaces import IConfigService, ILoggerService
+from core.di_container import Injectable
+
+class MyService(Injectable):
+    def __init__(self, config: IConfigService, logger: ILoggerService):
+        self._config = config
+        self._logger = logger
+
+# Method 2: Runtime injection (for controllers, one-off usage)
+from core.di_container import inject
+from services.user_service import UserService
+
+def my_function():
+    user_service = inject(UserService)
+    return user_service.get_user_by_id(123)
+```
+
+**Service Registration** happens in `core/service_config.py`:
+
+```python
+def service_configurator(container):
+    container.register_singleton(IConfigService, factory=lambda: ConfigService(app_config))
+    container.register_singleton(IRedisService, RedisService)
+    container.register_scoped(ICodeExecutionService, GlotService)
+```
+
+### Database Architecture
+
+The project uses **modular database services** built on Peewee ORM:
+
+- **Base Service**: `DatabaseService` provides generic CRUD operations
+- **Specialized Services**: `UserService`, `CodeExecutionService`, `APIService` inherit from `DatabaseService`
+- **Models**: Defined in `models/db_models.py`, all inherit from `BaseModel`
+
+**Key database services:**
+- `DatabaseService`: Generic CRUD, connection management
+- `UserService`: User-specific operations (create_user, get_user_by_username, etc.)
+- `UserService` and similar services inherit both `DatabaseService` and `Injectable`
+
+**Database configuration** is managed through environment variables (see main.py:26-33):
+- DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD
+- DB_MAX_CONNECTIONS, DB_STALE_TIMEOUT
+
+### Service Layer Patterns
+
+**Key Services and Their Purposes:**
+
+1. **ConfigService** (`services/config_service.py`): Centralized configuration management from environment variables
+2. **GlotService** (`services/glot_service.py`): Async code execution via Glot.io API
+3. **OIDCService** (`services/oidc_service.py`): OAuth/OIDC authentication (GitHub, custom providers)
+4. **JWTService** (`services/jwt_service.py`): JWT token generation, verification, refresh
+5. **RedisService** (`services/redis_service.py`): Caching, session management, rate limiting
+6. **DatabaseService** (`services/database_service.py`): Base database operations with Peewee
+7. **UserService** (`services/user_service.py`): User management (create, query, update users)
+8. **LoggerService** (`services/logger_service.py`): Structured logging
+
+### Authentication System
+
+The project implements **multi-provider OAuth + JWT**:
+
+1. **OIDC Flow**: User initiates login → redirected to OAuth provider → callback handles token exchange → JWT tokens issued
+2. **JWT Tokens**: Access token (short-lived, default 1h) + Refresh token (long-lived, default 7d)
+3. **Middleware**: `AuthMiddleware` provides decorators:
+   - `@AuthMiddleware.require_auth`: Protected endpoints
+   - `@AuthMiddleware.optional_auth`: Guest/authenticated access
+   - `@AuthMiddleware.rate_limit(max_requests, window_seconds)`: Rate limiting
+4. **Token Management**: Redis stores token blacklist, refresh tokens, user sessions
+
+**Supported OAuth Providers:**
+- GitHub OAuth (via GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET)
+- Custom OIDC providers (via OIDC_PROVIDERS JSON env var)
+
+### Redis Usage Patterns
+
+Redis is used for:
+1. **JWT Token Blacklist**: Revoked tokens stored with TTL matching token expiry
+2. **Rate Limiting**: Counter keys like `rate_limit:{user_id}:{endpoint}` with TTL
+3. **Code Execution Cache**: Cache results for identical code+language combinations
+4. **User Session Data**: Temporary user information with TTL
+
+**Key naming conventions:**
+- `user:profile:{user_id}` - User profile cache
+- `session:{session_id}` - User session data
+- `rate_limit:api:{user_id}:{endpoint}` - Rate limit counters
+- `blacklist:token:{jti}` - Revoked JWT tokens
+
+## Critical Implementation Details
+
+### Adding a New Service
+
+Complete workflow (follow this order):
+
+1. **Define interface** in `interfaces/service_interfaces.py`:
+```python
+class IMyService(ABC):
+    @abstractmethod
+    def my_method(self) -> str:
+        pass
+```
+
+2. **Implement service** in `services/my_service.py`:
+```python
+from interfaces.service_interfaces import IMyService, IConfigService
+from core.di_container import Injectable
+
+class MyService(IMyService, Injectable):
+    def __init__(self, config: IConfigService):
+        self._config = config
+
+    def my_method(self) -> str:
+        return "result"
+```
+
+3. **Register service** in `core/service_config.py`:
+```python
+def service_configurator(container):
+    # ... existing registrations ...
+    container.register_singleton(IMyService, MyService)
+```
+
+4. **Create controller** in `controllers/my_controller.py`:
+```python
+from flask_restx import Namespace, Resource
+from core.di_container import inject
+
+api = Namespace('my_module', description='My module')
+
+@api.route('/action')
+class MyController(Resource):
+    def get(self):
+        service = inject(IMyService)
+        return {'result': service.my_method()}
+```
+
+5. **Register namespace** in `main.py`:
+```python
+from controllers.my_controller import api as my_api
+api.add_namespace(my_api, path='/my-module')
+```
+
+### Database Service Pattern
+
+When creating a new database-backed service:
+
+1. **Define model** in `models/db_models.py`:
+```python
+class MyModel(BaseModel):
+    name = CharField(max_length=100, unique=True)
+    value = TextField()
+
+    class Meta:
+        table_name = "my_table"
+```
+
+2. **Create service** inheriting from `DatabaseService`:
+```python
+from services.database_service import DatabaseService
+from core.di_container import Injectable
+
+class MyTableService(DatabaseService, Injectable):
+    async def create_record(self, name: str, value: str) -> Dict[str, Any]:
+        return await self.create(MyModel, name=name, value=value)
+
+    async def get_by_name(self, name: str) -> Optional[Dict[str, Any]]:
+        try:
+            record = MyModel.get(MyModel.name == name)
+            return record.to_dict()
+        except DoesNotExist:
+            return None
+```
+
+3. **Register in service config** with factory function:
+```python
+def service_configurator(container):
+    def create_my_table_service():
+        config = container.resolve(IConfigService)
+        return MyTableService(config)
+
+    container.register_singleton(MyTableService, factory=create_my_table_service)
+```
+
+### Working with Async Code
+
+The project mixes **sync Flask with async services**:
+
+- Flask routes are sync, but services use `async/await`
+- Use `asyncio.run()` or `asyncio.create_task()` to call async services from sync controllers
+- GlotService uses `aiohttp` for async HTTP requests
+- All database operations are async (though Peewee itself is sync, the service layer wraps them)
+
+Example:
+```python
+import asyncio
+
+@api.route('/execute')
+class ExecuteController(Resource):
+    def post(self):
+        service = inject(ICodeExecutionService)
+        # Call async method from sync controller
+        result = asyncio.run(service.execute_code(request.get_json()))
+        return result
+```
+
+### Environment Configuration
+
+**Critical environment variables** (see main.py and README.md for complete list):
+
+**Required:**
+- `API_TOKEN`: Glot.io API token (required for code execution)
+
+**JWT (recommended for production):**
+- `JWT_SECRET_KEY`: Strong secret for JWT signing
+- `JWT_ACCESS_TOKEN_EXPIRE`: Access token TTL in seconds (default: 3600)
+- `JWT_REFRESH_TOKEN_EXPIRE`: Refresh token TTL in seconds (default: 604800)
+
+**Redis (recommended for production):**
+- `REDIS_HOST`, `REDIS_PORT`, `REDIS_DB`, `REDIS_PASSWORD`, `REDIS_TIMEOUT`
+
+**Database (required if using DB features):**
+- `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`
+- `DB_MAX_CONNECTIONS`, `DB_STALE_TIMEOUT`
+
+**OAuth (optional):**
+- `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`
+- `OIDC_PROVIDERS` (JSON string for custom providers)
+
+Configuration loading priority: Environment variables → `.env` file → defaults in main.py
+
+## Code Style and Conventions
+
+### Naming Conventions
+
+- **Interfaces**: `IServiceName` (e.g., `IConfigService`)
+- **Implementations**: `ServiceName` (e.g., `ConfigService`)
+- **Controllers**: `ResourceNameController` (e.g., `CodeExecutionController`)
+- **Models**: PascalCase for classes, snake_case for table names
+- **Service methods**: snake_case, descriptive verbs (get_user, create_record, execute_code)
+
+### File Organization
+
+- One service per file in `services/`
+- One controller namespace per file in `controllers/`
+- All interface definitions in `interfaces/service_interfaces.py`
+- Database models in `models/db_models.py`
+- API data models (dataclasses) in `models/` (e.g., `glot_models.py`, `auth_models.py`)
+
+### Error Handling Pattern
+
+Follow this pattern in services:
+```python
+try:
+    result = await self._perform_operation()
+    self._logger.info(f"Operation successful: {result}")
+    return result
+except SpecificException as e:
+    self._logger.error(f"Specific error: {e}")
+    raise ValueError(f"Business-friendly message: {e}")
+except Exception as e:
+    self._logger.error(f"Unexpected error: {e}")
+    raise RuntimeError(f"Internal error: {e}")
+```
+
+Controllers should catch service exceptions and return appropriate HTTP status codes:
+```python
+try:
+    result = service.my_method()
+    return {'data': result}, 200
+except ValueError as e:
+    return {'error': str(e)}, 400
+except RuntimeError as e:
+    return {'error': 'Internal server error'}, 500
+```
+
+### Dataclass Models
+
+Use `@dataclass` for API models with `to_dict()` methods:
+```python
+from dataclasses import dataclass, field
+from typing import Optional, List
+
+@dataclass
+class MyModel:
+    name: str
+    value: Optional[str] = None
+    items: List[str] = field(default_factory=list)
+
+    def to_dict(self) -> dict:
+        return {
+            'name': self.name,
+            'value': self.value,
+            'items': self.items
+        }
+```
+
+## Common Pitfalls and Solutions
+
+### Pitfall 1: Circular Dependencies
+
+**Problem**: Service A depends on Service B, which depends on Service A.
+
+**Solution**:
+- Redesign services to eliminate circular dependency
+- Use event-driven pattern instead of direct service calls
+- Extract common functionality into a third service
+
+### Pitfall 2: Forgetting to Register Services
+
+**Problem**: `ValueError: 服务 {service_type} 未注册`
+
+**Solution**: Always register new services in `core/service_config.py` before using them.
+
+### Pitfall 3: Redis Connection Failures
+
+**Problem**: Redis operations fail silently or with connection errors.
+
+**Solution**:
+- Use `redis_service.is_connected()` to check connection
+- Implement graceful degradation (continue without cache if Redis is down)
+- Use `redis_service.reconnect()` to attempt reconnection
+
+### Pitfall 4: Async/Sync Mixing Issues
+
+**Problem**: Calling async functions without `await` or `asyncio.run()`.
+
+**Solution**:
+- In async contexts: Use `await service.async_method()`
+- In sync contexts (controllers): Use `asyncio.run(service.async_method())`
+- Mark service methods with `async def` if they perform I/O operations
+
+### Pitfall 5: Database Model Changes
+
+**Problem**: Schema changes not reflected in database.
+
+**Solution**:
+- Peewee doesn't auto-migrate; modify database schema manually or recreate tables
+- For development: Delete tables and recreate with `create_tables()` in models/db_models.py
+- For production: Use migration tools or write migration scripts
+
+### Pitfall 6: Missing BaseModel.to_dict() for Sensitive Data
+
+**Problem**: Password hashes or secrets exposed in API responses.
+
+**Solution**: Override `to_dict()` in models to exclude sensitive fields:
+```python
+class User(BaseModel):
+    password_hash = CharField(max_length=255)
+
+    def to_dict(self) -> dict:
+        data = super().to_dict()
+        data.pop('password_hash', None)  # Remove sensitive field
+        return data
+```
+
+## Working with This Codebase
+
+### When modifying authentication
+
+- JWT token logic is in `services/jwt_service.py`
+- OAuth flow logic is in `services/oidc_service.py`
+- Middleware decorators are in `middleware/auth_middleware.py`
+- Token blacklist and refresh tokens are stored in Redis
+- Test token generation/verification independently before integration
+
+### When adding API endpoints
+
+1. Create or extend namespace in `controllers/`
+2. Use Flask-RESTX models for request/response documentation
+3. Apply `@AuthMiddleware.require_auth` if authentication is needed
+4. Use dependency injection to access services
+5. Return JSON with appropriate HTTP status codes
+6. Register namespace in `main.py` with URL prefix
+
+### When working with Redis
+
+- Always check connection with `is_connected()` before critical operations
+- Use meaningful key naming with namespaces (e.g., `user:profile:{id}`)
+- Set appropriate TTL for all cached data
+- Implement cache invalidation strategy for updated data
+- Use Redis CLI for debugging: `redis-cli --scan --pattern "user:*"`
+
+### When working with the database
+
+- Define models in `models/db_models.py` inheriting from `BaseModel`
+- Create specialized service classes inheriting from `DatabaseService`
+- Use async wrappers for database operations
+- Test connection with `database_service.test_connection()`
+- Use `to_dict()` to convert models to API responses
+- Add indexes to frequently queried fields
+
+## Language Support
+
+The service supports 30+ languages via Glot.io. Language mappings are in `services/glot_service.py` in the `LANGUAGES` dictionary. When adding support for new languages, update this dictionary and verify the language is supported by Glot.io API.
+
+## Troubleshooting
+
+**Issue: "服务 {type} 未注册"**
+→ Register the service in `core/service_config.py`
+
+**Issue: Redis connection errors**
+→ Check Redis is running (`redis-cli ping`), verify REDIS_* env vars, check `redis_service.is_connected()`
+
+**Issue: Database connection errors**
+→ Verify PostgreSQL is running, check DB_* env vars, test with `database_service.test_connection()`
+
+**Issue: "API_TOKEN 未配置"**
+→ Set API_TOKEN environment variable or in .env file
+
+**Issue: OAuth callback fails**
+→ Verify OAuth provider config, check redirect_uri matches provider settings, inspect logs from `oidc_service`
+
+**Issue: JWT tokens not working**
+→ Check JWT_SECRET_KEY is set and consistent, verify token expiry times, check Redis connection for blacklist
+
+## Additional Resources
+
+- Flask-RESTX documentation: For API documentation features
+- Peewee ORM documentation: For database model operations
+- Glot.io API documentation: For supported languages and execution limits
+- OAuth 2.0 / OIDC specs: For understanding authentication flows
+
+## Key Files to Understand the Architecture
+
+Reading these files in order will give you a complete understanding:
+
+1. `main.py` - Application entry point, configuration, namespace registration
+2. `core/di_container.py` - Dependency injection container implementation
+3. `core/service_config.py` - Service registration configuration
+4. `interfaces/service_interfaces.py` - All service interfaces
+5. `services/config_service.py` - Configuration management pattern
+6. `services/glot_service.py` - Async service pattern, external API integration
+7. `services/database_service.py` - Database service base class with CRUD operations
+8. `services/user_service.py` - Example of specialized database service
+9. `middleware/auth_middleware.py` - Authentication and authorization decorators
+10. `controllers/code_controller.py` - Controller pattern, dependency injection in action
diff --git a/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md b/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
new file mode 100644
index 0000000..6507deb
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/DEVELOPMENT_GUIDE.md
@@ -0,0 +1,1528 @@
+# LetCoding API 开发新手教程
+
+本教程将指导新手如何在 LetCoding API 项目中进行服务开发，包括依赖注入、控制器编写、Redis缓存使用和路由注册等核心概念。
+
+## 📚 目录
+
+1. [项目架构概览](#项目架构概览)
+2. [依赖注入详解](#依赖注入详解)
+3. [服务开发](#服务开发)
+4. [数据库服务使用](#数据库服务使用)
+5. [Redis 缓存服务使用](#redis-缓存服务使用)
+6. [认证和授权开发](#认证和授权开发)
+7. [控制器编写](#控制器编写)
+8. [路由注册](#路由注册)
+9. [完整开发流程示例](#完整开发流程示例)
+10. [常见问题和最佳实践](#常见问题和最佳实践)
+
+## 🏗️ 项目架构概览
+
+### 目录结构
+```
+fastapi_of_letcoing/
+├── core/                    # 核心模块
+│   ├── di_container.py      # 依赖注入容器
+│   └── service_config.py    # 服务配置
+├── interfaces/              # 服务接口定义
+│   ├── __init__.py
+│   └── service_interfaces.py # 抽象接口
+├── models/                  # 数据模型定义
+│   ├── __init__.py
+│   ├── glot_models.py      # Glot API 数据模型
+│   ├── auth_models.py      # 认证相关数据模型
+│   └── db_models.py        # 数据库模型（Peewee ORM）
+├── services/               # 业务服务层
+│   ├── config_service.py   # 配置服务
+│   ├── glot_service.py     # 代码执行服务
+│   ├── logger_service.py   # 日志服务
+│   ├── oidc_service.py     # OIDC 认证服务
+│   ├── jwt_service.py      # JWT 认证服务
+│   ├── redis_service.py    # Redis 缓存服务
+│   ├── database_service.py # 数据库基础服务
+│   ├── user_service.py     # 用户服务
+│   ├── code_execution_service.py # 代码执行记录服务
+│   └── api_service.py      # API 密钥服务
+├── middleware/             # 中间件层
+│   └── auth_middleware.py  # JWT 认证中间件
+├── controllers/            # 控制器层
+│   ├── __init__.py
+│   ├── code_controller.py  # 代码执行控制器
+│   └── auth_controller.py  # 认证控制器
+├── main.py                 # 应用入口
+└── requirements.txt        # 依赖管理
+```
+
+### 架构层次
+```
+请求 → 中间件 → 控制器 → 服务层 → 数据库/Redis/外部API
+```
+
+## 🔄 依赖注入详解
+
+### 什么是依赖注入？
+依赖注入（Dependency Injection, DI）是一种设计模式，它将对象的依赖关系从内部创建转移到外部注入，提高代码的可测试性和解耦性。
+
+### 生命周期类型
+
+#### 1. Singleton（单例）
+- **特点**: 整个应用生命周期内只有一个实例
+- **适用场景**: 配置服务、日志服务等无状态服务
+- **注册方式**:
+```python
+container.register_singleton(IConfigService, ConfigService)
+# 或使用工厂方法
+container.register_singleton(IConfigService, factory=lambda: ConfigService(app_config))
+```
+
+#### 2. Transient（瞬态）
+- **特点**: 每次请求都创建新实例
+- **适用场景**: 需要状态隔离的服务
+- **注册方式**:
+```python
+container.register_transient(IMyService, MyService)
+```
+
+#### 3. Scoped（作用域）
+- **特点**: 在单个请求周期内保持单例
+- **适用场景**: Web应用中的请求相关服务
+- **注册方式**:
+```python
+container.register_scoped(ICodeExecutionService, GlotService)
+```
+
+### 如何使用依赖注入
+
+#### 方法1：构造函数注入（推荐）
+```python
+from interfaces.service_interfaces import IConfigService, ILoggerService
+from core.di_container import Injectable
+
+class MyService(Injectable):
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
+        self._config = config_service
+        self._logger = logger_service
+    
+    def do_something(self):
+        api_token = self._config.get_api_token()
+        self._logger.info(f"使用token: {api_token[:8]}...")
+```
+
+#### 方法2：运行时注入
+```python
+from core.di_container import inject
+from interfaces.service_interfaces import ICodeExecutionService
+
+def my_function():
+    code_service = inject(ICodeExecutionService)
+    # 使用服务...
+```
+
+## 🛠️ 服务开发
+
+### 步骤1：定义服务接口
+
+在 `interfaces/service_interfaces.py` 中添加新的服务接口：
+
+```python
+class IMyService(ABC):
+    """我的服务接口"""
+    
+    @abstractmethod
+    def process_data(self, data: str) -> str:
+        """处理数据"""
+        pass
+    
+    @abstractmethod
+    def get_status(self) -> bool:
+        """获取服务状态"""
+        pass
+```
+
+### 步骤2：实现服务类
+
+在 `services/` 目录下创建新文件：
+
+```python
+# services/my_service.py
+from typing import Optional
+from interfaces.service_interfaces import IMyService, IConfigService, ILoggerService
+from core.di_container import Injectable
+
+class MyService(IMyService, Injectable):
+    """我的服务实现"""
+    
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
+        self._config_service = config_service
+        self._logger_service = logger_service
+    
+    def process_data(self, data: str) -> str:
+        """处理数据"""
+        self._logger_service.info(f"开始处理数据: {data}")
+        
+        # 业务逻辑
+        processed_data = data.upper()
+        
+        self._logger_service.info(f"数据处理完成: {processed_data}")
+        return processed_data
+    
+    def get_status(self) -> bool:
+        """获取服务状态"""
+        try:
+            # 检查配置
+            token = self._config_service.get_api_token()
+            return bool(token)
+        except Exception as ex:
+            self._logger_service.error("获取服务状态失败", ex)
+            return False
+```
+
+### 步骤3：注册服务
+
+在 `core/service_config.py` 中注册新服务：
+
+```python
+from services.my_service import MyService
+from interfaces.service_interfaces import IMyService
+
+def service_configurator(container):
+    # ... 其他服务注册 ...
+    
+    # 注册我的服务
+    container.register_singleton(IMyService, MyService)
+```
+
+### 服务开发最佳实践
+
+1. **接口优先**: 先定义接口，再实现具体类
+2. **单一职责**: 每个服务只负责一个具体功能
+3. **依赖最小化**: 只注入真正需要的依赖
+4. **数据持久化**: 合理使用数据库服务存储业务数据
+5. **缓存策略**: 合理使用 Redis 缓存提高性能
+6. **异常处理**: 在服务层统一处理异常
+7. **日志记录**: 重要操作都要记录日志
+8. **连接管理**: 数据库、Redis 等外部服务的连接状态管理
+
+#### 缓存服务最佳实践
+
+1. **键命名规范**: 使用有意义的键名和命名空间
+   ```python
+   # 好的命名
+   user_cache_key = f"user:profile:{user_id}"
+   rate_limit_key = f"rate_limit:api:{user_id}:{endpoint}"
+   
+   # 避免的命名
+   key = "data123"
+   ```
+
+2. **TTL 设置**: 根据数据特性设置合理的过期时间
+   ```python
+   # 用户会话信息：短时间过期
+   redis_service.set(f"session:{session_id}", session_data, ttl=1800)  # 30分钟
+   
+   # 用户基本信息：较长时间过期
+   redis_service.set(f"user:profile:{user_id}", profile, ttl=3600)  # 1小时
+   
+   # 系统配置：长时间过期
+   redis_service.set("system:config", config_data, ttl=86400)  # 24小时
+   ```
+
+3. **缓存穿透保护**: 使用空值缓存防止缓存穿透
+   ```python
+   def get_user_with_cache(user_id: str):
+       cache_key = f"user:profile:{user_id}"
+       
+       # 尝试从缓存获取
+       user = redis_service.get(cache_key)
+       if user is not None:
+           return user if user != "null" else None
+       
+       # 从数据库获取
+       user = database_service.get_user(user_id)
+       
+       # 缓存结果（包括空值）
+       cache_value = user.to_dict() if user else "null"
+       redis_service.set(cache_key, cache_value, ttl=300)  # 空值缓存5分钟
+       
+       return user
+   ```
+
+4. **批量操作优化**: 使用 Redis 管道或批量操作
+   ```python
+   # 避免循环单个操作
+   for user_id in user_ids:
+       profile = redis_service.get(f"user:profile:{user_id}")
+   
+   # 推荐使用批量操作
+   cache_keys = [f"user:profile:{uid}" for uid in user_ids]
+   profiles = [redis_service.get(key) for key in cache_keys]
+   ```
+
+#### 认证服务最佳实践
+
+1. **令牌安全**: 设置合理的令牌过期时间和强密钥
+2. **刷新策略**: 实现令牌刷新机制，避免频繁重新登录
+3. **权限控制**: 基于角色的访问控制
+4. **会话管理**: 使用 Redis 管理用户会话状态
+
+## 🗄️ 数据库服务使用
+
+### 数据库服务概述
+
+项目使用 PostgreSQL 数据库和 Peewee ORM 框架，采用模块化的数据库服务架构：
+
+- **DatabaseService**: 基础数据库服务，提供通用 CRUD 操作和连接管理
+- **UserService**: 用户相关数据库操作
+- **CodeExecutionService**: 代码执行记录相关操作
+- **APIService**: API 密钥管理相关操作
+
+每个表都有专门的服务类继承自 DatabaseService，实现了更好的解耦和可维护性。数据库配置通过 ConfigService 统一管理，支持环境变量配置。
+
+### 数据库模型设计
+
+#### 基础模型类
+```python
+# models/db_models.py
+from peewee import Model, CharField, TextField, DateTimeField, BooleanField, IntegerField, AutoField
+from datetime import datetime
+
+class BaseModel(Model):
+    """基础模型类"""
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+    
+    class Meta:
+        database = get_database()
+    
+    def save(self, force_insert=False, only=None):
+        """保存时更新 updated_at 字段"""
+        self.updated_at = datetime.now()
+        return super().save(force_insert, only)
+    
+    def to_dict(self) -> dict:
+        """转换为字典"""
+        data = {}
+        for field_name in self._meta.fields.keys():
+            value = getattr(self, field_name)
+            if isinstance(value, datetime):
+                value = value.isoformat()
+            data[field_name] = value
+        return data
+```
+
+#### 具体模型示例
+```python
+# 用户模型
+class User(BaseModel):
+    """用户模型"""
+    id = AutoField(primary_key=True, verbose_name="用户ID")
+    username = CharField(max_length=50, unique=True, null=False, verbose_name="用户名")
+    email = CharField(max_length=100, unique=True, null=True, verbose_name="邮箱")
+    password_hash = CharField(max_length=255, null=False, verbose_name="密码哈希")
+    is_active = BooleanField(default=True, verbose_name="是否激活")
+    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    
+    class Meta:
+        table_name = "users"
+    
+    def to_dict(self) -> dict:
+        """转换为字典，排除敏感信息"""
+        data = super().to_dict()
+        data.pop("password_hash", None)
+        return data
+```
+
+### 数据库服务架构
+
+#### 基础数据库服务 (DatabaseService)
+DatabaseService 提供通用的 CRUD 操作和数据库连接管理：
+
+```python
+# 基础 CRUD 操作
+async def create(self, model_class: type, **kwargs) -> Dict[str, Any]
+async def get_by_id(self, model_class: type, record_id: int) -> Optional[Dict[str, Any]]
+async def update(self, model_class: type, record_id: int, **kwargs) -> bool
+async def delete(self, model_class: type, record_id: int) -> bool
+async def list_all(self, model_class: type, limit: int = 50, offset: int = 0) -> List[Dict[str, Any]]
+async def count(self, model_class: type) -> int
+
+# 数据库管理
+def test_connection() -> bool
+def get_database_info() -> Dict[str, Any]
+def close()
+```
+
+#### 专门服务类继承 DatabaseService
+
+##### UserService - 用户服务
+```python
+from services.user_service import UserService
+from core.di_container import inject
+
+# 使用用户服务
+user_service = inject(UserService)
+
+# 创建用户
+user = await user_service.create_user("username", "password_hash", "email@example.com")
+
+# 根据用户名获取用户
+user = await user_service.get_user_by_username("username")
+
+# 更新用户最后登录时间
+await user_service.update_user_last_login(user_id)
+
+# 获取用户列表
+users = await user_service.list_users(limit=20, active_only=True)
+
+# 搜索用户
+results = await user_service.search_users("john")
+```
+
+#### 运行时注入方式
+```python
+from core.di_container import inject
+from services.user_service import UserService
+from services.code_execution_service import CodeExecutionService
+
+async def analyze_user_activity(user_id: int):
+    """分析用户活动"""
+    user_service = inject(UserService)
+    exec_service = inject(CodeExecutionService)
+    
+    # 获取用户信息
+    user = await user_service.get_user_by_id(user_id)
+    if not user:
+        return {"error": "用户不存在"}
+    
+    # 获取执行统计信息
+    stats = await exec_service.get_execution_statistics(user_id)
+    
+    return {
+        "user": user,
+        "statistics": stats,
+        "total_executions": stats["total_executions"],
+        "success_rate": stats["success_rate"],
+        "favorite_languages": stats["language_distribution"]
+    }
+```
+
+### 创建新的数据库服务
+
+#### 步骤1：创建服务类
+```python
+# services/my_table_service.py
+from datetime import datetime
+from typing import List, Optional, Dict, Any
+
+from services.database_service import DatabaseService
+from models.db_models import MyModel
+from core.di_container import Injectable
+
+class MyTableService(DatabaseService, Injectable):
+    """我的表服务类"""
+    
+    async def create_my_record(self, name: str, value: str) -> Dict[str, Any]:
+        """创建记录"""
+        try:
+            record_data = await self.create(
+                MyModel,
+                name=name,
+                value=value,
+                is_active=True
+            )
+            return record_data
+        except Exception as e:
+            raise RuntimeError(f"创建记录时发生错误: {e}")
+    
+    async def get_by_name(self, name: str) -> Optional[Dict[str, Any]]:
+        """根据名称获取记录"""
+        try:
+            record = MyModel.get(MyModel.name == name)
+            return record.to_dict()
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取记录时发生错误: {e}")
+    
+    async def list_active_records(self, limit: int = 50) -> List[Dict[str, Any]]:
+        """获取活跃记录列表"""
+        try:
+            query = (MyModel
+                    .select()
+                    .where(MyModel.is_active == True)
+                    .order_by(MyModel.created_at.desc())
+                    .limit(limit))
+            
+            return [record.to_dict() for record in query]
+        except Exception as e:
+            raise RuntimeError(f"获取活跃记录时发生错误: {e}")
+    
+    async def deactivate_record(self, record_id: int) -> bool:
+        """停用记录"""
+        return await self.update(MyModel, record_id, is_active=False)
+    
+    async def get_statistics(self) -> Dict[str, Any]:
+        """获取统计信息"""
+        try:
+            total_records = MyModel.select().count()
+            active_records = MyModel.select().where(MyModel.is_active == True).count()
+            
+            return {
+                "total_records": total_records,
+                "active_records": active_records,
+                "inactive_records": total_records - active_records,
+                "active_rate": active_records / total_records if total_records > 0 else 0
+            }
+        except Exception as e:
+            raise RuntimeError(f"获取统计信息时发生错误: {e}")
+```
+
+#### 步骤2：注册服务
+```python
+# core/service_config.py
+def create_my_table_service():
+    config_service = container.resolve(IConfigService)
+    return MyTableService(config_service)
+
+def service_configurator(container):
+    # ... 其他服务注册 ...
+    container.register_singleton(MyTableService, factory=create_my_table_service)
+```
+
+#### 步骤3：使用服务
+```python
+from services.my_table_service import MyTableService
+
+my_service = inject(MyTableService)
+
+# 创建记录
+record = await my_service.create_my_record("test", "value")
+
+# 获取记录
+record = await my_service.get_by_name("test")
+
+# 获取统计信息
+stats = await my_service.get_statistics()
+```
+
+### 数据库配置和环境变量
+
+#### 环境变量配置
+```bash
+# 数据库配置（在 main.py 中读取）
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=letcoding
+DB_USER=postgres
+DB_PASSWORD=your_password
+DB_MAX_CONNECTIONS=20
+DB_STALE_TIMEOUT=300
+```
+
+#### 配置服务使用
+```python
+# 在服务中获取数据库配置
+from interfaces.service_interfaces import IConfigService
+
+class MyService(Injectable):
+    def __init__(self, config_service: IConfigService):
+        self._config = config_service
+    
+    def get_database_info(self):
+        """获取数据库配置信息"""
+        db_config = self._config.get_database_config()
+        database_url = self._config.get_database_url()
+        
+        return {
+            "config": db_config,
+            "connection_url": database_url.replace(db_config["password"], "***")
+        }
+```
+
+### 数据库连接管理
+
+#### 连接状态检查
+```python
+class DatabaseHealthService(Injectable):
+    def __init__(self, database_service: DatabaseService):
+        self._db = database_service
+    
+    def check_database_health(self):
+        """检查数据库健康状态"""
+        is_connected = self._db.test_connection()
+        db_info = self._db.get_database_info()
+        
+        return {
+            "status": "healthy" if is_connected else "unhealthy",
+            "connection_details": db_info,
+            "timestamp": datetime.now().isoformat()
+        }
+```
+
+#### 连接池配置
+```python
+# 数据库服务自动管理连接池
+# 通过环境变量配置：
+# DB_MAX_CONNECTIONS=20  # 最大连接数
+# DB_STALE_TIMEOUT=300    # 连接超时时间
+```
+
+### 数据库迁移和表管理
+
+#### 创建表
+```python
+# 在应用启动时或部署脚本中
+from models.db_models import create_tables
+
+def initialize_database():
+    """初始化数据库表"""
+    try:
+        create_tables()
+        print("数据库表创建成功")
+    except Exception as e:
+        print(f"创建表失败: {e}")
+
+# 在 main.py 中调用
+if __name__ == '__main__':
+    initialize_database()
+    app.run(debug=True, host='0.0.0.0', port=6173)
+```
+
+#### 删除表（开发环境）
+```python
+from models.db_models import drop_tables
+
+def cleanup_database():
+    """清理数据库表（仅开发环境）"""
+    if os.getenv('ENVIRONMENT') == 'development':
+        drop_tables()
+        print("开发环境：数据库表已删除")
+```
+
+### 数据库操作最佳实践
+
+#### 1. 异常处理
+```python
+async def safe_user_creation(username: str, email: str, password_hash: str):
+    """安全的用户创建操作"""
+    try:
+        user = await self._db.create_user(username, email, password_hash)
+        return {"success": True, "user": user}
+    except ValueError as e:
+        # 业务逻辑错误
+        return {"success": False, "error": str(e)}
+    except RuntimeError as e:
+        # 数据库运行时错误
+        logger.error(f"数据库错误: {e}")
+        return {"success": False, "error": "服务器内部错误"}
+    except Exception as e:
+        # 未预期错误
+        logger.error(f"未预期错误: {e}")
+        return {"success": False, "error": "系统异常"}
+```
+
+#### 2. 事务处理
+```python
+# DatabaseService 内部自动处理事务
+# 使用 with database.atomic(): 确保操作原子性
+```
+
+#### 3. 数据验证
+```python
+async def create_user_with_validation(username: str, email: str, password_hash: str):
+    """带验证的用户创建"""
+    # 输入验证
+    if not username or len(username) < 3:
+        raise ValueError("用户名长度至少3个字符")
+    
+    if not email or "@" not in email:
+        raise ValueError("邮箱格式无效")
+    
+    if not password_hash or len(password_hash) < 8:
+        raise ValueError("密码哈希无效")
+    
+    # 调用数据库服务
+    return await self._db.create_user(username, email, password_hash)
+```
+
+#### 4. 分页查询
+```python
+async def get_user_executions_paginated(user_id: int, page: int = 1, page_size: int = 20):
+    """分页获取用户执行记录"""
+    offset = (page - 1) * page_size
+    
+    executions = await self._db.get_user_executions(
+        user_id=user_id,
+        limit=page_size,
+        offset=offset
+    )
+    
+    return {
+        "executions": executions,
+        "page": page,
+        "page_size": page_size,
+        "has_more": len(executions) == page_size
+    }
+```
+
+### 性能优化建议
+
+#### 1. 索引优化
+```python
+# 在模型中定义索引
+class User(BaseModel):
+    username = CharField(max_length=50, unique=True, index=True)
+    email = CharField(max_length=100, unique=True, index=True)
+    created_at = DateTimeField(index=True)  # 用于时间范围查询
+```
+
+#### 2. 查询优化
+```python
+# 使用 select_related 避免N+1查询
+executions = (CodeExecution
+             .select(CodeExecution, User)
+             .join(User)
+             .where(User.id == user_id))
+
+# 使用只查询需要的字段
+users = User.select(User.id, User.username, User.email)
+```
+
+#### 3. 批量操作
+```python
+# 批量插入
+with database.atomic():
+    for i in range(1000):
+        User.create(username=f"user_{i}", email=f"user_{i}@example.com")
+```
+
+## 🔄 Redis 缓存服务使用
+
+### Redis 服务概述
+
+项目中使用独立的 Redis 服务来处理所有缓存需求，包括用户信息缓存、JWT 令牌管理、速率限制等。
+
+### 基本使用方法
+
+#### 依赖注入方式
+```python
+from interfaces.service_interfaces import IRedisService
+from core.di_container import Injectable
+
+class MyService(Injectable):
+    def __init__(self, redis_service: IRedisService):
+        self._redis = redis_service
+    
+    def cache_data(self, key: str, value: dict):
+        # 设置缓存，1小时过期
+        self._redis.set(key, value, ttl=3600)
+    
+    def get_cached_data(self, key: str):
+        return self._redis.get(key)
+```
+
+#### 运行时注入方式
+```python
+from core.di_container import inject
+from interfaces.service_interfaces import IRedisService
+
+def my_function():
+    redis_service = inject(IRedisService)
+    
+    # 检查连接状态
+    if not redis_service.is_connected():
+        redis_service.reconnect()
+    
+    # 使用缓存
+    result = redis_service.get('my_key', default='default_value')
+    return result
+```
+
+### 常用操作示例
+
+#### 1. 基本键值操作
+```python
+# 设置字符串值（自动JSON序列化）
+redis_service.set('user:123', {
+    'id': 123,
+    'name': '张三',
+    'email': 'zhangsan@example.com'
+}, ttl=3600)
+
+# 获取值（自动JSON反序列化）
+user_data = redis_service.get('user:123')
+
+# 删除键
+redis_service.delete('user:123')
+
+# 检查键是否存在
+if redis_service.exists('user:123'):
+    print('用户数据存在')
+```
+
+#### 2. 计数器操作
+```python
+# 递增计数器（用户访问次数）
+visit_count = redis_service.increment(f'visits:user:{user_id}')
+print(f'用户 {user_id} 访问了 {visit_count} 次')
+
+# 递减计数器
+remaining_requests = redis_service.decrement(f'rate_limit:user:{user_id}')
+```
+
+#### 3. 集合操作
+```python
+# 添加用户到白名单
+redis_service.set_add('whitelist', 'user_123', 'user_456')
+
+# 检查用户是否在白名单中
+if redis_service.set_is_member('whitelist', 'user_123'):
+    print('用户在白名单中')
+
+# 获取所有白名单用户
+whitelist_users = redis_service.set_members('whitelist')
+
+# 从白名单移除用户
+redis_service.set_remove('whitelist', 'user_123')
+```
+
+#### 4. 列表操作
+```python
+# 添加日志到队列
+redis_service.list_push('logs', {
+    'timestamp': '2024-01-01T10:00:00',
+    'level': 'INFO',
+    'message': '用户登录'
+})
+
+# 获取最近的日志（FIFO）
+recent_log = redis_service.list_pop('logs')
+
+# 获取队列长度
+log_count = redis_service.list_length('logs')
+
+# 获取指定范围的日志
+all_logs = redis_service.list_range('logs', 0, -1)
+```
+
+#### 5. TTL 管理
+```python
+# 设置键的过期时间
+redis_service.expire('user:123', 1800)  # 30分钟后过期
+
+# 检查键的剩余生存时间
+remaining_seconds = redis_service.ttl('user:123')
+if remaining_seconds > 0:
+    print(f'键将在 {remaining_seconds} 秒后过期')
+elif remaining_seconds == -1:
+    print('键永不过期')
+else:
+    print('键不存在')
+```
+
+### 缓存设计模式
+
+#### 1. Cache-Aside 模式
+```python
+def get_user_profile(user_id: str):
+    cache_key = f'user_profile:{user_id}'
+    
+    # 先从缓存获取
+    profile = redis_service.get(cache_key)
+    if profile:
+        return profile
+    
+    # 缓存未命中，从数据库获取
+    profile = database_service.get_user_profile(user_id)
+    
+    # 写入缓存
+    if profile:
+        redis_service.set(cache_key, profile, ttl=3600)
+    
+    return profile
+```
+
+#### 2. Write-Through 模式
+```python
+def update_user_profile(user_id: str, profile_data: dict):
+    # 更新数据库
+    database_service.update_user_profile(user_id, profile_data)
+    
+    # 同时更新缓存
+    cache_key = f'user_profile:{user_id}'
+    redis_service.set(cache_key, profile_data, ttl=3600)
+```
+
+#### 3. 分布式锁
+```python
+def with_lock(lock_key: str, expire_time: int = 10):
+    """分布式锁装饰器"""
+    def decorator(func):
+        def wrapper(*args, **kwargs):
+            # 尝试获取锁
+            lock_acquired = redis_service.set(
+                lock_key, 
+                'locked', 
+                ttl=expire_time
+            )
+            
+            if not lock_acquired:
+                raise Exception('无法获取锁，请稍后重试')
+            
+            try:
+                return func(*args, **kwargs)
+            finally:
+                # 释放锁
+                redis_service.delete(lock_key)
+        
+        return wrapper
+    return decorator
+
+# 使用示例
+@with_lock('user_update:123')
+def update_user_data():
+    # 执行需要加锁的操作
+    pass
+```
+
+### 错误处理和重连
+
+```python
+class RobustCacheService:
+    def __init__(self, redis_service: IRedisService):
+        self._redis = redis_service
+    
+    def safe_get(self, key: str, default=None):
+        """安全的获取操作，包含重连逻辑"""
+        try:
+            result = self._redis.get(key, default)
+            return result
+        except Exception as ex:
+            logger.error(f"Redis 获取失败: {key}", ex)
+            
+            # 尝试重连
+            if self._redis.reconnect():
+                return self._redis.get(key, default)
+            
+            return default
+    
+    def safe_set(self, key: str, value, ttl=None):
+        """安全的设置操作"""
+        try:
+            return self._redis.set(key, value, ttl)
+        except Exception as ex:
+            logger.error(f"Redis 设置失败: {key}", ex)
+            return False
+```
+
+### Redis 配置和监控
+
+#### 环境变量配置
+```bash
+# Redis 基本配置
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_DB=0
+REDIS_PASSWORD=your_redis_password
+REDIS_TIMEOUT=5  # 连接超时时间
+```
+
+#### 连接状态监控
+```python
+# 获取 Redis 服务器信息
+redis_info = redis_service.info()
+if redis_info:
+    print(f"Redis 版本: {redis_info.get('redis_version')}")
+    print(f"已用内存: {redis_info.get('used_memory_human')}")
+
+# 检查连接状态
+if redis_service.is_connected():
+    print("Redis 连接正常")
+else:
+    print("Redis 连接断开，尝试重连...")
+    redis_service.reconnect()
+```
+
+## 🔐 认证和授权开发
+
+### 认证架构概述
+
+项目实现了基于 OIDC 的第三方认证和 JWT 令牌认证系统，支持 GitHub OAuth 和自定义 OIDC 提供商。
+
+### JWT 服务使用
+
+#### 生成和验证令牌
+```python
+from services.jwt_service import JWTService
+from models.auth_models import UserInfo
+
+# 在服务中使用 JWT
+class MyProtectedService(Injectable):
+    def __init__(self, jwt_service: JWTService, redis_service: IRedisService):
+        self._jwt = jwt_service
+        self._redis = redis_service
+    
+    def authenticate_user(self, user_info: dict):
+        """生成 JWT 令牌"""
+        # 创建用户信息对象
+        user = UserInfo(
+            id=user_info['id'],
+            username=user_info['username'],
+            email=user_info['email'],
+            provider=user_info['provider']
+        )
+        
+        # 生成令牌
+        tokens = self._jwt.generate_tokens(user.to_dict())
+        return tokens.to_dict()
+    
+    def verify_token(self, token: str):
+        """验证 JWT 令牌"""
+        user_info = self._jwt.verify_access_token(token)
+        return user_info
+    
+    def refresh_token(self, refresh_token: str):
+        """刷新访问令牌"""
+        new_tokens = self._jwt.refresh_access_token(refresh_token)
+        return new_tokens.to_dict() if new_tokens else None
+```
+
+### 认证中间件使用
+
+#### 在控制器中使用认证
+```python
+from flask import g
+from middleware.auth_middleware import AuthMiddleware
+
+@api.route('/protected')
+class ProtectedController(Resource):
+    @AuthMiddleware.require_auth
+    def get(self):
+        """需要认证的接口"""
+        # 从 g 对象获取当前用户信息
+        current_user = getattr(g, 'current_user', None)
+        
+        return {
+            'message': f'你好，{current_user["username"]}!',
+            'user_id': current_user['id']
+        }
+
+@api.route('/optional')
+class OptionalAuthController(Resource):
+    @AuthMiddleware.optional_auth
+    def get(self):
+        """可选认证的接口"""
+        current_user = getattr(g, 'current_user', None)
+        
+        if current_user:
+            return {'message': f'已登录用户：{current_user["username"]}'}
+        else:
+            return {'message': '游客访问'}
+
+@api.route('/admin')
+class AdminController(Resource):
+    @AuthMiddleware.require_auth
+    @AuthMiddleware.require_admin
+    def get(self):
+        """需要管理员权限的接口"""
+        return {'message': '管理员专用接口'}
+```
+
+#### 速率限制中间件
+```python
+@api.route('/rate-limited')
+class RateLimitedController(Resource):
+    @AuthMiddleware.require_auth
+    @AuthMiddleware.rate_limit(max_requests=100, window_seconds=3600)
+    def post(self):
+        """带速率限制的接口"""
+        return {'message': '请求成功'}
+```
+
+### OIDC 服务集成
+
+#### 支持的认证提供商
+```python
+from services.oidc_service import OIDCService
+
+class MyAuthService(Injectable):
+    def __init__(self, oidc_service: OIDCService):
+        self._oidc = oidc_service
+    
+    def get_supported_providers(self):
+        """获取支持的认证提供商"""
+        return self._oidc.get_supported_providers()
+    
+    def initiate_oauth(self, provider: str, redirect_uri: str):
+        """开始 OAuth 认证流程"""
+        if not self._oidc.validate_provider(provider):
+            raise ValueError(f'不支持的提供商: {provider}')
+        
+        auth_url = self._oidc.get_authorization_url(provider, redirect_uri)
+        return auth_url
+    
+    def handle_callback(self, provider: str, code: str):
+        """处理 OAuth 回调"""
+        auth_result = self._oidc.authorize_callback(provider)
+        
+        if not auth_result:
+            raise Exception('认证失败')
+        
+        return auth_result['user_info']
+```
+
+### 用户信息管理
+
+#### 数据模型使用
+```python
+from models.auth_models import UserInfo, TokenResponse
+
+# 创建用户信息
+user = UserInfo(
+    id='github_123456',
+    username='john_doe',
+    email='john@example.com',
+    name='John Doe',
+    avatar_url='https://avatars.githubusercontent.com/u/123456',
+    provider='github'
+)
+
+# 转换为字典
+user_dict = user.to_dict()
+
+# 创建令牌响应
+tokens = TokenResponse(
+    access_token='eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...',
+    refresh_token='eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...',
+    expires_in=3600,
+    user_info=user
+)
+```
+
+## 🎮 控制器编写
+
+### 控制器基本结构
+
+```python
+# controllers/my_controller.py
+from flask import request
+from flask_restx import Resource, Namespace, fields
+from core.di_container import inject
+from interfaces.service_interfaces import IMyService
+
+# 创建命名空间
+api = Namespace('my_module', description='我的模块相关操作')
+
+# 定义请求模型
+request_model = api.model('MyRequest', {
+    'data': fields.String(required=True, description='要处理的数据'),
+})
+
+# 定义响应模型
+response_model = api.model('MyResponse', {
+    'result': fields.String(description='处理结果'),
+    'success': fields.Boolean(description='是否成功'),
+})
+
+@api.route('/process')
+class MyController(Resource):
+    @api.expect(request_model)
+    @api.doc('process_data')
+    @api.response(200, 'Success', response_model)
+    @api.response(400, 'Bad Request')
+    def post(self):
+        """处理数据"""
+        # 注入服务
+        my_service = inject(IMyService)
+        
+        # 获取请求数据
+        data = request.get_json()
+        if not data:
+            return {'error': '请求体不能为空'}, 400
+        
+        input_data = data.get('data', '')
+        if not input_data:
+            return {'error': 'data参数不能为空'}, 400
+        
+        try:
+            # 调用服务
+            result = my_service.process_data(input_data)
+            
+            return {
+                'result': result,
+                'success': True
+            }, 200
+            
+        except Exception as ex:
+            return {
+                'error': f'处理失败: {str(ex)}',
+                'success': False
+            }, 500
+
+@api.route('/status')
+class StatusController(Resource):
+    @api.doc('get_service_status')
+    @api.response(200, 'Success')
+    def get(self):
+        """获取服务状态"""
+        my_service = inject(IMyService)
+        status = my_service.get_status()
+        
+        return {
+            'status': 'healthy' if status else 'unhealthy',
+            'timestamp': datetime.now().isoformat()
+        }, 200
+```
+
+### 控制器编写要点
+
+1. **依赖注入**: 使用 `inject()` 函数获取服务
+2. **参数验证**: 始终验证输入参数
+3. **错误处理**: 统一的错误响应格式
+4. **API文档**: 使用 flask-restx 的装饰器
+5. **HTTP状态码**: 返回正确的状态码
+
+## 🛣️ 路由注册
+
+### 步骤1：在控制器中定义命名空间
+
+```python
+# 在控制器文件顶部
+from flask_restx import Namespace
+
+api = Namespace('module_name', description='模块描述')
+```
+
+### 步骤2：在主应用中注册
+
+```python
+# 在 main.py 中
+from controllers.my_controller import api as my_api
+
+# 注册命名空间
+api.add_namespace(my_api, path='/my-module')
+```
+
+### 路由设计原则
+
+1. **RESTful风格**: 使用标准HTTP方法
+2. **资源导向**: URL应该表示资源
+3. **版本控制**: 可考虑添加版本前缀
+4. **清晰简洁**: 避免过深的路径嵌套
+
+## 🚀 完整开发流程示例
+
+### 需求：添加一个用户信息服务
+
+#### 1. 定义接口
+```python
+# interfaces/service_interfaces.py 添加
+@dataclass
+class UserProfile:
+    id: int
+    name: str
+    email: str
+
+class IUserService(ABC):
+    @abstractmethod
+    def get_user(self, user_id: int) -> Optional[UserProfile]:
+        pass
+    
+    @abstractmethod
+    def create_user(self, name: str, email: str) -> UserProfile:
+        pass
+```
+
+#### 2. 实现服务
+```python
+# services/user_service.py
+from typing import Optional, Dict
+from interfaces.service_interfaces import IUserService, UserProfile
+from core.di_container import Injectable
+
+class UserService(IUserService, Injectable):
+    def __init__(self, logger_service):
+        self._logger = logger_service
+        self._users: Dict[int, UserProfile] = {}
+        self._next_id = 1
+    
+    def get_user(self, user_id: int) -> Optional[UserProfile]:
+        return self._users.get(user_id)
+    
+    def create_user(self, name: str, email: str) -> UserProfile:
+        user = UserProfile(
+            id=self._next_id,
+            name=name,
+            email=email
+        )
+        self._users[self._next_id] = user
+        self._next_id += 1
+        
+        self._logger.info(f"创建用户: {user}")
+        return user
+```
+
+#### 3. 注册服务
+```python
+# core/service_config.py
+from services.user_service import UserService
+from interfaces.service_interfaces import IUserService
+
+def service_configurator(container):
+    # ... 其他注册 ...
+    container.register_singleton(IUserService, UserService)
+```
+
+#### 4. 创建控制器
+```python
+# controllers/user_controller.py
+from flask import request
+from flask_restx import Resource, Namespace, fields
+from core.di_container import inject
+from interfaces.service_interfaces import IUserService
+
+api = Namespace('users', description='用户管理')
+
+user_model = api.model('User', {
+    'name': fields.String(required=True, description='用户名'),
+    'email': fields.String(required=True, description='邮箱'),
+})
+
+@api.route('')
+class UserController(Resource):
+    @api.expect(user_model)
+    def post(self):
+        """创建用户"""
+        user_service = inject(IUserService)
+        data = request.get_json()
+        
+        user = user_service.create_user(data['name'], data['email'])
+        return user.__dict__, 201
+
+@api.route('/<int:user_id>')
+class UserDetailController(Resource):
+    def get(self, user_id):
+        """获取用户详情"""
+        user_service = inject(IUserService)
+        user = user_service.get_user(user_id)
+        
+        if not user:
+            return {'error': '用户不存在'}, 404
+        
+        return user.__dict__
+```
+
+#### 5. 注册路由
+```python
+# main.py 添加
+from controllers.user_controller import api as user_api
+
+api.add_namespace(user_api, path='/api/v1/users')
+```
+
+## ❓ 常见问题和最佳实践
+
+### 常见问题
+
+#### Q: 如何选择服务的生命周期？
+**A**: 
+- 配置服务、日志服务、Redis服务 → Singleton
+- 数据库上下文、请求会话 → Scoped  
+- 临时计算服务 → Transient
+
+#### Q: 如何处理循环依赖？
+**A**: 
+- 重新设计服务职责，避免循环依赖
+- 使用事件驱动模式
+- 提取共同依赖到第三方服务
+
+#### Q: Redis 连接失败怎么办？
+**A**: 
+- Redis 服务内置了自动重连机制
+- 使用 `redis_service.is_connected()` 检查连接状态
+- 使用 `redis_service.reconnect()` 手动重连
+- 对于非关键缓存，考虑降级处理
+
+#### Q: 如何处理 Redis 中的敏感数据？
+**A**: 
+- 对敏感数据进行加密后再存储
+- 使用合适的键命名避免敏感信息泄露
+- 设置适当的 TTL 确保数据及时过期
+- 定期清理不再需要的数据
+
+#### Q: 数据库连接失败怎么办？
+**A**: 
+- DatabaseService 内置了连接检查机制
+- 使用 `database_service.test_connection()` 测试连接
+- 检查数据库配置是否正确（环境变量）
+- 确保数据库服务正在运行
+- 查看数据库日志排查问题
+
+#### Q: 如何进行数据库迁移？
+**A**: 
+- 使用 Peewee 的 `pwiz` 工具生成迁移脚本
+- 在开发环境中谨慎使用 `drop_tables()`
+- 生产环境建议使用专业的数据库迁移工具
+- 备份重要数据后再执行迁移操作
+
+#### Q: 如何创建新的数据库服务？
+**A**: 
+- 创建新的服务类继承 DatabaseService 和 Injectable
+- 实现特定表的业务逻辑方法
+- 在 service_config.py 中注册新服务
+- 使用依赖注入获取服务实例
+
+#### Q: 数据库服务之间如何协作？
+**A**: 
+- 通过依赖注入获取其他服务实例
+- 使用统一的事务管理
+- 避免循环依赖，必要时通过事件或共享服务解耦
+- 利用 DatabaseService 提供的基础 CRUD 操作
+
+#### Q: 如何处理数据库中的敏感信息？
+**A**: 
+- 密码等敏感字段使用哈希存储
+- 在 `to_dict()` 方法中排除敏感字段
+- 数据库连接字符串中的密码使用环境变量
+- 限制数据库访问权限，使用最小权限原则
+
+#### Q: 数据库性能优化有哪些方法？
+**A**: 
+- 为经常查询的字段添加索引
+- 使用 `select_related()` 避免N+1查询
+- 合理使用分页查询
+- 考虑使用数据库连接池
+- 定期分析和优化慢查询
+- 使用专门的表服务减少不必要的字段查询
+- 在服务层实现查询优化和缓存策略
+
+#### Q: 模块化数据库服务有什么优势？
+**A**: 
+- **单一职责**: 每个服务专注于一个表的业务逻辑
+- **易于维护**: 修改某个表的业务逻辑不会影响其他服务
+- **便于测试**: 可以独立测试每个服务
+- **代码复用**: DatabaseService 提供通用 CRUD 操作
+- **团队协作**: 不同开发者可以并行开发不同的表服务
+- **扩展性**: 新增表只需创建对应的服务类
+
+#### Q: JWT 令牌被盗用怎么办？
+**A**: 
+- 实现令牌黑名单机制（项目中已实现）
+- 使用较短的访问令牌过期时间
+- 监控异常的令牌使用模式
+- 支持强制用户重新登录
+
+#### Q: 如何进行单元测试？
+**A**: 
+```python
+# 测试 Redis 服务
+def test_my_service_with_redis():
+    # 创建模拟 Redis 服务
+    mock_redis = Mock(spec=IRedisService)
+    mock_redis.get.return_value = "cached_value"
+    
+    # 创建测试服务
+    service = MyService(mock_redis, mock_config, mock_logger)
+    
+    # 测试方法
+    result = service.get_cached_data("test_key")
+    
+    # 验证调用
+    mock_redis.get.assert_called_once_with("test_key")
+    assert result == "cached_value"
+
+# 集成测试使用真实 Redis
+def test_integration_with_redis():
+    # 使用测试 Redis 数据库
+    redis_service = RedisService(test_config, test_logger)
+    redis_service.flushdb()  # 清空测试数据库
+    
+    # 测试缓存操作
+    redis_service.set("test_key", "test_value", ttl=60)
+    result = redis_service.get("test_key")
+    
+    assert result == "test_value"
+```
+
+### 最佳实践
+
+1. **命名规范**
+   - 接口: `IServiceName`
+   - 实现: `ServiceName`
+   - 控制器: `ServiceNameController`
+   
+2. **模块组织**
+   - 抽象接口放在 `interfaces/` 目录
+   - 数据模型放在 `models/` 目录
+   - 服务实现放在 `services/` 目录
+   - 控制器放在 `controllers/` 目录
+   - 数据库模型继承 BaseModel，使用 Peewee ORM 规范
+
+2. **错误处理**
+   ```python
+   try:
+       result = service.process(data)
+       return {'success': True, 'data': result}
+   except BusinessException as ex:
+       return {'error': str(ex)}, 400
+   except Exception as ex:
+       logger.error("未预期错误", ex)
+       return {'error': '内部服务器错误'}, 500
+   ```
+
+3. **配置管理**
+   ```python
+   # 使用配置服务而不是直接访问环境变量
+   timeout = config_service.get_config('TIMEOUT', 30)
+   ```
+
+4. **日志记录**
+   ```python
+   # 在关键操作前后记录日志
+   logger.info("开始处理请求")
+   try:
+       result = service.process()
+       logger.info(f"处理成功: {result}")
+       return result
+   except Exception as ex:
+       logger.error("处理失败", ex)
+       raise
+   ```
+
+5. **数据库设计**
+   ```python
+   # 使用 BaseModel 提供统一的基础字段
+   # 在 to_dict() 中排除敏感信息
+   # 为经常查询的字段添加索引
+   # 使用合适的字段类型和约束
+   # 为每个表创建专门的服务类继承 DatabaseService
+   # 在服务层实现业务逻辑，保持模型类简洁
+   ```
+
+6. **API设计**
+   - 使用复数名词表示资源集合
+   - 使用HTTP状态码表示操作结果
+   - 提供清晰的错误信息
+
+## 📝 总结
+
+通过本教程，你应该掌握了：
+- 依赖注入的概念和使用方法
+- 服务开发的完整流程
+- 数据库服务的设计和使用
+- Redis 缓存服务的使用和最佳实践
+- 认证和授权系统的开发
+- 控制器的编写规范
+- 路由注册的方式
+
+### 🎯 下一步学习建议
+
+1. **实践项目**: 尝试添加一个新的业务模块，完整地走一遍开发流程
+2. **数据库进阶**: 学习数据库高级特性，如事务处理、索引优化、分表分库等
+3. **性能优化**: 学习 Redis 高级特性，如管道、发布订阅等
+4. **安全加固**: 了解更多认证安全知识，如 CSRF 防护、令牌刷新策略、数据库安全
+5. **监控部署**: 学习如何监控数据库、Redis 和应用的性能指标
+6. **测试完善**: 为现有代码编写完整的单元测试和集成测试
+
+记住，好的代码架构需要持续的实践和改进。建议从小功能开始练习，逐步掌握这些概念。
+
+祝你编码愉快！🎉
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/README.md b/webapi/fastapi_of_letcoing/README.md
new file mode 100644
index 0000000..de08800
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/README.md
@@ -0,0 +1,455 @@
+# 代码运行 API 服务
+
+## 介绍
+
+这是一个基于 Flask + Flask-RESTX 框架开发的代码运行 API 服务，通过调用 Glot API 实现多种编程语言的代码在线执行功能。该服务采用分层架构设计，具有完整的 API 文档和 Swagger UI，为前端应用提供了稳定、高效的代码运行支持。
+
+## 功能特点
+
+- **多语言支持**: 支持 30+ 种编程语言，包括 Python、JavaScript、Java、C++ 等
+- **用户认证**: 支持第三方 OIDC 登录（GitHub、自定义 OIDC 提供商）
+- **JWT 鉴权**: 基于 JWT 的令牌认证和 Redis 缓存支持
+- **API 文档生成**: 集成 Flask-RESTX，自动生成 Swagger 文档和交互式 UI
+- **异步执行**: 使用 aiohttp 实现异步 HTTP 请求，提高并发处理能力
+- **分层架构**: 控制器和服务层分离，提高代码可维护性
+- **数据模型化**: 使用 dataclass 定义清晰的数据模型，提供 API 参数验证
+- **错误处理**: 完善的错误处理机制，返回友好的错误信息
+- **安全设计**: 实现了基本的输出转义，防止注入攻击
+- **速率限制**: 基于用户的请求速率限制功能
+- **环境配置**: 支持通过环境变量设置 API Token 和认证配置
+
+## 技术栈
+
+- **框架**: Flask 3.1.2
+- **API 文档**: Flask-RESTX 1.3.2
+- **异步支持**: aiohttp 3.13.2
+- **数据处理**: Python 内置 dataclass
+- **HTTP 客户端**: requests 2.32.5
+- **认证授权**: Authlib 1.3.1, PyJWT 2.9.0
+- **缓存**: Redis 5.2.1
+- **外部服务**: Glot API (https://glot.io/)
+
+## 支持的编程语言
+
+| 语言 | 关键字 | 语言 | 关键字 | 语言 | 关键字 |
+|------|--------|------|--------|------|--------|
+| Assembly | assembly | C | c | C++ | cpp |
+| C# | csharp | Clojure | clojure | CoffeeScript | coffeescript |
+| Crystal | crystal | D | d | Elixir | elixir |
+| Elm | elm | Erlang | erlang | F# | fsharp |
+| Go | go | Groovy | groovy | Hare | hare |
+| Haskell | haskell | Idris | idris | Java | java |
+| JavaScript | javascript | Julia | julia | Kotlin | kotlin |
+| Lua | lua | Mercury | mercury | Nim | nim |
+| Nix | nix | OCaml | ocaml | Perl | perl |
+| PHP | php | Python | python | Raku | raku |
+| Ruby | ruby | Rust | rust | Scala | scala |
+| Swift | swift | TypeScript | typescript | Zig | zig |
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. 配置环境变量
+
+#### 基本配置
+
+```bash
+# Glot API Token（必需）
+export API_TOKEN=your_glot_api_token
+
+# JWT 配置（推荐设置）
+export JWT_SECRET_KEY=your-very-secure-secret-key-here
+export JWT_ACCESS_TOKEN_EXPIRE=3600  # 1小时
+export JWT_REFRESH_TOKEN_EXPIRE=604800  # 7天
+
+# Redis 配置（推荐用于生产环境）
+export REDIS_HOST=localhost
+export REDIS_PORT=6379
+export REDIS_DB=0
+export REDIS_PASSWORD=your-redis-password
+export REDIS_TIMEOUT=5
+```
+
+#### OAuth 认证配置
+
+```bash
+# GitHub OAuth
+export GITHUB_CLIENT_ID=your_github_client_id
+export GITHUB_CLIENT_SECRET=your_github_client_secret
+
+# 自定义 OIDC 提供商（JSON格式）
+export OIDC_PROVIDERS='{
+  "my_provider": {
+    "client_id": "your_client_id",
+    "client_secret": "your_client_secret",
+    "server_metadata_url": "https://your-provider.com/.well-known/openid-configuration"
+  }
+}'
+```
+
+#### 配置文件方式
+
+在项目根目录创建 `.env` 文件：
+
+```
+API_TOKEN=your_glot_api_token
+JWT_SECRET_KEY=your-very-secure-secret-key-here
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=your-redis-password
+REDIS_TIMEOUT=5
+GITHUB_CLIENT_ID=your_github_client_id
+GITHUB_CLIENT_SECRET=your_github_client_secret
+```
+
+### 3. 启动服务
+
+```bash
+python main.py
+```
+
+服务将在 `http://localhost:6173` 启动。
+
+## API 文档
+
+### 🌐 Swagger 文档
+
+- **Swagger UI**: `http://localhost:6173/swagger/`
+- **API JSON**: `http://localhost:6173/swagger.json`
+
+### 📋 API 端点
+
+#### 认证相关 API
+
+##### POST /auth/login
+
+获取认证授权URL。
+
+**请求参数:**
+| 参数 | 类型 | 必填 | 描述 | 示例 |
+|------|------|------|------|------|
+| provider | string | 是 | 认证提供商 | `github` |
+| redirect_uri | string | 否 | 回调地址 | `http://localhost:3000/callback` |
+
+**请求示例:**
+```json
+{
+  "provider": "github"
+}
+```
+
+**成功响应 (200):**
+```json
+{
+  "success": true,
+  "authorization_url": "https://github.com/login/oauth/authorize?client_id=..."
+}
+```
+
+##### GET /auth/callback/{provider}
+
+处理认证回调。
+
+**响应示例:**
+```json
+{
+  "success": true,
+  "user_info": {
+    "id": "123456",
+    "username": "username",
+    "email": "user@example.com",
+    "provider": "github"
+  },
+  "tokens": {
+    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
+    "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
+    "expires_in": 3600,
+    "token_type": "Bearer"
+  }
+}
+```
+
+##### POST /auth/refresh
+
+刷新访问令牌。
+
+**请求参数:**
+| 参数 | 类型 | 必填 | 描述 |
+|------|------|------|------|
+| refresh_token | string | 是 | 刷新令牌 |
+
+##### POST /auth/logout
+
+登出（撤销令牌）。
+
+**请求头:**
+```
+Authorization: Bearer <access_token>
+```
+
+##### GET /auth/verify
+
+验证访问令牌有效性。
+
+##### GET /auth/providers
+
+获取支持的认证提供商列表。
+
+#### 代码执行 API
+
+##### POST /code/run
+
+运行指定语言的代码（需要认证）。
+
+**请求参数:**
+
+| 参数 | 类型 | 必填 | 描述 | 示例 |
+|------|------|------|------|------|
+| code | string | 是 | 要运行的代码 | `print("Hello World")` |
+| language | string | 否 | 编程语言，默认为 javascript | `python` |
+| stdin | string | 否 | 标准输入 | `input data` |
+
+**请求示例:**
+
+```json
+{
+  "code": "console.log(\"Hello, World!\")",
+  "language": "javascript",
+  "stdin": ""
+}
+```
+
+**成功响应 (200):**
+
+```json
+{
+  "message": "代码执行成功",
+  "stdout": "Hello, World!\n"
+}
+```
+
+**错误响应 (400):**
+
+```json
+{
+  "error": "请配置API_TOKEN环境变量或ApiToken配置项。"
+}
+```
+
+#### GET /api/v1/
+
+服务健康检查端点。
+
+**响应示例:**
+
+```json
+{
+  "message": "Hello World"
+}
+```
+
+### 🔍 使用示例
+
+```bash
+# 认证登录
+curl -X POST http://localhost:6173/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"provider": "github"}'
+
+# 使用认证后的 token 调用代码执行 API
+curl -X POST http://localhost:6173/code/run \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
+    "code": "print(\"Hello, World!\")",
+    "language": "python"
+  }'
+
+# 查看 Redis 服务器状态
+redis-cli ping
+
+# 测试代码执行接口（会使用 Redis 缓存）
+curl -X POST http://localhost:6173/code/run/public \
+  -H "Content-Type: application/json" \
+  -d '{
+    "code": "console.log(\"Hello, World!\")",
+    "language": "javascript"
+  }'
+
+# 查看完整 API 文档
+open http://localhost:6173/swagger/
+```
+
+## 项目架构
+
+### 目录结构
+
+```
+fastapi_of_letcoing/
+├── controllers/           # 控制器层
+│   ├── __init__.py
+│   ├── code_controller.py    # 代码执行控制器，API 路由和参数验证
+│   └── auth_controller.py    # 认证控制器，OAuth 和 JWT 相关接口
+├── core/                  # 核心模块
+│   ├── di_container.py        # 依赖注入容器
+│   └── service_config.py     # 服务配置
+├── interfaces/            # 接口定义
+│   ├── __init__.py
+│   └── service_interfaces.py # 服务接口定义
+├── middleware/            # 中间件
+│   └── auth_middleware.py     # JWT 认证中间件
+├── models/                # 数据模型
+│   ├── __init__.py
+│   ├── auth_models.py         # 认证相关数据模型
+│   └── glot_models.py         # Glot API 数据模型
+├── services/              # 服务层
+│   ├── config_service.py      # 配置服务
+│   ├── glot_service.py        # Glot API 调用服务，业务逻辑
+│   ├── jwt_service.py         # JWT 认证服务
+│   ├── logger_service.py      # 日志服务
+│   ├── oidc_service.py        # OIDC 认证服务
+│   └── redis_service.py       # Redis 缓存服务
+├── main.py               # Flask 应用入口，API 配置
+├── requirements.txt       # 项目依赖列表
+├── .gitignore            # Git 忽略文件配置
+└── README.md             # 项目说明文档
+```
+
+### 架构设计
+
+#### 分层架构
+
+1. **控制器层 (Controllers)**
+   - 处理 HTTP 请求和响应
+   - 参数验证和序列化
+   - API 文档注解
+   - 错误处理
+   - 认证相关的路由处理
+
+2. **服务层 (Services)**
+   - 业务逻辑实现
+   - 外部 API 调用
+   - 数据转换和处理
+   - JWT 和 OIDC 认证服务
+   - Redis 缓存服务
+   - 日志和配置管理
+
+3. **数据层 (Models)**
+   - 使用 dataclass 定义数据结构
+   - 类型提示和验证
+   - 认证和业务数据模型
+
+4. **中间件层 (Middleware)**
+   - JWT 认证中间件
+   - 速率限制中间件
+   - 权限控制中间件
+
+5. **核心层 (Core)**
+   - 依赖注入容器
+   - 服务配置管理
+
+6. **接口层 (Interfaces)**
+   - 服务接口抽象
+   - 提高可测试性和可扩展性
+
+### 核心代码说明
+
+#### CodeExecutionController 类
+
+控制器类，负责：
+- API 路由定义 (`/api/v1/code/run`)
+- 请求参数验证 (使用 Flask-RESTX 模型)
+- 响应格式化
+- Swagger 文档生成
+
+#### GlotService 类
+
+核心服务类，负责：
+- 与 Glot API 异步交互
+- 代码执行逻辑
+- 错误处理和转义
+- 语言映射管理
+
+#### 数据模型
+
+- `PostFile`: 表示代码文件的数据模型
+- `PostDataModel`: 表示发送给 Glot API 的请求数据模型
+- `RunResult`: 表示代码执行结果的数据模型
+
+## 环境要求
+
+- Python 3.7+
+- 网络连接（需要访问 Glot API）
+
+## 开发指南
+
+### 添加新的 API 端点
+
+1. 在 `controllers/` 目录下创建新的控制器文件
+2. 定义命名空间和数据模型
+3. 实现资源类和业务逻辑
+4. 在 `main.py` 中注册命名空间
+
+```python
+# 示例：新增控制器
+from flask_restx import Namespace, Resource, fields
+
+api = Namespace('new_feature', description='新功能')
+
+@api.route('/action')
+class NewController(Resource):
+    def get(self):
+        return {'message': 'Hello from new feature'}
+```
+
+### 代码规范
+
+- 使用 4 空格缩进
+- 遵循 PEP 8 代码风格
+- 使用类型提示
+- 编写完整的文档字符串
+- 控制器只处理 HTTP 逻辑，业务逻辑放在服务层
+
+### 测试
+
+```bash
+# 运行应用
+python main.py
+
+# 测试 API 端点
+curl http://localhost:6173/
+
+# 测试认证提供商列表
+curl http://localhost:6173/auth/providers
+
+# 查看 Swagger 文档
+open http://localhost:6173/swagger/
+
+# 测试 Redis 连接
+redis-cli ping
+
+# 测试公共代码执行接口（无需认证，使用 Redis 缓存）
+curl -X POST http://localhost:6173/code/run/public \
+  -H "Content-Type: application/json" \
+  -d '{
+    "code": "console.log(\"Hello, World!\")",
+    "language": "javascript"
+  }'
+```
+
+## 贡献指南
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+## 许可证
+
+本项目采用 MIT 许可证 - 查看 [LICENSE](../../../LICENSE) 文件了解详情。
diff --git a/webapi/fastapi_of_letcoing/controllers/__init__.py b/webapi/fastapi_of_letcoing/controllers/__init__.py
new file mode 100644
index 0000000..6ca5193
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/__init__.py
@@ -0,0 +1 @@
+# 控制器包
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/auth_controller.py b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
new file mode 100644
index 0000000..99228da
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/auth_controller.py
@@ -0,0 +1,264 @@
+from flask import request, jsonify, url_for
+from flask_restx import Resource, Namespace, fields
+from interfaces.service_interfaces import IConfigService, ILoggerService, IJWTService, IOIDCService
+from core.di_container import inject
+from models.auth_models import (
+    LoginRequest, LoginResponse, AuthCallbackRequest, 
+    AuthResult, UserInfo, TokenResponse
+)
+
+# 创建命名空间
+api = Namespace('auth', description='认证相关操作')
+
+# 定义数据模型
+login_request_model = api.model('LoginRequest', {
+    'provider': fields.String(required=True, description='认证提供商'),
+    'redirect_uri': fields.String(description='回调地址'),
+})
+
+token_request_model = api.model('TokenRequest', {
+    'refresh_token': fields.String(required=True, description='刷新令牌'),
+})
+
+# 定义响应模型
+login_response_model = api.model('LoginResponse', {
+    'success': fields.Boolean(description='是否成功'),
+    'authorization_url': fields.String(description='授权URL'),
+    'error': fields.String(description='错误信息'),
+})
+
+token_response_model = api.model('TokenResponse', {
+    'access_token': fields.String(description='访问令牌'),
+    'refresh_token': fields.String(description='刷新令牌'),
+    'expires_in': fields.Integer(description='过期时间（秒）'),
+    'token_type': fields.String(description='令牌类型'),
+    'user_info': fields.Raw(description='用户信息'),
+})
+
+auth_result_model = api.model('AuthResult', {
+    'success': fields.Boolean(description='是否成功'),
+    'user_info': fields.Raw(description='用户信息'),
+    'tokens': fields.Nested(token_response_model, description='令牌信息'),
+    'error': fields.String(description='错误信息'),
+})
+
+providers_response_model = api.model('ProvidersResponse', {
+    'providers': fields.List(fields.String(), description='支持的提供商列表'),
+})
+
+@api.route('/login')
+class AuthLoginController(Resource):
+    @api.expect(login_request_model)
+    @api.doc('login')
+    @api.response(200, 'Success', login_response_model)
+    @api.response(400, 'Bad Request')
+    def post(self):
+        """获取认证授权URL"""
+        # 注入服务
+        oidc_service = inject(IOIDCService)
+        
+        # 获取请求数据
+        data = request.get_json()
+        if not data:
+            return {'success': False, 'error': '请求体不能为空'}, 400
+        
+        provider = data.get('provider', '')
+        redirect_uri = data.get('redirect_uri')
+        
+        # 验证参数
+        if not provider:
+            return {'success': False, 'error': '提供商不能为空'}, 400
+        
+        # 验证提供商是否支持
+        if not oidc_service.validate_provider(provider):
+            return {'success': False, 'error': f'不支持的提供商: {provider}'}, 400
+        
+        # 获取授权URL
+        authorization_url = oidc_service.get_authorization_url(provider, redirect_uri)
+        
+        if not authorization_url:
+            return {'success': False, 'error': '获取授权URL失败'}, 500
+        
+        return {'success': True, 'authorization_url': authorization_url}, 200
+
+
+@api.route('/callback/<provider>')
+class AuthCallbackController(Resource):
+    @api.doc('auth_callback')
+    @api.response(200, 'Success', auth_result_model)
+    @api.response(400, 'Bad Request')
+    def get(self, provider: str):
+        """处理认证回调"""
+        # 注入服务
+        oidc_service = inject(IOIDCService)
+        jwt_service = inject(IJWTService)
+        
+        # 验证提供商
+        if not oidc_service.validate_provider(provider):
+            return {'success': False, 'error': f'不支持的提供商: {provider}'}, 400
+        
+        # 获取回调参数
+        code = request.args.get('code')
+        state = request.args.get('state')
+        error = request.args.get('error')
+        error_description = request.args.get('error_description')
+        
+        # 检查是否有错误
+        if error:
+            return {
+                'success': False, 
+                'error': error,
+                'error_description': error_description
+            }, 400
+        
+        if not code:
+            return {'success': False, 'error': '授权码不能为空'}, 400
+        
+        # 处理授权回调
+        auth_result = oidc_service.authorize_callback(provider)
+        
+        if not auth_result:
+            return {'success': False, 'error': '授权回调处理失败'}, 500
+        
+        # 提取用户信息
+        user_info_data = auth_result.get('user_info')
+        if not user_info_data:
+            return {'success': False, 'error': '获取用户信息失败'}, 500
+        
+        # 创建用户信息对象
+        user_info = UserInfo(
+            id=user_info_data['id'],
+            username=user_info_data.get('username', ''),
+            email=user_info_data.get('email', ''),
+            name=user_info_data.get('name', ''),
+            avatar_url=user_info_data.get('avatar_url', ''),
+            provider=user_info_data.get('provider', provider)
+        )
+        
+        # 生成JWT令牌
+        tokens = jwt_service.generate_tokens(user_info.to_dict())
+        
+        # 创建令牌响应
+        token_response = TokenResponse(
+            access_token=tokens.access_token,
+            refresh_token=tokens.refresh_token,
+            expires_in=tokens.expires_in,
+            user_info=user_info
+        )
+        
+        # 返回认证结果
+        return {
+            'success': True,
+            'user_info': user_info.to_dict(),
+            'tokens': token_response.to_dict()
+        }, 200
+
+
+@api.route('/refresh')
+class AuthRefreshController(Resource):
+    @api.expect(token_request_model)
+    @api.doc('refresh_token')
+    @api.response(200, 'Success', token_response_model)
+    @api.response(400, 'Bad Request')
+    def post(self):
+        """刷新访问令牌"""
+        # 注入服务
+        jwt_service = inject(IJWTService)
+        
+        # 获取请求数据
+        data = request.get_json()
+        if not data:
+            return {'error': '请求体不能为空'}, 400
+        
+        refresh_token = data.get('refresh_token', '')
+        
+        # 验证参数
+        if not refresh_token:
+            return {'error': '刷新令牌不能为空'}, 400
+        
+        # 刷新令牌
+        new_tokens = jwt_service.refresh_access_token(refresh_token)
+        
+        if not new_tokens:
+            return {'error': '刷新令牌无效或已过期'}, 400
+        
+        # 获取用户信息
+        user_info = jwt_service.verify_access_token(new_tokens.access_token)
+        user_obj = UserInfo(**user_info) if user_info else None
+        
+        # 创建令牌响应
+        token_response = TokenResponse(
+            access_token=new_tokens.access_token,
+            refresh_token=new_tokens.refresh_token,
+            expires_in=new_tokens.expires_in,
+            user_info=user_obj
+        )
+        
+        return token_response.to_dict(), 200
+
+
+@api.route('/logout')
+class AuthLogoutController(Resource):
+    @api.doc('logout')
+    @api.response(200, 'Success')
+    @api.response(400, 'Bad Request')
+    def post(self):
+        """登出（撤销令牌）"""
+        # 注入服务
+        jwt_service = inject(IJWTService)
+        
+        # 从请求头获取令牌
+        auth_header = request.headers.get('Authorization', '')
+        if not auth_header.startswith('Bearer '):
+            return {'error': '无效的授权头'}, 400
+        
+        token = auth_header[7:]  # 移除 'Bearer ' 前缀
+        
+        # 撤销令牌
+        success = jwt_service.revoke_token(token)
+        
+        if success:
+            return {'message': '登出成功'}, 200
+        else:
+            return {'error': '令牌撤销失败'}, 400
+
+
+@api.route('/verify')
+class AuthVerifyController(Resource):
+    @api.doc('verify_token')
+    @api.response(200, 'Success')
+    @api.response(401, 'Unauthorized')
+    def get(self):
+        """验证访问令牌"""
+        # 注入服务
+        jwt_service = inject(IJWTService)
+        
+        # 从请求头获取令牌
+        auth_header = request.headers.get('Authorization', '')
+        if not auth_header.startswith('Bearer '):
+            return {'error': '无效的授权头'}, 401
+        
+        token = auth_header[7:]  # 移除 'Bearer ' 前缀
+        
+        # 验证令牌
+        user_info = jwt_service.verify_access_token(token)
+        
+        if user_info:
+            return {'valid': True, 'user_info': user_info}, 200
+        else:
+            return {'valid': False, 'error': '令牌无效或已过期'}, 401
+
+
+@api.route('/providers')
+class AuthProvidersController(Resource):
+    @api.doc('list_providers')
+    @api.response(200, 'Success', providers_response_model)
+    def get(self):
+        """获取支持的认证提供商列表"""
+        # 注入服务
+        oidc_service = inject(IOIDCService)
+        
+        # 获取支持的提供商
+        providers = oidc_service.get_supported_providers()
+        
+        return {'providers': providers}, 200
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/code_controller.py b/webapi/fastapi_of_letcoing/controllers/code_controller.py
new file mode 100644
index 0000000..2c6a1d1
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/code_controller.py
@@ -0,0 +1,130 @@
+from flask import request, g
+from flask_restx import Resource, Namespace, fields
+from interfaces.service_interfaces import ICodeExecutionService
+from core.di_container import inject
+from models.glot_models import CodeExecutionRequest
+from middleware.auth_middleware import AuthMiddleware, RateLimitMiddleware
+
+# 创建命名空间
+api = Namespace('code', description='代码执行相关操作')
+
+# 定义数据模型
+code_execution_model = api.model('CodeExecution', {
+    'code': fields.String(required=True, description='要执行的代码'),
+    'language': fields.String(default='javascript', description='编程语言'),
+    'stdin': fields.String(description='标准输入'),
+})
+
+# 定义响应模型
+response_model = api.model('CodeExecutionResponse', {
+    'stdout': fields.String(description='标准输出'),
+    'stderr': fields.String(description='标准错误'),
+    'message': fields.String(description='执行结果信息'),
+})
+
+# 定义错误响应模型
+error_model = api.model('ErrorResponse', {
+    'error': fields.String(description='错误信息'),
+})
+
+@api.route('/run')
+class CodeExecutionController(Resource):
+    @api.expect(code_execution_model)
+    @api.doc('execute_code')
+    @api.response(200, 'Success', response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @api.response(401, 'Unauthorized')
+    @AuthMiddleware.require_auth
+    @RateLimitMiddleware.rate_limit(max_requests=100, window_seconds=3600)
+    def post(self):
+        """执行代码（需要认证）"""
+        # 注入服务
+        code_service = inject(ICodeExecutionService)
+        
+        # 获取当前用户信息
+        current_user = getattr(g, 'current_user', None)
+        
+        # 获取请求数据
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+        
+        code = model.get('code', '')
+        language = model.get('language', 'javascript')
+        stdin = model.get('stdin', '')
+        
+        # 验证代码
+        if not code or code.strip() == "":
+            return {'error': '代码不能为空'}, 400
+        
+        # 构建请求对象
+        execution_request = CodeExecutionRequest(
+            code=code,
+            language=language,
+            stdin=stdin if stdin else None
+        )
+        
+        # 调用服务
+        import asyncio
+        result = asyncio.run(code_service.execute_code(execution_request))
+        
+        # 处理结果并格式化响应
+        if not result.success:
+            return {'error': result.stderr}, 400
+        
+        response_data = {
+            'message': '代码执行成功', 
+            'stdout': result.stdout
+        }
+        
+        # 添加用户信息到响应中（可选）
+        if current_user:
+            response_data['user'] = {
+                'id': current_user.get('id'),
+                'username': current_user.get('username')
+            }
+        
+        return response_data, 200
+
+
+@api.route('/run/public')
+class PublicCodeExecutionController(Resource):
+    @api.expect(code_execution_model)
+    @api.doc('execute_code_public')
+    @api.response(200, 'Success', response_model)
+    @api.response(400, 'Bad Request', error_model)
+    @RateLimitMiddleware.rate_limit(max_requests=20, window_seconds=3600)
+    def post(self):
+        """执行代码（公共接口，无需认证，限制较严）"""
+        # 注入服务
+        code_service = inject(ICodeExecutionService)
+        
+        # 获取请求数据
+        model = request.get_json()
+        if not model:
+            return {'error': '请求体不能为空'}, 400
+        
+        code = model.get('code', '')
+        language = model.get('language', 'javascript')
+        stdin = model.get('stdin', '')
+        
+        # 验证代码
+        if not code or code.strip() == "":
+            return {'error': '代码不能为空'}, 400
+        
+        # 构建请求对象
+        execution_request = CodeExecutionRequest(
+            code=code,
+            language=language,
+            stdin=stdin if stdin else None
+        )
+        
+        # 调用服务
+        import asyncio
+        result = asyncio.run(code_service.execute_code(execution_request))
+        
+        # 处理结果并格式化响应
+        if not result.success:
+            return {'error': result.stderr}, 400
+        
+        return {'message': '代码执行成功', 'stdout': result.stdout}, 200
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/controllers/course_controller.py b/webapi/fastapi_of_letcoing/controllers/course_controller.py
new file mode 100644
index 0000000..04b1da5
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/course_controller.py
@@ -0,0 +1,200 @@
+"""Course and learning progress controllers."""
+
+from __future__ import annotations
+
+import asyncio
+
+from flask import g, request
+from flask_restx import Namespace, Resource, fields
+
+from core.di_container import inject
+from middleware.auth_middleware import AuthMiddleware
+from services.course_service import CourseService
+
+api = Namespace("courses", description="Course and learning progress operations")
+
+course_model = api.model(
+    "CourseCreate",
+    {
+        "title": fields.String(required=True, description="Course title"),
+        "description": fields.String(required=True, description="Course description"),
+        "cover_url": fields.String(required=False, description="Cover URL"),
+    },
+)
+
+course_update_model = api.model(
+    "CourseUpdate",
+    {
+        "title": fields.String(required=False, description="Course title"),
+        "description": fields.String(required=False, description="Course description"),
+        "cover_url": fields.String(required=False, description="Cover URL"),
+        "is_active": fields.Boolean(required=False, description="Active flag"),
+    },
+)
+
+course_response_model = api.model(
+    "CourseResponse",
+    {
+        "id": fields.Integer(description="Course ID"),
+        "title": fields.String(description="Course title"),
+        "description": fields.String(description="Course description"),
+        "cover_url": fields.String(description="Cover URL"),
+        "is_active": fields.Boolean(description="Active flag"),
+        "created_at": fields.String(description="Created time"),
+        "updated_at": fields.String(description="Updated time"),
+    },
+)
+
+progress_create_model = api.model(
+    "ProgressCreate",
+    {
+        "course_id": fields.Integer(required=True, description="Course ID"),
+        "progress": fields.Integer(required=True, description="Progress 0-100"),
+    },
+)
+
+progress_update_model = api.model(
+    "ProgressUpdate",
+    {
+        "progress": fields.Integer(required=False, description="Progress 0-100"),
+        "completed": fields.Boolean(required=False, description="Completed flag"),
+    },
+)
+
+progress_response_model = api.model(
+    "ProgressResponse",
+    {
+        "id": fields.Integer(description="Progress ID"),
+        "user_id": fields.Integer(description="User ID"),
+        "course_id": fields.Integer(description="Course ID"),
+        "progress": fields.Integer(description="Progress"),
+        "completed": fields.Boolean(description="Completed flag"),
+        "last_learned_at": fields.String(description="Last learned time"),
+        "created_at": fields.String(description="Created time"),
+        "updated_at": fields.String(description="Updated time"),
+    },
+)
+
+user_course_response_model = api.model(
+    "UserCourseResponse",
+    {
+        "course": fields.Nested(course_response_model),
+        "progress": fields.Nested(progress_response_model),
+    },
+)
+
+
+def _run(coro):
+    return asyncio.run(coro)
+
+
+@api.route("")
+class CourseListController(Resource):
+    @api.marshal_list_with(course_response_model)
+    def get(self):
+        service = inject(CourseService)
+        limit = request.args.get("limit", 50, type=int)
+        offset = request.args.get("offset", 0, type=int)
+        active_only = request.args.get("active_only", "true").lower() == "true"
+        return _run(service.list_courses(limit=limit, offset=offset, active_only=active_only)), 200
+
+    @api.expect(course_model)
+    @api.marshal_with(course_response_model, code=201)
+    @AuthMiddleware.require_auth
+    def post(self):
+        service = inject(CourseService)
+        data = request.get_json(silent=True) or {}
+        if not data.get("title") or not data.get("description"):
+            return {"error": "title and description are required"}, 400
+        try:
+            course = _run(service.create_course(data))
+            return course, 201
+        except Exception as exc:
+            return {"error": str(exc)}, 500
+
+
+@api.route("/<int:course_id>")
+class CourseDetailController(Resource):
+    @api.marshal_with(course_response_model)
+    def get(self, course_id: int):
+        service = inject(CourseService)
+        course = _run(service.get_course_by_id(course_id))
+        if not course:
+            return {"error": "Course not found"}, 404
+        return course, 200
+
+    @api.expect(course_update_model)
+    @api.marshal_with(course_response_model)
+    @AuthMiddleware.require_auth
+    def put(self, course_id: int):
+        service = inject(CourseService)
+        data = request.get_json(silent=True) or {}
+        course = _run(service.update_course(course_id, data))
+        if not course:
+            return {"error": "Course not found"}, 404
+        return course, 200
+
+
+@api.route("/progress")
+class LearningProgressListController(Resource):
+    @api.marshal_list_with(user_course_response_model)
+    @AuthMiddleware.require_auth
+    def get(self):
+        service = inject(CourseService)
+        current_user = getattr(g, "current_user", None)
+        if not current_user:
+            return {"error": "Unauthorized"}, 401
+        return _run(service.get_user_courses(int(current_user["id"]))), 200
+
+    @api.expect(progress_create_model)
+    @api.marshal_with(progress_response_model, code=201)
+    @AuthMiddleware.require_auth
+    def post(self):
+        service = inject(CourseService)
+        current_user = getattr(g, "current_user", None)
+        if not current_user:
+            return {"error": "Unauthorized"}, 401
+
+        data = request.get_json(silent=True) or {}
+        if "course_id" not in data or "progress" not in data:
+            return {"error": "course_id and progress are required"}, 400
+
+        try:
+            progress = _run(service.create_learning_progress(int(current_user["id"]), data))
+            return progress, 201
+        except ValueError as exc:
+            return {"error": str(exc)}, 400
+        except Exception as exc:
+            return {"error": str(exc)}, 500
+
+
+@api.route("/progress/<int:course_id>")
+class LearningProgressDetailController(Resource):
+    @api.marshal_with(progress_response_model)
+    @AuthMiddleware.require_auth
+    def get(self, course_id: int):
+        service = inject(CourseService)
+        current_user = getattr(g, "current_user", None)
+        if not current_user:
+            return {"error": "Unauthorized"}, 401
+
+        progress = _run(service.get_learning_progress(int(current_user["id"]), course_id))
+        if not progress:
+            return {"error": "Progress not found"}, 404
+        return progress, 200
+
+    @api.expect(progress_update_model)
+    @api.marshal_with(progress_response_model)
+    @AuthMiddleware.require_auth
+    def put(self, course_id: int):
+        service = inject(CourseService)
+        current_user = getattr(g, "current_user", None)
+        if not current_user:
+            return {"error": "Unauthorized"}, 401
+
+        data = request.get_json(silent=True) or {}
+        progress = _run(service.update_learning_progress(int(current_user["id"]), course_id, data))
+        if not progress:
+            return {"error": "Progress not found"}, 404
+        return progress, 200
+
diff --git a/webapi/fastapi_of_letcoing/controllers/question_controller.py b/webapi/fastapi_of_letcoing/controllers/question_controller.py
new file mode 100644
index 0000000..d92508e
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/question_controller.py
@@ -0,0 +1,87 @@
+from flask import request
+from flask_restx import Resource, Namespace, fields
+from core.di_container import inject
+from interfaces.service_interfaces import IQuestionService
+from models.question_models import QuestionResponse
+
+# 创建命名空间
+api = Namespace('questions', description='题目管理')
+
+# 定义数据模型
+question_model = api.model('Question', {
+    'id': fields.Integer(readonly=True, description="题目ID"),
+    'title': fields.String(required=True, description="题目标题"),
+    'intro': fields.String(description="题目介绍"),
+    'difficulty': fields.Integer(required=True, description="难度 (1-5)", min=1, max=5),
+    'testcode': fields.String(description="验证代码"),
+    'lang': fields.String(description="编程语言", default="cpp"),
+    'created_at': fields.DateTime(readonly=True, description="创建时间"),
+    'updated_at': fields.DateTime(readonly=True, description="更新时间"),
+})
+
+@api.route('/')
+class QuestionList(Resource):
+    @api.doc('list_questions')
+    @api.marshal_list_with(question_model)
+    def get(self):
+        """获取题目列表"""
+        # 注入服务
+        service = inject(IQuestionService)
+        
+        # 获取分页参数
+        skip = request.args.get('skip', 0, type=int)
+        limit = request.args.get('limit', 100, type=int)
+        
+        return service.get_questions(skip=skip, limit=limit)
+    
+    @api.doc('create_question')
+    @api.expect(question_model)
+    @api.marshal_with(question_model, code=201)
+    def post(self):
+        """创建新题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # request.json 包含前端发来的数据
+        return service.create_question(request.json), 201    
+    
+@api.route('/<int:id>')
+class QuestionDetail(Resource):
+    @api.doc('get_question')
+    @api.marshal_with(question_model)
+    def get(self, id):
+        """获取一个题目详情"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 提取题目ID
+        result = service.get_question(id)
+        if result:
+            return result
+        api.abort(404, "Question not found")
+    
+    @api.doc('update_question')
+    @api.expect(question_model)
+    @api.marshal_with(question_model)
+    def put(self, id):
+        """更新题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 更新题目信息
+        result = service.update_question(id, request.json)
+        if result:
+            return result
+        api.abort(404, "Question not found")
+
+    @api.doc('delete_question')
+    @api.response(204, 'Question deleted')
+    def delete(self, id):
+        """删除题目"""
+        # 注入服务
+        service = inject(IQuestionService)
+
+        # 删除题目
+        if service.delete_question(id):
+            return '', 204
+        api.abort(404, "Question not found")
diff --git a/webapi/fastapi_of_letcoing/controllers/user_controller.py b/webapi/fastapi_of_letcoing/controllers/user_controller.py
new file mode 100644
index 0000000..2f5c683
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/controllers/user_controller.py
@@ -0,0 +1,189 @@
+"""User management controllers."""
+
+from __future__ import annotations
+
+import asyncio
+
+from flask import g, request
+from flask_restx import Namespace, Resource, fields
+
+from core.di_container import inject
+from interfaces.service_interfaces import IJWTService
+from middleware.auth_middleware import AuthMiddleware
+from services.user_service import UserService
+
+api = Namespace("users", description="User related operations")
+
+user_create_model = api.model(
+    "UserCreate",
+    {
+        "username": fields.String(required=True, description="Username"),
+        "email": fields.String(required=False, description="Email"),
+        "password": fields.String(required=True, description="Password"),
+    },
+)
+
+user_login_model = api.model(
+    "UserLogin",
+    {
+        "identifier": fields.String(required=False, description="Username or email"),
+        "email": fields.String(required=False, description="Email"),
+        "username": fields.String(required=False, description="Username"),
+        "password": fields.String(required=True, description="Password"),
+    },
+)
+
+user_update_model = api.model(
+    "UserUpdate",
+    {
+        "username": fields.String(required=False, description="Username"),
+        "email": fields.String(required=False, description="Email"),
+        "password": fields.String(required=False, description="Password"),
+        "is_active": fields.Boolean(required=False, description="Active flag"),
+    },
+)
+
+user_response_model = api.model(
+    "UserResponse",
+    {
+        "id": fields.Integer(description="User ID"),
+        "username": fields.String(description="Username"),
+        "email": fields.String(description="Email"),
+        "is_active": fields.Boolean(description="Active flag"),
+        "last_login": fields.String(description="Last login time"),
+        "created_at": fields.String(description="Created time"),
+        "updated_at": fields.String(description="Updated time"),
+    },
+)
+
+login_response_model = api.model(
+    "LoginResponse",
+    {
+        "user": fields.Nested(user_response_model),
+        "token": fields.String(description="Access token"),
+        "message": fields.String(description="Message"),
+    },
+)
+
+
+def _run(coro):
+    return asyncio.run(coro)
+
+
+@api.route("/register")
+class UserRegisterController(Resource):
+    @api.expect(user_create_model)
+    @api.marshal_with(user_response_model, code=201)
+    def post(self):
+        service = inject(UserService)
+        data = request.get_json(silent=True) or {}
+        username = data.get("username", "").strip()
+        password = data.get("password", "")
+        email = data.get("email")
+
+        if not username or not password:
+            return {"error": "username and password are required"}, 400
+
+        try:
+            user = _run(service.create_user(username=username, password=password, email=email))
+            return user, 201
+        except ValueError as exc:
+            return {"error": str(exc)}, 400
+        except Exception as exc:
+            return {"error": str(exc)}, 500
+
+
+@api.route("/login")
+class UserLoginController(Resource):
+    @api.expect(user_login_model)
+    @api.marshal_with(login_response_model)
+    def post(self):
+        service = inject(UserService)
+        jwt_service = inject(IJWTService)
+        data = request.get_json(silent=True) or {}
+        identifier = (data.get("identifier") or data.get("username") or data.get("email") or "").strip()
+        password = data.get("password", "")
+
+        if not identifier or not password:
+            return {"error": "identifier and password are required"}, 400
+
+        user = _run(service.authenticate_user(identifier, password))
+        if not user:
+            return {"error": "Invalid credentials"}, 401
+
+        tokens = jwt_service.generate_tokens(
+            {
+                "id": user["id"],
+                "username": user["username"],
+                "email": user.get("email"),
+            }
+        )
+
+        return {
+            "user": user,
+            "token": tokens.access_token,
+            "message": "Login successful",
+        }, 200
+
+
+@api.route("/profile")
+class UserProfileController(Resource):
+    @AuthMiddleware.require_auth
+    @api.marshal_with(user_response_model)
+    def get(self):
+        current_user = getattr(g, "current_user", None)
+        if not current_user:
+            return {"error": "Unauthorized"}, 401
+        return current_user, 200
+
+
+@api.route("")
+class UserListController(Resource):
+    @api.marshal_list_with(user_response_model)
+    def get(self):
+        service = inject(UserService)
+        limit = request.args.get("limit", 50, type=int)
+        offset = request.args.get("offset", 0, type=int)
+        active_only = request.args.get("active_only", "false").lower() == "true"
+        users = _run(service.list_users(limit=limit, offset=offset, active_only=active_only))
+        return users, 200
+
+
+@api.route("/<int:user_id>")
+class UserDetailController(Resource):
+    @api.marshal_with(user_response_model)
+    def get(self, user_id: int):
+        service = inject(UserService)
+        user = _run(service.get_user_by_id(user_id))
+        if not user:
+            return {"error": "User not found"}, 404
+        return user, 200
+
+    @api.expect(user_update_model)
+    @api.marshal_with(user_response_model)
+    def put(self, user_id: int):
+        service = inject(UserService)
+        data = request.get_json(silent=True) or {}
+
+        try:
+            if "password" in data and data["password"]:
+                _run(service.update_user_password(user_id, data["password"]))
+            update_fields = {key: data.get(key) for key in ("username", "email", "is_active") if key in data}
+            if update_fields:
+                _run(service.update_user_info(user_id, **update_fields))
+            user = _run(service.get_user_by_id(user_id))
+            if not user:
+                return {"error": "User not found"}, 404
+            return user, 200
+        except ValueError as exc:
+            return {"error": str(exc)}, 400
+        except Exception as exc:
+            return {"error": str(exc)}, 500
+
+    def delete(self, user_id: int):
+        service = inject(UserService)
+        deleted = _run(service.delete_user(user_id))
+        if not deleted:
+            return {"error": "User not found"}, 404
+        return "", 204
+
diff --git a/webapi/fastapi_of_letcoing/core/db_config.py b/webapi/fastapi_of_letcoing/core/db_config.py
new file mode 100644
index 0000000..29c6ee3
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/core/db_config.py
@@ -0,0 +1,58 @@
+"""
+数据库配置文件
+PostgreSQL 数据库连接配置管理
+"""
+from dataclasses import dataclass
+from typing import Optional
+
+from core.di_container import get_container
+from interfaces.service_interfaces import IConfigService
+
+
+@dataclass
+class DatabaseConfig:
+    """数据库配置类"""
+    
+    # 数据库连接参数
+    host: str = "localhost"
+    port: int = 5432
+    database: str = "letcoding"
+    username: str = "postgres"
+    password: str = ""
+    
+    # 连接池配置
+    max_connections: int = 20
+    stale_timeout: int = 300
+    
+    def __post_init__(self):
+        """初始化时从 ConfigService 读取配置"""
+        try:
+            config_service = get_container().resolve(IConfigService)
+            db_config = config_service.get_database_config()
+            
+            self.host = db_config["host"]
+            self.port = db_config["port"]
+            self.database = db_config["database"]
+            self.username = db_config["username"]
+            self.password = db_config["password"]
+            self.max_connections = db_config["max_connections"]
+            self.stale_timeout = db_config["stale_timeout"]
+        except Exception:
+            # 如果依赖注入不可用，使用默认值
+            pass
+    
+    @property
+    def database_url(self) -> str:
+        """获取数据库连接 URL"""
+        return f"postgresql://{self.username}:{self.password}@{self.host}:{self.port}/{self.database}"
+    
+    def to_dict(self) -> dict:
+        """转换为字典格式"""
+        return {
+            "host": self.host,
+            "port": self.port,
+            "database": self.database,
+            "username": self.username,
+            "max_connections": self.max_connections,
+            "stale_timeout": self.stale_timeout
+        }
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/db_container.py b/webapi/fastapi_of_letcoing/core/db_container.py
new file mode 100644
index 0000000..8ccf26d
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/core/db_container.py
@@ -0,0 +1,67 @@
+"""
+Peewee连接PostgreSQL配置
+基于Peewee的PostgreSQL数据库连接管理及基础模型定义
+"""
+from dataclasses import dataclass
+from typing import Optional
+
+from peewee import PostgresqlDatabase, Model
+from core.di_container import get_container
+from interfaces.service_interfaces import IConfigService
+
+
+@dataclass
+class PeeweeDatabaseConfig:
+    """Peewee数据库配置类"""
+
+    # 数据库连接参数
+    host: str = "localhost"
+    port: int = 5432
+    database: str = "letcoding"
+    user: str = "postgres"
+    password: str = "123456"
+
+    # 连接池配置
+    max_connections: int = 20
+    stale_timeout: int = 300
+
+    def __post_init__(self):
+        """初始化时从ConfigService读取配置"""
+        try:
+            config_service = get_container().resolve(IConfigService)
+            db_config = config_service.get_database_config()
+
+            self.host = db_config["host"]
+            self.port = db_config["port"]
+            self.database = db_config["database"]
+            self.user = db_config["username"]
+            self.password = db_config["password"]
+            self.max_connections = db_config["max_connections"]
+            self.stale_timeout = db_config["stale_timeout"]
+        except Exception:
+            # 依赖注入不可用时使用默认值
+            pass
+
+    @property
+    def connection_params(self) -> dict:
+        """获取Peewee连接参数字典"""
+        return {
+            "database": self.database,
+            "user": self.user,
+            "password": self.password,
+            "host": self.host,
+            "port": self.port,
+            "max_connections": self.max_connections,
+            "stale_timeout": self.stale_timeout
+        }
+
+
+# 初始化数据库连接
+db_config = PeeweeDatabaseConfig()
+db = PostgresqlDatabase(** db_config.connection_params)
+
+
+# Peewee基础模型（所有业务模型继承此类）
+class BaseModel(Model):
+    class Meta:
+        database = db  # 绑定数据库连接
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/di_container.py b/webapi/fastapi_of_letcoing/core/di_container.py
new file mode 100644
index 0000000..f628bde
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/core/di_container.py
@@ -0,0 +1,216 @@
+"""
+依赖注入容器模块
+
+提供简单的依赖注入功能，支持服务注册、解析和生命周期管理。
+"""
+
+import inspect
+from typing import Any, Dict, Type, TypeVar, Callable, Optional, Union
+from abc import ABC, abstractmethod
+from enum import Enum
+
+T = TypeVar('T')
+
+
+class ServiceLifetime(Enum):
+    """服务生命周期枚举"""
+    SINGLETON = "singleton"  # 单例模式
+    TRANSIENT = "transient"  # 每次请求都创建新实例
+    SCOPED = "scoped"       # 作用域内单例（Flask请求级别）
+
+
+class ServiceDescriptor:
+    """服务描述符"""
+    
+    def __init__(
+        self,
+        service_type: Type,
+        implementation_type: Optional[Type] = None,
+        factory: Optional[Callable] = None,
+        instance: Optional[Any] = None,
+        lifetime: ServiceLifetime = ServiceLifetime.TRANSIENT
+    ):
+        self.service_type = service_type
+        self.implementation_type = implementation_type
+        self.factory = factory
+        self.instance = instance
+        self.lifetime = lifetime
+        
+        # 验证参数
+        if sum(bool(x) for x in [implementation_type, factory, instance]) != 1:
+            raise ValueError("必须且只能提供 implementation_type, factory, 或 instance 中的一个")
+
+
+class DIContainer:
+    """依赖注入容器"""
+    
+    def __init__(self):
+        self._services: Dict[Type, ServiceDescriptor] = {}
+        self._singleton_instances: Dict[Type, Any] = {}
+        self._scoped_instances: Dict[Type, Any] = {}
+    
+    def register_singleton(
+        self, 
+        service_type: Type[T], 
+        implementation_type: Optional[Type] = None,
+        factory: Optional[Callable[[], T]] = None,
+        instance: Optional[T] = None
+    ) -> 'DIContainer':
+        """注册单例服务"""
+        descriptor = ServiceDescriptor(
+            service_type=service_type,
+            implementation_type=implementation_type,
+            factory=factory,
+            instance=instance,
+            lifetime=ServiceLifetime.SINGLETON
+        )
+        self._services[service_type] = descriptor
+        return self
+    
+    def register_transient(
+        self,
+        service_type: Type[T],
+        implementation_type: Optional[Type] = None,
+        factory: Optional[Callable[[], T]] = None
+    ) -> 'DIContainer':
+        """注册瞬态服务"""
+        descriptor = ServiceDescriptor(
+            service_type=service_type,
+            implementation_type=implementation_type,
+            factory=factory,
+            instance=None,
+            lifetime=ServiceLifetime.TRANSIENT
+        )
+        self._services[service_type] = descriptor
+        return self
+    
+    def register_scoped(
+        self,
+        service_type: Type[T],
+        implementation_type: Optional[Type] = None,
+        factory: Optional[Callable[[], T]] = None
+    ) -> 'DIContainer':
+        """注册作用域服务"""
+        descriptor = ServiceDescriptor(
+            service_type=service_type,
+            implementation_type=implementation_type,
+            factory=factory,
+            instance=None,
+            lifetime=ServiceLifetime.SCOPED
+        )
+        self._services[service_type] = descriptor
+        return self
+    
+    def resolve(self, service_type: Type[T]) -> T:
+        """解析服务"""
+        if service_type not in self._services:
+            raise ValueError(f"服务 {service_type} 未注册")
+        
+        descriptor = self._services[service_type]
+        
+        # 处理单例
+        if descriptor.lifetime == ServiceLifetime.SINGLETON:
+            if service_type in self._singleton_instances:
+                return self._singleton_instances[service_type]
+            
+            instance = self._create_instance(descriptor)
+            self._singleton_instances[service_type] = instance
+            return instance
+        
+        # 处理作用域
+        elif descriptor.lifetime == ServiceLifetime.SCOPED:
+            if service_type in self._scoped_instances:
+                return self._scoped_instances[service_type]
+            
+            instance = self._create_instance(descriptor)
+            self._scoped_instances[service_type] = instance
+            return instance
+        
+        # 处理瞬态
+        else:
+            return self._create_instance(descriptor)
+    
+    def _create_instance(self, descriptor: ServiceDescriptor) -> Any:
+        """创建服务实例"""
+        # 如果有预定义实例
+        if descriptor.instance is not None:
+            return descriptor.instance
+        
+        # 如果有工厂方法
+        if descriptor.factory is not None:
+            return descriptor.factory()
+        
+        # 如果有实现类型
+        if descriptor.implementation_type is not None:
+            return self._create_with_injection(descriptor.implementation_type)
+        
+        raise ValueError(f"无法创建服务 {descriptor.service_type} 的实例")
+    
+    def _create_with_injection(self, implementation_type: Type) -> Any:
+        """通过构造函数注入创建实例"""
+        # 获取构造函数参数
+        sig = inspect.signature(implementation_type.__init__)
+        
+        # 准备参数
+        kwargs = {}
+        for param_name, param in sig.parameters.items():
+            if param_name == 'self':
+                continue
+            
+            # 尝试解析参数类型
+            if param.annotation != inspect.Parameter.empty:
+                param_type = param.annotation
+                if param_type in self._services:
+                    kwargs[param_name] = self.resolve(param_type)
+            # 如果有默认值，使用默认值
+            elif param.default != inspect.Parameter.empty:
+                kwargs[param_name] = param.default
+        
+        return implementation_type(**kwargs)
+    
+    def clear_scope(self):
+        """清除作用域实例（通常在请求结束时调用）"""
+        self._scoped_instances.clear()
+    
+    def is_registered(self, service_type: Type) -> bool:
+        """检查服务是否已注册"""
+        return service_type in self._services
+
+
+# 全局容器实例
+_container: Optional[DIContainer] = None
+
+
+def get_container() -> DIContainer:
+    """获取全局容器实例"""
+    global _container
+    if _container is None:
+        _container = DIContainer()
+        _register_default_services(_container)
+    return _container
+
+
+def _register_default_services(container: DIContainer) -> None:
+    """注册默认服务"""
+    # 注册数据库配置
+    from core.db_config import DatabaseConfig
+    container.register_singleton(DatabaseConfig)
+    
+    # 注意：DatabaseService 在 setup_services 中注册，因为它依赖于 IConfigService
+
+
+def configure_services(configurator: Callable[[DIContainer], None]) -> None:
+    """配置服务"""
+    container = get_container()
+    configurator(container)
+
+
+def inject(service_type: Type[T]) -> T:
+    """依赖注入装饰器辅助函数"""
+    container = get_container()
+    return container.resolve(service_type)
+
+
+class Injectable(ABC):
+    """可注入服务的抽象基类"""
+    pass
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/core/service_config.py b/webapi/fastapi_of_letcoing/core/service_config.py
new file mode 100644
index 0000000..8d1bbf8
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/core/service_config.py
@@ -0,0 +1,59 @@
+"""
+服务配置模块
+
+集中管理依赖注入的配置。
+"""
+
+from core.di_container import configure_services, get_container
+from services.config_service import ConfigService
+from services.logger_service import LoggerService
+from services.glot_service import GlotService
+from services.oidc_service import OIDCService
+from services.jwt_service import JWTService
+from services.redis_service import RedisService
+from services.database_service import DatabaseService
+from services.user_service import UserService
+from services.course_service import CourseService
+from services.question_service import QuestionService
+from interfaces.service_interfaces import IConfigService, ILoggerService, ICodeExecutionService, IRedisService, IOIDCService, IJWTService, IQuestionService
+
+
+def setup_services(app_config: dict) -> None:
+    """设置依赖注入服务"""
+    
+    def service_configurator(container):
+        # 配置服务
+        container.register_singleton(IConfigService, 
+                                  factory=lambda: ConfigService(app_config))
+        container.register_singleton(ILoggerService,
+                                  factory=lambda: LoggerService())
+        container.register_singleton(IRedisService, RedisService)
+        container.register_scoped(IQuestionService, QuestionService)
+        container.register_scoped(ICodeExecutionService, GlotService)
+        container.register_singleton(IOIDCService, OIDCService)
+        container.register_singleton(IJWTService, JWTService)
+        
+        # 数据库服务（依赖于ConfigService）
+        def create_database_service():
+            config_service = container.resolve(IConfigService)
+            return DatabaseService(config_service)
+        
+        def create_user_service():
+            config_service = container.resolve(IConfigService)
+            return UserService(config_service)
+
+        def create_course_service():
+            config_service = container.resolve(IConfigService)
+            return CourseService(config_service)
+        
+        container.register_singleton(DatabaseService, factory=create_database_service)
+        container.register_singleton(UserService, factory=create_user_service)
+        container.register_singleton(CourseService, factory=create_course_service)
+    
+    configure_services(service_configurator)
+
+
+def get_service(service_type):
+    """获取指定类型的服务实例"""
+    container = get_container()
+    return container.resolve(service_type)
diff --git a/webapi/fastapi_of_letcoing/interfaces/__init__.py b/webapi/fastapi_of_letcoing/interfaces/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
new file mode 100644
index 0000000..47f5826
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/interfaces/course_interfaces.py
@@ -0,0 +1,55 @@
+"""Course and progress request/response models."""
+
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class CourseCreateRequest(BaseModel):
+    title: str = Field(min_length=2, max_length=100)
+    description: str
+    cover_url: Optional[str] = None
+
+
+class CourseUpdateRequest(BaseModel):
+    title: Optional[str] = None
+    description: Optional[str] = None
+    cover_url: Optional[str] = None
+    is_active: Optional[bool] = None
+
+
+class CourseResponse(BaseModel):
+    id: int
+    title: str
+    description: str
+    cover_url: Optional[str] = None
+    is_active: bool = True
+    created_at: Optional[str] = None
+    updated_at: Optional[str] = None
+
+
+class LearningProgressCreateRequest(BaseModel):
+    course_id: int
+    progress: int = Field(ge=0, le=100)
+
+
+class LearningProgressUpdateRequest(BaseModel):
+    progress: Optional[int] = Field(default=None, ge=0, le=100)
+    completed: Optional[bool] = None
+
+
+class LearningProgressResponse(BaseModel):
+    id: int
+    user_id: int
+    course_id: int
+    progress: int
+    completed: bool
+    last_learned_at: Optional[str] = None
+    created_at: Optional[str] = None
+    updated_at: Optional[str] = None
+
+
+class UserCourseResponse(BaseModel):
+    course: CourseResponse
+    progress: LearningProgressResponse
+
diff --git a/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
new file mode 100644
index 0000000..f480fad
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/interfaces/service_interfaces.py
@@ -0,0 +1,303 @@
+"""
+服务接口和抽象基类模块
+
+定义各种服务的抽象接口，提供可测试和可扩展的架构基础。
+"""
+
+from abc import ABC, abstractmethod
+from typing import Optional, Dict, Any, List
+import os
+from models.auth_models import JWTToken
+from models.glot_models import CodeExecutionResponse
+
+
+class IConfigService(ABC):
+    """配置服务接口"""
+    
+    @abstractmethod
+    def get_api_token(self) -> str:
+        """获取API Token"""
+        pass
+    
+    @abstractmethod
+    def get_timeout(self) -> int:
+        """获取请求超时时间"""
+        pass
+    
+    @abstractmethod
+    def get_config(self, key: str, default: Any = None) -> Any:
+        """获取配置值"""
+        pass
+
+
+class ICodeExecutionService(ABC):
+    """代码执行服务接口"""
+    
+    @abstractmethod
+    async def execute_code(self, request) -> CodeExecutionResponse:
+        """执行代码"""
+        pass
+
+
+class ILoggerService(ABC):
+    """日志服务接口"""
+    
+    @abstractmethod
+    def info(self, message: str) -> None:
+        """记录信息日志"""
+        pass
+    
+    @abstractmethod
+    def error(self, message: str, exception: Optional[Exception] = None) -> None:
+        """记录错误日志"""
+        pass
+    
+    @abstractmethod
+    def warning(self, message: str) -> None:
+        """记录警告日志"""
+        pass
+    
+    @abstractmethod
+    def debug(self, message: str) -> None:
+        """记录调试日志"""
+        pass
+
+
+class IRedisService(ABC):
+    """Redis 服务接口"""
+    
+    @abstractmethod
+    def is_connected(self) -> bool:
+        """检查是否连接到 Redis"""
+        pass
+    
+    @abstractmethod
+    def reconnect(self) -> bool:
+        """重新连接到 Redis"""
+        pass
+    
+    @abstractmethod
+    def set(self, key: str, value: Any, ttl: Optional[int] = None) -> bool:
+        """设置键值对"""
+        pass
+    
+    @abstractmethod
+    def get(self, key: str, default: Any = None) -> Any:
+        """获取键值"""
+        pass
+    
+    @abstractmethod
+    def delete(self, key: str) -> bool:
+        """删除键"""
+        pass
+    
+    @abstractmethod
+    def exists(self, key: str) -> bool:
+        """检查键是否存在"""
+        pass
+    
+    @abstractmethod
+    def expire(self, key: str, ttl: int) -> bool:
+        """设置键的过期时间"""
+        pass
+    
+    @abstractmethod
+    def ttl(self, key: str) -> int:
+        """获取键的剩余过期时间"""
+        pass
+    
+    @abstractmethod
+    def increment(self, key: str, amount: int = 1) -> Optional[int]:
+        """递增计数器"""
+        pass
+    
+    @abstractmethod
+    def decrement(self, key: str, amount: int = 1) -> Optional[int]:
+        """递减计数器"""
+        pass
+    
+    @abstractmethod
+    def set_add(self, key: str, *members: Any) -> bool:
+        """向集合添加成员"""
+        pass
+    
+    @abstractmethod
+    def set_remove(self, key: str, *members: Any) -> bool:
+        """从集合移除成员"""
+        pass
+    
+    @abstractmethod
+    def set_members(self, key: str) -> List[Any]:
+        """获取集合所有成员"""
+        pass
+    
+    @abstractmethod
+    def set_is_member(self, key: str, member: Any) -> bool:
+        """检查成员是否在集合中"""
+        pass
+    
+    @abstractmethod
+    def list_push(self, key: str, *values: Any) -> Optional[int]:
+        """向列表左侧推送元素"""
+        pass
+    
+    @abstractmethod
+    def list_pop(self, key: str) -> Any:
+        """从列表右侧弹出元素"""
+        pass
+    
+    @abstractmethod
+    def list_length(self, key: str) -> int:
+        """获取列表长度"""
+        pass
+    
+    @abstractmethod
+    def list_range(self, key: str, start: int = 0, end: int = -1) -> List[Any]:
+        """获取列表范围内的元素"""
+        pass
+    
+    @abstractmethod
+    def keys(self, pattern: str = "*") -> List[str]:
+        """获取匹配模式的所有键"""
+        pass
+    
+    @abstractmethod
+    def flushdb(self) -> bool:
+        """清空当前数据库"""
+        pass
+    
+    @abstractmethod
+    def info(self) -> Optional[Dict[str, Any]]:
+        """获取 Redis 服务器信息"""
+        pass
+
+
+class IOIDCService(ABC):
+    """OIDC 认证服务接口"""
+    
+    @abstractmethod
+    def initialize_oauth(self, app) -> None:
+        """初始化 OAuth"""
+        pass
+
+    @abstractmethod
+    def get_authorization_url(self, provider: str, redirect_uri: Optional[str] = None) -> Optional[str]:
+        """
+        获取授权URL
+        
+        Args:
+            provider: 提供商名称 (如 'github')
+            redirect_uri: 回调地址
+            
+        Returns:
+            授权URL或None
+        """
+        pass
+
+    @abstractmethod
+    def authorize_callback(self, provider: str) -> Optional[Dict[str, Any]]:
+        """
+        处理授权回调
+        
+        Args:
+            provider: 提供商名称
+            
+        Returns:
+            用户信息字典或None
+        """
+        pass
+
+    @abstractmethod
+    def get_supported_providers(self) -> List[str]:
+        """获取支持的提供商列表"""
+        pass
+
+    @abstractmethod
+    def validate_provider(self, provider: str) -> bool:
+        """验证提供商是否支持"""
+        pass
+
+
+class IJWTService(ABC):
+    """JWT 认证服务接口"""
+    
+    @abstractmethod
+    def generate_tokens(self, user_info: Dict[str, Any]) -> JWTToken:
+        """
+        生成 JWT 令牌对
+        
+        Args:
+            user_info: 用户信息字典
+            
+        Returns:
+            JWT 令牌对象
+        """
+        pass
+
+    @abstractmethod
+    def verify_access_token(self, token: str) -> Optional[Dict[str, Any]]:
+        """
+        验证访问令牌
+        
+        Args:
+            token: JWT 访问令牌
+            
+        Returns:
+            用户信息或None
+        """
+        pass
+
+    @abstractmethod
+    def refresh_access_token(self, refresh_token: str) -> Optional[JWTToken]:
+        """
+        使用刷新令牌生成新的访问令牌
+        
+        Args:
+            refresh_token: 刷新令牌
+            
+        Returns:
+            新的JWT令牌对象或None
+        """
+        pass
+
+    @abstractmethod
+    def revoke_token(self, token: str) -> bool:
+        """
+        撤销令牌（加入黑名单）
+        
+        Args:
+            token: 要撤销的令牌
+            
+        Returns:
+            是否成功
+        """
+        pass
+
+
+class IQuestionService(ABC):
+    """题目服务接口"""
+    
+    @abstractmethod
+    def create_question(self, data: Dict[str, Any]) -> Any:
+        """创建题目"""
+        pass
+
+    @abstractmethod
+    def get_question(self, question_id: int) -> Optional[Any]:
+        """获取单个题目"""
+        pass
+    
+    @abstractmethod
+    def get_questions(self, skip: int = 0, limit: int = 100) -> List[Any]:
+        """获取题目列表"""
+        pass
+
+    @abstractmethod
+    def update_question(self, question_id: int, data: Dict[str, Any]) -> Optional[Any]:
+        """更新题目"""
+        pass
+
+    @abstractmethod
+    def delete_question(self, question_id: int) -> bool:
+        """删除题目"""
+        pass
diff --git a/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py b/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
new file mode 100644
index 0000000..11972ef
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/interfaces/user_interfaces.py
@@ -0,0 +1,32 @@
+"""User request and response models."""
+
+from typing import Optional
+
+from pydantic import BaseModel, Field
+
+
+class UserCreateRequest(BaseModel):
+    username: str = Field(min_length=3, max_length=50)
+    email: Optional[str] = None
+    password: str = Field(min_length=6)
+    avatar_url: Optional[str] = None
+
+
+class UserUpdateRequest(BaseModel):
+    username: Optional[str] = None
+    email: Optional[str] = None
+    password: Optional[str] = None
+    avatar_url: Optional[str] = None
+    is_active: Optional[bool] = None
+
+
+class UserResponse(BaseModel):
+    id: int
+    username: str
+    email: Optional[str] = None
+    is_active: bool = True
+    avatar_url: Optional[str] = None
+    created_at: Optional[str] = None
+    updated_at: Optional[str] = None
+    last_login: Optional[str] = None
+
diff --git a/webapi/fastapi_of_letcoing/main.py b/webapi/fastapi_of_letcoing/main.py
new file mode 100644
index 0000000..4a09556
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/main.py
@@ -0,0 +1,105 @@
+from flask import Flask, jsonify, request
+from flask_restx import Api, Resource
+from controllers.code_controller import api as code_api
+from controllers.auth_controller import api as auth_api
+from controllers.course_controller import api as course_api
+from controllers.user_controller import api as user_bp
+from controllers.question_controller import api as question_api
+import os
+import json
+import atexit
+from core.service_config import setup_services
+from interfaces.service_interfaces import IOIDCService
+from dotenv import load_dotenv
+from core.di_container import get_container
+from core.exceptions import ServiceInitError
+
+# 加载环境变量
+load_dotenv()
+
+# 创建 Flask 应用
+app = Flask(__name__)
+
+
+@app.before_request
+def handle_preflight():
+    if request.method == "OPTIONS":
+        return ("", 204)
+
+
+@app.after_request
+def add_cors_headers(response):
+    response.headers["Access-Control-Allow-Origin"] = os.environ.get("CORS_ALLOW_ORIGIN", "*")
+    response.headers["Access-Control-Allow-Headers"] = "Content-Type, Authorization"
+    response.headers["Access-Control-Allow-Methods"] = "GET, POST, PUT, DELETE, OPTIONS"
+    response.headers["Access-Control-Max-Age"] = "86400"
+    return response
+
+
+# 配置应用
+app.config["API_TOKEN"] = os.environ.get("API_TOKEN", "")
+app.config["JWT_SECRET_KEY"] = os.environ.get("JWT_SECRET_KEY", "your-secret-key-here")
+app.config["JWT_ACCESS_TOKEN_EXPIRE"] = int(os.environ.get("JWT_ACCESS_TOKEN_EXPIRE", "3600"))
+app.config["JWT_REFRESH_TOKEN_EXPIRE"] = int(os.environ.get("JWT_REFRESH_TOKEN_EXPIRE", "604800"))
+app.config["JWT_ALGORITHM"] = os.environ.get("JWT_ALGORITHM", "HS256")
+
+# Redis 配置
+app.config["REDIS_HOST"] = os.environ.get("REDIS_HOST", "localhost")
+app.config["REDIS_PORT"] = int(os.environ.get("REDIS_PORT", "6379"))
+app.config["REDIS_DB"] = int(os.environ.get("REDIS_DB", "0"))
+app.config["REDIS_PASSWORD"] = os.environ.get("REDIS_PASSWORD")
+app.config["REDIS_TIMEOUT"] = int(os.environ.get("REDIS_TIMEOUT", "5"))
+app.config["REDIS_MAX_CONNECTIONS"] = int(os.environ.get("REDIS_MAX_CONNECTIONS", "10"))
+
+# 数据库配置
+app.config["DB_HOST"] = os.environ.get("DB_HOST", "localhost")
+app.config["DB_PORT"] = int(os.environ.get("DB_PORT", "5432"))
+app.config["DB_NAME"] = os.environ.get("DB_NAME", "letcoding")
+app.config["DB_USER"] = os.environ.get("DB_USER", "postgres")
+app.config["DB_PASSWORD"] = os.environ.get("DB_PASSWORD", "")
+app.config["DB_MAX_CONNECTIONS"] = int(os.environ.get("DB_MAX_CONNECTIONS", "20"))
+app.config["DB_STALE_TIMEOUT"] = int(os.environ.get("DB_STALE_TIMEOUT", "300"))
+app.config["DB_SSL_MODE"] = os.environ.get("DB_SSL_MODE", "disable")
+
+# GitHub OAuth 配置
+app.config["GITHUB_CLIENT_ID"] = os.environ.get("GITHUB_CLIENT_ID")
+app.config["GITHUB_CLIENT_SECRET"] = os.environ.get("GITHUB_CLIENT_SECRET")
+
+# 自定义 OIDC 提供商配置（JSON格式）
+oidc_providers_json = os.environ.get("OIDC_PROVIDERS")
+if oidc_providers_json:
+    try:
+        app.config["OIDC_PROVIDERS"] = json.loads(oidc_providers_json)
+    except json.JSONDecodeError:
+        app.config["OIDC_PROVIDERS"] = {}
+else:
+    app.config["OIDC_PROVIDERS"] = {}
+
+# 配置依赖注入
+setup_services(app.config)
+
+# 初始化 OIDC 服务
+oidc_service = setup_services.__globals__.get("oidc_service")
+if not oidc_service:
+    container = get_container()
+    oidc_service = container.resolve(IOIDCService)
+    oidc_service.initialize_oauth(app)
+
+# 创建 API 实例
+api = Api(
+    app,
+    version="1.0",
+    title="LetCoding API",
+    description="代码执行 API 服务，支持多种编程语言和用户认证",
+    doc="/swagger/",
+)
+
+# 注册命名空间
+api.add_namespace(code_api, path="/code")
+api.add_namespace(auth_api, path="/auth")
+api.add_namespace(user_bp, path="/user")
+api.add_namespace(course_api, path="/courses")
+api.add_namespace(question_api, path="/questions")
+
+if __name__ == "__main__":
+    app.run(debug=True, host="0.0.0.0", port=6173)
diff --git a/webapi/fastapi_of_letcoing/middleware/auth_middleware.py b/webapi/fastapi_of_letcoing/middleware/auth_middleware.py
new file mode 100644
index 0000000..509f8f5
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/middleware/auth_middleware.py
@@ -0,0 +1,200 @@
+"""
+JWT 认证中间件
+
+提供 JWT 令牌验证功能，用于保护 API 端点
+"""
+
+from functools import wraps
+from flask import request, jsonify, g
+from services.jwt_service import JWTService
+from core.di_container import inject
+
+
+class AuthMiddleware:
+    """认证中间件类"""
+    
+    @staticmethod
+    def require_auth(f):
+        """
+        装饰器：要求有效的JWT令牌
+        
+        Args:
+            f: 被装饰的函数
+            
+        Returns:
+            装饰后的函数
+        """
+        @wraps(f)
+        def decorated_function(*args, **kwargs):
+            # 注入JWT服务
+            jwt_service = inject(JWTService)
+            
+            # 从请求头获取令牌
+            auth_header = request.headers.get('Authorization', '')
+            
+            if not auth_header:
+                return jsonify({'error': '缺少Authorization头'}), 401
+            
+            if not auth_header.startswith('Bearer '):
+                return jsonify({'error': '无效的Authorization格式'}), 401
+            
+            token = auth_header[7:]  # 移除 'Bearer ' 前缀
+            
+            # 验证令牌
+            user_info = jwt_service.verify_access_token(token)
+            
+            if not user_info:
+                return jsonify({'error': '令牌无效或已过期'}), 401
+            
+            # 将用户信息存储到g对象中
+            g.current_user = user_info
+            
+            return f(*args, **kwargs)
+        
+        return decorated_function
+    
+    @staticmethod
+    def optional_auth(f):
+        """
+        装饰器：可选的JWT令牌验证
+        
+        如果令牌有效，会将用户信息存储到g对象中
+        如果令牌无效或缺失，仍继续执行函数
+        
+        Args:
+            f: 被装饰的函数
+            
+        Returns:
+            装饰后的函数
+        """
+        @wraps(f)
+        def decorated_function(*args, **kwargs):
+            # 注入JWT服务
+            jwt_service = inject(JWTService)
+            
+            # 从请求头获取令牌
+            auth_header = request.headers.get('Authorization', '')
+            
+            if auth_header and auth_header.startswith('Bearer '):
+                token = auth_header[7:]  # 移除 'Bearer ' 前缀
+                
+                # 验证令牌
+                user_info = jwt_service.verify_access_token(token)
+                
+                # 如果令牌有效，存储用户信息
+                if user_info:
+                    g.current_user = user_info
+            
+            return f(*args, **kwargs)
+        
+        return decorated_function
+
+
+class RateLimitMiddleware:
+    """基于用户的速率限制中间件"""
+    
+    @staticmethod
+    def rate_limit(max_requests: int = 1000, window_seconds: int = 3600):
+        """
+        装饰器：基于用户的速率限制
+        
+        Args:
+            max_requests: 最大请求数
+            window_seconds: 时间窗口（秒）
+            
+        Returns:
+            装饰器函数
+        """
+        def decorator(f):
+            @wraps(f)
+            def decorated_function(*args, **kwargs):
+                # 检查是否有用户信息
+                user_info = getattr(g, 'current_user', None)
+                
+                if user_info:
+                    # 注入JWT服务获取Redis客户端
+                    jwt_service = inject(JWTService)
+                    redis_client = jwt_service._redis_client
+                    
+                    if redis_client:
+                        user_id = user_info.get('id')
+                        key = f"rate_limit:{user_id}"
+                        
+                        try:
+                            # 获取当前计数
+                            current_count = redis_client.get(key)
+                            
+                            if current_count is None:
+                                # 首次请求，设置计数
+                                redis_client.setex(key, window_seconds, 1)
+                            else:
+                                current_count = int(current_count)
+                                
+                                if current_count >= max_requests:
+                                    # 超过限制
+                                    return jsonify({
+                                        'error': '请求过于频繁，请稍后再试',
+                                        'limit': max_requests,
+                                        'window': window_seconds
+                                    }), 429
+                                
+                                # 增加计数
+                                redis_client.incr(key)
+                        except Exception:
+                            # Redis错误时不限制请求
+                            pass
+                
+                return f(*args, **kwargs)
+            
+            return decorated_function
+        
+        return decorator
+
+
+class RoleBasedAuth:
+    """基于角色的访问控制"""
+    
+    @staticmethod
+    def require_role(required_role: str):
+        """
+        装饰器：要求特定角色
+        
+        Args:
+            required_role: 必需的角色
+            
+        Returns:
+            装饰器函数
+        """
+        def decorator(f):
+            @wraps(f)
+            def decorated_function(*args, **kwargs):
+                # 检查用户认证
+                user_info = getattr(g, 'current_user', None)
+                
+                if not user_info:
+                    return jsonify({'error': '需要认证'}), 401
+                
+                # 检查角色（这里简化处理，可以根据实际情况扩展）
+                user_role = user_info.get('role', 'user')
+                
+                if user_role != required_role and user_role != 'admin':
+                    return jsonify({'error': '权限不足'}), 403
+                
+                return f(*args, **kwargs)
+            
+            return decorated_function
+        
+        return decorator
+    
+    @staticmethod
+    def require_admin(f):
+        """
+        装饰器：要求管理员权限
+        
+        Args:
+            f: 被装饰的函数
+            
+        Returns:
+            装饰后的函数
+        """
+        return RoleBasedAuth.require_role('admin')(f)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/__init__.py b/webapi/fastapi_of_letcoing/models/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/webapi/fastapi_of_letcoing/models/auth_models.py b/webapi/fastapi_of_letcoing/models/auth_models.py
new file mode 100644
index 0000000..c106521
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/auth_models.py
@@ -0,0 +1,182 @@
+"""
+认证相关的数据模型
+"""
+
+from dataclasses import dataclass, field
+import time
+from typing import Optional, Dict, List, Any
+from datetime import datetime
+
+class JWTToken:
+    """JWT 令牌数据模型"""
+    
+    def __init__(self, access_token: str, refresh_token: str, 
+                 expires_in: int, token_type: str = "Bearer"):
+        self.access_token = access_token
+        self.refresh_token = refresh_token
+        self.expires_in = expires_in
+        self.token_type = token_type
+        self.created_at = time.time()
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'access_token': self.access_token,
+            'refresh_token': self.refresh_token,
+            'expires_in': self.expires_in,
+            'token_type': self.token_type
+        }
+
+@dataclass
+class UserInfo:
+    """用户信息模型"""
+    id: str
+    username: str
+    email: str
+    name: str = ""
+    avatar_url: str = ""
+    provider: str = ""
+    created_at: datetime = field(default_factory=datetime.now)
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'id': self.id,
+            'username': self.username,
+            'email': self.email,
+            'name': self.name,
+            'avatar_url': self.avatar_url,
+            'provider': self.provider,
+            'created_at': self.created_at.isoformat()
+        }
+
+
+@dataclass
+class LoginRequest:
+    """登录请求模型"""
+    provider: str
+    redirect_uri: Optional[str] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'provider': self.provider,
+            'redirect_uri': self.redirect_uri
+        }
+
+
+@dataclass
+class LoginResponse:
+    """登录响应模型"""
+    success: bool
+    authorization_url: Optional[str] = None
+    error: Optional[str] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        result = {'success': self.success}
+        if self.authorization_url:
+            result['authorization_url'] = self.authorization_url
+        if self.error:
+            result['error'] = self.error
+        return result
+
+
+@dataclass
+class TokenResponse:
+    """令牌响应模型"""
+    access_token: str
+    refresh_token: str
+    expires_in: int
+    token_type: str = "Bearer"
+    user_info: Optional[UserInfo] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        result = {
+            'access_token': self.access_token,
+            'refresh_token': self.refresh_token,
+            'expires_in': self.expires_in,
+            'token_type': self.token_type
+        }
+        if self.user_info:
+            result['user_info'] = self.user_info.to_dict()
+        return result
+
+
+@dataclass
+class RefreshTokenRequest:
+    """刷新令牌请求模型"""
+    refresh_token: str
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'refresh_token': self.refresh_token
+        }
+
+
+@dataclass
+class AuthCallbackRequest:
+    """认证回调请求模型"""
+    provider: str
+    code: Optional[str] = None
+    state: Optional[str] = None
+    error: Optional[str] = None
+    error_description: Optional[str] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        result = {'provider': self.provider}
+        if self.code:
+            result['code'] = self.code
+        if self.state:
+            result['state'] = self.state
+        if self.error:
+            result['error'] = self.error
+        if self.error_description:
+            result['error_description'] = self.error_description
+        return result
+
+
+@dataclass
+class AuthResult:
+    """认证结果模型"""
+    success: bool
+    user_info: Optional[UserInfo] = None
+    tokens: Optional[TokenResponse] = None
+    error: Optional[str] = None
+    
+    def to_dict(self) -> Dict[str, Any]:
+        result = {'success': self.success}
+        if self.user_info:
+            result['user_info'] = self.user_info.to_dict()
+        if self.tokens:
+            result['tokens'] = self.tokens.to_dict()
+        if self.error:
+            result['error'] = self.error
+        return result
+
+
+@dataclass
+class OIDCProviderConfig:
+    """OIDC 提供商配置模型"""
+    name: str
+    client_id: str
+    client_secret: str
+    server_metadata_url: Optional[str] = None
+    access_token_url: Optional[str] = None
+    authorize_url: Optional[str] = None
+    api_base_url: Optional[str] = None
+    client_kwargs: Dict[str, Any] = field(default_factory=dict)
+    
+    def to_dict(self) -> Dict[str, Any]:
+        result = {
+            'name': self.name,
+            'client_id': self.client_id,
+            'client_secret': self.client_secret
+        }
+        if self.server_metadata_url:
+            result['server_metadata_url'] = self.server_metadata_url
+        if self.access_token_url:
+            result['access_token_url'] = self.access_token_url
+        if self.authorize_url:
+            result['authorize_url'] = self.authorize_url
+        if self.api_base_url:
+            result['api_base_url'] = self.api_base_url
+        if self.client_kwargs:
+            result['client_kwargs'] = self.client_kwargs
+        return result
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/course_models.py b/webapi/fastapi_of_letcoing/models/course_models.py
new file mode 100644
index 0000000..434bb34
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/course_models.py
@@ -0,0 +1,49 @@
+"""
+课程及学习进度模型
+"""
+from datetime import datetime
+from peewee import AutoField, CharField, TextField, IntegerField, ForeignKeyField, DateTimeField, BooleanField
+
+from core.db_container import BaseModel
+from models.user_models import User
+
+
+class Course(BaseModel):
+    """课程模型"""
+    id = AutoField(primary_key=True, verbose_name="课程ID")
+    title = CharField(max_length=100, verbose_name="课程标题")
+    description = TextField(verbose_name="课程描述")
+    cover_url = CharField(max_length=255, null=True, verbose_name="课程封面")
+    is_active = BooleanField(default=True, verbose_name="是否上架")
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+
+    class Meta:
+        table_name = "courses"
+
+    def to_dict(self) -> dict:
+        data = super().to_dict()
+        return data
+
+
+class LearningProgress(BaseModel):
+    """学习进度模型（关联用户与课程）"""
+    id = AutoField(primary_key=True, verbose_name="进度ID")
+    user = ForeignKeyField(User, on_delete='CASCADE', verbose_name="关联用户")
+    course = ForeignKeyField(Course, on_delete='CASCADE', verbose_name="关联课程")
+    progress = IntegerField(default=0, verbose_name="学习进度（百分比）")
+    completed = BooleanField(default=False, verbose_name="是否完成")
+    last_learned_at = DateTimeField(default=datetime.now, verbose_name="最后学习时间")
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+
+    class Meta:
+        table_name = "learning_progress"
+        unique_together = (('user', 'course'),)  # 一个用户对一个课程只能有一条进度记录
+
+    def to_dict(self) -> dict:
+        data = super().to_dict()
+        # 转换外键为ID
+        data['user_id'] = data.pop('user')
+        data['course_id'] = data.pop('course')
+        return data
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/db_models.py b/webapi/fastapi_of_letcoing/models/db_models.py
new file mode 100644
index 0000000..335f78a
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/db_models.py
@@ -0,0 +1,145 @@
+"""
+数据库模型文件
+使用 Peewee ORM 定义的数据库模型
+"""
+from datetime import datetime
+from typing import Optional
+
+from peewee import (
+    Model, CharField, TextField, DateTimeField, BooleanField,
+    IntegerField, ForeignKeyField, AutoField, Database
+)
+from playhouse.postgres_ext import PostgresqlExtDatabase
+
+from core.db_config import DatabaseConfig
+
+
+# 数据库连接实例
+database: Optional[PostgresqlExtDatabase] = None
+
+
+def get_database() -> PostgresqlExtDatabase:
+    """获取数据库连接实例"""
+    global database
+    if database is None:
+        try:
+            # 尝试使用 ConfigService
+            from core.di_container import get_container
+            from interfaces.service_interfaces import IConfigService
+            
+            config_service = get_container().resolve(IConfigService)
+            db_config = config_service.get_database_config()
+            
+            database = PostgresqlExtDatabase(
+                db_config["database"],
+                user=db_config["username"],
+                password=db_config["password"],
+                host=db_config["host"],
+                port=db_config["port"],
+                max_connections=db_config["max_connections"],
+                stale_timeout=db_config["stale_timeout"]
+            )
+        except Exception:
+            # 回退到 DatabaseConfig
+            config = DatabaseConfig()
+            database = PostgresqlExtDatabase(
+                config.database,
+                user=config.username,
+                password=config.password,
+                host=config.host,
+                port=config.port,
+                max_connections=config.max_connections,
+                stale_timeout=config.stale_timeout
+            )
+    return database
+
+
+class BaseModel(Model):
+    """基础模型类"""
+    
+    created_at = DateTimeField(default=datetime.now, verbose_name="创建时间")
+    updated_at = DateTimeField(default=datetime.now, verbose_name="更新时间")
+    
+    class Meta:
+        database = get_database()
+    
+    def save(self, force_insert=False, only=None):
+        """保存时更新 updated_at 字段"""
+        self.updated_at = datetime.now()
+        return super().save(force_insert, only)
+    
+    def to_dict(self) -> dict:
+        """转换为字典"""
+        data = {}
+        for field_name in self._meta.fields.keys():
+            value = getattr(self, field_name)
+            if isinstance(value, datetime):
+                value = value.isoformat()
+            data[field_name] = value
+        return data
+
+
+class User(BaseModel):
+    """用户模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="用户ID")
+    username = CharField(max_length=50, unique=True, null=False, verbose_name="用户名")
+    email = CharField(max_length=100, unique=True, null=True, verbose_name="邮箱")
+    password_hash = CharField(max_length=255, null=False, verbose_name="密码哈希")
+    is_active = BooleanField(default=True, verbose_name="是否激活")
+    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    
+    class Meta:
+        table_name = "users"
+    
+    def to_dict(self) -> dict:
+        """转换为字典，排除敏感信息"""
+        data = super().to_dict()
+        data.pop("password_hash", None)
+        return data
+
+class Question(BaseModel):
+    """题目模型"""
+    
+    id = AutoField(primary_key=True, verbose_name="题目ID")
+    title = CharField(max_length=200, null=False, verbose_name="题目标题")
+    intro = TextField(null=True, verbose_name="题目介绍")
+    difficulty = IntegerField(null=False, verbose_name="题目难度")
+    testcode = TextField(null=True, verbose_name="验证代码")
+    lang = CharField(max_length=50, null=False, verbose_name="可使用语言")
+
+    class Meta:
+        table_name = "questions"
+    
+    def to_dict(self) -> dict:
+        """转换为字典"""
+        return super().to_dict()
+
+# 模型列表
+MODELS = [User, Question]
+
+
+def create_tables():
+    """创建所有表"""
+    db = get_database()
+    db.create_tables(MODELS, safe=True)
+
+
+def drop_tables():
+    """删除所有表"""
+    db = get_database()
+    db.drop_tables(MODELS, safe=True)
+
+
+def connect_database():
+    """连接数据库"""
+    db = get_database()
+    if not db.is_connection_usable():
+        db.connect()
+
+
+def close_database():
+    """关闭数据库连接"""
+    db = get_database()
+    if not db.is_closed():
+        db.close()
diff --git a/webapi/fastapi_of_letcoing/models/glot_models.py b/webapi/fastapi_of_letcoing/models/glot_models.py
new file mode 100644
index 0000000..d448ade
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/glot_models.py
@@ -0,0 +1,67 @@
+from dataclasses import dataclass, field
+from typing import Optional, Dict, List, Any
+
+
+@dataclass
+class PostFile:
+    """文件数据模型"""
+    name: str = ""
+    content: str = ""
+    
+    def to_dict(self):
+        return {
+            "name": self.name,
+            "content": self.content
+        }
+
+
+@dataclass
+class PostDataModel:
+    """POST 请求数据模型"""
+    files: List[PostFile] = field(default_factory=list)
+    stdin: Optional[str] = None
+    
+    def __post_init__(self):
+        pass
+    
+    def to_dict(self):
+        return {
+            "files": [f.to_dict() for f in self.files],
+            "stdin": self.stdin
+        }
+
+
+@dataclass
+class RunResult:
+    """运行结果模型"""
+    stdout: str = ""
+    stderr: str = ""
+    
+    def to_dict(self):
+        return {
+            "stdout": self.stdout,
+            "stderr": self.stderr
+        }
+
+
+@dataclass
+class CodeExecutionRequest:
+    """代码执行请求模型"""
+    code: str
+    language: str = "javascript"
+    stdin: Optional[str] = None
+
+
+@dataclass
+class CodeExecutionResponse:
+    """代码执行响应模型"""
+    stdout: str
+    stderr: str = ""
+    success: bool = True
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "stdout": self.stdout,
+            "stderr": self.stderr,
+            "success": self.success
+        }
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/question_models.py b/webapi/fastapi_of_letcoing/models/question_models.py
new file mode 100644
index 0000000..42e8522
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/question_models.py
@@ -0,0 +1,33 @@
+from pydantic import BaseModel, Field
+from typing import Optional
+from datetime import datetime
+
+class QuestionCreate(BaseModel):
+    """创建题目模型"""
+    title: str
+    intro: Optional[str] = None 
+    difficulty: int = Field(..., ge=1, le=5, description="难度等级 (1-5)")
+    testcode: Optional[str] = None
+    lang: str = "cpp"
+
+class QuestionUpdate(BaseModel):
+    """更新题目模型"""
+    title: Optional[str] = None
+    intro: Optional[str] = None
+    difficulty: Optional[int] = Field(None, ge=1, le=5, description="难度等级 (1-5)")
+    testcode: Optional[str] = None
+    lang: Optional[str] = None
+
+class QuestionResponse(BaseModel):
+    """题目响应模型"""
+    id: int
+    title: str
+    intro: Optional[str] = None
+    difficulty: int
+    testcode: Optional[str] = None
+    lang: str
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        orm_mode = True
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/models/user_models.py b/webapi/fastapi_of_letcoing/models/user_models.py
new file mode 100644
index 0000000..4a32b98
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/user_models.py
@@ -0,0 +1,6 @@
+"""Compatibility alias for the Peewee User model."""
+
+from .db_models import User
+
+__all__ = ["User"]
+
diff --git a/webapi/fastapi_of_letcoing/models/user_modles.py b/webapi/fastapi_of_letcoing/models/user_modles.py
new file mode 100644
index 0000000..1c88b9b
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/models/user_modles.py
@@ -0,0 +1,28 @@
+"""
+用户模型
+"""
+from datetime import datetime
+from peewee import AutoField, CharField, BooleanField, DateTimeField
+
+from core.db_container import BaseModel
+
+
+class User(BaseModel):
+    """用户模型"""
+
+    id = AutoField(primary_key=True, verbose_name="用户ID")
+    username = CharField(max_length=50, unique=True, index=True, verbose_name="用户名")
+    email = CharField(max_length=100, unique=True, index=True, verbose_name="邮箱")
+    password_hash = CharField(max_length=255, verbose_name="密码哈希")
+    is_active = BooleanField(default=True, verbose_name="是否激活")
+    last_login = DateTimeField(null=True, verbose_name="最后登录时间")
+    avatar_url = CharField(max_length=255, null=True, default=None, verbose_name="头像地址")
+
+    class Meta:
+        table_name = "users"
+
+    def to_dict(self) -> dict:
+        """转换为字典，排除敏感信息"""
+        data = super().to_dict()
+        data.pop("password_hash", None)
+        return data
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/requirements.txt b/webapi/fastapi_of_letcoing/requirements.txt
new file mode 100644
index 0000000..f8faadb
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/requirements.txt
@@ -0,0 +1,37 @@
+aiohappyeyeballs==2.6.1
+aiohttp==3.13.2
+aiosignal==1.4.0
+aniso8601==10.0.1
+attrs==25.4.0
+Authlib==1.3.1
+blinker==1.9.0
+certifi==2025.11.12
+cffi==2.0.0
+charset-normalizer==3.4.4
+click==8.3.1
+cryptography==46.0.3
+dotenv==0.9.9
+Flask==3.1.2
+flask-restx==1.3.2
+frozenlist==1.8.0
+idna==3.11
+importlib_resources==6.5.2
+itsdangerous==2.2.0
+Jinja2==3.1.6
+jsonschema==4.25.1
+jsonschema-specifications==2025.9.1
+MarkupSafe==3.0.3
+multidict==6.7.0
+peewee==3.18.3
+propcache==0.4.1
+psycopg2-binary==2.9.10
+pycparser==2.23
+PyJWT==2.9.0
+python-dotenv==1.2.1
+redis==5.2.1
+referencing==0.37.0
+requests==2.32.5
+rpds-py==0.30.0
+urllib3==2.6.2
+Werkzeug==3.1.4
+yarl==1.22.0
diff --git a/webapi/fastapi_of_letcoing/services/config_service.py b/webapi/fastapi_of_letcoing/services/config_service.py
new file mode 100644
index 0000000..7b63336
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/config_service.py
@@ -0,0 +1,50 @@
+"""
+配置服务实现
+
+提供配置管理功能，支持环境变量和应用配置。
+"""
+
+from typing import Any, Optional
+from interfaces.service_interfaces import IConfigService
+
+
+class ConfigService(IConfigService):
+    """配置服务实现"""
+    
+    def __init__(self, app_config: Optional[dict] = None):
+        """
+        初始化配置服务
+        
+        Args:
+            app_config: Flask应用配置字典
+        """
+        self._app_config = app_config or {}
+    
+    def get_api_token(self) -> str:
+        """获取API Token"""
+        return self._app_config.get('API_TOKEN', '')
+    
+    def get_timeout(self) -> int:
+        """获取请求超时时间"""
+        return int(self._app_config.get('REQUEST_TIMEOUT', '30'))
+    
+    def get_config(self, key: str, default: Any = None) -> Any:
+        """获取配置值"""
+        return self._app_config.get(key, default)
+    
+    def get_database_config(self) -> dict:
+        """获取数据库配置"""
+        return {
+            "host": self.get_config("DB_HOST", "localhost"),
+            "port": self.get_config("DB_PORT", 5432),
+            "database": self.get_config("DB_NAME", "letcoding"),
+            "username": self.get_config("DB_USER", "postgres"),
+            "password": self.get_config("DB_PASSWORD", ""),
+            "max_connections": self.get_config("DB_MAX_CONNECTIONS", 20),
+            "stale_timeout": self.get_config("DB_STALE_TIMEOUT", 300)
+        }
+    
+    def get_database_url(self) -> str:
+        """获取数据库连接 URL"""
+        config = self.get_database_config()
+        return f"postgresql://{config['username']}:{config['password']}@{config['host']}:{config['port']}/{config['database']}"
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/course_service.py b/webapi/fastapi_of_letcoing/services/course_service.py
new file mode 100644
index 0000000..f7cff6d
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/course_service.py
@@ -0,0 +1,119 @@
+"""Course and learning progress service."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from peewee import DoesNotExist
+
+from core.di_container import Injectable
+from models.course_models import Course, LearningProgress
+from models.db_models import User
+from services.database_service import DatabaseService
+
+
+class CourseService(DatabaseService, Injectable):
+    """Course-related database operations."""
+
+    async def create_course(self, course_data: Any) -> Dict[str, Any]:
+        data = course_data.model_dump() if hasattr(course_data, "model_dump") else dict(course_data)
+        return await self.create(
+            Course,
+            title=data["title"],
+            description=data["description"],
+            cover_url=data.get("cover_url"),
+            is_active=True,
+        )
+
+    async def get_course_by_id(self, course_id: int) -> Optional[Dict[str, Any]]:
+        return await self.get_by_id(Course, course_id)
+
+    async def update_course(self, course_id: int, update_data: Any) -> Optional[Dict[str, Any]]:
+        data = update_data.model_dump(exclude_unset=True) if hasattr(update_data, "model_dump") else dict(update_data)
+        if not await self.get_course_by_id(course_id):
+            return None
+        if not data:
+            return await self.get_course_by_id(course_id)
+        await self.update(Course, course_id, **data)
+        return await self.get_course_by_id(course_id)
+
+    async def list_courses(self, limit: int = 50, offset: int = 0, active_only: bool = True) -> List[Dict[str, Any]]:
+        query = Course.select()
+        if active_only:
+            query = query.where(Course.is_active == True)
+        query = query.order_by(Course.created_at.desc()).limit(limit).offset(offset)
+        return [course.to_dict() for course in query]
+
+    async def create_learning_progress(self, user_id: int, progress_data: Any) -> Dict[str, Any]:
+        data = progress_data.model_dump() if hasattr(progress_data, "model_dump") else dict(progress_data)
+        if not self._user_exists(user_id):
+            raise ValueError("用户不存在")
+        if not await self.get_course_by_id(data["course_id"]):
+            raise ValueError("课程不存在")
+        if await self.get_learning_progress(user_id, data["course_id"]):
+            raise ValueError("学习进度已存在")
+
+        completed = data["progress"] >= 100
+        return await self.create(
+            LearningProgress,
+            user=user_id,
+            course=data["course_id"],
+            progress=data["progress"],
+            completed=completed,
+            last_learned_at=datetime.now(),
+        )
+
+    async def update_learning_progress(self, user_id: int, course_id: int, update_data: Any) -> Optional[Dict[str, Any]]:
+        data = update_data.model_dump(exclude_unset=True) if hasattr(update_data, "model_dump") else dict(update_data)
+        progress = await self.get_learning_progress(user_id, course_id)
+        if not progress:
+            return None
+
+        if "progress" in data and data["progress"] is not None:
+            data["completed"] = data["progress"] >= 100
+        if "completed" not in data and "progress" not in data:
+            return progress
+
+        data["last_learned_at"] = datetime.now()
+        await self.update(LearningProgress, progress["id"], **data)
+        return await self.get_learning_progress(user_id, course_id)
+
+    async def get_learning_progress(self, user_id: int, course_id: int) -> Optional[Dict[str, Any]]:
+        try:
+            progress = LearningProgress.get(
+                LearningProgress.user == user_id,
+                LearningProgress.course == course_id,
+            )
+            return progress.to_dict()
+        except DoesNotExist:
+            return None
+
+    async def get_user_courses(self, user_id: int) -> List[Dict[str, Any]]:
+        if not self._user_exists(user_id):
+            return []
+
+        query = (
+            LearningProgress.select(LearningProgress, Course)
+            .join(Course)
+            .where(LearningProgress.user == user_id)
+            .order_by(LearningProgress.last_learned_at.desc())
+        )
+
+        result: List[Dict[str, Any]] = []
+        for progress in query:
+            result.append(
+                {
+                    "course": progress.course.to_dict(),
+                    "progress": progress.to_dict(),
+                }
+            )
+        return result
+
+    def _user_exists(self, user_id: int) -> bool:
+        try:
+            User.get_by_id(user_id)
+            return True
+        except DoesNotExist:
+            return False
+
diff --git a/webapi/fastapi_of_letcoing/services/database_service.py b/webapi/fastapi_of_letcoing/services/database_service.py
new file mode 100644
index 0000000..ccfffdd
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/database_service.py
@@ -0,0 +1,134 @@
+"""
+数据库服务基类
+提供数据库连接和基础操作
+"""
+from datetime import datetime
+from typing import List, Optional, Dict, Any
+
+from peewee import DoesNotExist, IntegrityError, fn, Model, Database
+from playhouse.postgres_ext import PostgresqlExtDatabase
+from core.di_container import Injectable
+from interfaces.service_interfaces import IConfigService
+
+
+class DatabaseService(Injectable):
+    """数据库服务基类"""
+    
+    def __init__(self, config_service: IConfigService):
+        """初始化数据库服务"""
+        self._config_service = config_service
+        self._database = None
+        self._ensure_connection()
+    
+    def _get_database(self) -> PostgresqlExtDatabase:
+        """获取数据库连接实例"""
+        if self._database is None:
+            db_config = self._config_service.get_database_config()
+            self._database = PostgresqlExtDatabase(
+                db_config["database"],
+                user=db_config["username"],
+                password=db_config["password"],
+                host=db_config["host"],
+                port=db_config["port"],
+                max_connections=db_config["max_connections"],
+                stale_timeout=db_config["stale_timeout"]
+            )
+        return self._database
+    
+    def _ensure_connection(self):
+        """确保数据库连接正常"""
+        try:
+            db = self._get_database()
+            if not db.is_connection_usable():
+                db.connect()
+        except Exception as e:
+            print(f"数据库连接失败: {e}")
+            raise
+    
+    # 通用CRUD操作
+    async def create(self, model_class: type, **kwargs) -> Dict[str, Any]:
+        """通用创建操作"""
+        try:
+            with self._get_database().atomic():
+                instance = model_class.create(**kwargs)
+                return instance.to_dict()
+        except IntegrityError as e:
+            raise ValueError(f"创建失败: {str(e)}")
+        except Exception as e:
+            raise RuntimeError(f"创建记录时发生错误: {e}")
+    
+    async def get_by_id(self, model_class: type, record_id: int) -> Optional[Dict[str, Any]]:
+        """通用根据ID获取记录"""
+        try:
+            instance = model_class.get_by_id(record_id)
+            return instance.to_dict()
+        except DoesNotExist:
+            return None
+        except Exception as e:
+            raise RuntimeError(f"获取记录时发生错误: {e}")
+    
+    async def update(self, model_class: type, record_id: int, **kwargs) -> bool:
+        """通用更新操作"""
+        try:
+            with self._get_database().atomic():
+                query = model_class.update(**kwargs).where(model_class.id == record_id)
+                return query.execute() > 0
+        except Exception as e:
+            raise RuntimeError(f"更新记录时发生错误: {e}")
+    
+    async def delete(self, model_class: type, record_id: int) -> bool:
+        """通用删除操作"""
+        try:
+            with self._get_database().atomic():
+                query = model_class.delete().where(model_class.id == record_id)
+                return query.execute() > 0
+        except Exception as e:
+            raise RuntimeError(f"删除记录时发生错误: {e}")
+    
+    async def list_all(self, model_class: type, limit: int = 50, offset: int = 0, order_by=None) -> List[Dict[str, Any]]:
+        """通用列表查询"""
+        try:
+            query = model_class.select()
+            if order_by:
+                query = query.order_by(order_by)
+            query = query.limit(limit).offset(offset)
+            
+            return [instance.to_dict() for instance in query]
+        except Exception as e:
+            raise RuntimeError(f"查询列表时发生错误: {e}")
+    
+    async def count(self, model_class: type) -> int:
+        """通用计数操作"""
+        try:
+            return model_class.select().count()
+        except Exception as e:
+            raise RuntimeError(f"计数时发生错误: {e}")
+    
+    # 数据库管理操作
+    def test_connection(self) -> bool:
+        """测试数据库连接"""
+        try:
+            db = self._get_database()
+            db.execute_sql("SELECT 1")
+            return True
+        except Exception:
+            return False
+    
+    def get_database_info(self) -> Dict[str, Any]:
+        """获取数据库信息"""
+        try:
+            db = self._get_database()
+            return {
+                "database": db.database,
+                "host": db.connect_kwargs.get("host", "localhost"),
+                "port": db.connect_kwargs.get("port", 5432),
+                "is_connected": not db.is_closed() and db.is_connection_usable()
+            }
+        except Exception as e:
+            return {"error": str(e)}
+    
+    def close(self):
+        """关闭数据库连接"""
+        db = self._get_database()
+        if not db.is_closed():
+            db.close()
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/glot_service.py b/webapi/fastapi_of_letcoing/services/glot_service.py
new file mode 100644
index 0000000..e9d9581
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/glot_service.py
@@ -0,0 +1,187 @@
+import aiohttp
+import asyncio
+from typing import Optional, Dict, List
+from dataclasses import dataclass, field
+import json
+from interfaces.service_interfaces import ICodeExecutionService, IConfigService, ILoggerService
+from models.glot_models import PostFile, PostDataModel, RunResult, CodeExecutionRequest, CodeExecutionResponse
+from core.di_container import Injectable
+
+
+
+class GlotService(ICodeExecutionService, Injectable):
+    """Glot.io 代码运行服务（异步版本）"""
+    
+    # 语言映射字典
+    LANGUAGES: Dict[str, str] = {
+        "assembly": "asm", "ats": "dats", "bash": "sh", "c": "c", "clojure": "clj",
+        "cobol": "cob", "coffeescript": "coffee", "cpp": "cpp", "crystal": "cr",
+        "csharp": "cs", "d": "d", "elixir": "ex", "elm": "elm", "erlang": "erl",
+        "fsharp": "fs", "go": "go", "groovy": "groovy", "hare": "hare", "haskell": "hs",
+        "idris": "idr", "java": "java", "javascript": "js", "julia": "jl", "kotlin": "kt",
+        "lua": "lua", "mercury": "m", "nim": "nim", "nix": "nix", "ocaml": "ml",
+        "perl": "pl", "php": "php", "python": "py", "raku": "raku", "ruby": "rb",
+        "rust": "rs", "sac": "sac", "scala": "scala", "swift": "swift", "typescript": "ts",
+        "zig": "zig"
+    }
+    
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
+        """
+        初始化服务
+        
+        Args:
+            config_service: 配置服务
+            logger_service: 日志服务
+        """
+        self._config_service = config_service
+        self._logger_service = logger_service
+        self.timeout = aiohttp.ClientTimeout(total=config_service.get_timeout())
+    
+    async def execute_code(self, request: CodeExecutionRequest) -> CodeExecutionResponse:
+        """
+        执行代码（实现接口方法）
+        
+        Args:
+            request: 代码执行请求
+            
+        Returns:
+            代码执行响应
+        """
+        try:
+            self._logger_service.info(f"开始执行代码，语言: {request.language}")
+            
+            # 获取API Token
+            api_token = self._config_service.get_api_token()
+            if not api_token:
+                return CodeExecutionResponse(
+                    stdout="",
+                    stderr="API Token未配置",
+                    success=False
+                )
+            
+            # 调用原有方法
+            result = await self._run_glot_async(api_token, request.code, request.language, request.stdin)
+            
+            # 检查结果
+            if (result.startswith("请求出错:") or 
+                result.startswith("运行出错:") or 
+                result in ["请输入代码", "不支持的语言", "请求超时"]):
+                return CodeExecutionResponse(
+                    stdout="",
+                    stderr=result,
+                    success=False
+                )
+            
+            return CodeExecutionResponse(
+                stdout=result,
+                stderr="",
+                success=True
+            )
+            
+        except Exception as ex:
+            self._logger_service.error("代码执行过程中发生异常", ex)
+            return CodeExecutionResponse(
+                stdout="",
+                stderr=f"执行异常: {str(ex)}",
+                success=False
+            )
+    
+    async def _run_glot_async(self, api_token: str, code: str, 
+                            language: str = "javascript", 
+                            stdin: Optional[str] = None) -> str:
+        """
+        使用 glot.io 运行在线代码（异步）
+        
+        Args:
+            api_token: API Token
+            code: 要运行的代码
+            language: 语言（如 "javascript"，默认为 "javascript"）
+            stdin: 标准输入（可选）
+            
+        Returns:
+            结果字符串
+        """
+        # 验证代码
+        if not code or code.strip() == "":
+            return "请输入代码"
+        
+        # 设置默认语言
+        if not language or language.strip() == "":
+            language = "javascript"
+        
+        # 查找对应后缀（不区分大小写）
+        language_lower = language.lower()
+        extension = self.LANGUAGES.get(language_lower)
+        
+        if not extension:
+            return "不支持的语言"
+        
+        # 构建 URL
+        url = f"https://glot.io/api/run/{language_lower}/latest"
+        
+        # 构建 POST 数据
+        post_file = PostFile(
+            name=f"main.{extension}",
+            content=code
+        )
+        
+        data = PostDataModel(
+            files=[post_file],
+            stdin=stdin
+        )
+        
+        # 设置请求头
+        headers = {
+            "Authorization": f"Token {api_token}",
+            "Content-Type": "application/json"
+        }
+        
+        try:
+            # 发送异步 POST 请求
+            async with aiohttp.ClientSession(timeout=self.timeout) as session:
+                async with session.post(url, json=data.to_dict(), headers=headers) as response:
+                    resp_text = await response.text()
+                    
+                    # 检查响应状态
+                    if not response.ok:
+                        return f"请求出错: HTTP {response.status}"
+                    
+                    # 解析响应
+                    resp_json = json.loads(resp_text)
+                    
+                    result = RunResult(
+                        stdout=resp_json.get("stdout", ""),
+                        stderr=resp_json.get("stderr", "")
+                    )
+                    
+                    # 兼容接口结构
+                    if result.stderr:
+                        return f"运行出错: {self._escape(result.stderr)}\n{self._escape(result.stderr)}"
+                    else:
+                        return self._escape(result.stdout + result.stderr)
+                    
+        except asyncio.TimeoutError:
+            return "请求超时"
+        except aiohttp.ClientError as ex:
+            return f"请求出错: {str(ex)}"
+        except Exception as ex:
+            return f"请求出错: {str(ex)}"
+    
+    @staticmethod
+    def _escape(text: str) -> str:
+        """
+        转义输出，防注入（简单实现）
+        
+        Args:
+            text: 要转义的文本
+            
+        Returns:
+            转义后的文本
+        """
+        if not text:
+            return ""
+        
+        return (text
+                .replace("&", "&amp;")
+                .replace("<", "&lt;")
+                .replace(">", "&gt;"))
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/jwt_service.py b/webapi/fastapi_of_letcoing/services/jwt_service.py
new file mode 100644
index 0000000..17c444b
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/jwt_service.py
@@ -0,0 +1,251 @@
+"""
+JWT 认证服务
+
+提供 JWT 令牌生成、验证和缓存功能（使用独立的 Redis 服务）
+"""
+
+import jwt
+import json
+import time
+from datetime import datetime, timedelta
+from typing import Optional, Dict, Any, List
+from interfaces.service_interfaces import IConfigService, ILoggerService, IRedisService, IJWTService
+from core.di_container import Injectable
+from models.auth_models import JWTToken
+
+
+class JWTService(Injectable, IJWTService):
+    """JWT 认证服务"""
+    
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService, redis_service: IRedisService):
+        self._config_service = config_service
+        self._logger_service = logger_service
+        self._redis_service = redis_service
+        self._secret_key = self._config_service.get_config('JWT_SECRET_KEY', 'default-secret-key')
+        self._algorithm = self._config_service.get_config('JWT_ALGORITHM', 'HS256')
+        self._access_token_expire = self._config_service.get_config('JWT_ACCESS_TOKEN_EXPIRE', 3600)  # 1小时
+        self._refresh_token_expire = self._config_service.get_config('JWT_REFRESH_TOKEN_EXPIRE', 86400 * 7)  # 7天
+    
+
+    
+    def generate_tokens(self, user_info: Dict[str, Any]) -> JWTToken:
+        """
+        生成 JWT 令牌对
+        
+        Args:
+            user_info: 用户信息字典
+            
+        Returns:
+            JWT 令牌对象
+        """
+        now = datetime.utcnow()
+        access_expire = now + timedelta(seconds=self._access_token_expire)
+        refresh_expire = now + timedelta(seconds=self._refresh_token_expire)
+        
+        # 生成访问令牌
+        access_payload = {
+            'user_id': user_info['id'],
+            'username': user_info.get('username', ''),
+            'email': user_info.get('email', ''),
+            'provider': user_info.get('provider', ''),
+            'exp': access_expire,
+            'iat': now,
+            'type': 'access'
+        }
+        
+        access_token = jwt.encode(access_payload, self._secret_key, algorithm=self._algorithm)
+        
+        # 生成刷新令牌
+        refresh_payload = {
+            'user_id': user_info['id'],
+            'exp': refresh_expire,
+            'iat': now,
+            'type': 'refresh'
+        }
+        
+        refresh_token = jwt.encode(refresh_payload, self._secret_key, algorithm=self._algorithm)
+        
+        # 缓存用户信息
+        self._cache_user_info(user_info['id'], user_info)
+        
+        # 缓存刷新令牌
+        self._cache_refresh_token(user_info['id'], refresh_token)
+        
+        return JWTToken(
+            access_token=access_token,
+            refresh_token=refresh_token,
+            expires_in=self._access_token_expire
+        )
+    
+    def verify_access_token(self, token: str) -> Optional[Dict[str, Any]]:
+        """
+        验证访问令牌
+        
+        Args:
+            token: JWT 访问令牌
+            
+        Returns:
+            用户信息或None
+        """
+        try:
+            payload = jwt.decode(token, self._secret_key, algorithms=[self._algorithm])
+            
+            # 检查令牌类型
+            if payload.get('type') != 'access':
+                self._logger_service.warning("令牌类型不匹配")
+                return None
+            
+            # 检查是否在黑名单中
+            if self._is_token_blacklisted(token):
+                self._logger_service.warning("令牌已被撤销")
+                return None
+            
+            # 从缓存获取用户信息
+            user_info = self._get_cached_user_info(payload['user_id'])
+            if user_info:
+                return user_info
+            
+            # 如果缓存中没有，返回基本信息
+            return {
+                'id': payload['user_id'],
+                'username': payload.get('username', ''),
+                'email': payload.get('email', ''),
+                'provider': payload.get('provider', '')
+            }
+            
+        except jwt.ExpiredSignatureError:
+            self._logger_service.warning("访问令牌已过期")
+            return None
+        except jwt.InvalidTokenError as ex:
+            self._logger_service.warning(f"无效的访问令牌: {ex}")
+            return None
+        except Exception as ex:
+            self._logger_service.error("验证访问令牌时发生异常", ex)
+            return None
+    
+    def refresh_access_token(self, refresh_token: str) -> Optional[JWTToken]:
+        """
+        使用刷新令牌生成新的访问令牌
+        
+        Args:
+            refresh_token: 刷新令牌
+            
+        Returns:
+            新的JWT令牌对象或None
+        """
+        try:
+            payload = jwt.decode(refresh_token, self._secret_key, algorithms=[self._algorithm])
+            
+            # 检查令牌类型
+            if payload.get('type') != 'refresh':
+                self._logger_service.warning("令牌类型不匹配")
+                return None
+            
+            user_id = payload['user_id']
+            
+            # 检查刷新令牌是否有效
+            if not self._is_valid_refresh_token(user_id, refresh_token):
+                self._logger_service.warning("无效的刷新令牌")
+                return None
+            
+            # 获取用户信息
+            user_info = self._get_cached_user_info(user_id)
+            if not user_info:
+                self._logger_service.warning("用户信息不存在")
+                return None
+            
+            # 生成新的令牌对
+            return self.generate_tokens(user_info)
+            
+        except jwt.ExpiredSignatureError:
+            self._logger_service.warning("刷新令牌已过期")
+            return None
+        except jwt.InvalidTokenError as ex:
+            self._logger_service.warning(f"无效的刷新令牌: {ex}")
+            return None
+        except Exception as ex:
+            self._logger_service.error("刷新访问令牌时发生异常", ex)
+            return None
+    
+    def revoke_token(self, token: str) -> bool:
+        """
+        撤销令牌（加入黑名单）
+        
+        Args:
+            token: 要撤销的令牌
+            
+        Returns:
+            是否成功
+        """
+        try:
+            payload = jwt.decode(token, self._secret_key, algorithms=[self._algorithm])
+            exp = payload.get('exp', 0)
+            remaining_time = int(exp - time.time())
+            
+            if remaining_time > 0:
+                # 将令牌加入黑名单
+                self._blacklist_token(token, remaining_time)
+                return True
+            
+            return False
+            
+        except jwt.ExpiredSignatureError:
+            return True  # 已过期的令牌无需撤销
+        except jwt.InvalidTokenError as ex:
+            self._logger_service.warning(f"无效的令牌无法撤销: {ex}")
+            return False
+        except Exception as ex:
+            self._logger_service.error("撤销令牌时发生异常", ex)
+            return False
+    
+    def _cache_user_info(self, user_id: str, user_info: Dict[str, Any]) -> None:
+        """缓存用户信息"""
+        try:
+            key = f"user:{user_id}"
+            self._redis_service.set(key, user_info, self._refresh_token_expire)
+        except Exception as ex:
+            self._logger_service.warning("缓存用户信息失败", ex)
+    
+    def _get_cached_user_info(self, user_id: str) -> Optional[Dict[str, Any]]:
+        """获取缓存的用户信息"""
+        try:
+            key = f"user:{user_id}"
+            return self._redis_service.get(key)
+        except Exception as ex:
+            self._logger_service.warning("获取缓存的用户信息失败", ex)
+            return None
+    
+    def _cache_refresh_token(self, user_id: str, refresh_token: str) -> None:
+        """缓存刷新令牌"""
+        try:
+            key = f"refresh_token:{user_id}"
+            self._redis_service.set(key, refresh_token, self._refresh_token_expire)
+        except Exception as ex:
+            self._logger_service.warning("缓存刷新令牌失败", ex)
+    
+    def _is_valid_refresh_token(self, user_id: str, refresh_token: str) -> bool:
+        """检查刷新令牌是否有效"""
+        try:
+            key = f"refresh_token:{user_id}"
+            cached_token = self._redis_service.get(key)
+            return cached_token == refresh_token
+        except Exception as ex:
+            self._logger_service.warning("检查刷新令牌失败", ex)
+            return False
+    
+    def _blacklist_token(self, token: str, expire_time: int) -> None:
+        """将令牌加入黑名单"""
+        try:
+            key = f"blacklist:{token}"
+            self._redis_service.set(key, "1", expire_time)
+        except Exception as ex:
+            self._logger_service.warning("将令牌加入黑名单失败", ex)
+    
+    def _is_token_blacklisted(self, token: str) -> bool:
+        """检查令牌是否在黑名单中"""
+        try:
+            key = f"blacklist:{token}"
+            return self._redis_service.exists(key)
+        except Exception as ex:
+            self._logger_service.warning("检查令牌黑名单失败", ex)
+            return False
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/logger_service.py b/webapi/fastapi_of_letcoing/services/logger_service.py
new file mode 100644
index 0000000..0d984dc
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/logger_service.py
@@ -0,0 +1,58 @@
+"""
+日志服务实现
+
+提供简单的日志记录功能。
+"""
+
+import logging
+from typing import Optional
+from interfaces.service_interfaces import ILoggerService
+
+
+class LoggerService(ILoggerService):
+    """日志服务实现"""
+    
+    def __init__(self, name: str = "letcoding", level: int = logging.INFO):
+        """
+        初始化日志服务
+        
+        Args:
+            name: 日志记录器名称
+            level: 日志级别
+        """
+        self._logger = logging.getLogger(name)
+        
+        # 避免重复添加处理器
+        if not self._logger.handlers:
+            # 创建控制台处理器
+            handler = logging.StreamHandler()
+            
+            # 创建格式化器
+            formatter = logging.Formatter(
+                '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+            )
+            handler.setFormatter(formatter)
+            
+            # 添加处理器
+            self._logger.addHandler(handler)
+        
+        self._logger.setLevel(level)
+    
+    def info(self, message: str) -> None:
+        """记录信息日志"""
+        self._logger.info(message)
+    
+    def error(self, message: str, exception: Optional[Exception] = None) -> None:
+        """记录错误日志"""
+        if exception:
+            self._logger.error(f"{message}: {str(exception)}", exc_info=True)
+        else:
+            self._logger.error(message)
+    
+    def warning(self, message: str) -> None:
+        """记录警告日志"""
+        self._logger.warning(message)
+    
+    def debug(self, message: str) -> None:
+        """记录调试日志"""
+        self._logger.debug(message)
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/oidc_service.py b/webapi/fastapi_of_letcoing/services/oidc_service.py
new file mode 100644
index 0000000..b9b6297
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/oidc_service.py
@@ -0,0 +1,206 @@
+"""
+OIDC 认证服务
+
+支持 Github OAuth 和自定义 OIDC 提供商的认证服务
+"""
+
+from typing import Optional, Dict, Any, List
+from authlib.integrations.flask_client import OAuth
+from flask import url_for, current_app
+import requests
+from interfaces.service_interfaces import IConfigService, ILoggerService, IOIDCService
+from core.di_container import Injectable
+
+
+class OIDCProvider:
+    """OIDC 提供商配置"""
+    
+    def __init__(self, name: str, client_id: str, client_secret: str, 
+                 server_metadata_url: Optional[str] = None,
+                 access_token_url: Optional[str] = None,
+                 authorize_url: Optional[str] = None,
+                 api_base_url: Optional[str] = None,
+                 client_kwargs: Optional[Dict[str, Any]] = None):
+        self.name = name
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.server_metadata_url = server_metadata_url
+        self.access_token_url = access_token_url
+        self.authorize_url = authorize_url
+        self.api_base_url = api_base_url
+        self.client_kwargs = client_kwargs or {}
+
+
+class OIDCService(Injectable, IOIDCService):
+    """OIDC 认证服务"""
+    
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
+        self._config_service = config_service
+        self._logger_service = logger_service
+        self._oauth = None
+        self._providers = {}
+        
+    def initialize_oauth(self, app):
+        """初始化 OAuth"""
+        self._oauth = OAuth(app)
+        
+        # 注册 GitHub OAuth
+        github_client_id = self._config_service.get_config('GITHUB_CLIENT_ID')
+        github_client_secret = self._config_service.get_config('GITHUB_CLIENT_SECRET')
+        
+        if github_client_id and github_client_secret:
+            self._oauth.register(
+                'github',
+                client_id=github_client_id,
+                client_secret=github_client_secret,
+                server_metadata_url='https://api.github.com/.well-known/oauth-authorization-server',
+                client_kwargs={
+                    'scope': 'user:email'
+                }
+            )
+            self._logger_service.info("GitHub OAuth 注册成功")
+        else:
+            self._logger_service.warning("GitHub OAuth 配置缺失")
+        
+        # 注册自定义 OIDC 提供商
+        self._register_custom_providers()
+    
+    def _register_custom_providers(self):
+        """注册自定义 OIDC 提供商"""
+        # 获取自定义 OIDC 配置
+        oidc_configs = self._config_service.get_config('OIDC_PROVIDERS', {})
+        
+        for provider_name, config in oidc_configs.items():
+            try:
+                self._oauth.register(
+                    provider_name,
+                    client_id=config['client_id'],
+                    client_secret=config['client_secret'],
+                    server_metadata_url=config.get('server_metadata_url'),
+                    access_token_url=config.get('access_token_url'),
+                    authorize_url=config.get('authorize_url'),
+                    client_kwargs=config.get('client_kwargs', {})
+                )
+                self._logger_service.info(f"OIDC 提供商 {provider_name} 注册成功")
+            except Exception as ex:
+                self._logger_service.error(f"注册 OIDC 提供商 {provider_name} 失败", ex)
+    
+    def get_authorization_url(self, provider: str, redirect_uri: Optional[str] = None) -> Optional[str]:
+        """
+        获取授权URL
+        
+        Args:
+            provider: 提供商名称 (如 'github')
+            redirect_uri: 回调地址
+            
+        Returns:
+            授权URL或None
+        """
+        if not self._oauth:
+            return None
+            
+        try:
+            client = self._oauth.create_client(provider)
+            if not client:
+                self._logger_service.error(f"未找到提供商: {provider}")
+                return None
+                
+            # 设置回调地址
+            if redirect_uri:
+                redirect_uri = redirect_uri
+            else:
+                redirect_uri = url_for('auth.authorize_callback', provider=provider, _external=True)
+            
+            return client.authorize_redirect(redirect_uri)
+        except Exception as ex:
+            self._logger_service.error(f"获取授权URL失败: {provider}", ex)
+            return None
+    
+    def authorize_callback(self, provider: str) -> Optional[Dict[str, Any]]:
+        """
+        处理授权回调
+        
+        Args:
+            provider: 提供商名称
+            
+        Returns:
+            用户信息字典或None
+        """
+        if not self._oauth:
+            return None
+            
+        try:
+            client = self._oauth.create_client(provider)
+            if not client:
+                self._logger_service.error(f"未找到提供商: {provider}")
+                return None
+            
+            # 获取访问令牌
+            token = client.authorize_access_token()
+            
+            # 获取用户信息
+            user_info = self._get_user_info(provider, client, token)
+            
+            return {
+                'provider': provider,
+                'token': token,
+                'user_info': user_info
+            }
+        except Exception as ex:
+            self._logger_service.error(f"授权回调处理失败: {provider}", ex)
+            return None
+    
+    def _get_user_info(self, provider: str, client, token: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+        """获取用户信息"""
+        try:
+            if provider == 'github':
+                # GitHub 特殊处理
+                resp = client.get('user', token=token)
+                user_data = resp.json()
+                
+                # 获取用户邮箱（如果需要）
+                if not user_data.get('email'):
+                    email_resp = client.get('user/emails', token=token)
+                    emails = email_resp.json()
+                    primary_email = next((e['email'] for e in emails if e['primary']), None)
+                    if primary_email:
+                        user_data['email'] = primary_email
+                
+                return {
+                    'id': str(user_data['id']),
+                    'username': user_data['login'],
+                    'name': user_data.get('name', ''),
+                    'email': user_data.get('email', ''),
+                    'avatar_url': user_data.get('avatar_url', ''),
+                    'provider': provider
+                }
+            else:
+                # 标准 OIDC 用户信息端点
+                resp = client.get('userinfo', token=token)
+                return resp.json()
+                
+        except Exception as ex:
+            self._logger_service.error(f"获取用户信息失败: {provider}", ex)
+            return None
+    
+    def get_supported_providers(self) -> List[str]:
+        """获取支持的提供商列表"""
+        if not self._oauth:
+            return []
+        
+        providers = []
+        
+        # 检查 GitHub
+        github_client_id = self._config_service.get_config('GITHUB_CLIENT_ID')
+        if github_client_id:
+            providers.append('github')
+        
+        # 检查自定义 OIDC 提供商
+        oidc_configs = self._config_service.get_config('OIDC_PROVIDERS', {})
+        providers.extend(oidc_configs.keys())
+        
+        return providers
+    
+    def validate_provider(self, provider: str) -> bool:
+        """验证提供商是否支持"""
+        return provider in self.get_supported_providers()
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/question_service.py b/webapi/fastapi_of_letcoing/services/question_service.py
new file mode 100644
index 0000000..3d2bb17
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/question_service.py
@@ -0,0 +1,56 @@
+from typing import Dict, Any, Optional, List
+from interfaces.service_interfaces import IQuestionService
+from models.db_models import Question
+from models.question_models import QuestionResponse
+
+class QuestionService(IQuestionService):
+    """题目服务实现"""
+    
+    def create_question(self, data: Dict[str, Any]) -> Any:
+        """创建题目"""
+        question = Question.create(
+            title = data.get('title'),
+            intro = data.get('intro'),
+            difficulty = data.get('difficulty'),
+            testcode = data.get('testcode'),
+            lang = data.get('lang', 'cpp')
+        )
+        return QuestionResponse.from_orm(question)
+
+    def update_question(self, question_id: int, data: Dict[str, Any]) -> Optional[QuestionResponse]:
+        """更新题目"""
+        try:
+            question = Question.get_by_id(question_id)
+
+            if 'title' in data: question.title = data['title']
+            if 'intro' in data: question.intro = data['intro']
+            if 'difficulty' in data: question.difficulty = data['difficulty']
+            if 'testcode' in data: question.testcode = data['testcode']
+            if 'lang' in data: question.lang = data['lang']
+        
+            question.save()
+            return QuestionResponse.from_orm(question)
+        except Question.DoesNotExist:
+            return None
+    
+    def get_question(self, question_id: int) -> Optional[QuestionResponse]:
+        """获取一个题目"""
+        try:
+            question = Question.get_by_id(question_id)
+            return QuestionResponse.from_orm(question)
+        except Question.DoesNotExist:
+            return None
+    
+    def get_questions(self, skip: int = 0, limit: int = 100) -> List[QuestionResponse]:
+        """获取题目列表"""
+        questions = Question.select().offset(skip).limit(limit)
+        return [QuestionResponse.from_orm(q) for q in questions]
+
+    def delete_question(self, question_id: int) -> bool:
+        """删除题目"""
+        try:
+            question = Question.get_by_id(question_id)
+            question.delete_instance()
+            return True
+        except Question.DoesNotExist:
+            return False
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/redis_service.py b/webapi/fastapi_of_letcoing/services/redis_service.py
new file mode 100644
index 0000000..dc49334
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/redis_service.py
@@ -0,0 +1,448 @@
+"""
+Redis 缓存服务
+
+提供统一的 Redis 操作接口，支持缓存、会话管理和速率限制等功能
+"""
+
+import redis
+import json
+import time
+from typing import Optional, Any, Dict, List, Union
+from datetime import timedelta
+from interfaces.service_interfaces import IConfigService, ILoggerService, IRedisService
+from core.di_container import Injectable
+
+
+class RedisService(IRedisService, Injectable):
+    """Redis 服务实现类"""
+    
+    def __init__(self, config_service: IConfigService, logger_service: ILoggerService):
+        self._config_service = config_service
+        self._logger_service = logger_service
+        self._client = None
+        self._connected = False
+        self._connect()
+    
+    def _connect(self) -> bool:
+        """连接到 Redis 服务器"""
+        try:
+            redis_host = self._config_service.get_config('REDIS_HOST', 'localhost')
+            redis_port = self._config_service.get_config('REDIS_PORT', 6379)
+            redis_db = self._config_service.get_config('REDIS_DB', 0)
+            redis_password = self._config_service.get_config('REDIS_PASSWORD')
+            redis_timeout = self._config_service.get_config('REDIS_TIMEOUT', 5)
+            
+            self._client = redis.Redis(
+                host=redis_host,
+                port=redis_port,
+                db=redis_db,
+                password=redis_password,
+                decode_responses=True,
+                socket_timeout=redis_timeout,
+                socket_connect_timeout=redis_timeout
+            )
+            
+            # 测试连接
+            self._client.ping()
+            self._connected = True
+            self._logger_service.info(f"Redis 连接成功: {redis_host}:{redis_port}")
+            return True
+            
+        except Exception as ex:
+            self._connected = False
+            self._logger_service.error("Redis 连接失败", ex)
+            self._client = None
+            return False
+    
+    def is_connected(self) -> bool:
+        """检查是否连接到 Redis"""
+        return self._connected and self._client is not None
+    
+    def reconnect(self) -> bool:
+        """重新连接到 Redis"""
+        return self._connect()
+    
+    def set(self, key: str, value: Any, ttl: Optional[int] = None) -> bool:
+        """
+        设置键值对
+        
+        Args:
+            key: 键名
+            value: 值（会自动序列化为JSON字符串）
+            ttl: 过期时间（秒）
+            
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            serialized_value = json.dumps(value, ensure_ascii=False)
+            
+            if ttl:
+                return self._client.setex(key, ttl, serialized_value)
+            else:
+                return self._client.set(key, serialized_value)
+                
+        except Exception as ex:
+            self._logger_service.error(f"Redis 设置失败: {key}", ex)
+            return False
+    
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        获取键值
+        
+        Args:
+            key: 键名
+            default: 默认值
+            
+        Returns:
+            值（自动反序列化JSON）或默认值
+        """
+        if not self.is_connected():
+            return default
+        
+        try:
+            value = self._client.get(key)
+            if value is None:
+                return default
+            
+            return json.loads(value)
+            
+        except (json.JSONDecodeError, Exception) as ex:
+            self._logger_service.error(f"Redis 获取失败: {key}", ex)
+            return default
+    
+    def delete(self, key: str) -> bool:
+        """
+        删除键
+        
+        Args:
+            key: 键名
+            
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            return self._client.delete(key) > 0
+        except Exception as ex:
+            self._logger_service.error(f"Redis 删除失败: {key}", ex)
+            return False
+    
+    def exists(self, key: str) -> bool:
+        """
+        检查键是否存在
+        
+        Args:
+            key: 键名
+            
+        Returns:
+            是否存在
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            return self._client.exists(key) > 0
+        except Exception as ex:
+            self._logger_service.error(f"Redis 检查存在性失败: {key}", ex)
+            return False
+    
+    def expire(self, key: str, ttl: int) -> bool:
+        """
+        设置键的过期时间
+        
+        Args:
+            key: 键名
+            ttl: 过期时间（秒）
+            
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            return self._client.expire(key, ttl)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 设置过期时间失败: {key}", ex)
+            return False
+    
+    def ttl(self, key: str) -> int:
+        """
+        获取键的剩余过期时间
+        
+        Args:
+            key: 键名
+            
+        Returns:
+            剩余时间（秒），-1表示永不过期，-2表示键不存在
+        """
+        if not self.is_connected():
+            return -2
+        
+        try:
+            return self._client.ttl(key)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 获取TTL失败: {key}", ex)
+            return -2
+    
+    def increment(self, key: str, amount: int = 1) -> Optional[int]:
+        """
+        递增计数器
+        
+        Args:
+            key: 键名
+            amount: 递增量
+            
+        Returns:
+            递增后的值，失败返回None
+        """
+        if not self.is_connected():
+            return None
+        
+        try:
+            return self._client.incrby(key, amount)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 递增失败: {key}", ex)
+            return None
+    
+    def decrement(self, key: str, amount: int = 1) -> Optional[int]:
+        """
+        递减计数器
+        
+        Args:
+            key: 键名
+            amount: 递减量
+            
+        Returns:
+            递减后的值，失败返回None
+        """
+        if not self.is_connected():
+            return None
+        
+        try:
+            return self._client.decrby(key, amount)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 递减失败: {key}", ex)
+            return None
+    
+    def set_add(self, key: str, *members: Any) -> bool:
+        """
+        向集合添加成员
+        
+        Args:
+            key: 集合键名
+            members: 成员列表
+            
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            serialized_members = [json.dumps(member, ensure_ascii=False) for member in members]
+            return self._client.sadd(key, *serialized_members) > 0
+        except Exception as ex:
+            self._logger_service.error(f"Redis 集合添加失败: {key}", ex)
+            return False
+    
+    def set_remove(self, key: str, *members: Any) -> bool:
+        """
+        从集合移除成员
+        
+        Args:
+            key: 集合键名
+            members: 成员列表
+            
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            serialized_members = [json.dumps(member, ensure_ascii=False) for member in members]
+            return self._client.srem(key, *serialized_members) > 0
+        except Exception as ex:
+            self._logger_service.error(f"Redis 集合移除失败: {key}", ex)
+            return False
+    
+    def set_members(self, key: str) -> List[Any]:
+        """
+        获取集合所有成员
+        
+        Args:
+            key: 集合键名
+            
+        Returns:
+            成员列表
+        """
+        if not self.is_connected():
+            return []
+        
+        try:
+            members = self._client.smembers(key)
+            return [json.loads(member) for member in members]
+        except Exception as ex:
+            self._logger_service.error(f"Redis 获取集合成员失败: {key}", ex)
+            return []
+    
+    def set_is_member(self, key: str, member: Any) -> bool:
+        """
+        检查成员是否在集合中
+        
+        Args:
+            key: 集合键名
+            member: 成员
+            
+        Returns:
+            是否在集合中
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            serialized_member = json.dumps(member, ensure_ascii=False)
+            return self._client.sismember(key, serialized_member)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 检查集合成员失败: {key}", ex)
+            return False
+    
+    def list_push(self, key: str, *values: Any) -> Optional[int]:
+        """
+        向列表左侧推送元素
+        
+        Args:
+            key: 列表键名
+            values: 值列表
+            
+        Returns:
+            推送后的列表长度，失败返回None
+        """
+        if not self.is_connected():
+            return None
+        
+        try:
+            serialized_values = [json.dumps(value, ensure_ascii=False) for value in values]
+            return self._client.lpush(key, *serialized_values)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 列表推送失败: {key}", ex)
+            return None
+    
+    def list_pop(self, key: str) -> Any:
+        """
+        从列表右侧弹出元素
+        
+        Args:
+            key: 列表键名
+            
+        Returns:
+            弹出的元素，失败返回None
+        """
+        if not self.is_connected():
+            return None
+        
+        try:
+            value = self._client.rpop(key)
+            return json.loads(value) if value else None
+        except Exception as ex:
+            self._logger_service.error(f"Redis 列表弹出失败: {key}", ex)
+            return None
+    
+    def list_length(self, key: str) -> int:
+        """
+        获取列表长度
+        
+        Args:
+            key: 列表键名
+            
+        Returns:
+            列表长度
+        """
+        if not self.is_connected():
+            return 0
+        
+        try:
+            return self._client.llen(key)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 获取列表长度失败: {key}", ex)
+            return 0
+    
+    def list_range(self, key: str, start: int = 0, end: int = -1) -> List[Any]:
+        """
+        获取列表范围内的元素
+        
+        Args:
+            key: 列表键名
+            start: 起始索引
+            end: 结束索引
+            
+        Returns:
+            元素列表
+        """
+        if not self.is_connected():
+            return []
+        
+        try:
+            values = self._client.lrange(key, start, end)
+            return [json.loads(value) for value in values]
+        except Exception as ex:
+            self._logger_service.error(f"Redis 获取列表范围失败: {key}", ex)
+            return []
+    
+    def keys(self, pattern: str = "*") -> List[str]:
+        """
+        获取匹配模式的所有键
+        
+        Args:
+            pattern: 匹配模式
+            
+        Returns:
+            键列表
+        """
+        if not self.is_connected():
+            return []
+        
+        try:
+            return self._client.keys(pattern)
+        except Exception as ex:
+            self._logger_service.error(f"Redis 获取键列表失败: {pattern}", ex)
+            return []
+    
+    def flushdb(self) -> bool:
+        """
+        清空当前数据库
+        
+        Returns:
+            是否成功
+        """
+        if not self.is_connected():
+            return False
+        
+        try:
+            return self._client.flushdb()
+        except Exception as ex:
+            self._logger_service.error("Redis 清空数据库失败", ex)
+            return False
+    
+    def info(self) -> Optional[Dict[str, Any]]:
+        """
+        获取 Redis 服务器信息
+        
+        Returns:
+            服务器信息字典
+        """
+        if not self.is_connected():
+            return None
+        
+        try:
+            return self._client.info()
+        except Exception as ex:
+            self._logger_service.error("Redis 获取服务器信息失败", ex)
+            return None
\ No newline at end of file
diff --git a/webapi/fastapi_of_letcoing/services/user_service.py b/webapi/fastapi_of_letcoing/services/user_service.py
new file mode 100644
index 0000000..aa0821a
--- /dev/null
+++ b/webapi/fastapi_of_letcoing/services/user_service.py
@@ -0,0 +1,137 @@
+"""User service with basic CRUD and authentication helpers."""
+
+from __future__ import annotations
+
+import hashlib
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from peewee import DoesNotExist
+
+from core.di_container import Injectable
+from models.db_models import User
+from services.database_service import DatabaseService
+
+
+class UserService(DatabaseService, Injectable):
+    """User-related database operations."""
+
+    @staticmethod
+    def _hash_password(password: str) -> str:
+        return hashlib.sha256(password.encode("utf-8")).hexdigest()
+
+    def _serialize_user(self, user: User, include_password: bool = False) -> Dict[str, Any]:
+        data = user.to_dict()
+        if include_password:
+            data["password_hash"] = user.password_hash
+        return data
+
+    async def create_user(self, username: str, password: str, email: Optional[str] = None) -> Dict[str, Any]:
+        if await self.get_user_by_username(username):
+            raise ValueError("用户名已存在")
+        if email and await self.get_user_by_email(email):
+            raise ValueError("邮箱已存在")
+
+        return await self.create(
+            User,
+            username=username,
+            email=email,
+            password_hash=self._hash_password(password),
+            is_active=True,
+            last_login=None,
+        )
+
+    async def register_user(self, user_data: Any) -> Dict[str, Any]:
+        data = user_data.model_dump() if hasattr(user_data, "model_dump") else dict(user_data)
+        return await self.create_user(
+            username=data["username"],
+            password=data["password"],
+            email=data.get("email"),
+        )
+
+    async def get_user_by_id(self, user_id: int) -> Optional[Dict[str, Any]]:
+        return await self.get_by_id(User, user_id)
+
+    async def get_user_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        try:
+            return User.get(User.username == username).to_dict()
+        except DoesNotExist:
+            return None
+
+    async def get_user_by_email(self, email: str) -> Optional[Dict[str, Any]]:
+        try:
+            return User.get(User.email == email).to_dict()
+        except DoesNotExist:
+            return None
+
+    async def update_user_info(self, user_id: int, **kwargs) -> bool:
+        allowed_fields = {"username", "email", "is_active"}
+        update_data = {key: value for key, value in kwargs.items() if key in allowed_fields and value is not None}
+        if not update_data:
+            return False
+        return await self.update(User, user_id, **update_data)
+
+    async def update_user_password(self, user_id: int, password: str) -> bool:
+        return await self.update(User, user_id, password_hash=self._hash_password(password))
+
+    async def deactivate_user(self, user_id: int) -> bool:
+        return await self.update(User, user_id, is_active=False)
+
+    async def activate_user(self, user_id: int) -> bool:
+        return await self.update(User, user_id, is_active=True)
+
+    async def delete_user(self, user_id: int) -> bool:
+        return await self.delete(User, user_id)
+
+    async def update_user_last_login(self, user_id: int) -> bool:
+        return await self.update(User, user_id, last_login=datetime.now())
+
+    async def update_last_login(self, user_id: int) -> bool:
+        return await self.update_user_last_login(user_id)
+
+    async def update_user_status(self, user_id: int, is_active: bool) -> bool:
+        return await self.update(User, user_id, is_active=is_active)
+
+    async def list_users(self, limit: int = 50, offset: int = 0, active_only: bool = False) -> List[Dict[str, Any]]:
+        query = User.select()
+        if active_only:
+            query = query.where(User.is_active == True)
+        query = query.order_by(User.created_at.desc()).limit(limit).offset(offset)
+        return [user.to_dict() for user in query]
+
+    async def count_users(self, active_only: bool = False) -> int:
+        query = User.select()
+        if active_only:
+            query = query.where(User.is_active == True)
+        return query.count()
+
+    async def get_user_with_password_hash(self, user_id: int) -> Optional[Dict[str, Any]]:
+        try:
+            user = User.get_by_id(user_id)
+        except DoesNotExist:
+            return None
+        return self._serialize_user(user, include_password=True)
+
+    async def get_user_with_password_hash_by_username(self, username: str) -> Optional[Dict[str, Any]]:
+        try:
+            user = User.get(User.username == username)
+        except DoesNotExist:
+            return None
+        return self._serialize_user(user, include_password=True)
+
+    async def authenticate_user(self, identifier: str, password: str) -> Optional[Dict[str, Any]]:
+        user = await self.get_user_with_password_hash_by_username(identifier)
+        if not user:
+            user = await self.get_user_by_email(identifier)
+            if user and user.get("username"):
+                user = await self.get_user_with_password_hash_by_username(user["username"])
+
+        if not user or not user.get("is_active", False):
+            return None
+
+        if self._hash_password(password) != user.get("password_hash"):
+            return None
+
+        user.pop("password_hash", None)
+        return user
+
diff --git a/webapp/letapp/package.json b/webapp/letapp/package.json
index 809a567..f01a7ed 100644
--- a/webapp/letapp/package.json
+++ b/webapp/letapp/package.json
@@ -6,6 +6,7 @@
   "scripts": {
     "dev": "vite",
     "build": "vue-tsc -b && vite build",
+    "typecheck": "vue-tsc -b --pretty false",
     "preview": "vite preview"
   },
   "dependencies": {
diff --git a/webapp/letapp/src/pages/About.vue b/webapp/letapp/src/pages/About.vue
index 0ba5599..dff3adc 100644
--- a/webapp/letapp/src/pages/About.vue
+++ b/webapp/letapp/src/pages/About.vue
@@ -231,7 +231,7 @@ const media = readonly([
   { name: '微信公众号', url: '#', icon: 'simple-icons:wechat', action: 'search' }
 ]);
 
-const handleMediaClick = (platform) => {
+const handleMediaClick = (platform: { name: string; url: string; icon: string; action?: string }) => {
   if (platform.action === 'search' && platform.name === '微信公众号') {
     alert('请在微信中搜索公众号：西建大iOS众创空间俱乐部');
     return false; // 阻止默认导航行为
@@ -260,4 +260,4 @@ const handleMediaClick = (platform) => {
 ::-webkit-scrollbar-thumb:hover {
   background: #555;
 }
-</style>
\ No newline at end of file
+</style>
diff --git a/webapp/letapp/src/pages/Learn.vue b/webapp/letapp/src/pages/Learn.vue
index 77ce53b..e78606b 100644
--- a/webapp/letapp/src/pages/Learn.vue
+++ b/webapp/letapp/src/pages/Learn.vue
@@ -1,164 +1,304 @@
-<template>
-  <div class="min-h-screen bg-slate-50 text-slate-900 transition-colors dark:bg-slate-950 dark:text-slate-100">
-    <div class="mx-auto w-full max-w-7xl px-4 py-8 sm:px-6 lg:px-8 lg:py-12">
-      <header class="mb-8 flex flex-col gap-6 lg:mb-12 lg:flex-row lg:items-start lg:justify-between">
-        <div class="flex-1">
-          <h1 class="mb-3 text-2xl font-semibold tracking-tight sm:text-3xl">课程列表</h1>
-          <p class="max-w-xl text-sm text-slate-600 sm:text-base dark:text-slate-400">
-            浏览我们精心策划的课程，开始您的学习之旅
-          </p>
-        </div>
-
-        <div class="w-full lg:w-auto">
-          <n-input
-            v-model:value="keyword"
-            class="course-search w-full sm:min-w-[300px] lg:min-w-[360px]"
-            round
-            clearable
-            placeholder="搜索课程..."
-          >
-            <template #prefix>
-              <Icon icon="mdi:magnify" class="text-[18px] text-slate-500 dark:text-slate-400" />
-            </template>
-          </n-input>
-        </div>
-<<<<<<< HEAD
-      </header>
-
-      <section class="grid grid-cols-1 gap-5 sm:grid-cols-2 lg:grid-cols-3">
-        <article
-          v-for="course in filteredCourses"
-          :key="course.id"
-          class="group overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all duration-300 hover:-translate-y-1.5 hover:shadow-[0_20px_45px_-15px_rgba(16,24,40,0.22)] dark:border-slate-800 dark:bg-slate-900 dark:hover:shadow-[0_20px_45px_-18px_rgba(96,165,250,0.38)]"
-        >
-          <div class="relative h-44 overflow-hidden">
-            <img
-              :src="course.imageUrl"
-              :alt="course.name"
-              class="h-full w-full object-cover transition-transform duration-500 group-hover:scale-105"
-              loading="lazy"
-              @error="onImageError"
-            />
-          </div>
-
-          <div class="space-y-2 p-4">
-            <h2 class="course-title-clamp text-base font-medium leading-6">{{ course.name }}</h2>
-            <div class="flex items-center gap-2 text-sm text-slate-600 dark:text-slate-400">
-              <Icon icon="mdi:book-open-page-variant-outline" class="text-[18px]" />
-              <span>题目数：{{ course.questionCount }}</span>
-            </div>
-          </div>
-        </article>
-      </section>
-
-      <div
-        v-if="filteredCourses.length === 0"
-        class="rounded-2xl border border-dashed border-slate-300 py-14 text-center dark:border-slate-700"
-      >
-        <p class="text-slate-600 dark:text-slate-400">未找到相关课程，请尝试其他关键词。</p>
-      </div>
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { computed, ref } from "vue";
-import { NInput } from "naive-ui";
-import { Icon } from "@iconify/vue";
-
-type Course = {
-  id: number;
-  name: string;
-  questionCount: number;
-  imageUrl: string;
-};
-
-const courses = ref<Course[]>([
-  {
-    id: 1,
-    name: "前端开发基础",
-    questionCount: 120,
-    imageUrl:
-      "https://images.unsplash.com/photo-1565229284535-2cbbe3049123?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  },
-  {
-    id: 2,
-    name: "高等数学进阶",
-    questionCount: 85,
-    imageUrl:
-      "https://images.unsplash.com/photo-1758685848342-b5c350727ff5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  },
-  {
-    id: 3,
-    name: "UI/UX 设计原理",
-    questionCount: 95,
-    imageUrl:
-      "https://images.unsplash.com/photo-1664520132859-727fc515fc8d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  },
-  {
-    id: 4,
-    name: "商务英语实战",
-    questionCount: 150,
-    imageUrl:
-      "https://images.unsplash.com/photo-1631888717179-7e213fc93e1d?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  },
-  {
-    id: 5,
-    name: "在线学习方法论",
-    questionCount: 68,
-    imageUrl:
-      "https://images.unsplash.com/photo-1762330910399-95caa55acf04?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  },
-  {
-    id: 6,
-    name: "商业分析与决策",
-    questionCount: 110,
-    imageUrl:
-      "https://images.unsplash.com/photo-1709715357520-5e1047a2b691?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&q=80&w=1080"
-  }
-]);
-
-const keyword = ref("");
-
-const filteredCourses = computed(() => {
-  const value = keyword.value.trim().toLowerCase();
-  if (!value) return courses.value;
-  return courses.value.filter((course) => course.name.toLowerCase().includes(value));
-});
-
-const onImageError = (event: Event) => {
-  const target = event.target as HTMLImageElement;
-  target.src =
-    "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 320 180'><rect width='320' height='180' fill='%23f1f5f9'/><text x='50%25' y='50%25' dominant-baseline='middle' text-anchor='middle' fill='%2364748b' font-size='14'>image unavailable</text></svg>";
-};
-</script>
-
-<style scoped>
-.course-title-clamp {
-  display: -webkit-box;
-  overflow: hidden;
-  -webkit-box-orient: vertical;
-  -webkit-line-clamp: 2;
-}
-
-:deep(.course-search.n-input) {
-  --n-color: rgb(255 255 255);
-  --n-color-focus: rgb(255 255 255);
-  --n-color-disabled: rgb(255 255 255);
-  --n-border: 1px solid rgb(226 232 240);
-  --n-border-hover: 1px solid rgb(148 163 184);
-  --n-border-focus: 1px solid rgb(59 130 246);
-  --n-border-radius: 9999px;
-  --n-placeholder-color: rgb(100 116 139);
-}
-
-:global(.dark) :deep(.course-search.n-input) {
-  --n-color: rgb(15 23 42);
-  --n-color-focus: rgb(15 23 42);
-  --n-color-disabled: rgb(15 23 42);
-  --n-border: 1px solid rgb(51 65 85);
-  --n-border-hover: 1px solid rgb(100 116 139);
-  --n-border-focus: 1px solid rgb(96 165 250);
-  --n-placeholder-color: rgb(148 163 184);
-}
-</style>
\ No newline at end of file
+<script setup lang="ts">
+import { computed, onMounted, ref } from 'vue';
+import { Icon } from '@iconify/vue';
+import { useMessage } from 'naive-ui';
+import { listCourses, listQuestions, type Course, type Question } from '../services/api';
+
+const message = useMessage();
+
+const keyword = ref('');
+const loading = ref(false);
+const errorMessage = ref('');
+
+const courses = ref<Course[]>([]);
+const questions = ref<Question[]>([]);
+
+const fallbackCourses: Course[] = [
+  {
+    id: 1,
+    title: 'Frontend Basics',
+    description: 'Learn layout, interaction, and component thinking from the ground up.',
+    cover_url: '',
+    is_active: true,
+  },
+  {
+    id: 2,
+    title: 'Algorithms and Data Structures',
+    description: 'Practice arrays, linked lists, stacks, queues, trees, and more.',
+    cover_url: '',
+    is_active: true,
+  },
+  {
+    id: 3,
+    title: 'Engineering and Deployment',
+    description: 'Cover build pipelines, environment setup, CI/CD, and release flows.',
+    cover_url: '',
+    is_active: true,
+  },
+];
+
+const fallbackQuestions: Question[] = [
+  { id: 1, title: 'Two Sum', intro: 'A classic array and hash map warmup.', difficulty: 1, testcode: '', lang: 'javascript' },
+  { id: 2, title: 'Valid Parentheses', intro: 'Use a stack to match bracket pairs.', difficulty: 2, testcode: '', lang: 'cpp' },
+  { id: 3, title: 'Binary Tree Traversal', intro: 'Recursive and iterative tree practice.', difficulty: 3, testcode: '', lang: 'python' },
+];
+
+const defaultCover =
+  `data:image/svg+xml;charset=utf-8,${encodeURIComponent(`
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 420">
+      <defs>
+        <linearGradient id="g" x1="0" x2="1" y1="0" y2="1">
+          <stop offset="0%" stop-color="#0f172a" />
+          <stop offset="100%" stop-color="#1d4ed8" />
+        </linearGradient>
+      </defs>
+      <rect width="800" height="420" rx="36" fill="url(#g)" />
+      <circle cx="640" cy="110" r="100" fill="rgba(255,255,255,0.08)" />
+      <circle cx="120" cy="320" r="130" fill="rgba(255,255,255,0.08)" />
+      <text x="60" y="250" fill="#ffffff" font-size="44" font-family="Arial, sans-serif" font-weight="700">Let Coding</text>
+      <text x="60" y="300" fill="#bfdbfe" font-size="24" font-family="Arial, sans-serif">Learn from real backend data</text>
+    </svg>
+  `)}`;
+
+function normalizeCourse(course: Course): Course {
+  return {
+    ...course,
+    cover_url: course.cover_url ?? '',
+    description: course.description ?? '',
+    is_active: course.is_active ?? true,
+  };
+}
+
+function normalizeQuestion(question: Question): Question {
+  return {
+    ...question,
+    intro: question.intro ?? '',
+    testcode: question.testcode ?? '',
+    lang: question.lang ?? 'javascript',
+  };
+}
+
+async function loadData() {
+  loading.value = true;
+  errorMessage.value = '';
+
+  try {
+    const [courseResult, questionResult] = await Promise.all([listCourses(), listQuestions()]);
+    courses.value = courseResult.map(normalizeCourse);
+    questions.value = questionResult.map(normalizeQuestion);
+  } catch (error) {
+    errorMessage.value = error instanceof Error ? error.message : 'Failed to load learning content.';
+    message.error(errorMessage.value);
+    courses.value = [];
+    questions.value = [];
+  } finally {
+    loading.value = false;
+  }
+}
+
+onMounted(loadData);
+
+const courseSource = computed(() => (courses.value.length > 0 ? courses.value : fallbackCourses));
+const questionSource = computed(() => (questions.value.length > 0 ? questions.value : fallbackQuestions));
+
+const filteredCourses = computed(() => {
+  const value = keyword.value.trim().toLowerCase();
+  const source = courseSource.value;
+  if (!value) {
+    return source;
+  }
+  return source.filter((course) => {
+    return String(course.title ?? '').toLowerCase().includes(value) || String(course.description ?? '').toLowerCase().includes(value);
+  });
+});
+
+const filteredQuestions = computed(() => {
+  const value = keyword.value.trim().toLowerCase();
+  const source = questionSource.value;
+  if (!value) {
+    return source;
+  }
+  return source.filter((question) => {
+    return (
+      String(question.title ?? '').toLowerCase().includes(value) ||
+      String(question.intro ?? '').toLowerCase().includes(value) ||
+      String(question.lang ?? '').toLowerCase().includes(value)
+    );
+  });
+});
+
+const totalCourses = computed(() => courseSource.value.length);
+const totalQuestions = computed(() => questionSource.value.length);
+const activeCourses = computed(() => courseSource.value.filter((course) => Boolean(course.is_active)).length);
+const averageDifficulty = computed(() => {
+  if (!questionSource.value.length) {
+    return 0;
+  }
+  const sum = questionSource.value.reduce((acc, question) => acc + Number(question.difficulty ?? 0), 0);
+  return Math.round((sum / questionSource.value.length) * 10) / 10;
+});
+
+function difficultyMeta(level: number) {
+  if (level <= 2) {
+    return { label: 'Beginner', className: 'bg-emerald-100 text-emerald-700 dark:bg-emerald-900 dark:text-emerald-200' };
+  }
+  if (level === 3) {
+    return { label: 'Intermediate', className: 'bg-amber-100 text-amber-700 dark:bg-amber-900 dark:text-amber-200' };
+  }
+  return { label: 'Advanced', className: 'bg-rose-100 text-rose-700 dark:bg-rose-900 dark:text-rose-200' };
+}
+
+function onCoverError(event: Event) {
+  const target = event.target as HTMLImageElement;
+  target.src = defaultCover;
+}
+</script>
+
+<template>
+  <div class="min-h-screen bg-slate-50 text-slate-900 dark:bg-slate-950 dark:text-slate-100">
+    <div class="mx-auto max-w-7xl px-4 py-8 sm:px-6 lg:px-8 lg:py-12">
+      <header class="mb-8 flex flex-col gap-6 lg:mb-12 lg:flex-row lg:items-end lg:justify-between">
+        <div class="max-w-2xl">
+          <p class="mb-3 inline-flex items-center gap-2 rounded-full border border-sky-200 bg-sky-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.24em] text-sky-700 dark:border-sky-900 dark:bg-sky-950 dark:text-sky-300">
+            <Icon icon="material-symbols:school" class="h-4 w-4" />
+            Learning hub
+          </p>
+          <h1 class="text-3xl font-semibold tracking-tight sm:text-4xl">Courses and questions are now connected</h1>
+          <p class="mt-3 text-sm leading-7 text-slate-600 sm:text-base dark:text-slate-400">
+            The page first reads `/courses` and `/questions`. If the backend is empty, it falls back to local demo content so the layout still works.
+          </p>
+        </div>
+
+        <div class="w-full lg:w-auto">
+          <div class="relative">
+            <Icon icon="material-symbols:search" class="pointer-events-none absolute left-4 top-1/2 -translate-y-1/2 text-slate-400" />
+            <input
+              v-model="keyword"
+              type="text"
+              placeholder="Search courses or questions"
+              class="h-12 w-full rounded-2xl border border-slate-200 bg-white pl-11 pr-4 outline-none transition focus:border-blue-500 focus:ring-2 focus:ring-blue-500/20 dark:border-slate-800 dark:bg-slate-900 sm:min-w-[320px] lg:min-w-[380px]"
+            />
+          </div>
+        </div>
+      </header>
+
+      <section class="grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
+        <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <p class="text-sm text-slate-500 dark:text-slate-400">Courses</p>
+          <div class="mt-2 text-3xl font-semibold">{{ totalCourses }}</div>
+        </article>
+        <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <p class="text-sm text-slate-500 dark:text-slate-400">Questions</p>
+          <div class="mt-2 text-3xl font-semibold text-sky-600 dark:text-sky-400">{{ totalQuestions }}</div>
+        </article>
+        <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <p class="text-sm text-slate-500 dark:text-slate-400">Active courses</p>
+          <div class="mt-2 text-3xl font-semibold text-emerald-600 dark:text-emerald-400">{{ activeCourses }}</div>
+        </article>
+        <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <p class="text-sm text-slate-500 dark:text-slate-400">Average difficulty</p>
+          <div class="mt-2 text-3xl font-semibold text-amber-600 dark:text-amber-400">{{ averageDifficulty }}</div>
+        </article>
+      </section>
+
+      <div v-if="errorMessage" class="mt-6 rounded-2xl border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-800 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-200">
+        {{ errorMessage }}
+      </div>
+
+      <section class="mt-8">
+        <div class="mb-4 flex items-center justify-between gap-3">
+          <div>
+            <h2 class="text-xl font-semibold">Courses</h2>
+            <p class="text-sm text-slate-500 dark:text-slate-400">Click a course card to extend this into a detail view later.</p>
+          </div>
+          <div v-if="loading" class="text-sm text-slate-500 dark:text-slate-400">Loading...</div>
+        </div>
+
+        <div class="grid gap-5 md:grid-cols-2 xl:grid-cols-3">
+          <article
+            v-for="course in filteredCourses"
+            :key="course.id"
+            class="group overflow-hidden rounded-3xl border border-slate-200 bg-white shadow-sm transition hover:-translate-y-1 hover:shadow-[0_24px_60px_-24px_rgba(15,23,42,0.35)] dark:border-slate-800 dark:bg-slate-900"
+          >
+            <div class="relative h-44 overflow-hidden">
+              <img
+                :src="course.cover_url || defaultCover"
+                :alt="course.title"
+                class="h-full w-full object-cover transition duration-500 group-hover:scale-105"
+                loading="lazy"
+                @error="onCoverError"
+              />
+              <div class="absolute inset-0 bg-gradient-to-t from-slate-950/70 via-slate-950/20 to-transparent"></div>
+              <div class="absolute bottom-4 left-4 right-4 flex items-end justify-between gap-3">
+                <h3 class="text-lg font-semibold text-white">{{ course.title }}</h3>
+                <span
+                  class="rounded-full px-2.5 py-1 text-xs font-medium"
+                  :class="Boolean(course.is_active) ? 'bg-emerald-500/90 text-white' : 'bg-slate-500/90 text-white'"
+                >
+                  {{ Boolean(course.is_active) ? 'Enabled' : 'Disabled' }}
+                </span>
+              </div>
+            </div>
+
+            <div class="space-y-3 p-5">
+              <p class="line-clamp-3 text-sm leading-6 text-slate-600 dark:text-slate-400">
+                {{ course.description }}
+              </p>
+              <div class="flex items-center justify-between text-sm text-slate-500 dark:text-slate-400">
+                <span class="inline-flex items-center gap-1">
+                  <Icon icon="material-symbols:book-open" class="h-4 w-4" />
+                  Backend course
+                </span>
+                <span>#{{ course.id }}</span>
+              </div>
+            </div>
+          </article>
+        </div>
+
+        <div v-if="filteredCourses.length === 0" class="rounded-3xl border border-dashed border-slate-300 py-14 text-center dark:border-slate-700">
+          <p class="text-slate-600 dark:text-slate-400">No matching courses found.</p>
+        </div>
+      </section>
+
+      <section class="mt-10">
+        <div class="mb-4">
+          <h2 class="text-xl font-semibold">Questions</h2>
+          <p class="text-sm text-slate-500 dark:text-slate-400">Question data comes from the `/questions` endpoint.</p>
+        </div>
+
+        <div class="grid gap-4 lg:grid-cols-2">
+          <article
+            v-for="question in filteredQuestions"
+            :key="question.id"
+            class="rounded-3xl border border-slate-200 bg-white p-5 shadow-sm transition hover:border-slate-300 hover:shadow-lg dark:border-slate-800 dark:bg-slate-900"
+          >
+            <div class="flex items-start justify-between gap-4">
+              <div>
+                <h3 class="text-lg font-semibold">{{ question.title }}</h3>
+                <p class="mt-2 text-sm leading-6 text-slate-600 dark:text-slate-400">
+                  {{ question.intro || 'No question intro available.' }}
+                </p>
+              </div>
+              <span class="rounded-full px-3 py-1 text-xs font-medium" :class="difficultyMeta(question.difficulty).className">
+                {{ difficultyMeta(question.difficulty).label }} · {{ question.difficulty }}
+              </span>
+            </div>
+
+            <div class="mt-4 flex flex-wrap items-center gap-2">
+              <span class="rounded-full bg-slate-100 px-3 py-1 text-xs font-medium text-slate-600 dark:bg-slate-800 dark:text-slate-300">
+                {{ question.lang }}
+              </span>
+              <span class="rounded-full bg-blue-100 px-3 py-1 text-xs font-medium text-blue-700 dark:bg-blue-950 dark:text-blue-300">
+                ID {{ question.id }}
+              </span>
+            </div>
+          </article>
+        </div>
+
+        <div v-if="filteredQuestions.length === 0" class="rounded-3xl border border-dashed border-slate-300 py-14 text-center dark:border-slate-700">
+          <p class="text-slate-600 dark:text-slate-400">No matching questions found.</p>
+        </div>
+      </section>
+    </div>
+  </div>
+</template>
diff --git a/webapp/letapp/src/pages/Login.vue b/webapp/letapp/src/pages/Login.vue
index 7222681..4c1f217 100644
--- a/webapp/letapp/src/pages/Login.vue
+++ b/webapp/letapp/src/pages/Login.vue
@@ -1,292 +1,193 @@
-<script setup lang="ts">
-import { ref, onMounted } from 'vue';
-import { useRouter } from 'vue-router';
-import { Icon } from '@iconify/vue';
-import { NInput, NButton, NCheckbox, useMessage } from 'naive-ui';
-
-const router = useRouter();
-const message = useMessage(); // 创建 message 实例
-
-// 表单数据
-const formData = ref({
-  username: '',
-  password: '',
-  remember: false
-});
-
-// 加载状态
-const isLoading = ref(false);
-
-// 表单错误信息
-const errors = ref({
-  username: '',
-  password: ''
-});
-
-// 密码可见性
-const showPassword = ref(false);
-
-// 处理登录
-const handleLogin = async () => {
-  // 重置错误信息
-  errors.value = {
-    username: '',
-    password: ''
-  };
-  
-  // 表单验证
-  let isValid = true;
-  
-  if (!formData.value.username.trim()) {
-    errors.value.username = '请输入用户名或邮箱';
-    isValid = false;
-  }
-  
-  if (!formData.value.password) {
-    errors.value.password = '请输入密码';
-    isValid = false;
-  }
-  
-  if (!isValid) {
-    return;
-  }
-  
-  isLoading.value = true;
-  
-  try {
-    // 这里需要调用后端 API 来登录
-    // 暂时使用模拟数据
-    await new Promise(resolve => setTimeout(resolve, 1000));
-    
-    message.success('登录成功');
-    // 登录成功后跳转到首页
-    router.push('/');
-  } catch (error) {
-    message.error(`登录失败: ${error instanceof Error ? error.message : '未知错误'}`);
-  } finally {
-    isLoading.value = false;
-  }
-};
-
-// 密码可见性切换
-const togglePasswordVisibility = () => {
-  showPassword.value = !showPassword.value;
-};
-
-// 自动聚焦用户名输入框
-onMounted(() => {
-  const usernameInput = document.getElementById('username') as HTMLInputElement;
-  if (usernameInput) {
-    usernameInput.focus();
-  }
-});
-
-// 跳转到注册页面（实际跳转到社团官网）
-const handleRegister = () => {
-  window.location.href = 'https://www.xauat.site/SignUp';
-};
-</script>
-
-<template>
-  <div class="min-h-screen flex items-center justify-center bg-gradient-to-br from-gray-50 to-gray-100 dark:from-gray-900 dark:to-gray-800 py-12 px-4 sm:px-6 lg:px-8">
-    <div class="w-full max-w-md">
-      <!-- Logo 和标题 -->
-      <div class="text-center mb-10">
-        <div class="flex justify-center mb-4">
-          <img src="/assets/logo.png" alt="Let Coding" class="w-16 h-16" />
-        </div>
-        <h1 class="text-3xl font-bold text-gray-900 dark:text-white">欢迎回来</h1>
-        <p class="mt-2 text-sm text-gray-600 dark:text-gray-300">
-          登录你的 Let Coding 账户
-        </p>
-      </div>
-      
-      <!-- 登录表单 -->
-      <div class="bg-white dark:bg-gray-800 rounded-2xl shadow-lg overflow-hidden border border-gray-200 dark:border-gray-700 transition-all duration-300 hover:shadow-xl">
-        <div class="p-8 space-y-6">
-          <!-- 用户名 -->
-          <div class="space-y-2">
-            <label for="username" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
-              用户名或邮箱
-            </label>
-            <div class="relative h-12">
-              <div class="absolute left-0 top-0 bottom-0 w-12 flex items-center justify-center z-10">
-                <Icon icon="material-symbols:person" class="w-5 h-5 text-gray-400 dark:text-gray-500" />
-              </div>
-              <NInput
-                v-model:value="formData.username"
-                placeholder="输入用户名或邮箱"
-                id="username"
-                :bordered="false"
-                :class="[
-                  'w-full h-full pl-12 pr-4 rounded-lg text-gray-900 dark:text-white placeholder:text-gray-400 dark:placeholder:text-gray-500 transition-all duration-200',
-                  'bg-gray-50 dark:bg-gray-700 focus:bg-white dark:focus:bg-gray-600',
-                  errors.username ? 'ring-2 ring-red-500 dark:ring-red-400' : 'focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400'
-                ]"
-              />
-            </div>
-            <!-- 错误信息 -->
-            <p v-if="errors.username" class="text-xs text-red-600 dark:text-red-400 mt-1">{{ errors.username }}</p>
-          </div>
-          
-          <!-- 密码 -->
-          <div class="space-y-2">
-            <div class="flex items-center justify-between">
-              <label for="password" class="block text-sm font-medium text-gray-700 dark:text-gray-300">
-                密码
-              </label>
-              <router-link to="/forgot-password" class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">
-                忘记密码？
-              </router-link>
-            </div>
-            <div class="relative h-12">
-              <div class="absolute left-0 top-0 bottom-0 w-12 flex items-center justify-center z-10">
-                <Icon icon="material-symbols:lock" class="w-5 h-5 text-gray-400 dark:text-gray-500" />
-              </div>
-              <NInput
-                v-model:value="formData.password"
-                :type="showPassword ? 'text' : 'password'"
-                placeholder="输入密码"
-                id="password"
-                :bordered="false"
-                :class="[
-                  'w-full h-full pl-12 pr-12 rounded-lg text-gray-900 dark:text-white placeholder:text-gray-400 dark:placeholder:text-gray-500 transition-all duration-200',
-                  'bg-gray-50 dark:bg-gray-700 focus:bg-white dark:focus:bg-gray-600',
-                  errors.password ? 'ring-2 ring-red-500 dark:ring-red-400' : 'focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400'
-                ]"
-              />
-              <!-- 密码可见性切换按钮 -->
-              <button 
-                type="button"
-                class="absolute right-0 top-0 bottom-0 w-12 flex items-center justify-center text-gray-400 dark:text-gray-500 hover:text-gray-600 dark:hover:text-gray-300 transition-colors z-10"
-                @click="togglePasswordVisibility"
-              >
-                <Icon 
-                  :icon="showPassword ? 'material-symbols:visibility' : 'material-symbols:visibility-off'" 
-                  class="w-5 h-5"
-                />
-              </button>
-            </div>
-            <!-- 错误信息 -->
-            <p v-if="errors.password" class="text-xs text-red-600 dark:text-red-400 mt-1">{{ errors.password }}</p>
-          </div>
-          
-          <!-- 记住我和登录按钮 -->
-          <div class="flex items-center justify-between">
-            <div class="flex items-center">
-              <NCheckbox 
-                v-model:checked="formData.remember"
-                :bordered="false"
-                :class="['text-sm text-gray-600 dark:text-gray-300']"
-              >
-                <span class="text-sm text-gray-600 dark:text-gray-300">记住我</span>
-              </NCheckbox>
-            </div>
-          </div>
-          
-          <!-- 登录按钮 -->
-          <NButton
-            type="primary"
-            block
-            :loading="isLoading"
-            :bordered="false"
-            @click="handleLogin"
-            :class="[
-              'w-full py-3.5 px-4 rounded-lg font-medium transition-all duration-200',
-              'bg-blue-600 text-white hover:bg-blue-700 active:bg-blue-800',
-              'shadow-md hover:shadow-lg active:shadow-sm',
-              'transform hover:-translate-y-0.5 active:translate-y-0'
-            ]"
-          >
-            登录
-          </NButton>
-          
-          <!-- 分割线 -->
-          <div class="relative my-8">
-            <div class="absolute inset-0 flex items-center">
-              <div class="w-full border-t border-gray-200 dark:border-gray-700"></div>
-            </div>
-            <div class="relative flex justify-center">
-              <span class="px-4 bg-white dark:bg-gray-800 text-sm text-gray-500 dark:text-gray-400">
-                或使用其他方式登录
-              </span>
-            </div>
-          </div>
-          
-          <!-- 第三方登录 -->
-          <div class="grid grid-cols-2 gap-4">
-            <button
-              class="flex items-center justify-center gap-2 py-3.5 px-4 rounded-lg transition-all duration-200"
-              :class="[
-                'bg-white dark:bg-gray-700 border border-gray-200 dark:border-gray-600',
-                'hover:bg-gray-50 dark:hover:bg-gray-600 hover:border-gray-300 dark:hover:border-gray-500',
-                'shadow-sm hover:shadow-md active:shadow-sm'
-              ]"
-            >
-              <Icon icon="mdi:github" class="w-5 h-5" />
-              <span class="text-sm font-medium text-gray-700 dark:text-gray-300">GitHub</span>
-            </button>
-            <button
-              class="flex items-center justify-center gap-2 py-3.5 px-4 rounded-lg transition-all duration-200"
-              :class="[
-                'bg-white dark:bg-gray-700 border border-gray-200 dark:border-gray-600',
-                'hover:bg-gray-50 dark:hover:bg-gray-600 hover:border-gray-300 dark:hover:border-gray-500',
-                'shadow-sm hover:shadow-md active:shadow-sm'
-              ]"
-            >
-              <Icon icon="mdi:google" class="w-5 h-5" />
-              <span class="text-sm font-medium text-gray-700 dark:text-gray-300">Google</span>
-            </button>
-          </div>
-        </div>
-        
-        <!-- 底部注册链接 -->
-        <div class="bg-gray-50 dark:bg-gray-900 p-6 border-t border-gray-200 dark:border-gray-700">
-          <div class="text-center">
-            <span class="text-sm text-gray-600 dark:text-gray-300">
-              还没有账户？
-            </span>
-            <button
-              @click="handleRegister"
-              class="ml-1 text-sm font-semibold text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-all duration-200 transform hover:-translate-y-0.5"
-            >
-              立即注册
-            </button>
-          </div>
-        </div>
-      </div>
-      
-      <!-- 页脚 -->
-      <div class="mt-8 text-center text-sm text-gray-500 dark:text-gray-400">
-        <p>© {{ new Date().getFullYear() }} Let Coding. 保留所有权利。</p>
-        <div class="flex justify-center gap-4 mt-2">
-          <a href="#" class="hover:text-blue-600 dark:hover:text-blue-400 transition-colors">隐私政策</a>
-          <a href="#" class="hover:text-blue-600 dark:hover:text-blue-400 transition-colors">使用条款</a>
-          <a href="#" class="hover:text-blue-600 dark:hover:text-blue-400 transition-colors">帮助中心</a>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-/* 自定义滚动条样式 */
-::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
-}
-
-::-webkit-scrollbar-track {
-  background: #f1f1f1;
-  dark:bg-gray-800;
-}
-
-::-webkit-scrollbar-thumb {
-  background: #888;
-  border-radius: 3px;
-}
-
-::-webkit-scrollbar-thumb:hover {
-  background: #555;
-}
-</style>
\ No newline at end of file
+<script setup lang="ts">
+import { onMounted, ref } from 'vue';
+import { useRouter } from 'vue-router';
+import { Icon } from '@iconify/vue';
+import { useMessage } from 'naive-ui';
+import { loginUser, setAuthToken, setAuthUser } from '../services/api';
+
+const router = useRouter();
+const message = useMessage();
+
+const form = ref({
+  identifier: '',
+  password: '',
+  remember: false,
+});
+
+const errors = ref({
+  identifier: '',
+  password: '',
+});
+
+const isLoading = ref(false);
+const showPassword = ref(false);
+const identifierInput = ref<HTMLInputElement | null>(null);
+
+onMounted(() => {
+  identifierInput.value?.focus();
+});
+
+function resetErrors() {
+  errors.value.identifier = '';
+  errors.value.password = '';
+}
+
+function resolveRedirect(user: Record<string, unknown>) {
+  const username = String(user['username'] ?? '').toLowerCase();
+  const isAdmin = Boolean(user['is_admin']) || username === 'admin';
+  return isAdmin ? '/admin/dashboard' : '/';
+}
+
+async function handleLogin() {
+  resetErrors();
+
+  const identifier = form.value.identifier.trim();
+  const password = form.value.password;
+
+  if (!identifier) {
+    errors.value.identifier = 'Please enter a username or email.';
+  }
+
+  if (!password) {
+    errors.value.password = 'Please enter a password.';
+  }
+
+  if (errors.value.identifier || errors.value.password) {
+    return;
+  }
+
+  isLoading.value = true;
+
+  try {
+    const result = await loginUser({ identifier, password });
+    setAuthToken(result.token, form.value.remember);
+    setAuthUser(result.user, form.value.remember);
+    message.success(result.message ?? 'Login successful.');
+    await router.replace(resolveRedirect(result.user as Record<string, unknown>));
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : 'Login failed.';
+    message.error(errorMessage);
+  } finally {
+    isLoading.value = false;
+  }
+}
+
+function togglePasswordVisibility() {
+  showPassword.value = !showPassword.value;
+}
+</script>
+
+<template>
+  <div class="min-h-screen bg-[radial-gradient(circle_at_top,_rgba(59,130,246,0.25),_transparent_35%),linear-gradient(135deg,_#020617,_#0f172a_50%,_#111827)] text-white">
+    <div class="mx-auto flex min-h-screen w-full max-w-7xl items-center px-4 py-10 sm:px-6 lg:px-8">
+      <div class="grid w-full gap-8 lg:grid-cols-[1.15fr_0.85fr]">
+        <section class="flex flex-col justify-center">
+          <div class="mb-8 inline-flex items-center gap-3">
+            <img src="/assets/logo.png" alt="Let Coding" class="h-14 w-14 rounded-2xl bg-white/10 p-2 shadow-lg" />
+            <div>
+              <p class="text-sm uppercase tracking-[0.35em] text-sky-200/80">Let Coding</p>
+              <h1 class="text-3xl font-semibold tracking-tight sm:text-5xl">Unified login</h1>
+            </div>
+          </div>
+
+          <p class="max-w-2xl text-base leading-7 text-slate-300 sm:text-lg">
+            This login page is connected to the backend auth endpoint. After sign-in you can enter the home page, playground, and admin console.
+          </p>
+
+          <div class="mt-10 grid gap-4 sm:grid-cols-3">
+            <article class="rounded-2xl border border-white/10 bg-white/5 p-4 backdrop-blur">
+              <Icon icon="material-symbols:code" class="mb-3 text-2xl text-sky-300" />
+              <h2 class="mb-1 font-medium">Code execution</h2>
+              <p class="text-sm text-slate-300">Runs through the backend code runner.</p>
+            </article>
+            <article class="rounded-2xl border border-white/10 bg-white/5 p-4 backdrop-blur">
+              <Icon icon="material-symbols:school" class="mb-3 text-2xl text-emerald-300" />
+              <h2 class="mb-1 font-medium">Learning content</h2>
+              <p class="text-sm text-slate-300">Courses and questions come from real API data.</p>
+            </article>
+            <article class="rounded-2xl border border-white/10 bg-white/5 p-4 backdrop-blur">
+              <Icon icon="material-symbols:shield" class="mb-3 text-2xl text-amber-300" />
+              <h2 class="mb-1 font-medium">Admin tools</h2>
+              <p class="text-sm text-slate-300">Admin users can enter the management console.</p>
+            </article>
+          </div>
+        </section>
+
+        <section class="flex items-center justify-center">
+          <div class="w-full max-w-md rounded-3xl border border-white/10 bg-slate-950/70 p-8 shadow-[0_30px_90px_rgba(2,6,23,0.55)] backdrop-blur-xl">
+            <div class="mb-8 text-center">
+              <h2 class="text-2xl font-semibold tracking-tight">Welcome back</h2>
+              <p class="mt-2 text-sm text-slate-400">Sign in with your username or email address.</p>
+            </div>
+
+            <form class="space-y-5" @submit.prevent="handleLogin">
+              <div>
+                <label class="mb-2 block text-sm font-medium text-slate-200">Username or email</label>
+                <div class="relative">
+                  <Icon icon="material-symbols:person" class="pointer-events-none absolute left-4 top-1/2 -translate-y-1/2 text-slate-400" />
+                  <input
+                    ref="identifierInput"
+                    v-model="form.identifier"
+                    type="text"
+                    autocomplete="username"
+                    placeholder="Enter username or email"
+                    class="h-12 w-full rounded-2xl border border-slate-700 bg-slate-900/80 pl-11 pr-4 text-slate-100 outline-none transition focus:border-sky-500 focus:ring-2 focus:ring-sky-500/30"
+                  />
+                </div>
+                <p v-if="errors.identifier" class="mt-1 text-sm text-red-400">{{ errors.identifier }}</p>
+              </div>
+
+              <div>
+                <label class="mb-2 block text-sm font-medium text-slate-200">Password</label>
+                <div class="relative">
+                  <Icon icon="material-symbols:lock" class="pointer-events-none absolute left-4 top-1/2 -translate-y-1/2 text-slate-400" />
+                  <input
+                    v-model="form.password"
+                    :type="showPassword ? 'text' : 'password'"
+                    autocomplete="current-password"
+                    placeholder="Enter password"
+                    class="h-12 w-full rounded-2xl border border-slate-700 bg-slate-900/80 pl-11 pr-12 text-slate-100 outline-none transition focus:border-sky-500 focus:ring-2 focus:ring-sky-500/30"
+                  />
+                  <button
+                    type="button"
+                    class="absolute right-2 top-1/2 -translate-y-1/2 rounded-xl p-2 text-slate-400 transition hover:bg-white/5 hover:text-slate-200"
+                    @click="togglePasswordVisibility"
+                  >
+                    <Icon :icon="showPassword ? 'material-symbols:visibility' : 'material-symbols:visibility-off'" />
+                  </button>
+                </div>
+                <p v-if="errors.password" class="mt-1 text-sm text-red-400">{{ errors.password }}</p>
+              </div>
+
+              <div class="flex items-center justify-between gap-4">
+                <label class="flex items-center gap-2 text-sm text-slate-300">
+                  <input v-model="form.remember" type="checkbox" class="h-4 w-4 rounded border-slate-600 bg-slate-900 text-sky-500" />
+                  Remember me
+                </label>
+                <router-link to="/forgot-password" class="text-sm text-sky-300 transition hover:text-sky-200">
+                  Forgot password
+                </router-link>
+              </div>
+
+              <button
+                type="submit"
+                :disabled="isLoading"
+                class="flex h-12 w-full items-center justify-center rounded-2xl bg-sky-500 font-semibold text-white transition hover:bg-sky-400 disabled:cursor-not-allowed disabled:opacity-70"
+              >
+                <Icon v-if="isLoading" icon="eos-icons:three-dots-loading" class="mr-2 text-lg" />
+                {{ isLoading ? 'Signing in' : 'Sign in' }}
+              </button>
+            </form>
+
+            <div class="mt-8 border-t border-white/10 pt-6 text-center text-sm text-slate-400">
+              No account yet?
+              <a href="https://www.xauat.site/SignUp" target="_blank" rel="noreferrer" class="font-medium text-sky-300 transition hover:text-sky-200">
+                Register now
+              </a>
+            </div>
+          </div>
+        </section>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/webapp/letapp/src/pages/Playground.vue b/webapp/letapp/src/pages/Playground.vue
index 4cfc168..c5f7a6d 100644
--- a/webapp/letapp/src/pages/Playground.vue
+++ b/webapp/letapp/src/pages/Playground.vue
@@ -1,432 +1,254 @@
-<script setup lang="ts">
-import { ref, computed, onMounted, onUnmounted } from 'vue';
-import { Icon } from '@iconify/vue';
-import { useRouter, useRoute } from 'vue-router';
-import { useMessage } from 'naive-ui';
-
-const router = useRouter();
-const route = useRoute();
-const message = useMessage();
-
-interface Language {
-  name: string;
-  value: string;
-  icon: string;
-  color: string;
-}
-
-// 支持的编程语言
-const languages: Language[] = [
-  { name: 'JavaScript', value: 'javascript', icon: 'vscode-icons:file-type-js-official', color: '#F7DF1E' },
-  { name: 'Python', value: 'python', icon: 'vscode-icons:file-type-python', color: '#3776AB' },
-  { name: 'Java', value: 'java', icon: 'vscode-icons:file-type-java', color: '#ED8B00' },
-  { name: 'C++', value: 'cpp', icon: 'vscode-icons:file-type-cpp', color: '#00599C' },
-  { name: 'Go', value: 'go', icon: 'vscode-icons:file-type-go', color: '#00ADD8' },
-  { name: 'Rust', value: 'rust', icon: 'vscode-icons:file-type-rust', color: '#DEA584' },
-  { name: 'Swift', value: 'swift', icon: 'vscode-icons:file-type-swift', color: '#FA7343' },
-  { name: 'Kotlin', value: 'kotlin', icon: 'vscode-icons:file-type-kotlin', color: '#7F52FF' },
-];
-
-// 当前选择的语言
-const selectedLanguage = ref<string>('javascript');
-const showLanguageMenu = ref<boolean>(false);
-
-// 代码编辑器内容
-const code = ref<string>(`function greet(name) {
-  return \`Hello, \${name}!\`;
-}
-
-const message = greet('Let Coding');
-console.log(message);`);
-
-// 标准输入
-const stdin = ref<string>('');
-
-// 执行结果
-const stdout = ref<string>('');
-const stderr = ref<string>('');
-const isExecuting = ref<boolean>(false);
-
-// 计算属性：获取当前语言的图标和名称
-const currentLanguageInfo = computed(() => {
-  return languages.find(lang => lang.value === selectedLanguage.value) || languages[0];
-});
-
-// 处理URL参数，设置默认语言
-onMounted(() => {
-  const languageParam = route.query.language as string;
-  if (languageParam) {
-    const isValidLanguage = languages.some(lang => lang.value === languageParam);
-    if (isValidLanguage) {
-      selectedLanguage.value = languageParam;
-    }
-  }
-});
-
-// 选择语言
-const selectLanguage = (lang: Language) => {
-  selectedLanguage.value = lang.value;
-  showLanguageMenu.value = false;
-  message.info(`已切换到 ${lang.name}`);
-};
-
-// 运行代码
-const runCode = async () => {
-  isExecuting.value = true;
-  stdout.value = '';
-  stderr.value = '';
-
-  try {
-    // 这里需要调用后端 API 来执行代码
-    // 暂时使用模拟数据
-    await new Promise(resolve => setTimeout(resolve, 1000));
-
-    if (selectedLanguage.value === 'javascript') {
-      stdout.value = 'Hello, Let Coding!\n';
-    } else if (selectedLanguage.value === 'python') {
-      stdout.value = 'Hello, Let Coding!\n';
-    } else {
-      stdout.value = `Hello, Let Coding! (${selectedLanguage.value})\n`;
-    }
-    message.success('代码执行成功');
-  } catch (error) {
-    stderr.value = `执行错误: ${error instanceof Error ? error.message : '未知错误'}\n`;
-    message.error('代码执行失败');
-  } finally {
-    isExecuting.value = false;
-  }
-};
-
-// 保存代码到用户选择路径
-const saveCode = () => {
-  try {
-    // 根据语言生成文件名和扩展名
-    const languageMap: { [key: string]: { ext: string; name: string } } = {
-      javascript: { ext: 'js', name: 'script' },
-      python: { ext: 'py', name: 'script' },
-      java: { ext: 'java', name: 'Main' },
-      cpp: { ext: 'cpp', name: 'main' },
-      go: { ext: 'go', name: 'main' },
-      rust: { ext: 'rs', name: 'main' },
-      swift: { ext: 'swift', name: 'main' },
-      kotlin: { ext: 'kt', name: 'Main' }
-    };
-    
-    const langInfo = languageMap[selectedLanguage.value] || { ext: 'txt', name: 'code' };
-    const fileName = `${langInfo.name}.${langInfo.ext}`;
-    
-    // 创建Blob对象
-    const blob = new Blob([code.value], { type: 'text/plain;charset=utf-8' });
-    
-    // 创建下载链接
-    const link = document.createElement('a');
-    link.href = URL.createObjectURL(blob);
-    link.download = fileName;
-    
-    // 触发下载
-    document.body.appendChild(link);
-    link.click();
-    
-    // 清理
-    document.body.removeChild(link);
-    URL.revokeObjectURL(link.href);
-    
-    // 显示成功提示
-    message.success('代码已成功保存！');
-  } catch (error) {
-    console.error('保存代码失败:', error);
-    message.error(`保存代码失败: ${error instanceof Error ? error.message : '未知错误'}`);
-  }
-};
-
-// 重置代码
-const resetCode = () => {
-  code.value = '';
-  stdin.value = '';
-  stdout.value = '';
-  stderr.value = '';
-  message.info('已重置所有内容');
-};
-
-// 导入代码
-const importCode = () => {
-  // 创建隐藏的文件输入框
-  const fileInput = document.createElement('input');
-  fileInput.type = 'file';
-  fileInput.accept = '.js,.py,.java,.cpp,.go,.rs,.swift,.kt,.txt';
-  
-  // 文件选择事件处理
-  fileInput.onchange = (e) => {
-    const target = e.target as HTMLInputElement;
-    const file = target.files?.[0];
-    if (file) {
-      const reader = new FileReader();
-      
-      // 文件读取成功事件
-      reader.onload = (event) => {
-        const content = event.target?.result as string;
-        code.value = content;
-        
-        // 根据文件扩展名自动识别语言
-        const ext = file.name.split('.').pop()?.toLowerCase() || '';
-        const extToLanguage: { [key: string]: string } = {
-          js: 'javascript',
-          py: 'python',
-          java: 'java',
-          cpp: 'cpp',
-          go: 'go',
-          rs: 'rust',
-          swift: 'swift',
-          kt: 'kotlin'
-        };
-        
-        const detectedLanguage = extToLanguage[ext] || 'javascript';
-        selectedLanguage.value = detectedLanguage;
-        
-        // 显示成功提示
-        message.success('代码已成功导入！');
-      };
-      
-      // 文件读取失败事件
-      reader.onerror = () => {
-        message.error('读取文件失败！');
-      };
-      
-      // 开始读取文件
-      reader.readAsText(file);
-    }
-  };
-  
-  // 触发文件选择对话框
-  fileInput.click();
-};
-
-// 点击外部关闭语言菜单
-const handleClickOutside = (event: MouseEvent) => {
-  const target = event.target as HTMLElement;
-  if (!target.closest('.language-menu-container')) {
-    showLanguageMenu.value = false;
-  }
-};
-
-onMounted(() => {
-  document.addEventListener('click', handleClickOutside);
-});
-
-onUnmounted(() => {
-  document.removeEventListener('click', handleClickOutside);
-});
-</script>
-
-<template>
-  <div class="min-h-screen bg-slate-50 text-slate-900 transition-colors duration-300 dark:bg-slate-950 dark:text-slate-100">
-    <!-- 页面标题栏 - Apple 风格 -->
-    <div class="fixed left-0 right-0 top-16 z-40 border-b border-slate-200/80 bg-white/80 backdrop-blur-xl transition-colors dark:border-slate-800/80 dark:bg-slate-900/80">
-      <div class="mx-auto max-w-7xl px-4 py-4 sm:px-6 lg:px-8">
-        <div class="flex flex-wrap items-center justify-between gap-4">
-          <div class="flex items-center gap-3">
-            <h1 class="text-xl font-semibold tracking-tight sm:text-2xl">代码编辑器</h1>
-          </div>
-
-          <div class="flex items-center gap-2 flex-wrap">
-            <!-- 语言选择 -->
-            <div class="relative language-menu-container">
-              <button
-                class="flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm font-medium transition-all duration-200 hover:border-slate-300 hover:shadow-sm active:scale-95 dark:border-slate-700 dark:bg-slate-900 dark:hover:border-slate-600"
-                @click="showLanguageMenu = !showLanguageMenu"
-                :title="currentLanguageInfo.name"
-              >
-                <Icon :icon="currentLanguageInfo.icon" class="h-4 w-4" :style="{ color: currentLanguageInfo.color }" />
-                <span class="hidden sm:inline">{{ currentLanguageInfo.name }}</span>
-                <Icon icon="solar:alt-arrow-down-linear" class="h-4 w-4 transition-transform" :class="{ 'rotate-180': showLanguageMenu }" />
-              </button>
-
-              <!-- 语言下拉菜单 -->
-              <Transition
-                enter-active-class="transition duration-200 ease-out"
-                enter-from-class="opacity-0 scale-95"
-                enter-to-class="opacity-100 scale-100"
-                leave-active-class="transition duration-150 ease-in"
-                leave-from-class="opacity-100 scale-100"
-                leave-to-class="opacity-0 scale-95"
-              >
-                <div
-                  v-if="showLanguageMenu"
-                  class="absolute right-0 top-full z-50 mt-2 w-48 origin-top-right overflow-hidden rounded-xl border border-slate-200 bg-white shadow-xl dark:border-slate-700 dark:bg-slate-900"
-                >
-                  <button
-                    v-for="lang in languages"
-                    :key="lang.value"
-                    class="flex w-full items-center gap-3 px-4 py-2.5 text-left text-sm transition-colors hover:bg-slate-50 dark:hover:bg-slate-800"
-                    :class="{ 'bg-slate-50 dark:bg-slate-800': selectedLanguage === lang.value }"
-                    @click="selectLanguage(lang)"
-                  >
-                    <Icon :icon="lang.icon" class="h-5 w-5" :style="{ color: lang.color }" />
-                    <span>{{ lang.name }}</span>
-                    <Icon v-if="selectedLanguage === lang.value" icon="solar:check-circle-bold" class="ml-auto h-4 w-4 text-blue-500" />
-                  </button>
-                </div>
-              </Transition>
-            </div>
-
-            <!-- 导入按钮 -->
-            <button
-              class="flex items-center gap-2 rounded-xl border border-blue-200 bg-blue-50 px-3 py-2 text-sm font-medium text-blue-700 transition-all duration-200 hover:border-blue-300 hover:bg-blue-100 active:scale-95 dark:border-blue-900 dark:bg-blue-950 dark:text-blue-400 dark:hover:border-blue-800 dark:hover:bg-blue-900"
-              @click="importCode"
-            >
-              <Icon icon="solar:upload-linear" class="h-4 w-4" />
-              <span class="hidden sm:inline">导入</span>
-            </button>
-
-            <!-- 保存按钮 -->
-            <button
-              class="flex items-center gap-2 rounded-xl border border-emerald-200 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-700 transition-all duration-200 hover:border-emerald-300 hover:bg-emerald-100 active:scale-95 dark:border-emerald-900 dark:bg-emerald-950 dark:text-emerald-400 dark:hover:border-emerald-800 dark:hover:bg-emerald-900"
-              @click="saveCode"
-            >
-              <Icon icon="solar:diskette-linear" class="h-4 w-4" />
-              <span class="hidden sm:inline">保存</span>
-            </button>
-
-            <!-- 重置按钮 -->
-            <button
-              class="flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm font-medium transition-all duration-200 hover:border-slate-300 hover:shadow-sm active:scale-95 dark:border-slate-700 dark:bg-slate-900 dark:hover:border-slate-600"
-              @click="resetCode"
-            >
-              <Icon icon="solar:refresh-linear" class="h-4 w-4" />
-              <span class="hidden sm:inline">重置</span>
-            </button>
-
-            <!-- 运行按钮 -->
-            <button
-              class="flex items-center gap-2 rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white shadow-sm transition-all duration-200 hover:bg-blue-700 hover:shadow-md active:scale-95 disabled:cursor-not-allowed disabled:opacity-60"
-              @click="runCode"
-              :disabled="isExecuting"
-            >
-              <Icon
-                :icon="isExecuting ? 'solar:hourglass-line-linear' : 'solar:play-linear'"
-                class="h-4 w-4"
-                :class="{ 'animate-spin': isExecuting }"
-              />
-              <span>{{ isExecuting ? '执行中' : '运行' }}</span>
-            </button>
-          </div>
-        </div>
-      </div>
-    </div>
-
-    <!-- 编辑器主体 - Apple 风格布局 -->
-    <div class="mx-auto max-w-7xl px-4 pt-32 pb-6 sm:px-6 lg:px-8 lg:pb-8">
-      <div class="grid grid-cols-1 gap-5 lg:grid-cols-2">
-        <!-- 代码输入区域 -->
-        <div class="space-y-5">
-          <!-- 代码编辑器 -->
-          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
-            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
-              <div class="flex items-center gap-2">
-                <Icon icon="solar:code-square-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
-                <span class="text-sm font-medium">代码</span>
-              </div>
-              <div class="text-xs text-slate-500 dark:text-slate-400">
-                {{ code.split('\n').length }} 行
-              </div>
-            </div>
-            <textarea
-              v-model="code"
-              class="h-[400px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed text-slate-900 placeholder-slate-400 focus:outline-none focus:ring-2 focus:ring-blue-500/50 dark:bg-slate-900 dark:text-slate-100 dark:placeholder-slate-600 dark:focus:ring-blue-400/50"
-              placeholder="在此输入你的代码..."
-              spellcheck="false"
-            ></textarea>
-          </div>
-
-          <!-- 标准输入 -->
-          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
-            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
-              <div class="flex items-center gap-2">
-                <Icon icon="solar:import-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
-                <span class="text-sm font-medium">标准输入</span>
-              </div>
-            </div>
-            <textarea
-              v-model="stdin"
-              class="h-[150px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed text-slate-900 placeholder-slate-400 focus:outline-none focus:ring-2 focus:ring-blue-500/50 dark:bg-slate-900 dark:text-slate-100 dark:placeholder-slate-600 dark:focus:ring-blue-400/50"
-              placeholder="在此输入标准输入..."
-              spellcheck="false"
-            ></textarea>
-          </div>
-        </div>
-
-        <!-- 结果输出区域 -->
-        <div class="space-y-5">
-          <!-- 标准输出 -->
-          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
-            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
-              <div class="flex items-center gap-2">
-                <Icon icon="solar:export-linear" class="h-5 w-5 text-emerald-600 dark:text-emerald-400" />
-                <span class="text-sm font-medium">标准输出</span>
-              </div>
-            </div>
-            <div
-              class="h-[275px] w-full overflow-auto bg-white p-4 font-mono text-sm leading-relaxed dark:bg-slate-900"
-            >
-              <pre v-if="stdout" class="text-emerald-600 dark:text-emerald-400">{{ stdout }}</pre>
-              <div v-else class="text-slate-400 dark:text-slate-600">执行结果将显示在这里...</div>
-            </div>
-          </div>
-
-          <!-- 错误输出 -->
-          <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm transition-all dark:border-slate-800 dark:bg-slate-900">
-            <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
-              <div class="flex items-center gap-2">
-                <Icon icon="solar:danger-circle-linear" class="h-5 w-5 text-red-600 dark:text-red-400" />
-                <span class="text-sm font-medium">错误输出</span>
-              </div>
-            </div>
-            <div
-              class="h-[275px] w-full overflow-auto bg-white p-4 font-mono text-sm leading-relaxed dark:bg-slate-900"
-            >
-              <pre v-if="stderr" class="text-red-600 dark:text-red-400">{{ stderr }}</pre>
-              <div v-else class="text-slate-400 dark:text-slate-600">错误信息将显示在这里...</div>
-            </div>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-/* Apple 风格滚动条 */
-::-webkit-scrollbar {
-  width: 8px;
-  height: 8px;
-}
-
-::-webkit-scrollbar-track {
-  background: transparent;
-}
-
-::-webkit-scrollbar-thumb {
-  background: rgb(203 213 225);
-  border-radius: 4px;
-  transition: background 0.2s;
-}
-
-::-webkit-scrollbar-thumb:hover {
-  background: rgb(148 163 184);
-}
-
-:global(.dark) ::-webkit-scrollbar-thumb {
-  background: rgb(51 65 85);
-}
-
-:global(.dark) ::-webkit-scrollbar-thumb:hover {
-  background: rgb(71 85 105);
-}
-
-/* 点击语言菜单外部关闭 */
-@media (hover: hover) {
-  button:active {
-    transform: scale(0.98);
-  }
-}
-</style>
\ No newline at end of file
+<script setup lang="ts">
+import { computed, onMounted, ref } from 'vue';
+import { useRoute } from 'vue-router';
+import { Icon } from '@iconify/vue';
+import { useMessage } from 'naive-ui';
+import { getAuthToken, runCode } from '../services/api';
+
+type Language = {
+  name: string;
+  value: string;
+  icon: string;
+  color: string;
+};
+
+const route = useRoute();
+const message = useMessage();
+
+const languages: Language[] = [
+  { name: 'JavaScript', value: 'javascript', icon: 'vscode-icons:file-type-js-official', color: '#F7DF1E' },
+  { name: 'Python', value: 'python', icon: 'vscode-icons:file-type-python', color: '#3776AB' },
+  { name: 'Java', value: 'java', icon: 'vscode-icons:file-type-java', color: '#ED8B00' },
+  { name: 'C++', value: 'cpp', icon: 'vscode-icons:file-type-cpp', color: '#00599C' },
+  { name: 'Go', value: 'go', icon: 'vscode-icons:file-type-go', color: '#00ADD8' },
+  { name: 'Rust', value: 'rust', icon: 'vscode-icons:file-type-rust', color: '#DEA584' },
+  { name: 'Swift', value: 'swift', icon: 'vscode-icons:file-type-swift', color: '#FA7343' },
+  { name: 'Kotlin', value: 'kotlin', icon: 'vscode-icons:file-type-kotlin', color: '#7F52FF' },
+];
+
+const selectedLanguage = ref('javascript');
+const code = ref(`function greet(name) {
+  return \`Hello, \${name}!\`;
+}
+
+console.log(greet('Let Coding'));`);
+const stdin = ref('');
+const stdout = ref('');
+const stderr = ref('');
+const isExecuting = ref(false);
+
+const currentLanguage = computed(() => {
+  return languages.find((item) => item.value === selectedLanguage.value) ?? languages[0]!;
+});
+
+onMounted(() => {
+  const queryLanguage = String(route.query.language ?? '').toLowerCase();
+  if (languages.some((item) => item.value === queryLanguage)) {
+    selectedLanguage.value = queryLanguage;
+  }
+});
+
+async function executeCode() {
+  isExecuting.value = true;
+  stdout.value = '';
+  stderr.value = '';
+
+  try {
+    const result = await runCode(
+      {
+        code: code.value,
+        language: selectedLanguage.value,
+        stdin: stdin.value.trim() ? stdin.value : undefined,
+      },
+      Boolean(getAuthToken()),
+    );
+
+    stdout.value = result.stdout ?? '';
+    stderr.value = result.stderr ?? '';
+
+    if (stderr.value) {
+      message.warning(result.message ?? 'Execution completed with errors.');
+    } else {
+      message.success(result.message ?? 'Execution successful.');
+    }
+  } catch (error) {
+    stderr.value = error instanceof Error ? error.message : 'Execution failed.';
+    message.error(stderr.value);
+  } finally {
+    isExecuting.value = false;
+  }
+}
+
+function saveCode() {
+  const languageMap: Record<string, { ext: string; name: string }> = {
+    javascript: { ext: 'js', name: 'script' },
+    python: { ext: 'py', name: 'script' },
+    java: { ext: 'java', name: 'Main' },
+    cpp: { ext: 'cpp', name: 'main' },
+    go: { ext: 'go', name: 'main' },
+    rust: { ext: 'rs', name: 'main' },
+    swift: { ext: 'swift', name: 'main' },
+    kotlin: { ext: 'kt', name: 'Main' },
+  };
+
+  const fileInfo = languageMap[selectedLanguage.value] ?? { ext: 'txt', name: 'code' };
+  const blob = new Blob([code.value], { type: 'text/plain;charset=utf-8' });
+  const link = document.createElement('a');
+  link.href = URL.createObjectURL(blob);
+  link.download = `${fileInfo.name}.${fileInfo.ext}`;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  URL.revokeObjectURL(link.href);
+  message.success('Code saved.');
+}
+
+function importCode() {
+  const fileInput = document.createElement('input');
+  fileInput.type = 'file';
+  fileInput.accept = '.js,.py,.java,.cpp,.go,.rs,.swift,.kt,.txt';
+  fileInput.onchange = (event) => {
+    const target = event.target as HTMLInputElement;
+    const file = target.files?.[0];
+    if (!file) {
+      return;
+    }
+
+    const reader = new FileReader();
+    reader.onload = (loadEvent) => {
+      code.value = String(loadEvent.target?.result ?? '');
+      const extension = file.name.split('.').pop()?.toLowerCase() ?? '';
+      const mapping: Record<string, string> = {
+        js: 'javascript',
+        py: 'python',
+        java: 'java',
+        cpp: 'cpp',
+        go: 'go',
+        rs: 'rust',
+        swift: 'swift',
+        kt: 'kotlin',
+      };
+      selectedLanguage.value = mapping[extension] ?? 'javascript';
+      message.success('Code imported.');
+    };
+    reader.onerror = () => {
+      message.error('Failed to read the file.');
+    };
+    reader.readAsText(file);
+  };
+  fileInput.click();
+}
+
+function resetCode() {
+  code.value = '';
+  stdin.value = '';
+  stdout.value = '';
+  stderr.value = '';
+  message.info('Editor cleared.');
+}
+</script>
+
+<template>
+  <div class="min-h-screen bg-slate-50 text-slate-900 dark:bg-slate-950 dark:text-slate-100">
+    <div class="sticky top-0 z-30 border-b border-slate-200/80 bg-white/85 backdrop-blur-xl dark:border-slate-800/80 dark:bg-slate-900/85">
+      <div class="mx-auto flex max-w-7xl flex-wrap items-center justify-between gap-4 px-4 py-4 sm:px-6 lg:px-8">
+        <div>
+          <h1 class="text-2xl font-semibold tracking-tight">Online code playground</h1>
+          <p class="mt-1 text-sm text-slate-500 dark:text-slate-400">Current language: {{ currentLanguage.name }}</p>
+        </div>
+
+        <div class="flex flex-wrap items-center gap-2">
+          <label class="inline-flex items-center gap-2 rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm shadow-sm dark:border-slate-700 dark:bg-slate-900">
+            <Icon :icon="currentLanguage.icon" class="h-4 w-4" :style="{ color: currentLanguage.color }" />
+            <select v-model="selectedLanguage" class="bg-transparent outline-none">
+              <option v-for="lang in languages" :key="lang.value" :value="lang.value">
+                {{ lang.name }}
+              </option>
+            </select>
+          </label>
+
+          <button class="rounded-xl border border-blue-200 bg-blue-50 px-3 py-2 text-sm font-medium text-blue-700 transition hover:bg-blue-100 dark:border-blue-900 dark:bg-blue-950 dark:text-blue-300" @click="importCode">
+            <Icon icon="solar:upload-linear" class="mr-1 inline-block h-4 w-4" />
+            Import
+          </button>
+
+          <button class="rounded-xl border border-emerald-200 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-700 transition hover:bg-emerald-100 dark:border-emerald-900 dark:bg-emerald-950 dark:text-emerald-300" @click="saveCode">
+            <Icon icon="solar:diskette-linear" class="mr-1 inline-block h-4 w-4" />
+            Save
+          </button>
+
+          <button class="rounded-xl border border-slate-200 bg-white px-3 py-2 text-sm font-medium transition hover:bg-slate-50 dark:border-slate-700 dark:bg-slate-900 dark:hover:bg-slate-800" @click="resetCode">
+            <Icon icon="solar:refresh-linear" class="mr-1 inline-block h-4 w-4" />
+            Reset
+          </button>
+
+          <button
+            class="rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white transition hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-70"
+            :disabled="isExecuting"
+            @click="executeCode"
+          >
+            <Icon :icon="isExecuting ? 'eos-icons:three-dots-loading' : 'solar:play-linear'" class="mr-1 inline-block h-4 w-4" />
+            {{ isExecuting ? 'Running' : 'Run' }}
+          </button>
+        </div>
+      </div>
+    </div>
+
+    <div class="mx-auto grid max-w-7xl gap-5 px-4 py-6 sm:px-6 lg:grid-cols-2 lg:px-8 lg:py-8">
+      <section class="space-y-5">
+        <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <div class="flex items-center justify-between border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
+            <div class="flex items-center gap-2">
+              <Icon icon="solar:code-square-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
+              <span class="text-sm font-medium">Code</span>
+            </div>
+            <span class="text-xs text-slate-500 dark:text-slate-400">{{ code.split('\n').length }} lines</span>
+          </div>
+          <textarea
+            v-model="code"
+            class="h-[420px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed outline-none focus:ring-2 focus:ring-blue-500/40 dark:bg-slate-900"
+            spellcheck="false"
+            placeholder="Type your code here..."
+          />
+        </div>
+
+        <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <div class="flex items-center gap-2 border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
+            <Icon icon="solar:import-linear" class="h-5 w-5 text-slate-600 dark:text-slate-400" />
+            <span class="text-sm font-medium">Stdin</span>
+          </div>
+          <textarea
+            v-model="stdin"
+            class="h-[150px] w-full resize-none border-none bg-white p-4 font-mono text-sm leading-relaxed outline-none focus:ring-2 focus:ring-blue-500/40 dark:bg-slate-900"
+            spellcheck="false"
+            placeholder="Optional runtime input..."
+          />
+        </div>
+      </section>
+
+      <section class="space-y-5">
+        <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <div class="flex items-center gap-2 border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
+            <Icon icon="solar:export-linear" class="h-5 w-5 text-emerald-600 dark:text-emerald-400" />
+            <span class="text-sm font-medium">Stdout</span>
+          </div>
+          <div class="h-[275px] overflow-auto p-4 font-mono text-sm">
+            <pre v-if="stdout" class="whitespace-pre-wrap text-emerald-600 dark:text-emerald-400">{{ stdout }}</pre>
+            <div v-else class="text-slate-400 dark:text-slate-600">Execution output will appear here.</div>
+          </div>
+        </div>
+
+        <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
+          <div class="flex items-center gap-2 border-b border-slate-200 bg-slate-50 px-4 py-3 dark:border-slate-800 dark:bg-slate-800/50">
+            <Icon icon="solar:danger-circle-linear" class="h-5 w-5 text-red-600 dark:text-red-400" />
+            <span class="text-sm font-medium">Stderr</span>
+          </div>
+          <div class="h-[275px] overflow-auto p-4 font-mono text-sm">
+            <pre v-if="stderr" class="whitespace-pre-wrap text-red-600 dark:text-red-400">{{ stderr }}</pre>
+            <div v-else class="text-slate-400 dark:text-slate-600">Errors will appear here.</div>
+          </div>
+        </div>
+      </section>
+    </div>
+  </div>
+</template>
diff --git a/webapp/letapp/src/pages/admin/Dashboard.vue b/webapp/letapp/src/pages/admin/Dashboard.vue
index 22a73a7..b8fd5f6 100644
--- a/webapp/letapp/src/pages/admin/Dashboard.vue
+++ b/webapp/letapp/src/pages/admin/Dashboard.vue
@@ -1,208 +1,209 @@
-<script setup lang="ts">
-// import { ref } from 'vue'; // 未使用，注释掉
-import { Icon } from '@iconify/vue';
-
-// 统计数据
-const stats = [
-  { 
-    title: '总用户数', 
-    value: 1250, 
-    icon: 'material-symbols:people', 
-    color: 'bg-blue-100 dark:bg-blue-900 text-blue-600 dark:text-blue-400',
-    trend: '+15%',
-    trendType: 'up'
-  },
-  { 
-    title: '活跃用户', 
-    value: 890, 
-    icon: 'material-symbols:person', 
-    color: 'bg-green-100 dark:bg-green-900 text-green-600 dark:text-green-400',
-    trend: '+8%',
-    trendType: 'up'
-  },
-  { 
-    title: '代码执行次数', 
-    value: 5680, 
-    icon: 'material-symbols:code', 
-    color: 'bg-purple-100 dark:bg-purple-900 text-purple-600 dark:text-purple-400',
-    trend: '+22%',
-    trendType: 'up'
-  },
-  { 
-    title: '学习资源数', 
-    value: 120, 
-    icon: 'material-symbols:school', 
-    color: 'bg-orange-100 dark:bg-orange-900 text-orange-600 dark:text-orange-400',
-    trend: '+5%',
-    trendType: 'up'
-  },
-];
-
-// 最近用户
-const recentUsers = [
-  { id: 1, name: 'admin', email: 'admin@example.com', role: '管理员', status: 'active', joined: '2023-01-01' },
-  { id: 2, name: 'user1', email: 'user1@example.com', role: '普通用户', status: 'active', joined: '2023-12-30' },
-  { id: 3, name: 'user2', email: 'user2@example.com', role: '普通用户', status: 'inactive', joined: '2023-12-29' },
-  { id: 4, name: 'guest1', email: 'guest1@example.com', role: '访客', status: 'active', joined: '2023-12-28' },
-  { id: 5, name: 'user3', email: 'user3@example.com', role: '普通用户', status: 'suspended', joined: '2023-12-27' },
-];
-
-// 最近代码执行
-const recentExecutions = [
-  { id: 1, user: 'user1', language: 'JavaScript', status: 'success', executedAt: '2023-12-31 14:30:00' },
-  { id: 2, user: 'user2', language: 'Python', status: 'error', executedAt: '2023-12-31 14:25:00' },
-  { id: 3, user: 'admin', language: 'Java', status: 'success', executedAt: '2023-12-31 14:20:00' },
-  { id: 4, user: 'guest1', language: 'JavaScript', status: 'success', executedAt: '2023-12-31 14:15:00' },
-  { id: 5, user: 'user3', language: 'Python', status: 'success', executedAt: '2023-12-31 14:10:00' },
-];
-</script>
-
-<template>
-  <div class="space-y-6">
-    <!-- 页面标题 -->
-    <div>
-      <h1 class="text-2xl font-bold mb-1">仪表盘</h1>
-      <p class="text-gray-600 dark:text-gray-300">欢迎来到 Let Coding 管理后台</p>
-    </div>
-    
-    <!-- 统计卡片 -->
-    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
-      <div 
-        v-for="(stat, index) in stats" 
-        :key="index"
-        class="bg-white dark:bg-gray-800 rounded-xl shadow-md p-6 border border-gray-200 dark:border-gray-700 hover:shadow-lg transition-shadow"
-      >
-        <div class="flex items-center justify-between">
-          <div>
-            <p class="text-sm text-gray-600 dark:text-gray-300 mb-1">{{ stat.title }}</p>
-            <h3 class="text-2xl font-bold text-gray-900 dark:text-gray-100">{{ stat.value }}</h3>
-            <div class="flex items-center gap-1 mt-2 text-sm">
-              <Icon 
-                :icon="stat.trendType === 'up' ? 'material-symbols:trending-up' : 'material-symbols:trending-down'" 
-                class="w-4 h-4 text-green-600 dark:text-green-400"
-              />
-              <span class="text-green-600 dark:text-green-400 font-medium">{{ stat.trend }}</span>
-              <span class="text-gray-500 dark:text-gray-400">较上月</span>
-            </div>
-          </div>
-          <div :class="['w-12 h-12 rounded-lg flex items-center justify-center', stat.color]">
-            <Icon :icon="stat.icon" class="w-6 h-6" />
-          </div>
-        </div>
-      </div>
-    </div>
-    
-    <!-- 数据图表 -->
-    <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
-      <!-- 最近用户 -->
-      <div class="bg-white dark:bg-gray-800 rounded-xl shadow-md p-6 border border-gray-200 dark:border-gray-700">
-        <div class="flex items-center justify-between mb-4">
-          <h2 class="text-lg font-semibold text-gray-900 dark:text-gray-100">最近用户</h2>
-          <button class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">
-            查看全部
-          </button>
-        </div>
-        <div class="space-y-4">
-          <div 
-            v-for="(user, index) in recentUsers" 
-            :key="index"
-            class="flex items-center justify-between p-3 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-750 transition-colors"
-          >
-            <div class="flex items-center gap-3">
-              <div class="w-10 h-10 rounded-full bg-blue-100 dark:bg-blue-900 flex items-center justify-center">
-                <Icon icon="material-symbols:person" class="w-6 h-6 text-blue-600 dark:text-blue-400" />
-              </div>
-              <div>
-                <div class="flex items-center gap-2">
-                  <span class="font-medium text-gray-900 dark:text-gray-100">{{ user.name }}</span>
-                  <span class="text-xs px-2 py-0.5 rounded-full bg-blue-100 dark:bg-blue-900 text-blue-800 dark:text-blue-200">
-                    {{ user.role }}
-                  </span>
-                </div>
-                <p class="text-sm text-gray-600 dark:text-gray-300">{{ user.email }}</p>
-              </div>
-            </div>
-            <div class="text-right">
-              <div class="text-sm font-medium text-gray-900 dark:text-gray-100">{{ user.joined }}</div>
-              <span 
-                class="text-xs px-2 py-0.5 rounded-full mt-1 inline-block"
-                :class="[
-                  user.status === 'active' ? 'bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200' : 
-                  user.status === 'inactive' ? 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200' : 
-                  'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200'
-                ]"
-              >
-                {{ user.status === 'active' ? '活跃' : user.status === 'inactive' ? '未激活' : '已封禁' }}
-              </span>
-            </div>
-          </div>
-        </div>
-      </div>
-      
-      <!-- 最近代码执行 -->
-      <div class="bg-white dark:bg-gray-800 rounded-xl shadow-md p-6 border border-gray-200 dark:border-gray-700">
-        <div class="flex items-center justify-between mb-4">
-          <h2 class="text-lg font-semibold text-gray-900 dark:text-gray-100">最近代码执行</h2>
-          <button class="text-sm text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors">
-            查看全部
-          </button>
-        </div>
-        <div class="space-y-4">
-          <div 
-            v-for="(execution, index) in recentExecutions" 
-            :key="index"
-            class="flex items-center justify-between p-3 rounded-lg hover:bg-gray-50 dark:hover:bg-gray-750 transition-colors"
-          >
-            <div class="flex items-center gap-3">
-              <div class="w-10 h-10 rounded-full bg-purple-100 dark:bg-purple-900 flex items-center justify-center">
-                <Icon icon="material-symbols:code" class="w-6 h-6 text-purple-600 dark:text-purple-400" />
-              </div>
-              <div>
-                <div class="flex items-center gap-2">
-                  <span class="font-medium text-gray-900 dark:text-gray-100">{{ execution.user }}</span>
-                  <span class="text-xs px-2 py-0.5 rounded-full bg-purple-100 dark:bg-purple-900 text-purple-800 dark:text-purple-200">
-                    {{ execution.language }}
-                  </span>
-                </div>
-                <p class="text-sm text-gray-600 dark:text-gray-300">{{ execution.executedAt }}</p>
-              </div>
-            </div>
-            <div>
-              <span 
-                class="text-xs px-2 py-0.5 rounded-full mt-1 inline-block"
-                :class="[
-                  execution.status === 'success' ? 'bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200' : 
-                  'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200'
-                ]"
-              >
-                {{ execution.status === 'success' ? '成功' : '失败' }}
-              </span>
-            </div>
-          </div>
-        </div>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-/* 自定义滚动条样式 */
-::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
-}
-
-::-webkit-scrollbar-track {
-  background: #f1f1f1;
-  dark:bg-gray-800;
-}
-
-::-webkit-scrollbar-thumb {
-  background: #888;
-  border-radius: 3px;
-}
-
-::-webkit-scrollbar-thumb:hover {
-  background: #555;
-}
-</style>
\ No newline at end of file
+<script setup lang="ts">
+import { computed, onMounted, ref } from 'vue';
+import { Icon } from '@iconify/vue';
+import { useMessage } from 'naive-ui';
+import { listCourses, listQuestions, listUsers, type AppUser, type Course, type Question } from '../../services/api';
+
+const message = useMessage();
+
+const users = ref<AppUser[]>([]);
+const courses = ref<Course[]>([]);
+const questions = ref<Question[]>([]);
+const loading = ref(false);
+const errorMessage = ref('');
+
+function normalizeUser(user: AppUser): AppUser {
+  return {
+    ...user,
+    email: user.email ?? '',
+    is_active: user.is_active ?? true,
+    last_login: user.last_login ?? null,
+    created_at: user.created_at ?? null,
+  };
+}
+
+function normalizeCourse(course: Course): Course {
+  return {
+    ...course,
+    cover_url: course.cover_url ?? '',
+    description: course.description ?? '',
+    is_active: course.is_active ?? true,
+  };
+}
+
+function normalizeQuestion(question: Question): Question {
+  return {
+    ...question,
+    intro: question.intro ?? '',
+    testcode: question.testcode ?? '',
+    lang: question.lang ?? 'javascript',
+  };
+}
+
+async function loadDashboard() {
+  loading.value = true;
+  errorMessage.value = '';
+
+  try {
+    const [userResult, courseResult, questionResult] = await Promise.all([
+      listUsers(),
+      listCourses(),
+      listQuestions(),
+    ]);
+
+    users.value = userResult.map(normalizeUser);
+    courses.value = courseResult.map(normalizeCourse);
+    questions.value = questionResult.map(normalizeQuestion);
+  } catch (error) {
+    errorMessage.value = error instanceof Error ? error.message : 'Failed to load dashboard.';
+    message.error(errorMessage.value);
+    users.value = [];
+    courses.value = [];
+    questions.value = [];
+  } finally {
+    loading.value = false;
+  }
+}
+
+onMounted(loadDashboard);
+
+const totalUsers = computed(() => users.value.length);
+const activeUsers = computed(() => users.value.filter((user) => Boolean(user.is_active)).length);
+const totalCourses = computed(() => courses.value.length);
+const totalQuestions = computed(() => questions.value.length);
+
+const recentUsers = computed(() =>
+  [...users.value]
+    .sort((left, right) => String(right.created_at ?? '').localeCompare(String(left.created_at ?? '')))
+    .slice(0, 5),
+);
+
+const recentQuestions = computed(() =>
+  [...questions.value]
+    .sort((left, right) => String(right.created_at ?? '').localeCompare(String(left.created_at ?? '')))
+    .slice(0, 5),
+);
+
+function statusText(user: AppUser) {
+  return Boolean(user.is_active) ? 'Active' : 'Disabled';
+}
+
+function statusClass(user: AppUser) {
+  return Boolean(user.is_active)
+    ? 'bg-emerald-100 text-emerald-700 dark:bg-emerald-900 dark:text-emerald-200'
+    : 'bg-slate-100 text-slate-700 dark:bg-slate-800 dark:text-slate-200';
+}
+
+function difficultyClass(level: number) {
+  if (level <= 2) {
+    return 'bg-emerald-100 text-emerald-700 dark:bg-emerald-900 dark:text-emerald-200';
+  }
+  if (level === 3) {
+    return 'bg-amber-100 text-amber-700 dark:bg-amber-900 dark:text-amber-200';
+  }
+  return 'bg-rose-100 text-rose-700 dark:bg-rose-900 dark:text-rose-200';
+}
+</script>
+
+<template>
+  <div class="space-y-6">
+    <section class="flex flex-wrap items-start justify-between gap-4">
+      <div>
+        <h1 class="text-2xl font-bold tracking-tight">Dashboard</h1>
+        <p class="mt-1 text-sm text-slate-500 dark:text-slate-400">The dashboard now uses live backend data.</p>
+      </div>
+      <button
+        class="rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white transition hover:bg-blue-700"
+        @click="loadDashboard"
+      >
+        <Icon icon="material-symbols:refresh" class="mr-1 inline-block h-4 w-4" />
+        Refresh
+      </button>
+    </section>
+
+    <section class="grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Total users</p>
+        <div class="mt-2 text-3xl font-semibold">{{ totalUsers }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Active users</p>
+        <div class="mt-2 text-3xl font-semibold text-emerald-600 dark:text-emerald-400">{{ activeUsers }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Courses</p>
+        <div class="mt-2 text-3xl font-semibold text-sky-600 dark:text-sky-400">{{ totalCourses }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Questions</p>
+        <div class="mt-2 text-3xl font-semibold text-amber-600 dark:text-amber-400">{{ totalQuestions }}</div>
+      </article>
+    </section>
+
+    <div v-if="errorMessage" class="rounded-2xl border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700 dark:border-red-900 dark:bg-red-950 dark:text-red-300">
+      {{ errorMessage }}
+    </div>
+
+    <section class="grid gap-6 lg:grid-cols-2">
+      <article class="rounded-2xl border border-slate-200 bg-white p-6 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <div class="mb-4 flex items-center justify-between">
+          <h2 class="text-lg font-semibold">Recent users</h2>
+          <span class="text-sm text-slate-500 dark:text-slate-400">{{ recentUsers.length }} items</span>
+        </div>
+
+        <div class="space-y-4">
+          <div
+            v-for="user in recentUsers"
+            :key="user.id"
+            class="flex items-center justify-between gap-3 rounded-2xl border border-slate-200 px-4 py-3 dark:border-slate-800"
+          >
+            <div>
+              <div class="flex items-center gap-2">
+                <span class="font-medium">{{ user.username }}</span>
+                <span class="rounded-full px-2 py-0.5 text-xs font-medium" :class="statusClass(user)">
+                  {{ statusText(user) }}
+                </span>
+              </div>
+              <p class="mt-1 text-sm text-slate-500 dark:text-slate-400">{{ user.email || 'No email set' }}</p>
+            </div>
+            <div class="text-right text-sm text-slate-500 dark:text-slate-400">
+              <div>#{{ user.id }}</div>
+              <div>{{ user.created_at ? new Date(user.created_at).toLocaleDateString('en-US') : '-' }}</div>
+            </div>
+          </div>
+        </div>
+      </article>
+
+      <article class="rounded-2xl border border-slate-200 bg-white p-6 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <div class="mb-4 flex items-center justify-between">
+          <h2 class="text-lg font-semibold">Recent questions</h2>
+          <span class="text-sm text-slate-500 dark:text-slate-400">{{ recentQuestions.length }} items</span>
+        </div>
+
+        <div class="space-y-4">
+          <div
+            v-for="question in recentQuestions"
+            :key="question.id"
+            class="flex items-center justify-between gap-3 rounded-2xl border border-slate-200 px-4 py-3 dark:border-slate-800"
+          >
+            <div>
+              <div class="flex items-center gap-2">
+                <span class="font-medium">{{ question.title }}</span>
+                <span class="rounded-full px-2 py-0.5 text-xs font-medium" :class="difficultyClass(question.difficulty)">
+                  {{ question.difficulty }}
+                </span>
+              </div>
+              <p class="mt-1 text-sm text-slate-500 dark:text-slate-400">{{ question.lang }}</p>
+            </div>
+            <div class="text-right text-sm text-slate-500 dark:text-slate-400">
+              <div>#{{ question.id }}</div>
+              <div>{{ question.created_at ? new Date(question.created_at).toLocaleDateString('en-US') : '-' }}</div>
+            </div>
+          </div>
+        </div>
+      </article>
+    </section>
+
+    <div v-if="loading" class="text-sm text-slate-500 dark:text-slate-400">Loading dashboard data...</div>
+  </div>
+</template>
diff --git a/webapp/letapp/src/pages/admin/Users.vue b/webapp/letapp/src/pages/admin/Users.vue
index 114f191..5fa4942 100644
--- a/webapp/letapp/src/pages/admin/Users.vue
+++ b/webapp/letapp/src/pages/admin/Users.vue
@@ -1,450 +1,433 @@
-<script setup lang="ts">
-import { ref, computed } from 'vue';
-import { Icon } from '@iconify/vue';
-
-// 用户数据类型
-interface User {
-  id: number;
-  username: string;
-  email: string;
-  role: 'admin' | 'user' | 'guest';
-  status: 'active' | 'inactive' | 'suspended';
-  created_at: string;
-  last_login: string;
-}
-
-// 模拟用户数据
-const mockUsers: User[] = [
-  {
-    id: 1,
-    username: 'admin',
-    email: 'admin@example.com',
-    role: 'admin',
-    status: 'active',
-    created_at: '2023-01-01T12:00:00Z',
-    last_login: '2023-12-31T12:00:00Z'
-  },
-  {
-    id: 2,
-    username: 'user1',
-    email: 'user1@example.com',
-    role: 'user',
-    status: 'active',
-    created_at: '2023-02-01T12:00:00Z',
-    last_login: '2023-12-30T12:00:00Z'
-  },
-  {
-    id: 3,
-    username: 'user2',
-    email: 'user2@example.com',
-    role: 'user',
-    status: 'inactive',
-    created_at: '2023-03-01T12:00:00Z',
-    last_login: '2023-11-30T12:00:00Z'
-  },
-  {
-    id: 4,
-    username: 'guest1',
-    email: 'guest1@example.com',
-    role: 'guest',
-    status: 'active',
-    created_at: '2023-04-01T12:00:00Z',
-    last_login: '2023-12-29T12:00:00Z'
-  },
-  {
-    id: 5,
-    username: 'user3',
-    email: 'user3@example.com',
-    role: 'user',
-    status: 'suspended',
-    created_at: '2023-05-01T12:00:00Z',
-    last_login: '2023-10-30T12:00:00Z'
-  },
-];
-
-// 搜索关键词
-const searchKeyword = ref('');
-
-// 筛选条件
-const filterRole = ref('all');
-const filterStatus = ref('all');
-
-// 当前页码
-const currentPage = ref(1);
-
-// 每页显示数量
-const pageSize = ref(10);
-
-// 用户列表数据
-const users = ref<User[]>([...mockUsers]);
-
-// 计算属性：过滤后的用户列表
-const filteredUsers = computed(() => {
-  let result = [...users.value];
-  
-  // 按关键词搜索
-  if (searchKeyword.value) {
-    const keyword = searchKeyword.value.toLowerCase();
-    result = result.filter(user => 
-      user.username.toLowerCase().includes(keyword) || 
-      user.email.toLowerCase().includes(keyword)
-    );
-  }
-  
-  // 按角色过滤
-  if (filterRole.value !== 'all') {
-    result = result.filter(user => user.role === filterRole.value);
-  }
-  
-  // 按状态过滤
-  if (filterStatus.value !== 'all') {
-    result = result.filter(user => user.status === filterStatus.value);
-  }
-  
-  return result;
-});
-
-// 计算属性：分页后的用户列表
-const paginatedUsers = computed(() => {
-  const startIndex = (currentPage.value - 1) * pageSize.value;
-  const endIndex = startIndex + pageSize.value;
-  return filteredUsers.value.slice(startIndex, endIndex);
-});
-
-// 计算属性：总页数
-const totalPages = computed(() => {
-  return Math.ceil(filteredUsers.value.length / pageSize.value);
-});
-
-// 计算属性：总用户数
-const totalUsers = computed(() => {
-  return filteredUsers.value.length;
-});
-
-// 处理搜索
-const handleSearch = () => {
-  currentPage.value = 1; // 搜索后回到第一页
-};
-
-// 处理重置筛选
-const handleResetFilter = () => {
-  searchKeyword.value = '';
-  filterRole.value = 'all';
-  filterStatus.value = 'all';
-  currentPage.value = 1;
-};
-
-// 处理页码变化
-const handlePageChange = (page: number) => {
-  currentPage.value = page;
-};
-
-// 处理用户状态变更
-const handleStatusChange = (userId: number, status: User['status']) => {
-  const userIndex = users.value.findIndex(user => user.id === userId);
-  if (userIndex !== -1 && users.value[userIndex]) {
-    users.value[userIndex].status = status;
+<script setup lang="ts">
+import { computed, onMounted, ref } from 'vue';
+import { Icon } from '@iconify/vue';
+import { useMessage } from 'naive-ui';
+import { deleteUser, listUsers, updateUser, type AppUser } from '../../services/api';
+
+type StatusFilter = 'all' | 'active' | 'inactive';
+
+const message = useMessage();
+
+const users = ref<AppUser[]>([]);
+const loading = ref(false);
+const errorMessage = ref('');
+
+const searchKeyword = ref('');
+const filterStatus = ref<StatusFilter>('all');
+const currentPage = ref(1);
+const pageSize = 10;
+
+const editingUserId = ref<number | null>(null);
+const editDraft = ref({
+  username: '',
+  email: '',
+  is_active: true,
+});
+
+const savingUser = ref(false);
+const deletingUserId = ref<number | null>(null);
+
+function normalizeUser(user: AppUser): AppUser {
+  return {
+    ...user,
+    email: user.email ?? '',
+    is_active: user.is_active ?? true,
+    last_login: user.last_login ?? null,
+    created_at: user.created_at ?? null,
+    updated_at: user.updated_at ?? null,
+  };
+}
+
+async function loadUsers() {
+  loading.value = true;
+  errorMessage.value = '';
+
+  try {
+    const result = await listUsers();
+    users.value = result.map(normalizeUser);
+    if (currentPage.value > totalPages.value) {
+      currentPage.value = 1;
+    }
+  } catch (error) {
+    errorMessage.value = error instanceof Error ? error.message : 'Failed to load users.';
+    message.error(errorMessage.value);
+    users.value = [];
+  } finally {
+    loading.value = false;
   }
-};
-
-// 处理删除用户
-const handleDeleteUser = (userId: number) => {
-  // 这里需要调用后端 API 来删除用户
-  console.log('删除用户:', userId);
-  // 暂时使用模拟数据
-  users.value = users.value.filter(user => user.id !== userId);
-};
-
-// 处理编辑用户
-const handleEditUser = (userId: number) => {
-  // 这里需要跳转到编辑用户页面
-  console.log('编辑用户:', userId);
-  // 暂时使用 alert
-  alert(`编辑用户 ${userId}，功能开发中...`);
-};
-
-// 获取角色显示名称
-const getRoleDisplayName = (role: User['role']) => {
-  const roleMap = {
-    admin: '管理员',
-    user: '普通用户',
-    guest: '访客'
-  };
-  return roleMap[role];
-};
-
-// 获取状态显示名称和样式
-const getStatusInfo = (status: User['status']) => {
-  const statusMap = {
-    active: { name: '活跃', color: 'bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200' },
-    inactive: { name: '未激活', color: 'bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200' },
-    suspended: { name: '已封禁', color: 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200' }
-  };
-  return statusMap[status];
-};
-
-// 格式化日期
-const formatDate = (dateString: string) => {
-  const date = new Date(dateString);
-  return date.toLocaleString('zh-CN', {
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-    hour: '2-digit',
-    minute: '2-digit'
-  });
-};
-</script>
-
-<template>
-  <div class="space-y-6">
-    <!-- 页面标题和操作按钮 -->
-    <div class="flex items-center justify-between flex-wrap gap-4">
-      <div>
-        <h1 class="text-2xl font-bold mb-1">用户管理</h1>
-        <p class="text-gray-600 dark:text-gray-300">管理平台用户，包括添加、编辑、删除和修改用户状态</p>
-      </div>
-      <button 
-        class="flex items-center gap-2 px-4 py-2 bg-green-600 text-white font-medium rounded-lg hover:bg-green-700 transition-colors shadow-md"
-      >
-        <Icon icon="material-symbols:add" class="w-5 h-5" />
-        新增用户
-      </button>
-    </div>
-    
-    <!-- 筛选和搜索区域 -->
-    <div class="bg-white dark:bg-gray-800 rounded-xl shadow-md p-6 border border-gray-200 dark:border-gray-700">
-      <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
-        <!-- 搜索框 -->
-        <div class="md:col-span-2">
-          <label class="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">搜索用户</label>
-          <div class="relative">
-            <input 
-              type="text" 
-              v-model="searchKeyword" 
-              @input="handleSearch"
-              placeholder="输入用户名或邮箱搜索..."
-              class="w-full pl-10 pr-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 focus:outline-none focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
-            />
-            <Icon icon="material-symbols:search" class="w-5 h-5 absolute left-3 top-1/2 transform -translate-y-1/2 text-gray-500 dark:text-gray-400" />
-          </div>
-        </div>
-        
-        <!-- 角色筛选 -->
-        <div>
-          <label class="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">角色</label>
-          <select 
-            v-model="filterRole" 
-            @change="handleSearch"
-            class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 focus:outline-none focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
-          >
-            <option value="all">全部角色</option>
-            <option value="admin">管理员</option>
-            <option value="user">普通用户</option>
-            <option value="guest">访客</option>
-          </select>
-        </div>
-        
-        <!-- 状态筛选 -->
-        <div>
-          <label class="block text-sm font-medium text-gray-700 dark:text-gray-300 mb-1">状态</label>
-          <select 
-            v-model="filterStatus" 
-            @change="handleSearch"
-            class="w-full px-4 py-2 rounded-lg border border-gray-300 dark:border-gray-600 focus:outline-none focus:ring-2 focus:ring-blue-500 dark:focus:ring-blue-400 bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100"
-          >
-            <option value="all">全部状态</option>
-            <option value="active">活跃</option>
-            <option value="inactive">未激活</option>
-            <option value="suspended">已封禁</option>
-          </select>
-        </div>
-      </div>
-      
-      <!-- 筛选结果和重置按钮 -->
-      <div class="flex items-center justify-between mt-4 pt-4 border-t border-gray-200 dark:border-gray-700">
-        <div class="text-sm text-gray-600 dark:text-gray-300">
-          共 <span class="font-semibold">{{ totalUsers }}</span> 个用户
-        </div>
-        <button 
-          class="flex items-center gap-2 px-3 py-1.5 bg-gray-100 dark:bg-gray-700 text-gray-700 dark:text-gray-300 rounded-lg hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors text-sm"
-          @click="handleResetFilter"
-        >
-          <Icon icon="material-symbols:refresh" class="w-4 h-4" />
-          重置筛选
-        </button>
-      </div>
-    </div>
-    
-    <!-- 用户列表 -->
-    <div class="bg-white dark:bg-gray-800 rounded-xl shadow-md overflow-hidden border border-gray-200 dark:border-gray-700">
-      <table class="min-w-full divide-y divide-gray-200 dark:divide-gray-700">
-        <thead class="bg-gray-50 dark:bg-gray-900">
-          <tr>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">ID</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">用户名</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">邮箱</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">角色</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">状态</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">创建时间</th>
-            <th scope="col" class="px-6 py-3 text-left text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">最后登录</th>
-            <th scope="col" class="px-6 py-3 text-right text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider">操作</th>
-          </tr>
-        </thead>
-        <tbody class="bg-white dark:bg-gray-800 divide-y divide-gray-200 dark:divide-gray-700">
-          <tr 
-            v-for="user in paginatedUsers" 
-            :key="user.id"
-            class="hover:bg-gray-50 dark:hover:bg-gray-750 transition-colors"
-          >
-            <td class="px-6 py-4 whitespace-nowrap text-sm font-medium text-gray-900 dark:text-gray-100">{{ user.id }}</td>
-            <td class="px-6 py-4 whitespace-nowrap">
-              <div class="flex items-center gap-3">
-                <div class="w-8 h-8 rounded-full bg-blue-100 dark:bg-blue-900 flex items-center justify-center">
-                  <Icon icon="material-symbols:person" class="w-5 h-5 text-blue-600 dark:text-blue-400" />
-                </div>
-                <span class="text-sm font-medium text-gray-900 dark:text-gray-100">{{ user.username }}</span>
-              </div>
-            </td>
-            <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-600 dark:text-gray-300">{{ user.email }}</td>
-            <td class="px-6 py-4 whitespace-nowrap">
-              <span class="px-2.5 py-0.5 rounded-full text-xs font-medium bg-blue-100 dark:bg-blue-900 text-blue-800 dark:text-blue-200">
-                {{ getRoleDisplayName(user.role) }}
-              </span>
-            </td>
-            <td class="px-6 py-4 whitespace-nowrap">
-              <span :class="['px-2.5 py-0.5 rounded-full text-xs font-medium', getStatusInfo(user.status).color]">
-                {{ getStatusInfo(user.status).name }}
-              </span>
-            </td>
-            <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-600 dark:text-gray-300">{{ formatDate(user.created_at) }}</td>
-            <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-600 dark:text-gray-300">{{ formatDate(user.last_login) }}</td>
-            <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
-              <div class="flex items-center justify-end gap-2">
-                <button 
-                  class="text-blue-600 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-300 transition-colors p-1.5 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700"
-                  @click="handleEditUser(user.id)"
-                  title="编辑"
-                >
-                  <Icon icon="material-symbols:edit" class="w-4 h-4" />
-                </button>
-                <button 
-                  class="text-red-600 dark:text-red-400 hover:text-red-800 dark:hover:text-red-300 transition-colors p-1.5 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700"
-                  @click="handleDeleteUser(user.id)"
-                  title="删除"
-                >
-                  <Icon icon="material-symbols:delete" class="w-4 h-4" />
-                </button>
-                <div class="relative group">
-                  <button 
-                    class="text-gray-600 dark:text-gray-300 hover:text-gray-800 dark:hover:text-gray-100 transition-colors p-1.5 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700"
-                    title="更多操作"
-                  >
-                    <Icon icon="material-symbols:more-vert" class="w-4 h-4" />
-                  </button>
-                  <!-- 下拉菜单 -->
-                  <div class="absolute right-0 mt-2 w-48 bg-white dark:bg-gray-800 rounded-lg shadow-lg border border-gray-200 dark:border-gray-700 opacity-0 invisible group-hover:opacity-100 group-hover:visible transition-all duration-200 z-50">
-                    <button 
-                      class="w-full text-left px-4 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
-                      @click="handleStatusChange(user.id, 'active')"
-                    >
-                      设为活跃
-                    </button>
-                    <button 
-                      class="w-full text-left px-4 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
-                      @click="handleStatusChange(user.id, 'inactive')"
-                    >
-                      设为未激活
-                    </button>
-                    <button 
-                      class="w-full text-left px-4 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
-                      @click="handleStatusChange(user.id, 'suspended')"
-                    >
-                      封禁账号
-                    </button>
-                  </div>
-                </div>
-              </div>
-            </td>
-          </tr>
-        </tbody>
-      </table>
-      
-      <!-- 空状态 -->
-      <div v-if="filteredUsers.length === 0" class="px-6 py-12 text-center">
-        <Icon icon="material-symbols:search-off" class="w-16 h-16 text-gray-400 dark:text-gray-500 mx-auto mb-4" />
-        <h3 class="text-lg font-medium text-gray-900 dark:text-gray-100 mb-1">未找到用户</h3>
-        <p class="text-sm text-gray-500 dark:text-gray-400">
-          请尝试调整筛选条件或搜索关键词
-        </p>
-      </div>
-    </div>
-    
-    <!-- 分页 -->
-    <div v-if="totalPages > 1" class="flex items-center justify-between bg-white dark:bg-gray-800 px-6 py-4 rounded-xl shadow-md border border-gray-200 dark:border-gray-700">
-      <div class="text-sm text-gray-600 dark:text-gray-300">
-        显示第 <span class="font-semibold">{{ currentPage }}</span> 页，共 <span class="font-semibold">{{ totalPages }}</span> 页
-      </div>
-      <div class="flex items-center gap-2">
-        <button 
-          class="px-3 py-1.5 rounded-lg transition-colors text-sm font-medium"
-          :class="[
-            currentPage === 1 ? 'bg-gray-100 text-gray-400 cursor-not-allowed' : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-700 dark:text-gray-300 dark:hover:bg-gray-600'
-          ]"
-          @click="handlePageChange(currentPage - 1)"
-          :disabled="currentPage === 1"
-        >
-          上一页
-        </button>
-        
-        <!-- 页码列表 -->
-        <div class="flex items-center gap-1">
-          <button 
-            v-for="page in totalPages" 
-            :key="page"
-            class="w-8 h-8 flex items-center justify-center rounded-lg transition-colors text-sm font-medium"
-            :class="[
-              currentPage === page ? 'bg-blue-600 text-white' : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-700 dark:text-gray-300 dark:hover:bg-gray-600'
-            ]"
-            @click="handlePageChange(page)"
-          >
-            {{ page }}
-          </button>
-        </div>
-        
-        <button 
-          class="px-3 py-1.5 rounded-lg transition-colors text-sm font-medium"
-          :class="[
-            currentPage === totalPages ? 'bg-gray-100 text-gray-400 cursor-not-allowed' : 'bg-gray-100 text-gray-700 hover:bg-gray-200 dark:bg-gray-700 dark:text-gray-300 dark:hover:bg-gray-600'
-          ]"
-          @click="handlePageChange(currentPage + 1)"
-          :disabled="currentPage === totalPages"
-        >
-          下一页
-        </button>
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-/* 自定义滚动条样式 */
-::-webkit-scrollbar {
-  width: 6px;
-  height: 6px;
-}
-
-::-webkit-scrollbar-track {
-  background: #f1f1f1;
-  dark:bg-gray-800;
-}
-
-::-webkit-scrollbar-thumb {
-  background: #888;
-  border-radius: 3px;
-}
-
-::-webkit-scrollbar-thumb:hover {
-  background: #555;
-}
-</style>
\ No newline at end of file
+}
+
+onMounted(loadUsers);
+
+const filteredUsers = computed(() => {
+  const keyword = searchKeyword.value.trim().toLowerCase();
+  let result = [...users.value];
+
+  if (keyword) {
+    result = result.filter((user) => {
+      return (
+        String(user.username ?? '').toLowerCase().includes(keyword) ||
+        String(user.email ?? '').toLowerCase().includes(keyword)
+      );
+    });
+  }
+
+  if (filterStatus.value === 'active') {
+    result = result.filter((user) => Boolean(user.is_active));
+  } else if (filterStatus.value === 'inactive') {
+    result = result.filter((user) => !Boolean(user.is_active));
+  }
+
+  return result.sort((a, b) => String(b.created_at ?? '').localeCompare(String(a.created_at ?? '')));
+});
+
+const totalUsers = computed(() => filteredUsers.value.length);
+const activeUsers = computed(() => users.value.filter((user) => Boolean(user.is_active)).length);
+const inactiveUsers = computed(() => users.value.filter((user) => !Boolean(user.is_active)).length);
+const adminUsers = computed(() => users.value.filter((user) => String(user.username ?? '').toLowerCase() === 'admin').length);
+
+const totalPages = computed(() => Math.max(1, Math.ceil(filteredUsers.value.length / pageSize)));
+
+const paginatedUsers = computed(() => {
+  const start = (currentPage.value - 1) * pageSize;
+  return filteredUsers.value.slice(start, start + pageSize);
+});
+
+function roleLabel(user: AppUser) {
+  return String(user.username ?? '').toLowerCase() === 'admin' ? 'Admin' : 'User';
+}
+
+function statusMeta(user: AppUser) {
+  return Boolean(user.is_active)
+    ? { label: 'Active', className: 'bg-emerald-100 text-emerald-700 dark:bg-emerald-900 dark:text-emerald-200' }
+    : { label: 'Disabled', className: 'bg-slate-100 text-slate-700 dark:bg-slate-800 dark:text-slate-200' };
+}
+
+function formatDate(value?: string | null) {
+  if (!value) {
+    return '-';
+  }
+
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return value;
+  }
+
+  return date.toLocaleString('en-US', {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+  });
+}
+
+function handleSearch() {
+  currentPage.value = 1;
+}
+
+function handleResetFilter() {
+  searchKeyword.value = '';
+  filterStatus.value = 'all';
+  currentPage.value = 1;
+}
+
+function beginEdit(user: AppUser) {
+  editingUserId.value = user.id;
+  editDraft.value = {
+    username: String(user.username ?? ''),
+    email: String(user.email ?? ''),
+    is_active: Boolean(user.is_active),
+  };
+}
+
+function cancelEdit() {
+  editingUserId.value = null;
+}
+
+async function saveEdit() {
+  if (editingUserId.value == null) {
+    return;
+  }
+
+  savingUser.value = true;
+
+  try {
+    const updated = await updateUser(editingUserId.value, {
+      username: editDraft.value.username.trim(),
+      email: editDraft.value.email.trim() || null,
+      is_active: editDraft.value.is_active,
+    });
+    users.value = users.value.map((user) => (user.id === updated.id ? normalizeUser(updated) : user));
+    editingUserId.value = null;
+    message.success('User updated.');
+  } catch (error) {
+    const errorText = error instanceof Error ? error.message : 'Failed to update user.';
+    message.error(errorText);
+  } finally {
+    savingUser.value = false;
+  }
+}
+
+async function toggleActive(user: AppUser, nextActive: boolean) {
+  try {
+    const updated = await updateUser(user.id, { is_active: nextActive });
+    users.value = users.value.map((item) => (item.id === updated.id ? normalizeUser(updated) : item));
+    message.success(nextActive ? 'User enabled.' : 'User disabled.');
+  } catch (error) {
+    const errorText = error instanceof Error ? error.message : 'Failed to change status.';
+    message.error(errorText);
+  }
+}
+
+async function removeUser(user: AppUser) {
+  const confirmed = window.confirm(`Delete user ${user.username}?`);
+  if (!confirmed) {
+    return;
+  }
+
+  deletingUserId.value = user.id;
+
+  try {
+    await deleteUser(user.id);
+    users.value = users.value.filter((item) => item.id !== user.id);
+    message.success('User deleted.');
+    if (currentPage.value > totalPages.value) {
+      currentPage.value = Math.max(1, totalPages.value);
+    }
+  } catch (error) {
+    const errorText = error instanceof Error ? error.message : 'Failed to delete user.';
+    message.error(errorText);
+  } finally {
+    deletingUserId.value = null;
+  }
+}
+
+function changePage(nextPage: number) {
+  currentPage.value = Math.min(Math.max(1, nextPage), totalPages.value);
+}
+</script>
+
+<template>
+  <div class="space-y-6">
+    <section class="flex flex-wrap items-start justify-between gap-4">
+      <div>
+        <h1 class="text-2xl font-bold tracking-tight">User management</h1>
+        <p class="mt-1 text-sm text-slate-500 dark:text-slate-400">Data comes from the backend `/user` endpoint.</p>
+      </div>
+      <button
+        class="rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white transition hover:bg-blue-700"
+        @click="loadUsers"
+      >
+        <Icon icon="material-symbols:refresh" class="mr-1 inline-block h-4 w-4" />
+        Refresh
+      </button>
+    </section>
+
+    <section class="grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Total users</p>
+        <div class="mt-2 text-3xl font-semibold">{{ users.length }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Active users</p>
+        <div class="mt-2 text-3xl font-semibold text-emerald-600 dark:text-emerald-400">{{ activeUsers }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Disabled users</p>
+        <div class="mt-2 text-3xl font-semibold text-slate-600 dark:text-slate-300">{{ inactiveUsers }}</div>
+      </article>
+      <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+        <p class="text-sm text-slate-500 dark:text-slate-400">Admins</p>
+        <div class="mt-2 text-3xl font-semibold text-amber-600 dark:text-amber-400">{{ adminUsers }}</div>
+      </article>
+    </section>
+
+    <section class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+      <div class="grid gap-4 md:grid-cols-[1.5fr_0.8fr_0.8fr]">
+        <div>
+          <label class="mb-2 block text-sm font-medium text-slate-600 dark:text-slate-300">Search users</label>
+          <div class="relative">
+            <Icon icon="material-symbols:search" class="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-slate-400" />
+            <input
+              v-model="searchKeyword"
+              type="text"
+              placeholder="Username or email"
+              class="h-11 w-full rounded-xl border border-slate-200 bg-white pl-10 pr-3 outline-none transition focus:border-blue-500 focus:ring-2 focus:ring-blue-500/20 dark:border-slate-700 dark:bg-slate-950"
+              @input="handleSearch"
+            />
+          </div>
+        </div>
+
+        <div>
+          <label class="mb-2 block text-sm font-medium text-slate-600 dark:text-slate-300">Status</label>
+          <select
+            v-model="filterStatus"
+            class="h-11 w-full rounded-xl border border-slate-200 bg-white px-3 outline-none transition focus:border-blue-500 focus:ring-2 focus:ring-blue-500/20 dark:border-slate-700 dark:bg-slate-950"
+            @change="handleSearch"
+          >
+            <option value="all">All</option>
+            <option value="active">Active</option>
+            <option value="inactive">Disabled</option>
+          </select>
+        </div>
+
+        <div class="flex items-end justify-start md:justify-end">
+          <button
+            class="h-11 rounded-xl border border-slate-200 bg-slate-50 px-4 text-sm font-medium transition hover:bg-slate-100 dark:border-slate-700 dark:bg-slate-950 dark:hover:bg-slate-800"
+            @click="handleResetFilter"
+          >
+            Reset
+          </button>
+        </div>
+      </div>
+
+      <div v-if="errorMessage" class="mt-4 rounded-xl border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700 dark:border-red-900 dark:bg-red-950 dark:text-red-300">
+        {{ errorMessage }}
+      </div>
+    </section>
+
+    <section
+      v-if="editingUserId !== null"
+      class="rounded-2xl border border-blue-200 bg-blue-50 p-5 shadow-sm dark:border-blue-900 dark:bg-blue-950/40"
+    >
+      <div class="flex flex-wrap items-center justify-between gap-3">
+        <div>
+          <h2 class="text-lg font-semibold">Edit user</h2>
+          <p class="text-sm text-slate-600 dark:text-slate-300">Update the user and save it back to the backend.</p>
+        </div>
+        <button class="rounded-xl border border-slate-200 bg-white px-4 py-2 text-sm font-medium dark:border-slate-700 dark:bg-slate-900" @click="cancelEdit">
+          Cancel
+        </button>
+      </div>
+
+      <div class="mt-4 grid gap-4 md:grid-cols-3">
+        <label class="block">
+          <span class="mb-2 block text-sm font-medium">Username</span>
+          <input
+            v-model="editDraft.username"
+            type="text"
+            class="h-11 w-full rounded-xl border border-slate-200 bg-white px-3 outline-none focus:border-blue-500 focus:ring-2 focus:ring-blue-500/20 dark:border-slate-700 dark:bg-slate-900"
+          />
+        </label>
+
+        <label class="block">
+          <span class="mb-2 block text-sm font-medium">Email</span>
+          <input
+            v-model="editDraft.email"
+            type="email"
+            class="h-11 w-full rounded-xl border border-slate-200 bg-white px-3 outline-none focus:border-blue-500 focus:ring-2 focus:ring-blue-500/20 dark:border-slate-700 dark:bg-slate-900"
+          />
+        </label>
+
+        <label class="flex items-end gap-2 rounded-xl border border-slate-200 bg-white px-4 py-3 dark:border-slate-700 dark:bg-slate-900">
+          <input v-model="editDraft.is_active" type="checkbox" class="h-4 w-4 rounded border-slate-300 text-blue-600" />
+          <span class="text-sm font-medium">Active</span>
+        </label>
+      </div>
+
+      <div class="mt-4 flex gap-3">
+        <button
+          class="rounded-xl bg-blue-600 px-4 py-2 text-sm font-semibold text-white transition hover:bg-blue-700 disabled:cursor-not-allowed disabled:opacity-70"
+          :disabled="savingUser"
+          @click="saveEdit"
+        >
+          {{ savingUser ? 'Saving...' : 'Save changes' }}
+        </button>
+      </div>
+    </section>
+
+    <section class="overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-sm dark:border-slate-800 dark:bg-slate-900">
+      <div class="border-b border-slate-200 px-5 py-4 dark:border-slate-800">
+        <div class="flex items-center justify-between gap-3">
+          <div>
+            <h2 class="text-lg font-semibold">User list</h2>
+            <p class="text-sm text-slate-500 dark:text-slate-400">{{ totalUsers }} result(s).</p>
+          </div>
+          <div v-if="loading" class="text-sm text-slate-500">Loading...</div>
+        </div>
+      </div>
+
+      <div class="overflow-x-auto">
+        <table class="min-w-full divide-y divide-slate-200 dark:divide-slate-800">
+          <thead class="bg-slate-50 dark:bg-slate-950/40">
+            <tr>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">ID</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Username</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Email</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Role</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Status</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Created</th>
+              <th class="px-5 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Last login</th>
+              <th class="px-5 py-3 text-right text-xs font-medium uppercase tracking-wider text-slate-500">Actions</th>
+            </tr>
+          </thead>
+          <tbody class="divide-y divide-slate-200 dark:divide-slate-800">
+            <tr v-for="user in paginatedUsers" :key="user.id" class="transition hover:bg-slate-50 dark:hover:bg-slate-950/40">
+              <td class="px-5 py-4 text-sm">{{ user.id }}</td>
+              <td class="px-5 py-4 text-sm font-medium">{{ user.username }}</td>
+              <td class="px-5 py-4 text-sm text-slate-500">{{ user.email || '-' }}</td>
+              <td class="px-5 py-4 text-sm text-slate-500">{{ roleLabel(user) }}</td>
+              <td class="px-5 py-4 text-sm">
+                <span class="rounded-full px-2.5 py-1 text-xs font-medium" :class="statusMeta(user).className">
+                  {{ statusMeta(user).label }}
+                </span>
+              </td>
+              <td class="px-5 py-4 text-sm text-slate-500">{{ formatDate(user.created_at) }}</td>
+              <td class="px-5 py-4 text-sm text-slate-500">{{ formatDate(user.last_login) }}</td>
+              <td class="px-5 py-4">
+                <div class="flex items-center justify-end gap-2">
+                  <button class="rounded-lg p-2 text-blue-600 transition hover:bg-blue-50 dark:text-blue-400 dark:hover:bg-blue-950/40" @click="beginEdit(user)" title="Edit">
+                    <Icon icon="material-symbols:edit" class="h-4 w-4" />
+                  </button>
+                  <button
+                    class="rounded-lg p-2 text-emerald-600 transition hover:bg-emerald-50 dark:text-emerald-400 dark:hover:bg-emerald-950/40"
+                    @click="toggleActive(user, !Boolean(user.is_active))"
+                    :title="Boolean(user.is_active) ? 'Disable' : 'Enable'"
+                  >
+                    <Icon :icon="Boolean(user.is_active) ? 'material-symbols:pause-circle' : 'material-symbols:play-circle'" class="h-4 w-4" />
+                  </button>
+                  <button
+                    class="rounded-lg p-2 text-red-600 transition hover:bg-red-50 dark:text-red-400 dark:hover:bg-red-950/40"
+                    @click="removeUser(user)"
+                    :disabled="deletingUserId === user.id"
+                    title="Delete"
+                  >
+                    <Icon icon="material-symbols:delete" class="h-4 w-4" />
+                  </button>
+                </div>
+              </td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+
+      <div v-if="!loading && paginatedUsers.length === 0" class="px-5 py-14 text-center">
+        <Icon icon="material-symbols:search-off" class="mx-auto mb-3 h-14 w-14 text-slate-400" />
+        <p class="text-sm text-slate-500 dark:text-slate-400">No users matched the current filters.</p>
+      </div>
+    </section>
+
+    <section v-if="filteredUsers.length > pageSize" class="flex flex-wrap items-center justify-between gap-3 rounded-2xl border border-slate-200 bg-white px-5 py-4 shadow-sm dark:border-slate-800 dark:bg-slate-900">
+      <div class="text-sm text-slate-500 dark:text-slate-400">
+        Page <span class="font-semibold text-slate-900 dark:text-slate-100">{{ currentPage }}</span> / {{ totalPages }}
+      </div>
+      <div class="flex items-center gap-2">
+        <button
+          class="rounded-xl border border-slate-200 px-3 py-2 text-sm font-medium transition hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-50 dark:border-slate-700 dark:hover:bg-slate-800"
+          :disabled="currentPage === 1"
+          @click="changePage(currentPage - 1)"
+        >
+          Previous
+        </button>
+        <button
+          class="rounded-xl border border-slate-200 px-3 py-2 text-sm font-medium transition hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-50 dark:border-slate-700 dark:hover:bg-slate-800"
+          :disabled="currentPage === totalPages"
+          @click="changePage(currentPage + 1)"
+        >
+          Next
+        </button>
+      </div>
+    </section>
+  </div>
+</template>
diff --git a/webapp/letapp/src/services/api.ts b/webapp/letapp/src/services/api.ts
new file mode 100644
index 0000000..53ad8e2
--- /dev/null
+++ b/webapp/letapp/src/services/api.ts
@@ -0,0 +1,205 @@
+type JsonValue = Record<string, unknown>;
+
+const API_BASE_URL = import.meta.env.VITE_API_BASE_URL ?? '/api';
+const TOKEN_STORAGE_KEYS = ['letapp_auth_token', 'letapp_token'] as const;
+const USER_STORAGE_KEYS = ['letapp_auth_user'] as const;
+
+function readStorage(keys: readonly string[]): string | null {
+  for (const key of keys) {
+    const sessionValue = sessionStorage.getItem(key);
+    if (sessionValue) {
+      return sessionValue;
+    }
+
+    const localValue = localStorage.getItem(key);
+    if (localValue) {
+      return localValue;
+    }
+  }
+
+  return null;
+}
+
+export function getAuthToken(): string | null {
+  return readStorage(TOKEN_STORAGE_KEYS);
+}
+
+export function setAuthToken(token: string, remember = false): void {
+  const storage = remember ? localStorage : sessionStorage;
+  storage.setItem(TOKEN_STORAGE_KEYS[0], token);
+  const oppositeStorage = remember ? sessionStorage : localStorage;
+  oppositeStorage.removeItem(TOKEN_STORAGE_KEYS[0]);
+  oppositeStorage.removeItem(TOKEN_STORAGE_KEYS[1]);
+}
+
+export function clearAuthToken(): void {
+  TOKEN_STORAGE_KEYS.forEach((key) => {
+    localStorage.removeItem(key);
+    sessionStorage.removeItem(key);
+  });
+}
+
+export function setAuthUser(user: unknown, remember = false): void {
+  const storage = remember ? localStorage : sessionStorage;
+  storage.setItem(USER_STORAGE_KEYS[0], JSON.stringify(user));
+  const oppositeStorage = remember ? sessionStorage : localStorage;
+  oppositeStorage.removeItem(USER_STORAGE_KEYS[0]);
+}
+
+export function getAuthUser<T = unknown>(): T | null {
+  const value = readStorage(USER_STORAGE_KEYS);
+  if (!value) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(value) as T;
+  } catch {
+    return null;
+  }
+}
+
+export function clearAuthUser(): void {
+  USER_STORAGE_KEYS.forEach((key) => {
+    localStorage.removeItem(key);
+    sessionStorage.removeItem(key);
+  });
+}
+
+export function clearAuthSession(): void {
+  clearAuthToken();
+  clearAuthUser();
+}
+
+async function parseResponse<T>(response: Response): Promise<T> {
+  if (response.status === 204) {
+    return null as T;
+  }
+
+  const text = await response.text();
+  if (!text) {
+    return null as T;
+  }
+
+  try {
+    return JSON.parse(text) as T;
+  } catch {
+    return text as T;
+  }
+}
+
+export async function apiRequest<T>(path: string, init: RequestInit = {}): Promise<T> {
+  const headers = new Headers(init.headers ?? {});
+
+  if (init.body && !(init.body instanceof FormData) && !headers.has('Content-Type')) {
+    headers.set('Content-Type', 'application/json');
+  }
+
+  const token = getAuthToken();
+  if (token && !headers.has('Authorization')) {
+    headers.set('Authorization', `Bearer ${token}`);
+  }
+
+  const response = await fetch(`${API_BASE_URL}${path}`, {
+    ...init,
+    headers,
+  });
+
+  const data = await parseResponse<T>(response);
+
+  if (!response.ok) {
+    const errorMessage =
+      (data as JsonValue | null)?.error ||
+      (data as JsonValue | null)?.message ||
+      response.statusText ||
+      'Request failed';
+    throw new Error(String(errorMessage));
+  }
+
+  return data;
+}
+
+export type UserSession = {
+  user: Record<string, unknown>;
+  token: string;
+};
+
+export type LoginResult = {
+  user: Record<string, unknown>;
+  token: string;
+  message?: string;
+};
+
+export type AppUser = {
+  id: number;
+  username: string;
+  email?: string | null;
+  is_active?: boolean;
+  last_login?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+};
+
+export type Course = {
+  id: number;
+  title: string;
+  description: string;
+  cover_url?: string | null;
+  is_active?: boolean;
+  created_at?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+};
+
+export type Question = {
+  id: number;
+  title: string;
+  intro?: string | null;
+  difficulty: number;
+  testcode?: string | null;
+  lang: string;
+  created_at?: string | null;
+  updated_at?: string | null;
+  [key: string]: unknown;
+};
+
+export async function loginUser(payload: { identifier: string; password: string }) {
+  return apiRequest<LoginResult>('/user/login', {
+    method: 'POST',
+    body: JSON.stringify(payload),
+  });
+}
+
+export async function runCode(payload: { code: string; language: string; stdin?: string }, useAuth = false) {
+  const path = useAuth ? '/code/run' : '/code/run/public';
+  return apiRequest<{ stdout?: string; stderr?: string; message?: string }>(path, {
+    method: 'POST',
+    body: JSON.stringify(payload),
+  });
+}
+
+export async function listUsers() {
+  return apiRequest<Array<AppUser>>('/user');
+}
+
+export async function updateUser(userId: number, payload: Record<string, unknown>) {
+  return apiRequest<AppUser>(`/user/${userId}`, {
+    method: 'PUT',
+    body: JSON.stringify(payload),
+  });
+}
+
+export async function deleteUser(userId: number) {
+  return apiRequest<null>(`/user/${userId}`, {
+    method: 'DELETE',
+  });
+}
+
+export async function listCourses() {
+  return apiRequest<Array<Course>>('/courses');
+}
+
+export async function listQuestions() {
+  return apiRequest<Array<Question>>('/questions');
+}
diff --git a/webapp/letapp/vite.config.ts b/webapp/letapp/vite.config.ts
index fff7f3f..ca59001 100644
--- a/webapp/letapp/vite.config.ts
+++ b/webapp/letapp/vite.config.ts
@@ -5,4 +5,13 @@ import tailwindcss from "@tailwindcss/vite";
 // https://vite.dev/config/
 export default defineConfig({
     plugins: [vue(), tailwindcss()],
+    server: {
+        proxy: {
+            '/api': {
+                target: 'http://127.0.0.1:6173',
+                changeOrigin: true,
+                rewrite: (path) => path.replace(/^\/api/, ''),
+            },
+        },
+    },
 })
-- 
Gitee