feat: add comprehensive backend topics and fix build issues

## 新增内容

### 附录文档扩展
- 扩展前端项目架构文档 (frontend-project-architecture.md)
- 扩展后端项目架构文档 (backend-project-architecture.md)
- 扩展数据治理文档 (data-governance.md)
- 扩展数据可视化文档 (data-visualization.md)
- 扩展分布式系统文档 (distributed-systems.md)
- 扩展高可用文档 (high-availability.md)
- 扩展单体到微服务文档 (monolith-to-microservices.md)
- 扩展系统设计方法论文档 (system-design-methodology.md)
- 扩展 Docker 容器文档 (docker-containers.md)
- 扩展 Kubernetes 文档 (kubernetes.md)
- 扩展 Linux 基础文档 (linux-basics.md)
- 扩展神经网络文档 (neural-networks.md)

### 新增交互式组件
- 数据治理组件: DataQualityDemo, DataGovernanceFrameworkDemo, DataLineageDemo
- 数据可视化组件: ChartTypeSelectorDemo, DashboardLayoutDemo
- 分布式系统组件: CAPTheoremDemo, ConsistencyModelsDemo, DistributedChallengesDemo
- 高可用组件: AvailabilityCalculatorDemo, FailoverStrategyDemo
- 系统设计组件: SystemDesignStepsDemo, CapacityEstimationDemo
- Docker 容器组件: DockerArchitectureDemo, DockerLifecycleDemo
- Kubernetes 组件: K8sArchitectureDemo, K8sWorkloadsDemo
- Linux 基础组件: LinuxFileSystemDemo, LinuxCommandDemo, LinuxPermissionsDemo
- 神经网络组件: NeuronDemo, NetworkLayersDemo, NetworkArchitectureDemo
- 单体到微服务组件: ArchEvolutionDemo
- 项目架构组件: ProjectArchitectureComparisonDemo
- 附录导航组件: AppendixFlowMap

### 英文版重构
- 将 en-us 目录重命名为 en
- 更新相关配置和组件中的语言代码

## Bug 修复
- 修复 index.js 中重复的组件导入语句导致的 build 失败
- 恢复被注释的 InvertedIndexDemo 和 SearchRelevanceDemo 导入
- 修复 HomeFeatures.vue 中 en-us 与 config.mjs 中 en 不一致导致的语言切换问题

