feat(docs): add interactive demo components for technical appendices
Add placeholder Vue components for visualizing technical concepts across multiple domains including frontend routing, browser rendering, cache design, queue design, database principles, API design, cloud services, and backend evolution. These components provide interactive educational content for the documentation. Update documentation structure to include new appendix sections and enhance existing content with visual components. Remove unused 'codex' dependency from package.json.
This commit is contained in:
sanbuphy
@@ -0,0 +1,570 @@
|
||||
<!--
|
||||
RoutingRulesDemo.vue
|
||||
路由规则 - 路径匹配/重写/转发
|
||||
-->
|
||||
<template>
|
||||
<div class="routing-rules-demo">
|
||||
<div class="header">
|
||||
<div class="title">🧭 路由规则：如何把请求送到正确的服务？</div>
|
||||
<div class="subtitle">想象成快递分拣中心——根据地址把包裹分配到不同的配送站</div>
|
||||
</div>
|
||||
|
||||
<div class="playground">
|
||||
<div class="playground-header">
|
||||
<div class="playground-title">🎮 路由规则实验室</div>
|
||||
<div class="playground-subtitle">输入一个 URL，看看它会被路由到哪个服务</div>
|
||||
</div>
|
||||
|
||||
<div class="input-section">
|
||||
<div class="input-group">
|
||||
<label>HTTP 方法</label>
|
||||
<select v-model="request.method">
|
||||
<option value="GET">GET</option>
|
||||
<option value="POST">POST</option>
|
||||
<option value="PUT">PUT</option>
|
||||
<option value="DELETE">DELETE</option>
|
||||
</select>
|
||||
</div>
|
||||
<div class="input-group flex-2">
|
||||
<label>URL 路径</label>
|
||||
<input
|
||||
type="text"
|
||||
v-model="request.path"
|
||||
placeholder="/api/users/123"
|
||||
@keyup.enter="matchRoute"
|
||||
/>
|
||||
</div>
|
||||
<div class="input-group">
|
||||
<label>Header (可选)</label>
|
||||
<input
|
||||
type="text"
|
||||
v-model="request.header"
|
||||
placeholder="X-Version: v2"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<button class="match-btn" @click="matchRoute" :disabled="isMatching">
|
||||
{{ isMatching ? '匹配中...' : '🔍 开始匹配' }}
|
||||
</button>
|
||||
|
||||
<div class="result-section" v-if="matchResult">
|
||||
<div :class="['result-card', matchResult.found ? 'success' : 'fail']">
|
||||
<div class="result-header">
|
||||
<div class="result-icon">{{ matchResult.found ? '✅' : '❌' }}</div>
|
||||
<div class="result-title">{{ matchResult.found ? '匹配成功' : '未找到匹配规则' }}</div>
|
||||
</div>
|
||||
<div class="result-detail" v-if="matchResult.found">
|
||||
<div class="detail-row">
|
||||
<span class="label">目标服务：</span>
|
||||
<span class="value service">{{ matchResult.service }}</span>
|
||||
</div>
|
||||
<div class="detail-row">
|
||||
<span class="label">匹配规则：</span>
|
||||
<span class="value">{{ matchResult.rule }}</span>
|
||||
</div>
|
||||
<div class="detail-row">
|
||||
<span class="label">重写后路径：</span>
|
||||
<span class="value path">{{ matchResult.rewrittenPath }}</span>
|
||||
</div>
|
||||
<div class="detail-row">
|
||||
<span class="label">目标地址：</span>
|
||||
<span class="value url">{{ matchResult.targetUrl }}</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="result-suggestion" v-else>
|
||||
<p>💡 建议检查：</p>
|
||||
<ul>
|
||||
<li>路径是否以 /api 开头？</li>
|
||||
<li>HTTP 方法是否匹配？（GET/POST）</li>
|
||||
<li>Header 条件是否满足？</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="rules-table">
|
||||
<div class="table-title">📋 当前路由规则表</div>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>优先级</th>
|
||||
<th>匹配规则</th>
|
||||
<th>目标服务</th>
|
||||
<th>路径重写</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr v-for="(rule, index) in routingRules" :key="index"
|
||||
:class="{ active: matchResult && matchResult.ruleIndex === index }">
|
||||
<td>{{ index + 1 }}</td>
|
||||
<td><code>{{ rule.match }}</code></td>
|
||||
<td><span class="service-tag">{{ rule.service }}</span></td>
|
||||
<td><code v-if="rule.rewrite">{{ rule.rewrite }}</code><span v-else class="no-rewrite">无</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<div class="quick-presets">
|
||||
<div class="presets-title">🚀 快速测试示例</div>
|
||||
<div class="preset-buttons">
|
||||
<button
|
||||
v-for="preset in presets"
|
||||
:key="preset.name"
|
||||
class="preset-btn"
|
||||
@click="applyPreset(preset)"
|
||||
>
|
||||
{{ preset.name }}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<script setup>
|
||||
import { ref, reactive } from 'vue'
|
||||
|
||||
const request = reactive({
|
||||
method: 'GET',
|
||||
path: '/api/users/123',
|
||||
header: ''
|
||||
})
|
||||
|
||||
const isMatching = ref(false)
|
||||
const matchResult = ref(null)
|
||||
|
||||
const routingRules = [
|
||||
{
|
||||
match: 'Header: X-Version=v2',
|
||||
service: '用户服务V2',
|
||||
rewrite: null
|
||||
},
|
||||
{
|
||||
match: 'Path: /api/users/*',
|
||||
service: '用户服务',
|
||||
rewrite: '/users/*'
|
||||
},
|
||||
{
|
||||
match: 'Path: /api/orders/*',
|
||||
service: '订单服务',
|
||||
rewrite: '/orders/*'
|
||||
},
|
||||
{
|
||||
match: 'Path: /api/pay/*',
|
||||
service: '支付服务',
|
||||
rewrite: '/payments/*'
|
||||
},
|
||||
{
|
||||
match: 'Method: GET, Path: /health',
|
||||
service: '健康检查',
|
||||
rewrite: null
|
||||
}
|
||||
]
|
||||
|
||||
const presets = [
|
||||
{ name: '👤 查询用户', method: 'GET', path: '/api/users/123', header: '' },
|
||||
{ name: '📦 创建订单', method: 'POST', path: '/api/orders', header: '' },
|
||||
{ name: '💳 发起支付', method: 'POST', path: '/api/pay/checkout', header: '' },
|
||||
{ name: '🔍 健康检查', method: 'GET', path: '/health', header: '' },
|
||||
{ name: '🆕 V2版本', method: 'GET', path: '/api/users/456', header: 'X-Version: v2' }
|
||||
]
|
||||
|
||||
const matchRoute = async () => {
|
||||
isMatching.value = true
|
||||
matchResult.value = null
|
||||
|
||||
await new Promise(resolve => setTimeout(resolve, 500))
|
||||
|
||||
const path = request.path
|
||||
const method = request.method
|
||||
const header = request.header
|
||||
|
||||
let found = false
|
||||
let matchedIndex = -1
|
||||
let service = ''
|
||||
let rule = ''
|
||||
let rewrittenPath = path
|
||||
let targetUrl = ''
|
||||
|
||||
if (header.includes('X-Version=v2')) {
|
||||
found = true
|
||||
matchedIndex = 0
|
||||
service = '用户服务V2 (新版本)'
|
||||
rule = 'Header: X-Version=v2'
|
||||
targetUrl = 'http://user-service-v2:8080' + path
|
||||
} else if (path.startsWith('/api/users/')) {
|
||||
found = true
|
||||
matchedIndex = 1
|
||||
service = '用户服务'
|
||||
rule = 'Path: /api/users/*'
|
||||
rewrittenPath = path.replace('/api/users/', '/users/')
|
||||
targetUrl = 'http://user-service:8080' + rewrittenPath
|
||||
} else if (path.startsWith('/api/orders')) {
|
||||
found = true
|
||||
matchedIndex = 2
|
||||
service = '订单服务'
|
||||
rule = 'Path: /api/orders/*'
|
||||
rewrittenPath = path.replace('/api/orders/', '/orders/')
|
||||
targetUrl = 'http://order-service:8080' + rewrittenPath
|
||||
} else if (path.startsWith('/api/pay/')) {
|
||||
found = true
|
||||
matchedIndex = 3
|
||||
service = '支付服务'
|
||||
rule = 'Path: /api/pay/*'
|
||||
rewrittenPath = path.replace('/api/pay/', '/payments/')
|
||||
targetUrl = 'http://payment-service:8080' + rewrittenPath
|
||||
} else if (method === 'GET' && path === '/health') {
|
||||
found = true
|
||||
matchedIndex = 4
|
||||
service = '健康检查'
|
||||
rule = 'Method: GET, Path: /health'
|
||||
targetUrl = 'http://health-check-service:8080/health'
|
||||
}
|
||||
|
||||
matchResult.value = {
|
||||
found,
|
||||
service,
|
||||
rule,
|
||||
ruleIndex: matchedIndex,
|
||||
originalPath: path,
|
||||
rewrittenPath,
|
||||
targetUrl
|
||||
}
|
||||
|
||||
isMatching.value = false
|
||||
}
|
||||
|
||||
const applyPreset = (preset) => {
|
||||
request.method = preset.method
|
||||
request.path = preset.path
|
||||
request.header = preset.header
|
||||
matchResult.value = null
|
||||
}
|
||||
</script>
|
||||
|
||||
<style scoped>
|
||||
.routing-rules-demo {
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
background: var(--vp-c-bg-soft);
|
||||
border-radius: 12px;
|
||||
padding: 1.5rem;
|
||||
margin: 1.5rem 0;
|
||||
font-family: var(--vp-font-family-base);
|
||||
}
|
||||
|
||||
.header {
|
||||
margin-bottom: 1.5rem;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.title {
|
||||
font-weight: 700;
|
||||
font-size: 1.2rem;
|
||||
margin-bottom: 0.5rem;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.subtitle {
|
||||
color: var(--vp-c-text-2);
|
||||
font-size: 0.9rem;
|
||||
}
|
||||
|
||||
.playground {
|
||||
background: var(--vp-c-bg);
|
||||
border-radius: 12px;
|
||||
padding: 1.5rem;
|
||||
margin-bottom: 1.5rem;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
}
|
||||
|
||||
.playground-header {
|
||||
margin-bottom: 1.5rem;
|
||||
}
|
||||
|
||||
.playground-title {
|
||||
font-weight: 700;
|
||||
font-size: 1.1rem;
|
||||
margin-bottom: 0.25rem;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.playground-subtitle {
|
||||
font-size: 0.85rem;
|
||||
color: var(--vp-c-text-2);
|
||||
}
|
||||
|
||||
.input-section {
|
||||
display: grid;
|
||||
grid-template-columns: auto 2fr 1fr;
|
||||
gap: 1rem;
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.input-group {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 0.5rem;
|
||||
}
|
||||
|
||||
.input-group.flex-2 {
|
||||
flex: 2;
|
||||
}
|
||||
|
||||
.input-group label {
|
||||
font-size: 0.8rem;
|
||||
font-weight: 600;
|
||||
color: var(--vp-c-text-2);
|
||||
text-transform: uppercase;
|
||||
}
|
||||
|
||||
.input-group input,
|
||||
.input-group select {
|
||||
padding: 0.75rem;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 8px;
|
||||
font-size: 0.95rem;
|
||||
background: var(--vp-c-bg);
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.input-group input:focus,
|
||||
.input-group select:focus {
|
||||
outline: none;
|
||||
border-color: var(--vp-c-brand);
|
||||
}
|
||||
|
||||
.match-btn {
|
||||
width: 100%;
|
||||
padding: 1rem;
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
border: none;
|
||||
border-radius: 8px;
|
||||
font-weight: 600;
|
||||
font-size: 1rem;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s;
|
||||
}
|
||||
|
||||
.match-btn:hover:not(:disabled) {
|
||||
transform: translateY(-2px);
|
||||
box-shadow: 0 4px 12px rgba(var(--vp-c-brand-rgb), 0.3);
|
||||
}
|
||||
|
||||
.match-btn:disabled {
|
||||
opacity: 0.6;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
.result-section {
|
||||
margin-top: 1.5rem;
|
||||
}
|
||||
|
||||
.result-card {
|
||||
border-radius: 10px;
|
||||
padding: 1.25rem;
|
||||
border: 2px solid;
|
||||
}
|
||||
|
||||
.result-card.success {
|
||||
background: rgba(34, 197, 94, 0.1);
|
||||
border-color: #22c55e;
|
||||
}
|
||||
|
||||
.result-card.fail {
|
||||
background: rgba(239, 68, 68, 0.1);
|
||||
border-color: #ef4444;
|
||||
}
|
||||
|
||||
.result-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.75rem;
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.result-icon {
|
||||
font-size: 1.5rem;
|
||||
}
|
||||
|
||||
.result-title {
|
||||
font-weight: 700;
|
||||
font-size: 1.1rem;
|
||||
}
|
||||
|
||||
.result-detail {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 0.75rem;
|
||||
}
|
||||
|
||||
.detail-row {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.detail-row .label {
|
||||
font-weight: 600;
|
||||
color: var(--vp-c-text-2);
|
||||
min-width: 100px;
|
||||
}
|
||||
|
||||
.detail-row .value {
|
||||
font-family: monospace;
|
||||
background: var(--vp-c-bg-soft);
|
||||
padding: 0.25rem 0.5rem;
|
||||
border-radius: 4px;
|
||||
font-size: 0.9rem;
|
||||
}
|
||||
|
||||
.detail-row .value.service {
|
||||
background: rgba(34, 197, 94, 0.2);
|
||||
color: #15803d;
|
||||
}
|
||||
|
||||
.detail-row .value.path {
|
||||
background: rgba(59, 130, 246, 0.2);
|
||||
color: #1d4ed8;
|
||||
}
|
||||
|
||||
.detail-row .value.url {
|
||||
background: rgba(168, 85, 247, 0.2);
|
||||
color: #7c3aed;
|
||||
}
|
||||
|
||||
.result-suggestion {
|
||||
color: var(--vp-c-text-2);
|
||||
}
|
||||
|
||||
.result-suggestion ul {
|
||||
margin: 0.5rem 0 0 0;
|
||||
padding-left: 1.5rem;
|
||||
}
|
||||
|
||||
.result-suggestion li {
|
||||
margin: 0.25rem 0;
|
||||
}
|
||||
|
||||
.rules-table {
|
||||
background: var(--vp-c-bg);
|
||||
border-radius: 12px;
|
||||
padding: 1.5rem;
|
||||
margin-bottom: 1.5rem;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
}
|
||||
|
||||
.table-title {
|
||||
font-weight: 700;
|
||||
font-size: 1.1rem;
|
||||
margin-bottom: 1rem;
|
||||
text-align: center;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
font-size: 0.85rem;
|
||||
}
|
||||
|
||||
th, td {
|
||||
padding: 0.75rem;
|
||||
text-align: left;
|
||||
border-bottom: 1px solid var(--vp-c-divider);
|
||||
}
|
||||
|
||||
th {
|
||||
font-weight: 600;
|
||||
background: var(--vp-c-bg-soft);
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
tr:hover {
|
||||
background: var(--vp-c-bg-soft);
|
||||
}
|
||||
|
||||
tr.active {
|
||||
background: rgba(34, 197, 94, 0.1);
|
||||
}
|
||||
|
||||
.service-tag {
|
||||
display: inline-block;
|
||||
padding: 0.25rem 0.5rem;
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
border-radius: 4px;
|
||||
font-size: 0.75rem;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
code {
|
||||
font-family: monospace;
|
||||
background: var(--vp-c-bg-soft);
|
||||
padding: 0.2rem 0.4rem;
|
||||
border-radius: 4px;
|
||||
font-size: 0.85em;
|
||||
}
|
||||
|
||||
.quick-presets {
|
||||
background: var(--vp-c-bg);
|
||||
border-radius: 12px;
|
||||
padding: 1.5rem;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
}
|
||||
|
||||
.presets-title {
|
||||
font-weight: 700;
|
||||
font-size: 1.1rem;
|
||||
margin-bottom: 1rem;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.preset-buttons {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 0.75rem;
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
.preset-btn {
|
||||
padding: 0.6rem 1rem;
|
||||
background: var(--vp-c-bg-soft);
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 8px;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s;
|
||||
font-size: 0.9rem;
|
||||
}
|
||||
|
||||
.preset-btn:hover {
|
||||
border-color: var(--vp-c-brand);
|
||||
background: rgba(var(--vp-c-brand-rgb), 0.1);
|
||||
}
|
||||
|
||||
@media (max-width: 768px) {
|
||||
.input-section {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.detail-row {
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
}
|
||||
|
||||
.detail-row .label {
|
||||
min-width: auto;
|
||||
}
|
||||
|
||||
table {
|
||||
font-size: 0.75rem;
|
||||
}
|
||||
|
||||
th, td {
|
||||
padding: 0.5rem;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
Reference in New Issue
Block a user