feat(docs): enhance interactive demos and improve documentation

- Add new interactive components for frontend routing, browser rendering pipeline, and database transactions
- Improve existing demos with better visuals, explanations, and examples
- Update documentation structure and content for better clarity
- Add new utility scripts and update package.json with new commands
- Fix formatting and alignment in documentation tables
This commit is contained in:
sanbuphy
2026-02-13 22:10:03 +08:00
parent 599052b2e0
commit d174ceea32
88 changed files with 26273 additions and 15539 deletions
@@ -71,21 +71,31 @@ const setHover = (id) => {
<template>
<div class="relational-demo">
<div class="demo-header">
<span class="icon">📊</span>
<span class="title">关系型数据演示</span>
<span class="subtitle">Excel 模式 vs 数据库模式</span>
</div>
<div class="intro-text">
想象你在管理一个<span class="highlight">书店订单</span> Excel 每个订单都重复写顾客信息用关系型数据库时顾客信息单独存一张表订单表只存顾客 ID就像把<span class="highlight">通讯录和订单分开</span>而不是每笔订单都抄一遍地址
</div>
<div class="tabs">
<div
<button
class="tab"
:class="{ active: activeTab === 'excel' }"
@click="activeTab = 'excel'"
>
Excel 模式 (单表)
</div>
<div
📋 Excel 模式 (单表)
</button>
<button
class="tab"
:class="{ active: activeTab === 'db' }"
@click="activeTab = 'db'"
>
数据库模式 (多表关联)
</div>
🗄 数据库模式 (多表关联)
</button>
</div>
<div class="content-area">
@@ -117,7 +127,7 @@ const setHover = (id) => {
</div>
<div class="note error">
<p> <strong>问题</strong> "张三"的信息重复存储了 3 </p>
<p>如果张三换了电话你需要修改 3 行数据很容易漏改</p>
<p>如果张三换了电话你需要修改 3 行数据很容易漏改这叫<span class="highlight">数据冗余</span></p>
</div>
</div>
@@ -126,7 +136,7 @@ const setHover = (id) => {
<div class="db-layout">
<!-- Users Table -->
<div class="db-table users-table">
<div class="table-title">用户表 (Users)</div>
<div class="table-title">👥 用户表 (Users)</div>
<table>
<thead>
<tr>
@@ -143,7 +153,7 @@ const setHover = (id) => {
@mouseenter="setHover(u.id)"
@mouseleave="setHover(null)"
>
<td>{{ u.id }}</td>
<td class="primary-key">{{ u.id }}</td>
<td>{{ u.name }}</td>
<td>{{ u.phone }}</td>
</tr>
@@ -153,12 +163,13 @@ const setHover = (id) => {
<!-- Connection Lines (Visual only, simplified) -->
<div class="connector">
<div class="arrow"> 关联 (Join) </div>
<div class="arrow-label">🔗 外键关联</div>
<div class="arrow"> Join </div>
</div>
<!-- Orders Table -->
<div class="db-table orders-table">
<div class="table-title">订单表 (Orders)</div>
<div class="table-title">📦 订单表 (Orders)</div>
<table>
<thead>
<tr>
@@ -179,134 +190,239 @@ const setHover = (id) => {
<td>{{ o.id }}</td>
<td>{{ o.book }}</td>
<td>{{ o.price }}</td>
<td class="highlight-cell">{{ o.user_id }}</td>
<td class="highlight-cell foreign-key">{{ o.user_id }}</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="note success">
<p> <strong>优势</strong> 订单表只存 "用户 ID"</p>
<p> <strong>优势</strong> 订单表只存 "用户 ID"不重复存用户信息</p>
<p>
鼠标悬停在某一行看看它们是如何自动关联修改用户表一次所有订单都会自动更新
鼠标悬停在用户表或订单表的某一行看看它们是如何通过 <span class="highlight">外键自动关联</span>修改用户表一次所有订单都会自动更新
</p>
</div>
</div>
</div>
<div class="info-box">
<span class="icon">💡</span>
<strong>核心思想</strong>关系型数据库通过<span class="highlight">拆表 + 外键</span>消除冗余就像把通讯录和记账本分开记账本只写"姓名"查账时再去通讯录找详细信息这样改一次电话所有记录都更新
</div>
</div>
</template>
<style scoped>
.relational-demo {
border: 1px solid #e4e7ed;
border: 1px solid var(--vp-c-divider);
border-radius: 8px;
background: #fff;
overflow: hidden;
margin: 20px 0;
font-family: sans-serif;
background: var(--vp-c-bg-soft);
padding: 1rem;
margin: 1rem 0;
}
.demo-header {
display: flex;
align-items: center;
gap: 0.5rem;
margin-bottom: 0.75rem;
}
.demo-header .icon { font-size: 1.25rem; }
.demo-header .title { font-weight: bold; font-size: 1rem; }
.demo-header .subtitle { color: var(--vp-c-text-2); font-size: 0.85rem; margin-left: 0.5rem; }
.intro-text {
font-size: 0.9rem;
color: var(--vp-c-text-2);
line-height: 1.6;
margin-bottom: 1rem;
padding: 0.75rem;
background: var(--vp-c-bg);
border-radius: 6px;
}
.intro-text .highlight {
color: var(--vp-c-brand-1);
font-weight: 500;
}
.tabs {
display: flex;
background: #f5f7fa;
border-bottom: 1px solid #e4e7ed;
gap: 0.5rem;
margin-bottom: 1rem;
}
.tab {
padding: 12px 24px;
flex: 1;
padding: 0.75rem;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
font-size: 0.85rem;
cursor: pointer;
font-size: 14px;
color: #606266;
border-right: 1px solid #e4e7ed;
transition: all 0.2s;
color: var(--vp-c-text-2);
font-weight: 500;
}
.tab:hover {
background: var(--vp-c-bg-soft);
border-color: var(--vp-c-brand);
}
.tab.active {
background: #fff;
color: #409eff;
font-weight: bold;
border-bottom: 2px solid #409eff;
margin-bottom: -1px;
background: var(--vp-c-brand-soft);
border-color: var(--vp-c-brand);
color: var(--vp-c-brand-1);
}
.content-area {
padding: 20px;
background: var(--vp-c-bg);
padding: 0.75rem;
border-radius: 6px;
margin-bottom: 1rem;
}
.table-wrapper {
overflow-x: auto;
margin-bottom: 0.75rem;
}
table {
width: 100%;
border-collapse: collapse;
font-size: 13px;
font-size: 0.8rem;
}
th,
td {
border: 1px solid #ebeef5;
padding: 8px 12px;
border: 1px solid var(--vp-c-divider);
padding: 0.5rem 0.75rem;
text-align: left;
}
th {
background: #fafafa;
font-weight: bold;
color: #303133;
background: var(--vp-c-bg-soft);
font-weight: 600;
color: var(--vp-c-text-1);
}
.highlight-col {
background: #ecf5ff;
color: #409eff;
background: rgba(245, 158, 11, 0.1);
color: #f59e0b;
}
.highlight-cell {
background: #f0f9eb;
color: #67c23a;
font-weight: bold;
background: rgba(239, 68, 68, 0.1);
color: #ef4444;
font-weight: 500;
}
.primary-key {
color: var(--vp-c-brand-1);
font-weight: 500;
}
.foreign-key {
color: #f59e0b;
font-weight: 500;
}
.excel-view .highlight-cell {
background: #fef0f0;
color: #f56c6c;
background: rgba(239, 68, 68, 0.1);
color: #ef4444;
}
.db-layout {
display: flex;
gap: 20px;
gap: 1rem;
align-items: flex-start;
flex-wrap: wrap;
}
.db-table {
flex: 1;
min-width: 280px;
border: 1px solid #ebeef5;
border-radius: 4px;
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
overflow: hidden;
}
.table-title {
background: #f2f6fc;
padding: 8px 12px;
font-weight: bold;
font-size: 13px;
color: #606266;
border-bottom: 1px solid #ebeef5;
background: var(--vp-c-bg-soft);
padding: 0.5rem 0.75rem;
font-weight: 600;
font-size: 0.8rem;
color: var(--vp-c-text-1);
border-bottom: 1px solid var(--vp-c-divider);
}
.connector {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
padding-top: 50px;
font-size: 12px;
color: #909399;
padding-top: 1.5rem;
font-size: 0.75rem;
color: var(--vp-c-text-2);
min-width: 100px;
}
.arrow-label {
font-weight: 500;
margin-bottom: 0.25rem;
}
.arrow {
color: var(--vp-c-brand-1);
}
tr.active {
background: #ecf5ff;
background: rgba(34, 197, 94, 0.1);
}
.note {
margin-top: 15px;
padding: 12px;
border-radius: 4px;
font-size: 13px;
line-height: 1.6;
padding: 0.75rem;
border-radius: 6px;
font-size: 0.85rem;
line-height: 1.5;
}
.note p {
margin: 0.25rem 0;
}
.note.error {
background: #fef0f0;
color: #f56c6c;
background: rgba(239, 68, 68, 0.05);
border: 1px solid rgba(239, 68, 68, 0.2);
color: var(--vp-c-text-2);
}
.note.success {
background: #f0f9eb;
color: #67c23a;
background: rgba(34, 197, 94, 0.05);
border: 1px solid rgba(34, 197, 94, 0.2);
color: var(--vp-c-text-2);
}
.note .highlight {
color: var(--vp-c-brand-1);
font-weight: 500;
}
.info-box {
background: var(--vp-c-bg-alt);
padding: 0.75rem;
border-radius: 6px;
font-size: 0.85rem;
color: var(--vp-c-text-2);
line-height: 1.5;
}
.info-box .icon { margin-right: 0.25rem; }
.info-box .highlight {
color: var(--vp-c-brand-1);
font-weight: 500;
}
</style>