iotlcm-public/website
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

style(portal): 重做整站排版，改为落地页式布局
mirror-to-gitee / mirror (push) Successful in 5s
Details

Browse Source 
排版语言
- 引入独立视觉系统 .vitepress/theme/styles/portal.css：
  中性底色 + 单一强调色（#4f46e5），正文靠留白与层级取胜，
  不使用大面积彩色底、渐变铺满或装饰性图形
- CSS 变量定义在 :root（原先挂在 .portal 下，导致内容页拿不到值）
- 完整支持暗色模式，变量在 html.dark 下整体替换

首页（pages/index.md → HomePage.vue）
- hero：居中大标题（强调色渐变仅作用于一个词组）、双按钮、四格数据条
- 项目区：三栏卡片，标题 + 状态徽标 + 定位 + 说明 + 技术栈标签
- 通用能力：六格编号卡片
- 组合方式：三栏场景步骤卡，每张带一条可复制命令
- 底部 CTA 区块
- 页面改用 layout: page，通过 Layout 包装层去掉默认窄栏

项目详情页
- iotLCM / DTU：能力矩阵改为标签切换（CapabilityTabs），
  每个业务域一屏，点击切换，替代原先的大宽表
- XiuAdmin：22 项内置功能按用途归为四组标签墙（FeatureGrid）
- 内容页二级标题加短强调线，表格首列不换行，属性表不再竖排

数据
- 新增 data/content.ts 承载首页文案、能力分组、长期事实统计，
  与 projects.ts 并列；文案口径取自各项目 README/详情页，无凭空数字
- 修正 scripts/check-registry.mjs：原先扫描 data/ 下所有 .ts 的 id，
  新增 content.ts 后把业务分组 id 误判为项目；改为只读 projects.ts

