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 通过
This commit is contained in:
2026-08-29 22:43:27 +08:00
parent f70b344c85
commit ae45aba607
46 changed files with 2878 additions and 0 deletions
+33
View File
@@ -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>
+11
View File
@@ -0,0 +1,11 @@
import axios from 'axios'
// Axios 实例:baseURL 为 /api/v1Vite dev proxy 转发到 Go 后端;
// 生产由 go:embed 同源提供)。M1 起在此统一拦截 401 / 错误码。
const http = axios.create({
baseURL: '/api/v1',
timeout: 15000,
withCredentials: true, // cookie 会话
})
export default http
+7
View File
@@ -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
}
+14
View File
@@ -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')
+15
View File
@@ -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
+32
View File
@@ -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 M0Go (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>