feat(M0): 工程骨架 — Go 后端 + Vue3 前端脚手架

- Go 工程：cmd/usernode CLI（serve/migrate/admin create/reset-password/user otp） + internal/{config,model,service,system,auth,cron,api,router,server,pkg,webui} - 配置：TOML + 环境变量覆盖（USERNODE_<SEC>_<FIELD>），config.example.toml - 数据：GORM 双驱动（SQLite/MySQL）8 表模型，migrate 子命令可跑通 - 系统层：system.Manager 接口（useradd/userdel/passwd 白名单，dev dry-run） - HTTP：Gin 路由骨架（/api/v1 + 501 占位），healthz，slog 结构化日志，优雅启停 - 前端：Vite + Vue3 + TS + Element Plus 最小可运行（web/），go:embed 打通 - 构建：deploy/Containerfile 多阶段单二进制镜像，web/Containerfile.dev 前端 dev 镜像，Makefile（build/test/dev/web-build/image）；go.mod 锁定 go 1.22 - 验证：go build/vet/test 通过；podman 镜像构建运行 healthz+embed 通过
2026-08-29 22:43:27 +08:00
parent f70b344c85
commit ae45aba607
46 changed files with 2878 additions and 0 deletions
@@ -0,0 +1,4 @@
+node_modules
+dist
+.vite
+*.log
@@ -0,0 +1,39 @@
+# 前端开发镜像（podman 热开发）
+#
+# 构建（走代理时）：
+#   podman build -t ws-usernode-web-dev \
+#     --build-arg HTTP_PROXY=http://10.62.25.123:7897 \
+#     --build-arg HTTPS_PROXY=http://10.62.25.123:7897 \
+#     --build-arg ALL_PROXY=http://10.62.25.123:7897 \
+#     -f web/Containerfile.dev web/
+#
+# 运行：
+#   podman run --rm -p 5173:5173 \
+#     -v $PWD/web:/app -v web_node_modules:/app/node_modules \
+#     -e VITE_API_PROXY=http://host.containers.internal:8080 \
+#     ws-usernode-web-dev
+#
+# 说明：-v 挂载源码热更新；named volume 缓存 node_modules 避免每次重装。
+#       容器内无 proxychains，代理须经 --build-arg 传入。
+
+FROM node:20-alpine
+ARG HTTP_PROXY=
+ARG HTTPS_PROXY=
+ARG ALL_PROXY=
+ARG NO_PROXY=
+ENV HTTP_PROXY=$HTTP_PROXY \
+    HTTPS_PROXY=$HTTPS_PROXY \
+    ALL_PROXY=$ALL_PROXY \
+    NO_PROXY=$NO_PROXY
+
+WORKDIR /app
+
+# 先复制依赖清单，利用层缓存
+COPY package.json package-lock.json* ./
+RUN npm install
+
+COPY . .
+
+EXPOSE 5173
+
+CMD ["npm", "run", "dev"]
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ws_usernode 用户管理</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
@@ -0,0 +1,26 @@
+{
+  "name": "ws-usernode-web",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "typecheck": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "element-plus": "^2.9.3",
+    "pinia": "^2.3.1",
+    "vue": "^3.5.13",
+    "vue-router": "^4.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@vitejs/plugin-vue": "^5.2.1",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.11",
+    "vue-tsc": "^2.2.0"
+  }
+}
@@ -0,0 +1,33 @@
+<script setup lang="ts">
+// 骨架阶段根组件：展示项目名与健康检查状态。
+// M1 起替换为登录页 + 主布局（侧边导航、用户管理、审批、审计等页面）。
+</script>
+
+<template>
+  <el-config-provider>
+    <el-container class="app-shell">
+      <el-header class="app-header">
+        <span class="app-title">ws_usernode 服务器用户管理节点</span>
+      </el-header>
+      <el-main>
+        <router-view />
+      </el-main>
+    </el-container>
+  </el-config-provider>
+</template>
+
+<style scoped>
+.app-shell {
+  min-height: 100vh;
+}
+.app-header {
+  display: flex;
+  align-items: center;
+  border-bottom: 1px solid var(--el-border-color);
+  background: var(--el-bg-color);
+}
+.app-title {
+  font-weight: 600;
+  font-size: 16px;
+}
+</style>
@@ -0,0 +1,11 @@
+import axios from 'axios'
+
+// Axios 实例：baseURL 为 /api/v1（Vite dev proxy 转发到 Go 后端；
+// 生产由 go:embed 同源提供）。M1 起在此统一拦截 401 / 错误码。
+const http = axios.create({
+  baseURL: '/api/v1',
+  timeout: 15000,
+  withCredentials: true, // cookie 会话
+})
+
+export default http
@@ -0,0 +1,7 @@
+/// <reference types="vite/client" />
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<Record<string, unknown>, Record<string, unknown>, unknown>
+  export default component
+}
@@ -0,0 +1,14 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import ElementPlus from 'element-plus'
+import zhCn from 'element-plus/es/locale/lang/zh-cn'
+import 'element-plus/dist/index.css'
+
+import App from './App.vue'
+import router from './router'
+
+const app = createApp(App)
+app.use(createPinia())
+app.use(router)
+app.use(ElementPlus, { locale: zhCn })
+app.mount('#app')
@@ -0,0 +1,15 @@
+import { createRouter, createWebHistory } from 'vue-router'
+
+// 骨架阶段：仅首页（占位）。M1 起增加 /login、/admin/*、/me 等路由并做鉴权守卫。
+const router = createRouter({
+  history: createWebHistory(),
+  routes: [
+    {
+      path: '/',
+      name: 'home',
+      component: () => import('@/views/HomeView.vue'),
+    },
+  ],
+})
+
+export default router
@@ -0,0 +1,32 @@
+<script setup lang="ts">
+import { onMounted, ref } from 'vue'
+import { ElMessage } from 'element-plus'
+
+const backendOk = ref<boolean | null>(null)
+
+onMounted(async () => {
+  try {
+    const resp = await fetch('/healthz')
+    backendOk.value = resp.ok
+  } catch {
+    backendOk.value = false
+  }
+})
+</script>
+
+<template>
+  <el-card shadow="never">
+    <template #header>
+      <b>工程骨架已就绪</b>
+    </template>
+    <p>ws_usernode M0：Go (Gin + GORM) 后端与 Vue3 前端脚手架已打通，API 前缀 <code>/api/v1</code>。</p>
+    <p>
+      后端健康检查：
+      <el-tag :type="backendOk === null ? 'info' : backendOk ? 'success' : 'danger'">
+        {{ backendOk === null ? '检测中…' : backendOk ? '正常' : '不可达（请先启动 Go 后端）' }}
+      </el-tag>
+    </p>
+    <el-divider />
+    <el-text type="info">登录 / 用户管理 / 密钥 / 审批 / 审计页面将在 M1 起逐步落地。</el-text>
+  </el-card>
+</template>
@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "jsx": "preserve",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": ["vite/client", "node"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.vue", "vite.config.ts"]
+}
@@ -0,0 +1,32 @@
+import { fileURLToPath, URL } from 'node:url'
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+// 开发期：Vite dev server 监听 5173；API 请求 /api 代理到 Go 后端
+// （默认 127.0.0.1:8080，可用 VITE_API_PROXY 覆盖）。
+export default defineConfig({
+  plugins: [vue()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
+  server: {
+    host: '0.0.0.0',
+    port: 5173,
+    proxy: {
+      '/api': {
+        target: process.env.VITE_API_PROXY || 'http://127.0.0.1:8080',
+        changeOrigin: true,
+      },
+      '/healthz': {
+        target: process.env.VITE_API_PROXY || 'http://127.0.0.1:8080',
+        changeOrigin: true,
+      },
+    },
+  },
+  build: {
+    outDir: 'dist',
+    sourcemap: false,
+  },
+})