验证
- 构建通过，12 个页面，193 条引用 0 失效
- HTTP 实测 12 个路径全 200，不存在路径 404
- 暗色模式与移动端（390px）已截图核对，无横向溢出
This commit is contained in:
Dai0814
2026-11-04 14:13:50 +08:00
parent 1d67fc7082
commit ac1354da9e
16 changed files with 1286 additions and 219 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitignore
+8
View File
@@ -4,3 +4,11 @@ node_modules
.vitepress/.temp
dist
*.log
# 本地构建产物（多形态验证用）
.vitepress/dist-build*
.vitepress/final
# 本地构建产物（多形态验证用）
.vitepress/dist-build*
.vitepress/final
.vitepress/theme/components/CapabilityTabs.vue
+54
View File
@@ -0,0 +1,54 @@
<script setup lang="ts">
import { ref, computed } from 'vue'
import { iotlcmGroups, dtuGroups, type CapGroup } from '../../../data/content'
const props = defineProps<{ source?: 'iotlcm' | 'dtu' }>()
const groups: CapGroup[] = props.source === 'dtu' ? dtuGroups : iotlcmGroups
const active = ref(groups[0]?.id ?? '')
const current = computed(() => groups.find((g) => g.id === active.value) ?? groups[0])
</script>
<template>
<div class="cap-tabs">
<div class="p-tabs" role="tablist">
<button
v-for="g in groups"
:key="g.id"
class="p-tab"
:class="{ 'is-active': g.id === active }"
role="tab"
:aria-selected="g.id === active"
@click="active = g.id"
>
{{ g.name }}
</button>
</div>
<p v-if="current" class="cap-intro">{{ current.intro }}</p>
<div v-if="current" :key="current.id" class="p-grid p-grid--3 cap-grid">
<div v-for="(item, i) in current.items" :key="item.title" class="p-card">
<span class="p-card-index">{{ String(i + 1).padStart(2, '0') }}</span>
<h3 class="p-card-title">{{ item.title }}</h3>
<p class="p-card-text">{{ item.text }}</p>
</div>
</div>
</div>
</template>
<style scoped>
.cap-intro {
max-width: 760px;
margin: 0 auto 36px;
text-align: center;
font-size: 15px;
line-height: 1.8;
color: var(--p-ink-2);
}
.cap-grid {
transition: opacity 0.2s ease;
}
</style>
.vitepress/theme/components/FeatureGrid.vue
+75
View File
@@ -0,0 +1,75 @@
<script setup lang="ts">
import { adminGroups } from '../../../data/content'
</script>
<template>
<div class="feat-grid">
<section v-for="g in adminGroups" :key="g.name" class="feat-group">
<h3 class="feat-group-name">{{ g.name }}</h3>
<ul class="feat-items">
<li v-for="item in g.items" :key="item">{{ item }}</li>
</ul>
</section>
</div>
</template>
<style scoped>
.feat-grid {
display: grid;
grid-template-columns: repeat(2, 1fr);
gap: 20px;
margin: 28px 0 8px;
}
.feat-group {
padding: 24px 26px;
background: var(--p-surface-alt);
border: 1px solid var(--p-line);
border-radius: var(--p-radius);
}
.feat-group-name {
display: flex;
align-items: center;
gap: 10px;
margin: 0 0 16px;
padding: 0;
font-size: 14.5px;
font-weight: 650;
letter-spacing: 0.01em;
color: var(--p-ink);
}
.feat-group-name::before {
content: '';
flex: none;
width: 3px;
height: 14px;
border-radius: 2px;
background: var(--p-accent);
}
.feat-items {
margin: 0;
padding: 0;
list-style: none;
display: flex;
flex-wrap: wrap;
gap: 8px;
}
.feat-items li {
padding: 7px 13px;
font-size: 13.5px;
color: var(--p-ink);
background: var(--p-surface);
border: 1px solid var(--p-line-strong);
border-radius: 8px;
}
@media (max-width: 720px) {
.feat-grid {
grid-template-columns: 1fr;
}
}
</style>
.vitepress/theme/components/HomePage.vue
+134
View File
@@ -0,0 +1,134 @@
<script setup lang="ts">
import { ref } from 'vue'
import { projects } from '../../../data/projects'
import { stats, foundations } from '../../../data/content'
</script>
<template>
<div class="portal">
<!-- Hero -->
<section class="p-hero">
<div class="p-wrap">
<span class="p-eyebrow">APACHE-2.0 · 开源项目门户</span>
<h1 class="p-hero-title">物联网与中后台<em>基础软件</em></h1>
<p class="p-hero-sub">
雪羊科技对外开源的项目集合。物联网卡管理、DTU 设备管理、中后台开发底座，
同一套工程规范，同一个许可证，clone 之后就能跑起来。
</p>
<div class="p-hero-actions">
<a class="p-btn p-btn--primary" href="/projects/">
浏览全部项目
<svg width="14" height="14" viewBox="0 0 16 16" fill="none" aria-hidden="true">
<path d="M3 8h10M9 4l4 4-4 4" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" />
</svg>
</a>
<a class="p-btn p-btn--ghost" href="/projects/iotlcm/guide/quickstart">快速开始</a>
</div>
<div class="p-stats">
<div v-for="s in stats" :key="s.label" class="p-stat">
<span class="p-stat-num">{{ s.num }}<span v-if="s.unit">{{ s.unit }}</span></span>
<span class="p-stat-label">{{ s.label }}</span>
</div>
</div>
</div>
</section>
<!-- 项目 -->
<section class="p-section p-section--alt" id="projects">
<div class="p-wrap">
<header class="p-head">
<span class="p-eyebrow">PROJECTS</span>
<h2 class="p-title">三个可直接投入使用的项目</h2>
<p class="p-desc">
都已在生产环境验证，都能单机一条命令启动。按需取用，也可以组合成一套完整方案。
</p>
</header>
<div class="p-grid p-grid--3">
<a v-for="p in projects" :key="p.id" :href="p.page" class="p-proj">
<div class="p-proj-top">
<h3 class="p-proj-name">{{ p.name }}</h3>
<span class="p-badge">{{ p.status }}</span>
</div>
<p class="p-proj-tagline">{{ p.tagline }}</p>
<p class="p-proj-summary">{{ p.summary }}</p>
<ul class="p-tags">
<li v-for="t in p.tech.slice(0, 4)" :key="t">{{ t }}</li>
</ul>
<div class="p-proj-foot">
<span>{{ p.license }}</span>
<span class="p-proj-more">查看详情 →</span>
</div>
</a>
</div>
</div>
</section>
<!-- 通用能力 -->
<section class="p-section">
<div class="p-wrap">
<header class="p-head">
<span class="p-eyebrow">FOUNDATION</span>
<h2 class="p-title">三个项目共享同一套工程底座</h2>
<p class="p-desc">
不是各自为战的三个仓库。技术栈、部署方式、权限模型与文档规范保持一致，
学会一个就大致知道另外两个怎么用。
</p>
</header>
<div class="p-grid p-grid--3">
<div v-for="(f, i) in foundations" :key="f.title" class="p-card">
<span class="p-card-index">{{ String(i + 1).padStart(2, '0') }}</span>
<h3 class="p-card-title">{{ f.title }}</h3>
<p class="p-card-text">{{ f.text }}</p>
</div>
</div>
</div>
</section>
<!-- 组合方式 -->
<section class="p-section p-section--alt">
<div class="p-wrap">
<header class="p-head">
<span class="p-eyebrow">HOW THEY FIT</span>
<h2 class="p-title">三者可以单独用，也可以拼起来用</h2>
<p class="p-desc">按你的业务起点选一个入口，需要时再引入其它两个。</p>
</header>
<div class="p-steps">
<div class="p-step">
<span class="p-step-num">场景一</span>
<h3>只做物联网卡管理</h3>
<p>直接部署 iotLCM。它自带管理端与用户端，运营商协议内置，不需要额外组件。</p>
<code>cd iotlcm/deploy && docker compose up -d</code>
</div>
<div class="p-step">
<span class="p-step-num">场景二</span>
<h3>要管硬件设备</h3>
<p>部署秀杰 DTU。卡 + 设备的组合场景，两个平台可并存，数据各自独立。</p>
<code>cd xiu-dtu && 按 README 初始化</code>
</div>
<div class="p-step">
<span class="p-step-num">场景三</span>
<h3>自建业务系统</h3>
<p>以 XiuAdmin 作底座。租户、权限、代码生成、定时任务开箱可用，专注写业务。</p>
<code>从 xiu-admin 拉分支开始</code>
</div>
</div>
</div>
</section>
<!-- CTA -->
<section class="p-cta">
<div class="p-wrap">
<h2 class="p-title">从源码开始，不依赖任何商业授权</h2>
<p class="p-desc">全部项目以 Apache-2.0 发布，可自由使用、修改、商用与再分发。</p>
<div class="p-hero-actions">
<a class="p-btn p-btn--primary" href="/projects/">开始浏览项目</a>
<a class="p-btn p-btn--ghost" href="/about">许可证与贡献</a>
</div>
</div>
</section>
</div>
</template>
.vitepress/theme/components/ProjectCard.vue
+10 -98
View File
@@ -5,107 +5,19 @@ defineProps<{ project: Project }>()
</script>
<template>
<a :href="project.page" class="project-card">
<div class="project-card-head">
<h3>{{ project.name }}</h3>
<span class="project-status" :data-status="project.status">{{ project.status }}</span>
<a :href="project.page" class="p-proj">
<div class="p-proj-top">
<h3 class="p-proj-name">{{ project.name }}</h3>
<span class="p-badge">{{ project.status }}</span>
</div>
<p class="project-tagline">{{ project.tagline }}</p>
<p class="project-summary">{{ project.summary }}</p>
<ul class="project-tech">
<p class="p-proj-tagline">{{ project.tagline }}</p>
<p class="p-proj-summary">{{ project.summary }}</p>
<ul class="p-tags">
<li v-for="t in project.tech" :key="t">{{ t }}</li>
</ul>
<div class="project-foot">
<span class="project-license">{{ project.license }}</span>
<span class="project-link">查看详情 →</span>
<div class="p-proj-foot">
<span>{{ project.license }}</span>
<span class="p-proj-more">查看详情 →</span>
</div>
</a>
</template>
<style scoped>
.project-card {
display: block;
padding: 20px 22px;
border: 1px solid var(--vp-c-divider);
border-radius: 12px;
background: var(--vp-c-bg-soft);
color: var(--vp-c-text-1);
transition: border-color 0.2s, transform 0.2s;
}
.project-card:hover {
border-color: var(--vp-c-brand-1);
transform: translateY(-2px);
}
.project-card-head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
}
.project-card h3 {
margin: 0;
font-size: 20px;
border: none;
padding: 0;
}
.project-status {
flex: none;
font-size: 12px;
padding: 2px 10px;
border-radius: 999px;
border: 1px solid var(--vp-c-divider);
color: var(--vp-c-text-2);
}
.project-status[data-status='已发布'] {
border-color: var(--vp-c-brand-1);
color: var(--vp-c-brand-1);
}
.project-tagline {
margin: 8px 0 0;
font-weight: 600;
color: var(--vp-c-text-1);
}
.project-summary {
margin: 8px 0 0;
font-size: 14px;
line-height: 1.7;
color: var(--vp-c-text-2);
}
.project-tech {
display: flex;
flex-wrap: wrap;
gap: 6px;
margin: 14px 0 0;
padding: 0;
list-style: none;
}
.project-tech li {
font-size: 12px;
padding: 2px 8px;
border-radius: 6px;
background: var(--vp-c-default-soft);
color: var(--vp-c-text-2);
}
.project-foot {
display: flex;
align-items: center;
justify-content: space-between;
margin-top: 16px;
font-size: 13px;
color: var(--vp-c-text-3);
}
.project-link {
color: var(--vp-c-brand-1);
}
</style>
.vitepress/theme/components/ProjectList.vue
+11 -5
View File
@@ -4,16 +4,22 @@ import ProjectCard from './ProjectCard.vue'
</script>
<template>
<div class="project-list">
<div class="proj-list">
<ProjectCard v-for="p in projects" :key="p.id" :project="p" />
</div>
</template>
<style scoped>
.project-list {
.proj-list {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
gap: 16px;
margin: 24px 0 0;
grid-template-columns: repeat(auto-fit, minmax(340px, 1fr));
gap: 20px;
margin: 32px 0 56px;
}
@media (max-width: 720px) {
.proj-list {
grid-template-columns: 1fr;
}
}
</style>
.vitepress/theme/index.ts
+21
View File
@@ -1,11 +1,32 @@
import DefaultTheme from 'vitepress/theme'
import type { Theme } from 'vitepress'
import { h } from 'vue'
import { useData } from 'vitepress'
import ProjectList from './components/ProjectList.vue'
import HomePage from './components/HomePage.vue'
import CapabilityTabs from './components/CapabilityTabs.vue'
import FeatureGrid from './components/FeatureGrid.vue'
import './styles/portal.css'
/**
* 首页用 layout: page 承载自定义整页排版，
* 这里给它套一层 .portal-page，把默认窄栏与 padding 去掉。
*/
const PortalLayout = () => {
const { frontmatter } = useData()
const isPortal = frontmatter.value.layout === 'page'
return h('div', { class: isPortal ? 'portal-page' : '' }, h(DefaultTheme.Layout))
}
export default {
extends: DefaultTheme,
Layout: PortalLayout,
enhanceApp({ app }) {
app.component('ProjectList', ProjectList)
app.component('HomePage', HomePage)
app.component('CapabilityTabs', CapabilityTabs)
app.component('FeatureGrid', FeatureGrid)
},
} satisfies Theme
.vitepress/theme/styles/portal.css
+743
View File
@@ -0,0 +1,743 @@
/* ============================================================
雪羊科技开源门户 —— 视觉系统
独立的排版语言：中性底色 + 单一强调色，正文以留白和层级取胜。
============================================================ */
:root {
--p-accent: #4f46e5;
--p-accent-2: #06b6d4;
--p-accent-soft: rgba(79, 70, 229, 0.08);
--p-accent-line: rgba(79, 70, 229, 0.22);
--p-surface: #ffffff;
--p-surface-alt: #f7f8fb;
--p-line: rgba(15, 23, 42, 0.08);
--p-line-strong: rgba(15, 23, 42, 0.14);
--p-ink: #0f172a;
--p-ink-2: #475569;
--p-ink-3: #8a94a6;
--p-shadow: 0 1px 2px rgba(15, 23, 42, 0.04), 0 8px 24px -12px rgba(15, 23, 42, 0.12);
--p-shadow-hover: 0 1px 2px rgba(15, 23, 42, 0.05), 0 18px 40px -18px rgba(15, 23, 42, 0.22);
--p-radius: 16px;
--p-radius-sm: 10px;
--p-max: 1180px;
}
.portal {
color: var(--p-ink);
background: var(--p-surface);
}
html.dark {
--p-accent: #8b8bfa;
--p-accent-2: #45d3e8;
--p-accent-soft: rgba(139, 139, 250, 0.12);
--p-accent-line: rgba(139, 139, 250, 0.28);
--p-surface: #0c0f16;
--p-surface-alt: #11151e;
--p-line: rgba(255, 255, 255, 0.09);
--p-line-strong: rgba(255, 255, 255, 0.16);
--p-ink: #eef1f6;
--p-ink-2: #a8b2c4;
--p-ink-3: #6f7a8d;
--p-shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px -12px rgba(0, 0, 0, 0.5);
--p-shadow-hover: 0 1px 2px rgba(0, 0, 0, 0.35), 0 18px 40px -18px rgba(0, 0, 0, 0.7);
}
/* 让 page 布局摆脱默认窄栏，门户整页自管宽度 */
.portal-page .VPPage,
.portal-page .vp-doc.container {
max-width: none !important;
padding: 0 !important;
}
.portal-page .VPContent {
padding: 0 !important;
}
.portal-page .vp-doc > div > h1:first-child,
.portal-page .vp-doc > h1:first-child {
display: none;
}
.portal *,
.portal *::before,
.portal *::after {
box-sizing: border-box;
}
/* ---------- 容器与分区 ---------- */
.p-wrap {
max-width: var(--p-max);
margin: 0 auto;
padding: 0 28px;
}
.p-section {
padding: 96px 0;
border-top: 1px solid var(--p-line);
}
.p-section--alt {
background: var(--p-surface-alt);
}
.p-section--tight {
padding: 72px 0;
}
/* ---------- 区块标题（居中） ---------- */
.p-head {
max-width: 720px;
margin: 0 auto 56px;
text-align: center;
}
.p-head--left {
margin-left: 0;
text-align: left;
}
.p-eyebrow {
display: inline-flex;
align-items: center;
gap: 8px;
margin-bottom: 16px;
padding: 4px 12px;
font-size: 12px;
font-weight: 600;
letter-spacing: 0.06em;
color: var(--p-accent);
background: var(--p-accent-soft);
border: 1px solid var(--p-accent-line);
border-radius: 999px;
}
.p-title {
margin: 0;
font-size: 36px;
font-weight: 650;
line-height: 1.25;
letter-spacing: -0.02em;
color: var(--p-ink);
}
.p-desc {
margin: 16px 0 0;
font-size: 16px;
line-height: 1.75;
color: var(--p-ink-2);
}
@media (max-width: 720px) {
.p-section {
padding: 64px 0;
}
.p-title {
font-size: 26px;
}
.p-desc {
font-size: 15px;
}
.p-head {
margin-bottom: 36px;
}
}
/* ---------- Hero ---------- */
.p-hero {
position: relative;
padding: 104px 0 88px;
text-align: center;
overflow: hidden;
}
.p-hero::before {
content: '';
position: absolute;
inset: -40% -20% auto;
height: 620px;
background: radial-gradient(50% 50% at 50% 50%, var(--p-accent-soft) 0%, transparent 70%);
pointer-events: none;
}
.p-hero > .p-wrap {
position: relative;
}
.p-hero-title {
margin: 20px 0 0;
font-size: 60px;
font-weight: 700;
line-height: 1.1;
letter-spacing: -0.035em;
color: var(--p-ink);
}
.p-hero-title em {
font-style: normal;
background: linear-gradient(100deg, var(--p-accent), var(--p-accent-2));
-webkit-background-clip: text;
background-clip: text;
-webkit-text-fill-color: transparent;
}
.p-hero-sub {
margin: 22px auto 0;
max-width: 640px;
font-size: 17px;
line-height: 1.8;
color: var(--p-ink-2);
}
.p-hero-actions {
display: flex;
flex-wrap: wrap;
justify-content: center;
gap: 12px;
margin-top: 34px;
}
.p-btn {
display: inline-flex;
align-items: center;
gap: 8px;
height: 46px;
padding: 0 26px;
font-size: 15px;
font-weight: 600;
border-radius: 999px;
border: 1px solid transparent;
text-decoration: none !important;
transition: transform 0.15s, box-shadow 0.2s, background 0.2s, border-color 0.2s;
}
.p-btn:hover {
transform: translateY(-1px);
}
.p-btn--primary {
color: #fff !important;
background: var(--p-accent);
box-shadow: 0 8px 20px -8px var(--p-accent);
}
.p-btn--primary:hover {
box-shadow: 0 14px 28px -10px var(--p-accent);
}
.p-btn--ghost {
color: var(--p-ink) !important;
background: var(--p-surface);
border-color: var(--p-line-strong);
}
.p-btn--ghost:hover {
border-color: var(--p-accent);
color: var(--p-accent) !important;
}
@media (max-width: 720px) {
.p-hero {
padding: 56px 0 48px;
}
.p-hero-title {
font-size: 29px;
letter-spacing: -0.02em;
line-height: 1.28;
}
.p-hero-sub {
font-size: 14.5px;
line-height: 1.75;
margin-top: 18px;
}
.p-hero-actions {
margin-top: 26px;
}
.p-btn {
height: 44px;
padding: 0 22px;
font-size: 14.5px;
}
}
/* ---------- 数据条 ---------- */
.p-stats {
display: grid;
grid-template-columns: repeat(4, 1fr);
gap: 0;
max-width: 900px;
margin: 64px auto 0;
padding: 28px 0;
border-top: 1px solid var(--p-line);
border-bottom: 1px solid var(--p-line);
}
.p-stat {
text-align: center;
padding: 0 12px;
}
.p-stat + .p-stat {
border-left: 1px solid var(--p-line);
}
.p-stat-num {
display: block;
font-size: 34px;
font-weight: 700;
letter-spacing: -0.03em;
line-height: 1.1;
color: var(--p-ink);
}
.p-stat-num span {
font-size: 18px;
font-weight: 600;
color: var(--p-accent);
}
.p-stat-label {
display: block;
margin-top: 8px;
font-size: 13px;
color: var(--p-ink-3);
}
@media (max-width: 720px) {
.p-stats {
grid-template-columns: repeat(2, 1fr);
gap: 24px 0;
margin-top: 44px;
}
.p-stat:nth-child(3) {
border-left: none;
}
.p-stat-num {
font-size: 26px;
}
}
/* ---------- 通用卡片网格 ---------- */
.p-grid {
display: grid;
gap: 20px;
}
.p-grid--3 {
grid-template-columns: repeat(3, 1fr);
}
.p-grid--4 {
grid-template-columns: repeat(4, 1fr);
}
@media (max-width: 1024px) {
.p-grid--4 {
grid-template-columns: repeat(2, 1fr);
}
}
@media (max-width: 860px) {
.p-grid--3,
.p-grid--4 {
grid-template-columns: 1fr;
}
}
.p-card {
display: flex;
flex-direction: column;
padding: 28px 26px;
background: var(--p-surface);
border: 1px solid var(--p-line);
border-radius: var(--p-radius);
box-shadow: var(--p-shadow);
transition: transform 0.2s, box-shadow 0.2s, border-color 0.2s;
}
.p-card:hover {
transform: translateY(-3px);
border-color: var(--p-accent-line);
box-shadow: var(--p-shadow-hover);
}
.p-card-index {
display: inline-flex;
align-items: center;
justify-content: center;
width: 32px;
height: 32px;
margin-bottom: 16px;
font-size: 12px;
font-weight: 700;
letter-spacing: 0.02em;
color: var(--p-accent);
background: var(--p-accent-soft);
border-radius: 8px;
}
.p-card-title {
margin: 0;
font-size: 16px;
font-weight: 650;
line-height: 1.4;
color: var(--p-ink);
}
.p-card-text {
margin: 10px 0 0;
font-size: 14px;
line-height: 1.75;
color: var(--p-ink-2);
}
/* ---------- 标签切换 ---------- */
.p-tabs {
display: flex;
flex-wrap: wrap;
justify-content: center;
gap: 8px;
margin-bottom: 40px;
}
.p-tab {
height: 38px;
padding: 0 18px;
font-family: inherit;
font-size: 14px;
font-weight: 500;
color: var(--p-ink-2);
background: transparent;
border: 1px solid var(--p-line-strong);
border-radius: 999px;
cursor: pointer;
transition: all 0.18s;
}
.p-tab:hover {
color: var(--p-ink);
border-color: var(--p-ink-3);
}
.p-tab.is-active {
color: #fff;
background: var(--p-accent);
border-color: var(--p-accent);
}
html.dark .p-tab.is-active {
color: #0c0f16;
}
/* ---------- 左右图文 ---------- */
.p-split {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 64px;
align-items: center;
}
@media (max-width: 960px) {
.p-split {
grid-template-columns: 1fr;
gap: 40px;
}
}
.p-list {
margin: 28px 0 0;
padding: 0;
list-style: none;
}
.p-list li {
position: relative;
padding: 14px 0 14px 30px;
font-size: 15px;
line-height: 1.7;
color: var(--p-ink-2);
border-top: 1px solid var(--p-line);
}
.p-list li::before {
content: '';
position: absolute;
left: 4px;
top: 22px;
width: 7px;
height: 7px;
border-radius: 2px;
background: var(--p-accent);
}
.p-list strong {
color: var(--p-ink);
font-weight: 600;
}
/* ---------- 代码面板 ---------- */
.p-panel {
padding: 22px 24px;
font-family: var(--vp-font-family-mono);
font-size: 13px;
line-height: 1.9;
color: var(--p-ink-2);
background: var(--p-surface-alt);
border: 1px solid var(--p-line);
border-radius: var(--p-radius);
}
.p-panel .c {
color: var(--p-ink-3);
}
.p-panel .k {
color: var(--p-accent);
}
/* ---------- 步骤 ---------- */
.p-steps {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 20px;
margin-top: 8px;
}
@media (max-width: 860px) {
.p-steps {
grid-template-columns: 1fr;
}
}
.p-step {
padding: 26px;
background: var(--p-surface);
border: 1px solid var(--p-line);
border-radius: var(--p-radius);
}
.p-step-num {
display: inline-block;
font-size: 12px;
font-weight: 700;
letter-spacing: 0.08em;
color: var(--p-accent);
}
.p-step h3 {
margin: 10px 0 0;
font-size: 16px;
font-weight: 650;
color: var(--p-ink);
}
.p-step p {
margin: 8px 0 0;
font-size: 14px;
line-height: 1.75;
color: var(--p-ink-2);
}
.p-step code {
display: block;
margin-top: 14px;
padding: 10px 12px;
font-size: 12.5px;
color: var(--p-ink);
background: var(--p-surface-alt);
border: 1px solid var(--p-line);
border-radius: var(--p-radius-sm);
word-break: break-all;
white-space: pre-wrap;
}
/* ---------- 底部 CTA ---------- */
.p-cta {
text-align: center;
padding: 88px 0;
}
.p-cta .p-title {
font-size: 32px;
}
/* ---------- 项目卡片 ---------- */
.p-proj {
display: flex;
flex-direction: column;
padding: 30px 28px;
background: var(--p-surface);
border: 1px solid var(--p-line);
border-radius: var(--p-radius);
box-shadow: var(--p-shadow);
color: var(--p-ink) !important;
text-decoration: none !important;
transition: transform 0.2s, box-shadow 0.2s, border-color 0.2s;
}
.p-proj:hover {
transform: translateY(-3px);
border-color: var(--p-accent-line);
box-shadow: var(--p-shadow-hover);
}
.p-proj-top {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 12px;
}
.p-proj-name {
margin: 0;
font-size: 21px;
font-weight: 680;
letter-spacing: -0.01em;
color: var(--p-ink);
border: none;
padding: 0;
}
.p-badge {
flex: none;
padding: 3px 10px;
font-size: 11.5px;
font-weight: 600;
color: var(--p-accent);
background: var(--p-accent-soft);
border: 1px solid var(--p-accent-line);
border-radius: 999px;
}
.p-proj-tagline {
margin: 10px 0 0;
font-size: 14px;
font-weight: 600;
color: var(--p-ink-2);
}
.p-proj-summary {
margin: 12px 0 0;
font-size: 14px;
line-height: 1.8;
color: var(--p-ink-2);
}
.p-tags {
display: flex;
flex-wrap: wrap;
gap: 6px;
margin: 18px 0 0;
padding: 0;
list-style: none;
}
.p-tags li {
padding: 3px 9px;
font-size: 11.5px;
color: var(--p-ink-3);
background: var(--p-surface-alt);
border: 1px solid var(--p-line);
border-radius: 6px;
}
.p-proj-foot {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
margin-top: 22px;
padding-top: 18px;
border-top: 1px solid var(--p-line);
font-size: 12.5px;
color: var(--p-ink-3);
}
.p-proj-more {
font-weight: 600;
color: var(--p-accent);
}
/* ============================================================
内容页（非首页）的细节调整
============================================================ */
/* 属性表首列不要挤成竖排 */
.vp-doc table th:first-child,
.vp-doc table td:first-child {
white-space: nowrap;
}
/* 表格更轻，去掉重边框感 */
.vp-doc table {
display: table;
width: 100%;
}
.vp-doc tr {
background: transparent !important;
}
.vp-doc th {
font-weight: 600;
color: var(--p-ink, inherit);
}
/* 详情页一级标题更醒目 */
.vp-doc h1 {
font-size: 38px;
font-weight: 700;
letter-spacing: -0.025em;
line-height: 1.2;
}
@media (max-width: 720px) {
.vp-doc h1 {
font-size: 28px;
}
}
/* 二级标题加一条短强调线 */
.vp-doc h2 {
padding-top: 40px;
margin-top: 56px;
font-size: 26px;
font-weight: 650;
letter-spacing: -0.02em;
}
.vp-doc h2::before {
content: '';
display: block;
width: 32px;
height: 3px;
margin-bottom: 18px;
border-radius: 2px;
background: var(--p-accent, #4f46e5);
}
.vp-doc h3 {
font-size: 18px;
font-weight: 650;
}
/* 提示块圆角统一 */
.vp-doc .custom-block {
border-radius: 10px;
}
/* 行内代码轻一点 */
.vp-doc :not(pre) > code {
border-radius: 5px;
font-size: 0.86em;
}
/* 内容页正文用强调色变量，避免与默认主题脱节 */
.vp-doc a {
color: var(--p-accent);
text-decoration-color: var(--p-accent-line);
}
.vp-doc a:hover {
text-decoration-color: var(--p-accent);
}
data/content.ts
+172
View File
@@ -0,0 +1,172 @@
/**
* 门户首页的内容数据 —— 与 data/projects.ts 并列，只放首页排版需要的文案。
*
* 口径约束：这里的每一条都取自各项目的 README / 详情页，不写没有依据的数字。
* 需要新增能力时，先在对应项目仓核实，再补到这里。
*/
export interface Stat {
num: string
unit?: string
label: string
}
/** 首页数据条。只列可从仓库直接核对的事实。 */
export const stats: Stat[] = [
{ num: '3', label: '开源项目' },
{ num: '3', label: '运营商协议直连' },
{ num: '22', unit: '+', label: 'XiuAdmin 内置模块' },
{ num: '100', unit: '%', label: 'Apache-2.0 许可' },
]
export interface Capability {
title: string
text: string
}
/** 通用能力底座 —— 三个项目共享的工程特征 */
export const foundations: Capability[] = [
{
title: '单仓多服务',
text: '后端服务、前端应用、文档站与部署编排收在同一个仓库，一次 clone 拿到全部内容。',
},
{
title: '一条命令起',
text: 'Docker Compose 编排齐备，首次启动自动建库建表与种子数据，不需要本地编译。',
},
{
title: '接口开放',
text: '对外接口有独立的版本化合同与鉴权方式，可被自有系统或三方平台直接调用。',
},
{
title: '权限与审计',
text: '多租户、角色、菜单按钮权限与数据范围划分，关键操作留痕可追溯。',
},
{
title: '离线可部署',
text: '镜像可导出为归档文件带入内网，无外网环境同样可以完成安装与升级。',
},
{
title: '文档随仓发布',
text: '使用手册、部署手册与接口合同与代码同仓维护，版本不会脱节。',
},
]
/** iotLCM 的能力分组，按业务域拆 */
export interface CapGroup {
id: string
name: string
intro: string
items: Capability[]
}
export const iotlcmGroups: CapGroup[] = [
{
id: 'card',
name: '卡与库存',
intro: '从运营商渠道入库开始，一路管到销户，卡片状态与位置始终可查。',
items: [
{ title: '卡信息管理', text: '单卡详情、按三码检索、状态与用量快照，支持批量导入建立卡档案。' },
{ title: '三级库存流转', text: '入库、在库、出库全程留痕，按批次追溯每一张卡的来源与去向。' },
{ title: '批量开停复机', text: '按批次下发至运营商，执行结果自动回写，失败项可单独重试。' },
{ title: '续费与变更套餐', text: '单卡与批量受理并行，支持指定生效时间与到期处理策略。' },
{ title: '达量断网', text: '按用量阈值自动停机，阈值可批量设置，避免超量产生额外费用。' },
{ title: '智能诊断', text: '结合卡状态、通道与用量给出诊断结论与处置建议，缩短排障时间。' },
],
},
{
id: 'channel',
name: '通道与上游',
intro: '把不同运营商的接口差异收敛到一层，上层业务不用关心底层协议。',
items: [
{ title: '三大运营商直连', text: '中国移动 OneLink、中国电信 5G CMP、中国联通 10646 协议适配内置。' },
{ title: '通道与接入模板', text: '按运营商维护通道，接入参数模板化，新增通道不改业务代码。' },
{ title: '共享 Token 接入', text: '三方渠道商以共享 Token 模式接入，配合白名单转发控制调用范围。' },
{ title: '通道缓存转发', text: '独立转发层隔离上游抖动，上游异常不影响管理端可用性。' },
{ title: '凭据与配额管理', text: '上游凭据集中维护，调用量与配额可观测，异常调用及时告警。' },
{ title: '执行日志', text: '每次上游调用的请求与响应留存，问题定位有据可依。' },
],
},
{
id: 'billing',
name: '资费与计费',
intro: '套餐、流量池与定价分离建模，同一张卡可以按不同口径结算。',
items: [
{ title: '套餐配置', text: '套餐与流量池定义，支持多层套餐结构与绑定关系。' },
{ title: '定价规则', text: '面向代理商与终端客户的定价分开维护，支持差异化报价。' },
{ title: '生效与到期', text: '套餐生效、到期、续期的处理策略可配置，避免人工干预。' },
{ title: '用量查询', text: '实时用量与月累计分开统计，支持历史账期回溯。' },
{ title: '时序数据留存', text: '流量与状态按账期落入时序库，长期趋势分析不失真。' },
{ title: '分佣与结算', text: '代理商分佣规则配置，划拨与回收动作与结算口径对齐。' },
],
},
{
id: 'org',
name: '组织与账号',
intro: '多租户下的企业、账号与权限治理，对外凭证与对内角色分开管理。',
items: [
{ title: '企业与用户', text: '多级组织结构，企业下挂用户，数据按组织隔离。' },
{ title: '角色与权限', text: '按角色分配菜单与操作权限，按钮级权限可粒度控制。' },
{ title: '代理商体系', text: '代理商分级管理，设备与卡片划拨、回收动作全程留痕。' },
{ title: 'API 凭证', text: '对外调用凭证的签发、吊销与使用记录，异常调用可即时阻断。' },
{ title: '操作审计', text: '关键操作留痕，可按时段、操作人、对象多维检索。' },
{ title: '工单流转', text: '内部与客户侧工单流转，处理时效与责任人可追踪。' },
],
},
{
id: 'delivery',
name: '对外交付',
intro: '把平台能力以接口形式交付出去，自有系统与三方平台都能接。',
items: [
{ title: 'V3 版本化接口', text: '接口按版本演进，升级不破坏既有调用方。' },
{ title: '旧版兼容接口', text: '历史接口保持兼容，存量系统无需改造即可迁移。' },
{ title: '运营商能力代理', text: '白名单转发与共享 Token 两种模式，按需开放上游能力。' },
{ title: 'Web 管理端', text: '完整的后台界面，覆盖卡管理、资费、组织、运维全场景。' },
{ title: '小程序 / H5', text: '面向终端用户的移动端，支持查卡、办理与自助服务。' },
{ title: '接口文档', text: '接口合同与示例随文档站发布，接入方可以自助完成联调。' },
],
},
]
/** XiuAdmin 内置模块（取自项目详情页的 22 项，归并为可读分组） */
export interface AdminGroup {
name: string
items: string[]
}
export const adminGroups: AdminGroup[] = [
{ name: '租户与组织', items: ['租户管理', '租户套餐', '客户端管理', '部门管理', '岗位管理'] },
{ name: '账号与权限', items: ['用户管理', '角色管理', '菜单管理', '在线用户'] },
{ name: '开发效率', items: ['代码生成', '定时任务', '消息队列', '字典管理'] },
{ name: '配置与运维', items: ['配置管理', '服务监控', '缓存监控', '操作日志', '登录日志', '服务日志'] },
]
/** DTU 的能力分组 */
export const dtuGroups: CapGroup[] = [
{
id: 'produce',
name: '生产与研发',
intro: '从产品定义到固件版本，设备出厂前的每个环节都在系统里。',
items: [
{ title: '产品与型号', text: '产品定义、硬件型号与工厂信息维护，生产批次可追溯。' },
{ title: '设备生产', text: '批量生产导入导出，设备序列号与产品型号绑定。' },
{ title: '固件管理', text: '固件版本登记与发布，支持按型号推送不同版本。' },
{ title: 'OTA 升级', text: '升级任务分批下发，进度与结果可查，失败设备可重试。' },
{ title: '配置中心', text: '产品通用模型、配置分组与版本，下发状态逐台可见。' },
{ title: '指令下发', text: 'HTTP / TCP 双通道接入，指令下发与回执确认。' },
],
},
{
id: 'channel',
name: '代理与客户',
intro: '设备划拨链路透明，代理商与终端客户的归属关系清晰。',
items: [
{ title: '代理商管理', text: '多级代理结构，下级代理与设备列表分开维护。' },
{ title: '设备划拨', text: '划拨与回收动作留痕，历史记录可回溯到具体批次。' },
{ title: '终端绑定', text: '终端客户扫码绑定设备，一机一码防止串货。' },
{ title: '我的订单', text: '代理商自助查看订单与设备状态，减少人工对接。' },
{ title: '运行监控', text: '设备在线状态、信号与事件上报集中呈现。' },
{ title: '联调工具', text: '仓库自带设备联调与压测脚本，新设备接入可先本地验证。' },
],
},
]
pages/about.md
+25 -13
View File
@@ -10,13 +10,13 @@ outline: deep
## 许可证
全部项目以 **Apache-2.0** 发布。可自由使用、修改、商用与再分发；分发时保留版权声明与许可证原文，并对修改部分注明变更。各项目依赖的上游组件保留其原始许可。
全部项目以 **Apache-2.0** 发布。
## 参与贡献
1. 从目标项目的默认分支切出特性分支，命名 `feat/xxx`、`fix/xxx`
2. 提交前确保各自的构建与测试通过（Go 服务跑 `go build ./...` 与 `go test ./...`，前端跑 `pnpm build`）
3. 提交合入请求并说明变更动机
| 允许 | 需要 |
| --- | --- |
| 自由使用、修改、商用、再分发 | 保留版权声明与许可证原文 |
| 用于闭源商业产品 | 对修改过的文件注明变更 |
| 专利授权（贡献者授予） | 各项目上游依赖保留其原始许可 |
## 各项目仓库
@@ -27,17 +27,29 @@ outline: deep
| XiuAdmin | <https://gitee.com/snowgoat/xiu-admin> |
| 本门户站 | <https://git.5iot.com/iotlcm-public/website> |
## 参与贡献
| 步骤 | 做什么 |
| --- | --- |
| 1 | 从目标项目的默认分支切出特性分支，命名 `feat/xxx`、`fix/xxx` |
| 2 | 提交前确保构建与测试通过：Go 服务跑 `go build ./...` 与 `go test ./...`，前端跑 `pnpm build` |
| 3 | 提交合入请求，说明变更动机与影响范围 |
## 提问与反馈
- 使用问题与缺陷：对应仓库开 issue
- 功能建议：issue 里描述清楚场景与期望
- 部署排错：先看各项目详情页的常见问题表，再开 issue 附上 `docker compose ps` 与相关日志
| 类型 | 去哪 |
| --- | --- |
| 使用问题与缺陷 | 对应仓库开 issue |
| 功能建议 | issue 里描述清楚场景与期望 |
| 部署排错 | 先看各项目详情页的常见问题表，再开 issue 并附 `docker compose ps` 与相关日志 |
## 运维自用组件的边界
## 边界说明
飞书通知机器人（`with-bot` profile）是给运维方自用的工具，需要自建应用的凭据才能启动，**不是平台功能**，未配置时不影响平台运行。
运营商通道的生产凭据不随仓发布，需自行向运营商申请。
| 项 | 说明 |
| --- | --- |
| 飞书通知机器人 | `with-bot` profile 下的运维自用工具，需要自建应用凭据才能启动，**不是平台功能**，未配置不影响运行 |
| 运营商凭据 | 通道的生产凭据不随仓发布，需自行向运营商申请与配置 |
| 老平台私有模块 | 开源版发布的是微服务家族，不含历史项目的私有定制部分 |
## 门户本身
pages/index.md
+6 -36
View File
@@ -1,39 +1,9 @@
---
layout: home
hero:
name: 雪羊科技开源
text: 物联网与中后台基础软件
tagline: 开源项目门户 · Apache-2.0
actions:
- theme: brand
text: 浏览全部项目
link: /projects/
- theme: alt
text: iotLCM 快速开始
link: /projects/iotlcm/guide/quickstart
features:
- title: 全生命周期管理
details: iotLCM 覆盖物联网 SIM 卡的入库、划拨、激活、续费、停机、流量与状态同步、销户全流程。
- title: 设备接入闭环
details: 秀杰 DTU 管理平台覆盖 DTU 设备生产、出厂、划拨、绑定、配置下发、固件 OTA 与指令下发。
- title: 中后台开发底座
details: XiuAdmin 是基于 GoFrame + Vue3 的全栖中后台框架，租户、权限、代码生成、消息队列等内置可用。
- title: 一条命令部署
details: 各项目均提供 Docker Compose 编排与预构建镜像，clone 之后即可跑起来。
- title: 统一 Apache-2.0
details: 全部项目以 Apache-2.0 发布，可自由使用、修改、商用与再分发。
- title: 持续新增
details: 门户项目清单由单一注册表驱动，新增项目不需要改动站点其它部分。
layout: page
title: 雪羊科技开源
description: 雪羊科技开源项目门户：物联网卡管理、DTU 设备管理、中后台开发框架
sidebar: false
aside: false
---
## 开源项目
<ProjectList />
## 使用说明
- 每个项目在「项目详情」页给出定位、能力边界与代码仓地址
- 部署与运维细节见各项目的指南页
- 源码仓统一托管在 Gitee 企业仓 `snowgoat` 命名空间下
<HomePage />
pages/projects/index.md
+8 -4
View File
@@ -6,15 +6,19 @@ outline: deep
# 全部项目
雪羊科技对外开源的项目集合。三个项目覆盖物联网卡管理、硬件设备管理与中后台开发底座，全部以 Apache-2.0 发布。
<ProjectList />
## 关于这份清单
## 清单怎么维护
项目清单由站点源码里的单一注册表维护（`data/projects.ts`），首页卡片、侧边栏与本页都从它生成。
新增一个项目需要两步：
1. 在注册表里加一条记录（名称、定位、说明、代码仓、许可证、技术栈、状态）
2. 写 `pages/projects/<id>/index.md` 详情页，若有子页面（快速开始、部署、教程）在记录的 `sections` 里登记
| 步骤 | 做什么 |
| --- | --- |
| 1 | 在 `data/projects.ts` 里加一条记录（名称、定位、说明、代码仓、许可证、技术栈、状态、详情页路径、子页面） |
| 2 | 写 `pages/projects/<id>/index.md` 详情页，有子页面则在记录的 `sections` 里登记 |
站点构建前会自动校验「注册表条目」与「详情页目录」是否一一对应，不一致直接报错，避免清单与页面脱节。
构建前会自动校验「注册表条目」与「详情页目录」是否一一对应，不一致直接报错，避免清单与页面脱节。
pages/projects/iotlcm/index.md
+9 -27
View File
@@ -18,32 +18,11 @@ outline: deep
| 技术栈 | GoFrame v2、Vue 3 + Vben Admin、MySQL、Redis、RabbitMQ、TDengine、Consul、Docker Compose |
| 文档站 | <http://open.5iot.com:5051/docs/> |
## 能力概览
## 能力矩阵
按业务域拆开的能力矩阵：
按业务域拆开的能力矩阵，点击标签切换查看各域下的具体能力。
| 域 | 能力 |
| --- | --- |
| 卡资产 | 卡信息、批量导入、入库 / 库存 / 出库、批量开停复机、续费、变更套餐、达量断网 |
| 通信管理 | 通道与接入模板、运营商能力对接、共享 Token 接入三方渠道、通道缓存转发 |
| 资费 | 套餐与流量池、定价、生效与到期策略 |
| 代理商 | 代理商与分佣、划拨与回收 |
| 数据同步 | 流量 / 状态 / IMEI 全量同步与增量对齐、历史账期时序数据 |
| 对外接口 | V3 接口、旧版兼容接口、运营商能力代理（白名单转发 / 共享 Token） |
| 运营 | 工单、预警、执行日志、审计、智能诊断 |
| 端 | Web 管理端、小程序 / H5 用户端 |
细分能力：
| 模块 | 说明 |
| --- | --- |
| 卡与库存 | 卡信息检索、按三码查卡、批量导入出入库、库存与出库、批量开停复机 |
| 智能诊断 | 结合卡状态、通道与用量给出诊断结论与处置建议 |
| 资费与计费 | 套餐与定价管理、用量与流量查询、达量断网阈值 |
| 业务受理 | 开通、续费、停复机、变更套餐 |
| 通道与上游 | 上游通道配置与凭据、协议适配、共享 Token、缓存转发 |
| 组织与账号 | 多租户下的企业与账号治理、角色权限、对外 API 凭证 |
| 运维支撑 | 全量同步、批次执行、工单与告警、执行日志、飞书通知、指标与日志 |
<CapabilityTabs />
## 服务构成
@@ -67,9 +46,12 @@ outline: deep
## 下一步
- [快速开始](/projects/iotlcm/guide/quickstart) — 三步把整套跑起来
- [部署与运维](/projects/iotlcm/guide/deploy) — 生产部署前的必改项、可选组件、离线部署与排错
- [教程视频](/projects/iotlcm/guide/tutorial) — 部署与使用的录屏教程
| 文档 | 内容 |
| --- | --- |
| [快速开始](/projects/iotlcm/guide/quickstart) | 三步把整套跑起来 |
| [部署与运维](/projects/iotlcm/guide/deploy) | 生产部署前的必改项、可选组件、离线部署与排错 |
| [教程视频](/projects/iotlcm/guide/tutorial) | 部署与使用的录屏教程 |
| [方案对比](/projects/iotlcm/compare) | 与同类开源方案的可验证差异 |
## 边界
pages/projects/xiu-admin/index.md
+3 -22
View File
@@ -25,28 +25,9 @@ outline: deep
## 内置功能
1. 租户管理：系统内租户的管理，如租户套餐、过期时间、用户数量、企业信息等
2. 租户套餐管理：租户所能使用的套餐管理，如套餐内所包含的菜单等
3. 客户端管理：系统内对接的所有客户端管理，如 pc 端、小程序端等
4. 用户管理：用户是系统操作者，完成系统用户配置
5. 部门管理：配置系统组织机构（公司、部门、岗位），树结构展现支持数据权限
6. 岗位管理：配置系统用户所属担任职务
7. 菜单管理：配置系统菜单，操作权限、按钮权限标识等
8. 角色管理：角色菜单权限分配、设置角色按机构或按上下级关系进行数据范围权限划分
9. 字典管理：对系统中经常使用的一些特定数据进行维护，支持枚举字典和自定义方法字典
10. 配置管理：对系统动态配置常用参数
11. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询
12. 登录日志：系统登录日志记录查询，包含登录异常
13. 服务日志：服务端运行所产生的警告、异常、崩溃日志的详细数据和堆栈信息
14. 在线用户：当前系统中活跃用户状态监控
15. 定时任务：在线（添加、修改、删除）任务调度，包含执行结果日志
16. 代码生成：支持自动化生成前后端代码。CURD 关联表、树表、消息队列、定时任务一键生成等
17. 服务监控：监视当前系统 CPU、内存、磁盘、网络、堆栈等相关信息
18. 缓存监控：对系统的缓存信息查询、命令统计等
19. 附件管理：文件图片上传，大文件分片上传、断点续传，支持本地
20. 消息队列：Asynq 消息队列
21. 通知公告：采用 WebSocket 实时推送在线用户最新通知、公告、私信消息
22. 常用工具：集成常用的工具包和命令行工具，可以快速开发自定义命令行，多种启动入口
22 项功能开箱可用，按用途归为四组。每项都不需要自己实现，装上就能用。
<FeatureGrid />
## 目录结构
pages/projects/xiu-dtu/index.md
+4 -9
View File
@@ -15,16 +15,11 @@ outline: deep
| 状态 | 已发布 |
| 技术栈 | GoFrame v2、Vue 3 + Vite + TypeScript、Vben Admin 5.x、Ant Design Vue、MySQL 8、Redis、TDengine（可选）、asynq、VitePress |
## 功能概览
## 能力分组
| 模块 | 说明 |
| --- | --- |
| 生产中心 | 产品、硬件型号、工厂、生产批次、设备生产与导入导出 |
| 研发中心 | 固件管理、固件版本、OTA 升级任务 |
| 配置中心 | 产品通用模型、配置分组、配置版本与下发状态 |
| 代理中心 | 代理商设备列表、下级代理、设备划拨与划拨历史、我的订单 |
| 系统管理 | 用户、角色、菜单、部门、字典、参数、租户、监控 |
| 设备接入 | HTTP / TCP 双通道接入，指令下发、事件上报、UART 隧道 |
按业务环节拆开，点击标签切换查看各环节下的具体能力。
<CapabilityTabs source="dtu" />
## 目录结构
scripts/check-registry.mjs
+3 -5
View File
@@ -14,11 +14,9 @@ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
const dataDir = join(root, 'data')
const pagesDir = join(root, 'pages', 'projects')
// 注册表是 TS 源文件，这里只需要 id 列表，正则抽取即可，不引入编译步骤
const registrySrc = readdirSync(dataDir)
.filter((f) => f.endsWith('.ts'))
.map((f) => readFileSync(join(dataDir, f), 'utf-8'))
.join('\n')
// 注册表是 TS 源文件，这里只需要 id 列表，正则抽取即可，不引入编译步骤。
// 只看 projects.ts：data/ 下其它文件（如首页文案 content.ts）里的 id 不是项目 id。
const registrySrc = readFileSync(join(dataDir, 'projects.ts'), 'utf-8')
const registered = [...registrySrc.matchAll(/\bid:\s*'([^']+)'/g)].map((m) => m[1])