Merge PR #18: overhaul registration flow with questionnaire enforcement, LLM scoring, bug fixes (v1.2.8)

Author: Starry-cbz

README.md

@@ -66,6 +66,30 @@
 2. Start the server to auto-generate config files, then edit `config.yml` as needed (see full example below).
 3. Restart the server and visit `http://your_server_ip:8080` to access the admin panel.
 
+### ✅ Recommended Minimum Environment
+
+- Java 17+
+- Bukkit/Spigot/Paper/Folia 1.20+
+- A public domain with HTTPS enabled (recommended for production)
+- SMTP mailbox account (required when using `email` verification)
+
+### ⚡ 5-Minute Quick Start
+
+1. Set `auth_methods: [captcha]` in `config.yml` (fastest setup, no SMTP required).
+2. Set `whitelist_mode: plugin` and `web_register_url: https://your-domain.com/`.
+3. Configure `admin.password` to a strong password.
+4. (Optional) Enable `register.auto_approve: true` for small private servers.
+5. Restart the server and open `http://your_server_ip:8080`.
+
+### 🧪 Build from Source
+
+```bash
+cd plugin
+mvn clean package
+```
+
+Output jar: `plugin/target/verifymc-<version>.jar`
+
 ```yaml
 # ----------------------------------------
 # General Settings
@@ -269,6 +293,8 @@ questionnaire:
   pass_score: 60
   # Auto-approve users who pass the questionnaire
   auto_approve_on_pass: false
+  # Whether users must pass questionnaire before registration is allowed
+  require_pass_before_register: false
 
 # ----------------------------------------
 # Discord Integration (OAuth2)

README_zh.md

@@ -72,6 +72,30 @@
 2. 启动服务器自动生成配置文件，按需编辑 `config.yml`（见下方完整示例）。
 3. 重启服务器，访问 `http://你的服务器IP:8080` 进入管理后台。
 
