Files
wangjia 3ae96ef229 docs: 新增整体架构设计文档(doc/,HTML 七章)
覆盖前端五端/后端/MySQL/弹性节点拓扑/Web安全/安全总纲,遵循 design/ 设计系统视觉呈现。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 23:57:49 +08:00

409 lines
17 KiB
CSS
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/* =============================================================
穿山甲 · Pangolin — 架构设计文档样式
令牌部分逐字拷贝自 design/colors_and_type.css(唯一真相源);
改令牌请先改源文件再同步此处。文档版式附在令牌之后。
============================================================= */
@import url('https://fonts.googleapis.com/css2?family=Sora:wght@500;600;700&family=Manrope:wght@400;500;600;700&family=Noto+Sans+SC:wght@400;500;700&family=JetBrains+Mono:wght@400;500&display=swap');
:root {
/* Clay / Copper — the pangolin-armor primary (warm earth) */
--clay-50: #FAF3ED;
--clay-100: #F2E2D4;
--clay-200: #E6C7AC;
--clay-300: #D9A982;
--clay-400: #CC8B5C;
--clay-500: #B96A3D; /* ← brand primary */
--clay-600: #9E5630;
--clay-700: #7E4426;
--clay-800: #5E331D;
--clay-900: #3D2213;
/* Sand / Taupe — warm neutral ramp */
--sand-50: #FAF8F4;
--sand-100: #F2EEE7;
--sand-200: #E6DFD3;
--sand-300: #D2C8B8;
--sand-400: #B0A491;
--sand-500: #8C8270;
--sand-600: #6B6253;
--sand-700: #4E4940;
--sand-800: #2E2A24;
--sand-900: #1F1C18;
--sand-950: #14110E;
/* Semantic hues (earth-tuned) */
--green-400: #7FB07A;
--green-500: #5B8C5A;
--green-600: #467046;
--amber-400: #E2B05A;
--amber-500: #D69A3C;
--amber-600: #B47E29;
--red-400: #D4715A;
--red-500: #C0533B;
--red-600: #9E4230;
/* Semantic tokens — light */
--bg: var(--sand-50);
--bg-subtle: var(--sand-100);
--surface: #FFFFFF;
--surface-2: var(--sand-50);
--overlay: rgba(31, 28, 24, 0.45);
--fg1: var(--sand-900);
--fg2: var(--sand-600);
--fg3: var(--sand-500);
--fg-on-accent: #FFFFFF;
--accent: var(--clay-500);
--accent-hover: var(--clay-600);
--accent-press: var(--clay-700);
--accent-subtle: var(--clay-50);
--accent-border: var(--clay-200);
--border: var(--sand-200);
--border-strong: var(--sand-300);
--ring: rgba(185, 106, 61, 0.35);
--success: var(--green-500);
--success-subtle: #E9F0E6;
--warning: var(--amber-500);
--warning-subtle: #F8EED6;
--danger: var(--red-500);
--danger-subtle: #F6E1DA;
/* Typography */
--font-display: 'Sora', 'Noto Sans SC', system-ui, sans-serif;
--font-sans: 'Manrope', 'Noto Sans SC', system-ui, sans-serif;
--font-cjk: 'Noto Sans SC', 'Manrope', system-ui, sans-serif;
--font-mono: 'JetBrains Mono', ui-monospace, 'SFMono-Regular', monospace;
--text-display-xl: 3rem;
--text-display: 2.25rem;
--text-h1: 1.875rem;
--text-h2: 1.5rem;
--text-h3: 1.25rem;
--text-body-lg: 1.125rem;
--text-body: 1rem;
--text-sm: 0.875rem;
--text-caption: 0.75rem;
--leading-tight: 1.15;
--leading-snug: 1.3;
--leading-normal:1.5;
--leading-relaxed:1.65;
--tracking-tight: -0.02em;
--tracking-snug: -0.01em;
--tracking-wide: 0.04em;
--tracking-caps: 0.08em;
/* Spacing (4px base) */
--space-1: 0.25rem;
--space-2: 0.5rem;
--space-3: 0.75rem;
--space-4: 1rem;
--space-5: 1.25rem;
--space-6: 1.5rem;
--space-8: 2rem;
--space-10: 2.5rem;
--space-12: 3rem;
--space-16: 4rem;
/* Radii */
--radius-sm: 6px;
--radius-md: 10px;
--radius-lg: 14px;
--radius-xl: 20px;
--radius-2xl: 28px;
--radius-full: 999px;
/* Shadows (warm-tinted, soft) */
--shadow-sm: 0 1px 2px rgba(45, 30, 20, 0.06);
--shadow-md: 0 4px 14px rgba(45, 30, 20, 0.08);
--shadow-lg: 0 12px 32px rgba(45, 30, 20, 0.12);
--shadow-xl: 0 24px 60px rgba(45, 30, 20, 0.16);
--shadow-focus: 0 0 0 4px var(--ring);
/* Motion */
--ease-out: cubic-bezier(0.22, 1, 0.36, 1);
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
--dur-fast: 140ms;
--dur-base: 220ms;
--dur-slow: 360ms;
}
[data-theme="dark"] {
--bg: var(--sand-950);
--bg-subtle: var(--sand-900);
--surface: #221E19;
--surface-2: #2A251F;
--overlay: rgba(0, 0, 0, 0.6);
--fg1: #F4EFE8;
--fg2: #B6AC9C;
--fg3: #897F6F;
--fg-on-accent: #1F1C18;
--accent: var(--clay-400);
--accent-hover: var(--clay-300);
--accent-press: var(--clay-500);
--accent-subtle: rgba(204, 139, 92, 0.14);
--accent-border: rgba(204, 139, 92, 0.30);
--border: rgba(242, 238, 231, 0.10);
--border-strong: rgba(242, 238, 231, 0.18);
--ring: rgba(204, 139, 92, 0.45);
--success: var(--green-400);
--success-subtle: rgba(127, 176, 122, 0.16);
--warning: var(--amber-400);
--warning-subtle: rgba(226, 176, 90, 0.16);
--danger: var(--red-400);
--danger-subtle: rgba(212, 113, 90, 0.16);
--shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4);
--shadow-md: 0 4px 14px rgba(0, 0, 0, 0.45);
--shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.5);
--shadow-xl: 0 24px 60px rgba(0, 0, 0, 0.55);
}
/* =============================================================
文档版式(doc-only
============================================================= */
* { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; }
body {
background: var(--bg);
color: var(--fg1);
font-family: var(--font-sans);
font-size: var(--text-body);
line-height: var(--leading-normal);
transition: background-color var(--dur-base) var(--ease-in-out), color var(--dur-base) var(--ease-in-out);
}
a { color: var(--accent); text-decoration: none; transition: color var(--dur-fast) var(--ease-in-out); }
a:hover { color: var(--accent-hover); }
strong { font-weight: 600; }
/* ---- 顶栏 ---- */
.site-header {
position: sticky; top: 0; z-index: 50;
backdrop-filter: blur(12px);
background: color-mix(in srgb, var(--bg) 82%, transparent);
border-bottom: 1px solid var(--border);
}
.site-header .inner {
max-width: 1120px; margin: 0 auto;
display: flex; align-items: center; gap: var(--space-4);
padding: var(--space-3) var(--space-6);
}
.brand { display: flex; align-items: center; gap: var(--space-2); color: var(--fg1); }
.brand img { width: 26px; height: 26px; display: block; }
.brand .zh { font-family: var(--font-display); font-weight: 600; font-size: var(--text-body); letter-spacing: var(--tracking-snug); }
.brand .en { font-size: 0.625rem; font-weight: 600; letter-spacing: var(--tracking-caps); color: var(--fg3); text-transform: uppercase; }
.site-nav { margin-left: auto; display: flex; gap: 2px; flex-wrap: wrap; }
.site-nav a {
padding: 5px 11px; border-radius: var(--radius-full);
font-size: var(--text-sm); color: var(--fg2); white-space: nowrap;
transition: background-color var(--dur-fast) var(--ease-in-out), color var(--dur-fast) var(--ease-in-out);
}
.site-nav a:hover { background: var(--accent-subtle); color: var(--accent); }
.site-nav a.active { background: var(--accent-subtle); color: var(--accent); font-weight: 600; }
.theme-btn {
margin-left: var(--space-2);
width: 32px; height: 32px; border-radius: var(--radius-full);
border: 1px solid var(--border); background: var(--surface); color: var(--fg2);
cursor: pointer; display: grid; place-items: center;
transition: border-color var(--dur-fast) var(--ease-in-out);
}
.theme-btn:hover { border-color: var(--accent-border); color: var(--accent); }
.theme-btn svg { width: 15px; height: 15px; }
/* ---- 正文容器 ---- */
.doc { max-width: 1120px; margin: 0 auto; padding: var(--space-12) var(--space-6) var(--space-16); }
.doc-hero { max-width: 760px; margin-bottom: var(--space-10); }
.overline {
font-size: var(--text-caption); font-weight: 600;
letter-spacing: var(--tracking-caps); text-transform: uppercase;
color: var(--accent); margin-bottom: var(--space-3);
}
h1 {
font-family: var(--font-display); font-size: var(--text-display);
font-weight: 700; line-height: var(--leading-tight); letter-spacing: var(--tracking-tight);
margin-bottom: var(--space-4);
}
.doc-hero .lede { color: var(--fg2); font-size: var(--text-body-lg); line-height: var(--leading-relaxed); }
.doc-meta { display: flex; gap: var(--space-4); margin-top: var(--space-5); font-size: var(--text-caption); color: var(--fg3); font-family: var(--font-mono); }
section { margin-top: var(--space-12); }
h2 {
font-family: var(--font-display); font-size: var(--text-h2); font-weight: 600;
letter-spacing: var(--tracking-snug); line-height: var(--leading-snug);
margin-bottom: var(--space-5);
padding-top: var(--space-2);
}
h2 .num { color: var(--accent); font-family: var(--font-mono); font-size: var(--text-body); font-weight: 500; margin-right: var(--space-2); }
h3 { font-size: var(--text-h3); font-weight: 600; margin: var(--space-8) 0 var(--space-3); }
h4 { font-size: var(--text-body); font-weight: 600; margin: var(--space-6) 0 var(--space-2); }
p { margin-bottom: var(--space-3); color: var(--fg1); max-width: 76ch; }
p.muted, .muted { color: var(--fg2); }
ul, ol { margin: 0 0 var(--space-4) 1.25em; max-width: 76ch; }
li { margin-bottom: var(--space-1); }
li::marker { color: var(--accent); }
/* ---- 卡片与栅格 ---- */
.card {
background: var(--surface); border: 1px solid var(--border);
border-radius: var(--radius-xl); padding: var(--space-6);
box-shadow: var(--shadow-sm);
}
.grid2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--space-4); }
.grid3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--space-4); }
@media (max-width: 860px) { .grid2, .grid3 { grid-template-columns: 1fr; } }
/* 章节导航卡(index 用) */
.chapter-card {
display: block; background: var(--surface); border: 1px solid var(--border);
border-radius: var(--radius-xl); padding: var(--space-6);
box-shadow: var(--shadow-sm); color: var(--fg1);
transition: box-shadow var(--dur-base) var(--ease-out), transform var(--dur-base) var(--ease-out), border-color var(--dur-base) var(--ease-out);
}
.chapter-card:hover { box-shadow: var(--shadow-md); transform: translateY(-2px); border-color: var(--accent-border); color: var(--fg1); }
.chapter-card .ic {
width: 38px; height: 38px; border-radius: var(--radius-md);
background: var(--accent-subtle); color: var(--accent);
display: grid; place-items: center; margin-bottom: var(--space-3);
}
.chapter-card .ic svg { width: 19px; height: 19px; }
.chapter-card .no { font-family: var(--font-mono); font-size: var(--text-caption); color: var(--fg3); }
.chapter-card b { display: block; font-family: var(--font-display); font-size: var(--text-body-lg); font-weight: 600; margin: 2px 0 var(--space-2); }
.chapter-card p { font-size: var(--text-sm); color: var(--fg2); margin: 0; }
/* ---- 表格 ---- */
.tbl-wrap { overflow-x: auto; border: 1px solid var(--border); border-radius: var(--radius-lg); background: var(--surface); box-shadow: var(--shadow-sm); margin-bottom: var(--space-4); }
table { width: 100%; border-collapse: collapse; font-size: var(--text-sm); }
th {
text-align: left; background: var(--bg-subtle); color: var(--fg2);
font-size: var(--text-caption); font-weight: 600; letter-spacing: var(--tracking-wide);
padding: 10px 14px; border-bottom: 1px solid var(--border); white-space: nowrap;
}
td { padding: 11px 14px; border-bottom: 1px solid var(--border); vertical-align: top; }
tr:last-child td { border-bottom: none; }
td code, li code, p code {
font-family: var(--font-mono); font-size: 0.85em;
background: var(--bg-subtle); border: 1px solid var(--border);
padding: 1px 6px; border-radius: var(--radius-sm); white-space: nowrap;
}
/* ---- 代码块 ---- */
pre {
background: var(--sand-900); color: #F4EFE8;
padding: var(--space-5); border-radius: var(--radius-lg);
overflow-x: auto; font-size: var(--text-sm); line-height: 1.65;
margin-bottom: var(--space-4); box-shadow: var(--shadow-sm);
}
pre code { font-family: var(--font-mono); background: none; border: none; padding: 0; }
pre .c { color: #8C8270; } /* comment */
pre .k { color: #CC8B5C; } /* keyword (clay-400) */
pre .s { color: #7FB07A; } /* string (green-400) */
[data-theme="dark"] pre { background: var(--surface-2); border: 1px solid var(--border); }
/* ---- 状态胶囊(色点 + 文字,铁律 7) ---- */
.pill {
display: inline-flex; align-items: center; gap: 6px;
padding: 2px 10px; border-radius: var(--radius-full);
font-size: var(--text-caption); font-weight: 600; white-space: nowrap;
}
.pill .dot { width: 7px; height: 7px; border-radius: 50%; flex: none; }
.pill.ok { background: var(--success-subtle); color: var(--success); }
.pill.ok .dot { background: var(--success); }
.pill.warn { background: var(--warning-subtle); color: var(--warning); }
.pill.warn .dot { background: var(--warning); }
.pill.bad { background: var(--danger-subtle); color: var(--danger); }
.pill.bad .dot { background: var(--danger); }
.pill.brand { background: var(--accent-subtle); color: var(--accent); }
.pill.brand .dot { background: var(--accent); }
.pill.dim { background: var(--bg-subtle); color: var(--fg2); }
.pill.dim .dot { background: var(--fg3); }
/* ---- 提示块 ---- */
.callout {
border-left: 3px solid var(--accent); background: var(--accent-subtle);
border-radius: var(--radius-md); padding: var(--space-4) var(--space-5);
margin: var(--space-4) 0; font-size: var(--text-sm); max-width: 86ch;
}
.callout b:first-child { display: block; margin-bottom: 4px; }
.callout.warn { border-left-color: var(--warning); background: var(--warning-subtle); }
.callout.danger { border-left-color: var(--danger); background: var(--danger-subtle); }
.callout.ok { border-left-color: var(--success); background: var(--success-subtle); }
.callout p { margin-bottom: var(--space-2); }
.callout p:last-child, .callout ul:last-child { margin-bottom: 0; }
/* ---- 流程图(CSS 盒 + 箭头) ---- */
.diagram {
background: var(--bg-subtle); border: 1px solid var(--border);
border-radius: var(--radius-xl); padding: var(--space-6);
overflow-x: auto; margin-bottom: var(--space-4);
}
.diagram .cap {
font-size: var(--text-caption); color: var(--fg3); text-align: center;
margin-top: var(--space-4); font-family: var(--font-mono);
}
.flow { display: flex; align-items: center; gap: var(--space-2); flex-wrap: wrap; }
.flow + .flow { margin-top: var(--space-4); }
.fbox {
background: var(--surface); border: 1.5px solid var(--border-strong);
border-radius: var(--radius-lg); padding: var(--space-3) var(--space-4);
min-width: 110px; text-align: center; flex: none;
box-shadow: var(--shadow-sm);
}
.fbox b { display: block; font-size: var(--text-sm); font-weight: 600; }
.fbox span { display: block; font-size: var(--text-caption); color: var(--fg3); margin-top: 2px; }
.fbox.accent { border-color: var(--accent-border); background: var(--accent-subtle); }
.fbox.accent b { color: var(--accent); }
.fbox.ok { border-color: var(--success); background: var(--success-subtle); }
.fbox.ok b { color: var(--success); }
.fbox.warn { border-color: var(--warning); background: var(--warning-subtle); }
.fbox.warn b { color: var(--warning); }
.fbox.bad { border-color: var(--danger); background: var(--danger-subtle); }
.fbox.bad b { color: var(--danger); }
.fbox.ghost { border-style: dashed; background: transparent; }
.farr { color: var(--fg3); font-family: var(--font-mono); font-size: var(--text-sm); flex: none; padding: 0 2px; }
.fnote { font-size: var(--text-caption); color: var(--fg3); flex-basis: 100%; }
/* 分层堆叠图 */
.stack { display: flex; flex-direction: column; gap: var(--space-2); }
.stack .layer {
background: var(--surface); border: 1px solid var(--border);
border-radius: var(--radius-lg); padding: var(--space-3) var(--space-5);
display: flex; align-items: baseline; gap: var(--space-4); flex-wrap: wrap;
}
.stack .layer .t { font-weight: 600; font-size: var(--text-sm); min-width: 11em; }
.stack .layer .d { font-size: var(--text-caption); color: var(--fg2); }
.stack .layer.accent { background: var(--accent-subtle); border-color: var(--accent-border); }
.stack .layer.accent .t { color: var(--accent); }
/* ---- 翻页 ---- */
.pager {
max-width: 1120px; margin: 0 auto; padding: 0 var(--space-6) var(--space-16);
display: flex; justify-content: space-between; gap: var(--space-4);
}
.pager a {
flex: 1; max-width: 380px; display: block;
background: var(--surface); border: 1px solid var(--border);
border-radius: var(--radius-lg); padding: var(--space-4) var(--space-5);
color: var(--fg1); box-shadow: var(--shadow-sm);
transition: border-color var(--dur-fast) var(--ease-in-out), box-shadow var(--dur-base) var(--ease-out);
}
.pager a:hover { border-color: var(--accent-border); box-shadow: var(--shadow-md); }
.pager a span { display: block; font-size: var(--text-caption); color: var(--fg3); margin-bottom: 2px; }
.pager a b { font-size: var(--text-sm); font-weight: 600; }
.pager a.next { text-align: right; margin-left: auto; }
footer.colophon {
text-align: center; padding: var(--space-8) var(--space-6) var(--space-12);
font-size: var(--text-caption); color: var(--fg3); border-top: 1px solid var(--border);
}