## 其他改进
- 添加构建脚本 (scripts/build.mjs)
- 更新依赖版本
This commit is contained in:
sanbuphy
2026-02-26 04:35:28 +08:00
parent df51f84ab5
commit ef70b1d8e1
84 changed files with 12917 additions and 3477 deletions
@@ -0,0 +1,183 @@
<!--
K8sArchitectureDemo.vue
Kubernetes 架构演示控制平面与工作节点
-->
<template>
<div class="k8s-arch-demo">
<div class="header">
<div class="title">Kubernetes 架构</div>
<div class="subtitle">点击组件查看详细说明</div>
</div>
<div class="arch-layout">
<div class="plane control-plane">
<div class="plane-title">控制平面Control Plane</div>
<div class="components">
<div
v-for="c in controlPlane"
:key="c.key"
:class="['comp-card', { active: active === c.key }]"
@click="active = c.key"
>
<div class="comp-name">{{ c.name }}</div>
</div>
</div>
</div>
<div class="plane worker-plane">
<div class="plane-title">工作节点Worker Node× N</div>
<div class="components">
<div
v-for="c in workerNode"
:key="c.key"
:class="['comp-card', { active: active === c.key }]"
@click="active = c.key"
>
<div class="comp-name">{{ c.name }}</div>
</div>
</div>
</div>
</div>
<div v-if="current" class="detail-panel">
<div class="detail-title">{{ current.name }}</div>
<div class="detail-desc">{{ current.desc }}</div>
<div class="detail-analogy">
<span class="label">类比</span>{{ current.analogy }}
</div>
</div>
</div>
</template>
<script setup>
import { ref, computed } from 'vue'
const active = ref('api-server')
const controlPlane = [
{
key: 'api-server',
name: 'API Server',
desc: 'Kubernetes 的"前门",所有操作(kubectl、Dashboard、内部组件)都通过 API Server 进行。它负责认证、授权、准入控制,是集群的唯一入口。',
analogy: '公司前台,所有访客和快递都要经过前台登记'
},
{
key: 'etcd',
name: 'etcd',
desc: '分布式键值存储,保存集群的所有状态数据:Pod 信息、Service 配置、Secret 等。它是集群的"记忆",丢失 etcd 数据等于丢失整个集群。',
analogy: '公司的档案室,记录所有员工信息和规章制度'
},
{
key: 'scheduler',
name: 'Scheduler',
desc: '负责将新创建的 Pod 分配到合适的节点上。它会考虑资源需求、亲和性规则、污点容忍等因素,做出最优调度决策。',
analogy: 'HR 部门,根据岗位需求把新员工分配到合适的部门'
},
{
key: 'controller',
name: 'Controller Manager',
desc: '运行各种控制器(Deployment、ReplicaSet、Job 等),持续监控集群状态,确保实际状态与期望状态一致。如果 Pod 挂了,控制器会自动重建。',
analogy: '各部门经理,确保每个部门的人员配置符合编制要求'
}
]
const workerNode = [
{
key: 'kubelet',
name: 'kubelet',
desc: '每个节点上的"代理人",负责管理本节点上的 Pod 生命周期。它接收 API Server 的指令,调用容器运行时创建/销毁容器,并上报节点状态。',
analogy: '每个工位上的组长,负责管理组员的日常工作'
},
{
key: 'kube-proxy',
name: 'kube-proxy',
desc: '负责实现 Service 的网络规则,将访问 Service 的流量转发到对应的 Pod。它维护节点上的 iptables/IPVS 规则,实现负载均衡。',
analogy: '公司的电话总机,把外部来电转接到正确的分机'
},
{
key: 'runtime',
name: '容器运行时',
desc: '实际运行容器的组件,如 containerd、CRI-O。kubelet 通过 CRI(容器运行时接口)与它交互,它负责拉取镜像、创建和管理容器。',
analogy: '实际干活的工人,按照指令完成具体的生产任务'
}
]
const allComponents = [...controlPlane, ...workerNode]
const current = computed(() => allComponents.find(c => c.key === active.value))
</script>
<style scoped>
.k8s-arch-demo {
border: 1px solid var(--vp-c-divider);
background: var(--vp-c-bg-soft);
border-radius: 12px;
padding: 1.5rem;
margin: 1.5rem 0;
}
.header { margin-bottom: 1rem; }
.title { font-weight: 700; font-size: 1.1rem; }
.subtitle { color: var(--vp-c-text-2); font-size: 0.9rem; }
.arch-layout {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 0.75rem;
margin-bottom: 1rem;
}
@media (max-width: 640px) {
.arch-layout { grid-template-columns: 1fr; }
}
.plane {
border-radius: 8px;
padding: 0.75rem;
border: 1px solid var(--vp-c-divider);
}
.control-plane { background: rgba(59, 130, 246, 0.06); }
.worker-plane { background: rgba(34, 197, 94, 0.06); }
.plane-title {
font-weight: 700;
font-size: 0.8rem;
margin-bottom: 0.5rem;
color: var(--vp-c-text-2);
}
.components {
display: flex;
flex-wrap: wrap;
gap: 0.4rem;
}
.comp-card {
padding: 0.35rem 0.6rem;
border-radius: 6px;
cursor: pointer;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
font-size: 0.78rem;
font-weight: 600;
transition: all 0.2s;
}
.comp-card:hover { border-color: var(--vp-c-brand); }
.comp-card.active {
border-color: var(--vp-c-brand);
background: rgba(var(--vp-c-brand-rgb, 100, 108, 255), 0.08);
color: var(--vp-c-brand);
}
.detail-panel {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 1rem;
border: 1px solid var(--vp-c-divider);
}
.detail-title { font-weight: 700; font-size: 0.95rem; margin-bottom: 0.4rem; }
.detail-desc {
font-size: 0.82rem;
color: var(--vp-c-text-2);
margin-bottom: 0.5rem;
line-height: 1.6;
}
.detail-analogy {
font-size: 0.8rem;
padding: 0.4rem 0.6rem;
background: var(--vp-c-bg-soft);
border-radius: 6px;
}
.label { font-weight: 600; color: var(--vp-c-text-2); }
</style>
@@ -0,0 +1,235 @@
<!--
K8sWorkloadsDemo.vue
Kubernetes 工作负载演示PodDeploymentService 等核心资源
-->
<template>
<div class="k8s-workloads-demo">
<div class="header">
<div class="title">K8s 核心资源</div>
<div class="subtitle">点击资源类型查看说明和 YAML 示例</div>
</div>
<div class="resource-tabs">
<button
v-for="r in resources"
:key="r.key"
:class="['res-btn', { active: activeRes === r.key }]"
@click="activeRes = r.key"
>
{{ r.name }}
</button>
</div>
<div v-if="current" class="detail-panel">
<div class="detail-header">
<div class="detail-title">{{ current.name }}</div>
<div class="detail-badge">{{ current.category }}</div>
</div>
<div class="detail-desc">{{ current.desc }}</div>
<div class="yaml-block">
<div class="yaml-label">YAML 示例</div>
<pre class="yaml-code"><code>{{ current.yaml }}</code></pre>
</div>
<div v-if="current.tips" class="tips">
<span class="tip-label">要点</span>{{ current.tips }}
</div>
</div>
</div>
</template>
<script setup>
import { ref, computed } from 'vue'
const activeRes = ref('pod')
const resources = [
{
key: 'pod',
name: 'Pod',
category: '最小调度单元',
desc: 'Pod 是 K8s 中最小的部署单元,包含一个或多个紧密关联的容器。同一 Pod 内的容器共享网络和存储,可以通过 localhost 互相通信。',
yaml: `apiVersion: v1
kind: Pod
metadata:
name: my-app
spec:
containers:
- name: app
image: my-app:1.0
ports:
- containerPort: 3000`,
tips: '生产环境中很少直接创建 Pod,通常通过 Deployment 管理。'
},
{
key: 'deployment',
name: 'Deployment',
category: '工作负载',
desc: 'Deployment 管理 Pod 的副本数、滚动更新和回滚。你声明"我要 3 个副本运行 v1.0"Deployment 控制器会确保始终有 3 个健康的 Pod 在运行。',
yaml: `apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app
spec:
replicas: 3
selector:
matchLabels:
app: my-app
template:
metadata:
labels:
app: my-app
spec:
containers:
- name: app
image: my-app:1.0`,
tips: '更新镜像版本后,Deployment 会自动执行滚动更新,逐步替换旧 Pod。'
},
{
key: 'service',
name: 'Service',
category: '网络',
desc: 'Service 为一组 Pod 提供稳定的访问入口。Pod 的 IP 会变,但 Service 的 ClusterIP 和 DNS 名称不变。它通过 label selector 找到对应的 Pod,并做负载均衡。',
yaml: `apiVersion: v1
kind: Service
metadata:
name: my-app-svc
spec:
selector:
app: my-app
ports:
- port: 80
targetPort: 3000
type: ClusterIP`,
tips: 'ClusterIP(集群内访问)、NodePort(节点端口)、LoadBalancer(云负载均衡器)是三种常用类型。'
},
{
key: 'configmap',
name: 'ConfigMap',
category: '配置',
desc: 'ConfigMap 存储非敏感的配置数据(如数据库地址、功能开关),可以作为环境变量或文件挂载到 Pod 中。修改 ConfigMap 后可以不重建镜像就更新配置。',
yaml: `apiVersion: v1
kind: ConfigMap
metadata:
name: app-config
data:
DB_HOST: "db.example.com"
LOG_LEVEL: "info"`,
tips: '敏感数据(密码、密钥)应该用 Secret 而不是 ConfigMap。'
},
{
key: 'ingress',
name: 'Ingress',
category: '网络',
desc: 'Ingress 管理集群的外部 HTTP/HTTPS 访问入口,支持基于域名和路径的路由规则。它是集群的"反向代理",通常配合 Nginx Ingress Controller 使用。',
yaml: `apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-ingress
spec:
rules:
- host: app.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: my-app-svc
port:
number: 80`,
tips: 'Ingress 需要 Ingress Controller 才能工作,它本身只是路由规则的声明。'
}
]
const current = computed(() => resources.find(r => r.key === activeRes.value))
</script>
<style scoped>
.k8s-workloads-demo {
border: 1px solid var(--vp-c-divider);
background: var(--vp-c-bg-soft);
border-radius: 12px;
padding: 1.5rem;
margin: 1.5rem 0;
}
.header { margin-bottom: 1rem; }
.title { font-weight: 700; font-size: 1.1rem; }
.subtitle { color: var(--vp-c-text-2); font-size: 0.9rem; }
.resource-tabs {
display: flex;
flex-wrap: wrap;
gap: 0.4rem;
margin-bottom: 1rem;
}
.res-btn {
padding: 0.35rem 0.7rem;
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
background: var(--vp-c-bg);
cursor: pointer;
font-size: 0.8rem;
font-weight: 600;
color: var(--vp-c-text-2);
transition: all 0.2s;
}
.res-btn:hover { border-color: var(--vp-c-brand); }
.res-btn.active {
background: var(--vp-c-brand);
color: #fff;
border-color: var(--vp-c-brand);
}
.detail-panel {
background: var(--vp-c-bg);
border-radius: 8px;
padding: 1rem;
border: 1px solid var(--vp-c-divider);
}
.detail-header {
display: flex;
align-items: center;
gap: 0.5rem;
margin-bottom: 0.4rem;
}
.detail-title { font-weight: 700; font-size: 0.95rem; }
.detail-badge {
font-size: 0.68rem;
padding: 0.15rem 0.4rem;
border-radius: 4px;
background: rgba(var(--vp-c-brand-rgb, 100, 108, 255), 0.1);
color: var(--vp-c-brand);
font-weight: 600;
}
.detail-desc {
font-size: 0.82rem;
color: var(--vp-c-text-2);
margin-bottom: 0.75rem;
line-height: 1.6;
}
.yaml-block {
background: var(--vp-c-bg-soft);
border-radius: 6px;
padding: 0.6rem;
margin-bottom: 0.5rem;
}
.yaml-label {
font-weight: 600;
font-size: 0.72rem;
color: var(--vp-c-text-3);
margin-bottom: 0.3rem;
}
.yaml-code {
font-size: 0.75rem;
line-height: 1.5;
margin: 0;
overflow-x: auto;
color: var(--vp-c-text-1);
}
.tips {
font-size: 0.78rem;
color: var(--vp-c-text-2);
padding: 0.4rem 0.6rem;
background: rgba(245, 158, 11, 0.08);
border-radius: 6px;
}
.tip-label { font-weight: 600; }
</style>