+### ✅ 建议最低环境
+
+- Java 17+
+- Bukkit/Spigot/Paper/Folia 1.20+
+- 可公网访问并启用 HTTPS 的域名（生产环境强烈建议）
+- SMTP 邮箱账号（当使用 `email` 验证方式时必需）
+
+### ⚡ 5 分钟快速开始
+
+1. 在 `config.yml` 中设置 `auth_methods: [captcha]`（最快启动方式，无需 SMTP）。
+2. 设置 `whitelist_mode: plugin` 和 `web_register_url: https://your-domain.com/`。
+3. 将 `admin.password` 修改为强密码。
+4. （可选）小型私服可开启 `register.auto_approve: true`。
+5. 重启服务器并访问 `http://你的服务器IP:8080`。
+
+### 🧪 从源码构建
+
+```bash
+cd plugin
+mvn clean package
+```
+
+产物 jar：`plugin/target/verifymc-<version>.jar`
+
 ```yaml
 # ----------------------------------------
 # 全局设置

frontend/glassx/src/components/AdminReviewPanel.vue

@@ -43,6 +43,8 @@
               <th class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.username') }}</th>
               <th class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.email') }}</th>
               <th class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.register_time') }}</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.questionnaire_score') }}</th>
+              <th class="px-6 py-3 text-left text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.questionnaire_reason') }}</th>
               <th class="px-6 py-3 text-right text-xs font-medium text-gray-400 uppercase tracking-wider">{{ $t('admin.review.table.actions') }}</th>
             </tr>
           </thead>
@@ -63,7 +65,17 @@
               </td>
               <td class="px-6 py-4 whitespace-nowrap">
                 <div class="text-sm text-gray-300">
-                  {{ formatDate(user.registerTime) }}
+                  {{ formatDate(user.regTime || user.registerTime) }}
+                </div>
+              </td>
+              <td class="px-6 py-4 whitespace-nowrap">
+                <div class="text-sm text-gray-300">
+                  {{ user.questionnaire_score ?? '-' }}
+                </div>
+              </td>
+              <td class="px-6 py-4">
+                <div class="text-sm text-gray-300 max-w-[360px] break-words">
+                  {{ user.questionnaire_review_summary || '-' }}
                 </div>
               </td>
               <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
@@ -168,7 +180,8 @@ const rejectModal = ref({
   processing: false
 })
 
-const formatDate = (dateString: string) => {
+const formatDate = (dateString?: string | number | null) => {
+  if (!dateString) return "-"
   return new Date(dateString).toLocaleString()
 }
 

frontend/glassx/src/components/AnimatedMenuBar.vue

@@ -81,36 +81,51 @@ const route = useRoute()
 const hoveredIndex = ref<number | null>(null)
 const isNavHovered = ref(false)
 
-const menuItems = computed(() => [
-  {
-    icon: Home,
-    label: t('nav.home'),
-    href: '/',
-    gradient: 'radial-gradient(circle, rgba(59,130,246,0.15) 0%, rgba(37,99,235,0.06) 50%, rgba(29,78,216,0) 100%)',
-    iconColor: 'text-blue-500',
-  },
-  {
-    icon: UserPlus,
-    label: t('nav.register'),
-    href: '/register',
-    gradient: 'radial-gradient(circle, rgba(249,115,22,0.15) 0%, rgba(234,88,12,0.06) 50%, rgba(194,65,12,0) 100%)',
-    iconColor: 'text-orange-500',
-  },
-  {
-    icon: LogIn,
-    label: t('nav.login'),
-    href: '/login',
-    gradient: 'radial-gradient(circle, rgba(34,197,94,0.15) 0%, rgba(22,163,74,0.06) 50%, rgba(21,128,61,0) 100%)',
-    iconColor: 'text-green-500',
-  },
-  {
-    icon: Settings,
-    label: t('nav.admin'),
-    href: '/admin',
-    gradient: 'radial-gradient(circle, rgba(239,68,68,0.15) 0%, rgba(220,38,38,0.06) 50%, rgba(185,28,28,0) 100%)',
-    iconColor: 'text-red-500',
-  },
-])
+const isAdminLoggedIn = computed(() => {
+  // 绑定路由，确保登录/跳转后菜单可及时响应
+  route.fullPath
+  return !!localStorage.getItem('admin_token')
+})
+
+const menuItems = computed(() => {
+  const items = [
+    {
+      icon: Home,
+      label: t('nav.home'),
+      href: '/',
+      gradient: 'radial-gradient(circle, rgba(59,130,246,0.15) 0%, rgba(37,99,235,0.06) 50%, rgba(29,78,216,0) 100%)',
+      iconColor: 'text-blue-500',
+    },
+  ]
+
+  if (isAdminLoggedIn.value) {
+    items.push({
+      icon: Settings,
+      label: t('nav.admin'),
+      href: '/admin',
+      gradient: 'radial-gradient(circle, rgba(239,68,68,0.15) 0%, rgba(220,38,38,0.06) 50%, rgba(185,28,28,0) 100%)',
+      iconColor: 'text-red-500',
+    })
+  } else {
+    items.push({
+      icon: UserPlus,
+      label: t('nav.register'),
+      href: '/register',
+      gradient: 'radial-gradient(circle, rgba(249,115,22,0.15) 0%, rgba(234,88,12,0.06) 50%, rgba(194,65,12,0) 100%)',
+      iconColor: 'text-orange-500',
+    })
+
+    items.push({
+      icon: LogIn,
+      label: t('nav.login'),
+      href: '/login',
+      gradient: 'radial-gradient(circle, rgba(34,197,94,0.15) 0%, rgba(22,163,74,0.06) 50%, rgba(21,128,61,0) 100%)',
+      iconColor: 'text-green-500',
+    })
+  }
+
+  return items
+})
 
 const isActive = (href: string) => {
   if (href === '/') {
@@ -321,4 +336,4 @@ const isActive = (href: string) => {
     display: none !important;
   }
 }
-</style>
+</style>

frontend/glassx/src/components/HeroGeometric.vue

@@ -59,7 +59,7 @@
         <!-- Action buttons -->
         <div class="fade-up-item" style="--delay: 0.6s">
           <div class="flex flex-col sm:flex-row gap-4 justify-center items-center">
-            <router-link to="/register" class="register-button group">
+            <router-link v-if="!isAdminLoggedIn" to="/register" class="register-button group">
               <span class="button-glow"></span>
               <span class="button-content">
                 <svg class="w-5 h-5 transition-transform duration-300 group-hover:scale-110" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -71,15 +71,15 @@
               <span class="button-shine"></span>
             </router-link>
 
-            <router-link to="/admin" class="glass-button group">
+            <router-link :to="secondaryAction.href" class="glass-button group">
               <svg class="w-5 h-5 transition-transform duration-300 group-hover:rotate-90" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                   d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z">
                 </path>
                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
                   d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"></path>
               </svg>
-              <span>{{ $t('nav.admin') }}</span>
+              <span>{{ secondaryAction.label }}</span>
             </router-link>
           </div>
         </div>
@@ -94,8 +94,10 @@
 <script setup lang="ts">
 import { inject, computed, watch } from 'vue'
 import { useI18n } from 'vue-i18n'
+import { useRoute } from 'vue-router'
 
 const { t } = useI18n()
+const route = useRoute()
 const config = inject('config', { value: {} as any })
 
 interface Props {
@@ -124,6 +126,25 @@ const announcement = computed(() => {
   return config.value?.frontend?.announcement || ''
 })
 
+const isAdminLoggedIn = computed(() => {
+  route.fullPath
+  return !!localStorage.getItem('admin_token')
+})
+
+const secondaryAction = computed(() => {
+  if (isAdminLoggedIn.value) {
+    return {
+      href: '/admin',
+      label: t('nav.admin')
+    }
+  }
+
+  return {
+    href: '/login',
+    label: t('nav.login')
+  }
+})
+
 // 监听配置变化
 watch(() => config.value?.frontend?.web_server_prefix, (newPrefix) => {
   if (newPrefix) {
@@ -374,4 +395,4 @@ watch(() => config.value?.frontend?.web_server_prefix, (newPrefix) => {
     min-height: -webkit-fill-available;
   }
 }
-</style>
+</style>