From 11c6c746347193bb8ad3830c66df8ace9d82b534 Mon Sep 17 00:00:00 2001
From: xiong <xiongyuxing@gongxue100.com>
Date: Wed, 29 Jul 2026 15:42:23 +0800
Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=B7=BB=E5=8A=A0=20TIKU=20Backe?=
 =?UTF-8?q?nd=20=E5=BD=93=E5=89=8D=E6=8A=80=E6=9C=AF=E6=9E=B6=E6=9E=84?=
 =?UTF-8?q?=E5=9B=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                 |   2 +
 docs/assets/tiku-backend-architecture.svg | 236 ++++++++++++++++++++++
 2 files changed, 238 insertions(+)
 create mode 100644 docs/assets/tiku-backend-architecture.svg

diff --git a/README.md b/README.md
index f92b6df..0f57511 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 题库 SaaS 的正式后端。项目已收敛到 ASP.NET Core + EF Core + PostgreSQL，本仓库是后续开发的唯一目标后端。架构决策见 [ADR 0001](docs/adr/0001-authoritative-dotnet-backend.md)。
 
+![TIKU Backend 技术架构图](docs/assets/tiku-backend-architecture.svg)
+
 ## 架构边界
 
 - 旧 NestJS / Supabase 仓库只作为业务行为和接口清单参考，不作为运行时依赖。
diff --git a/docs/assets/tiku-backend-architecture.svg b/docs/assets/tiku-backend-architecture.svg
new file mode 100644
index 0000000..797c191
--- /dev/null
+++ b/docs/assets/tiku-backend-architecture.svg
@@ -0,0 +1,236 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1080" viewBox="0 0 1600 1080" role="img" aria-labelledby="title desc">
+  <title id="title">TIKU Backend 当前技术架构图</title>
+  <desc id="desc">TIKU Backend 是 ASP.NET Core 模块化单体。API、Worker 和 DbMigrator 共享 Application 契约、Infrastructure 实现以及 PostgreSQL、Redis、RabbitMQ 和外部服务。</desc>
+  <defs>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
+      <path d="M0 0L10 5L0 10Z" fill="#334155"/>
+    </marker>
+    <marker id="arrowBlue" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
+      <path d="M0 0L10 5L0 10Z" fill="#1686d9"/>
+    </marker>
+    <style>
+      text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif; letter-spacing: 0; }
+      .bg { fill: #fff; }
+      .title { fill: #172033; font-size: 34px; font-weight: 700; }
+      .subtitle { fill: #5f6b7a; font-size: 16px; font-weight: 400; }
+      .group { fill: #fbfdff; stroke: #1686d9; stroke-width: 2; stroke-dasharray: 10 8; }
+      .group-title { fill: #e11d2e; font-size: 22px; font-weight: 700; }
+      .node { fill: #fff; stroke: #cbd5e1; stroke-width: 1.5; }
+      .node-blue { fill: #edf7ff; stroke: #69aee0; stroke-width: 1.5; }
+      .node-green { fill: #effaf3; stroke: #78bc8b; stroke-width: 1.5; }
+      .node-amber { fill: #fff8e8; stroke: #d5ad52; stroke-width: 1.5; }
+      .node-violet { fill: #f7f1fb; stroke: #ae8bc3; stroke-width: 1.5; }
+      .node-title { fill: #172033; font-size: 17px; font-weight: 700; }
+      .node-text { fill: #526070; font-size: 13px; font-weight: 400; }
+      .node-tiny { fill: #64748b; font-size: 12px; font-weight: 400; }
+      .badge { fill: #1686d9; }
+      .badge-text { fill: #fff; font-size: 16px; font-weight: 700; text-anchor: middle; dominant-baseline: central; }
+      .edge { fill: none; stroke: #334155; stroke-width: 1.8; marker-end: url(#arrow); }
+      .edge-blue { fill: none; stroke: #1686d9; stroke-width: 2; marker-end: url(#arrowBlue); }
+      .edge-dash { fill: none; stroke: #64748b; stroke-width: 1.6; stroke-dasharray: 7 6; marker-end: url(#arrow); }
+      .edge-label { fill: #475569; font-size: 13px; font-weight: 500; }
+      .boundary { fill: #fffdf4; stroke: #d2ad3e; stroke-width: 1.5; stroke-dasharray: 8 6; }
+      .boundary-text { fill: #614d11; font-size: 14px; font-weight: 500; }
+    </style>
+  </defs>
+
+  <rect class="bg" width="1600" height="1080"/>
+  <text class="title" x="56" y="54">TIKU Backend 当前技术架构</text>
+  <text class="subtitle" x="57" y="82">ASP.NET Core 模块化单体 · Application 定义契约与上下文 · Infrastructure 提供业务、持久化和 Provider 实现</text>
+
+  <!-- Clients -->
+  <text class="group-title" x="48" y="129">访问端</text>
+  <rect class="group" x="40" y="145" width="230" height="570" rx="4"/>
+
+  <rect class="node-blue" x="66" y="180" width="178" height="92" rx="6"/>
+  <circle class="badge" cx="96" cy="211" r="18"/>
+  <text class="badge-text" x="96" y="211">P</text>
+  <text class="node-title" x="124" y="207">平台管理端</text>
+  <text class="node-text" x="84" y="239">/platform-admin 静态原型</text>
+  <text class="node-tiny" x="84" y="258">平台账号 · SaaS 运营</text>
+
+  <rect class="node-blue" x="66" y="307" width="178" height="92" rx="6"/>
+  <circle class="badge" cx="96" cy="338" r="18"/>
+  <text class="badge-text" x="96" y="338">T</text>
+  <text class="node-title" x="124" y="334">租户管理端</text>
+  <text class="node-text" x="84" y="366">内容与业务运营</text>
+  <text class="node-tiny" x="84" y="385">租户 Realm · RBAC</text>
+
+  <rect class="node-blue" x="66" y="434" width="178" height="92" rx="6"/>
+  <circle class="badge" cx="96" cy="465" r="18"/>
+  <text class="badge-text" x="96" y="465">H5</text>
+  <text class="node-title" x="124" y="461">学员端</text>
+  <text class="node-text" x="84" y="493">H5 / 小程序 / App</text>
+  <text class="node-tiny" x="84" y="512">学习 · 题库 · 商城</text>
+
+  <rect class="node-blue" x="66" y="561" width="178" height="92" rx="6"/>
+  <circle class="badge" cx="96" cy="592" r="18"/>
+  <text class="badge-text" x="96" y="592">↩</text>
+  <text class="node-title" x="124" y="588">外部回调</text>
+  <text class="node-text" x="84" y="620">微信 / 支付通知</text>
+  <text class="node-tiny" x="84" y="639">签名校验 · 幂等处理</text>
+
+  <!-- API -->
+  <text class="group-title" x="318" y="129">HTTP 接入与安全管线</text>
+  <rect class="group" x="310" y="145" width="355" height="570" rx="4"/>
+
+  <rect class="node-blue" x="338" y="180" width="299" height="92" rx="6"/>
+  <circle class="badge" cx="371" cy="211" r="18"/>
+  <text class="badge-text" x="371" y="211">API</text>
+  <text class="node-title" x="402" y="207">Tiku.Api</text>
+  <text class="node-text" x="356" y="239">ASP.NET Core Controller API</text>
+  <text class="node-tiny" x="356" y="258">OpenAPI / Scalar · 静态文件</text>
+
+  <rect class="node" x="338" y="307" width="299" height="184" rx="6"/>
+  <text class="node-title" x="358" y="337">请求管线（按执行顺序）</text>
+  <text class="node-text" x="358" y="367">1  日志 / 异常 / Forwarded Headers / HTTPS</text>
+  <text class="node-text" x="358" y="393">2  Static / Routing / CORS</text>
+  <text class="node-text" x="358" y="419">3  可信 Host 租户解析 / Browser CSRF</text>
+  <text class="node-text" x="358" y="445">4  JWT / 认证分区限流 / Rate Limiter</text>
+  <text class="node-text" x="358" y="471">5  CurrentPrincipal / Authorization / Feature</text>
+
+  <rect class="node-green" x="338" y="526" width="299" height="127" rx="6"/>
+  <text class="node-title" x="358" y="556">Controller 边界</text>
+  <text class="node-text" x="358" y="584">平台 SaaS 管理 · 租户后台</text>
+  <text class="node-text" x="358" y="608">题库内容学习 · 商城增长</text>
+  <text class="node-text" x="358" y="632">认证运行时 · 支付回调 · 后台任务</text>
+
+  <path class="edge-blue" d="M244 226H338"/>
+  <path class="edge-blue" d="M244 353H338"/>
+  <path class="edge-blue" d="M244 480H338"/>
+  <path class="edge-blue" d="M244 607H338"/>
+  <text class="edge-label" x="272" y="214">HTTPS</text>
+
+  <!-- Modular monolith -->
+  <text class="group-title" x="713" y="129">模块化单体业务核心</text>
+  <rect class="group" x="705" y="145" width="565" height="570" rx="4"/>
+
+  <rect class="node-green" x="733" y="180" width="509" height="98" rx="6"/>
+  <text class="node-title" x="755" y="210">Tiku.Application：契约与执行上下文</text>
+  <text class="node-text" x="755" y="239">用例接口 / Provider 接口 · TenantContext · CurrentUser</text>
+  <text class="node-tiny" x="755" y="261">仅引用 Domain；不包含 EF Core 与第三方 SDK</text>
+
+  <rect class="node-amber" x="733" y="307" width="509" height="92" rx="6"/>
+  <text class="node-title" x="755" y="337">Tiku.Domain：领域模型</text>
+  <text class="node-text" x="755" y="366">Identity · Tenant · Catalog · QuestionBank · Content</text>
+  <text class="node-tiny" x="755" y="387">Learning · Commerce · Growth · Operations · Platform</text>
+
+  <rect class="node-violet" x="733" y="428" width="509" height="225" rx="6"/>
+  <text class="node-title" x="755" y="458">Tiku.Infrastructure：当前业务实现与适配器</text>
+
+  <rect class="node" x="755" y="480" width="144" height="142" rx="5"/>
+  <text class="node-title" x="773" y="508">平台底座</text>
+  <text class="node-text" x="773" y="535">身份认证</text>
+  <text class="node-text" x="773" y="558">租户 / 域名</text>
+  <text class="node-text" x="773" y="581">RBAC / Feature</text>
+  <text class="node-text" x="773" y="604">SaaS / 审计</text>
+
+  <rect class="node" x="915" y="480" width="144" height="142" rx="5"/>
+  <text class="node-title" x="933" y="508">教育业务</text>
+  <text class="node-text" x="933" y="535">分类 / 内容</text>
+  <text class="node-text" x="933" y="558">题库 / 视频</text>
+  <text class="node-text" x="933" y="581">学习 / 分数线</text>
+  <text class="node-text" x="933" y="604">档案 / 资源</text>
+
+  <rect class="node" x="1075" y="480" width="144" height="142" rx="5"/>
+  <text class="node-title" x="1093" y="508">交易增长</text>
+  <text class="node-text" x="1093" y="535">订单 / 支付</text>
+  <text class="node-text" x="1093" y="558">积分 / 推荐</text>
+  <text class="node-text" x="1093" y="581">CRM / 佣金</text>
+  <text class="node-text" x="1093" y="604">平台账务</text>
+
+  <path class="edge-blue" d="M637 589H733"/>
+  <text class="edge-label" x="658" y="577">调用契约</text>
+  <path class="edge" d="M987 278V307"/>
+  <text class="edge-label" x="997" y="298">引用</text>
+  <path class="edge-dash" d="M827 428V399"/>
+  <path class="edge-dash" d="M1147 428C1147 412 1110 407 1050 399"/>
+  <text class="edge-label" x="844" y="418">实现 Application 接口并操作 Domain</text>
+
+  <!-- Processes -->
+  <text class="group-title" x="1318" y="129">独立运行入口</text>
+  <rect class="group" x="1310" y="145" width="250" height="570" rx="4"/>
+
+  <rect class="node-green" x="1336" y="180" width="198" height="192" rx="6"/>
+  <circle class="badge" cx="1368" cy="211" r="18"/>
+  <text class="badge-text" x="1368" y="211">W</text>
+  <text class="node-title" x="1398" y="207">Tiku.Worker</text>
+  <text class="node-text" x="1354" y="242">域名 DNS / TLS 生命周期</text>
+  <text class="node-text" x="1354" y="269">SaaS 订阅生命周期</text>
+  <text class="node-text" x="1354" y="296">Feature 用量校准</text>
+  <text class="node-text" x="1354" y="323">后台任务租约执行</text>
+  <text class="node-text" x="1354" y="350">RabbitMQ 消费者</text>
+
+  <rect class="node-amber" x="1336" y="408" width="198" height="144" rx="6"/>
+  <circle class="badge" cx="1368" cy="439" r="18"/>
+  <text class="badge-text" x="1368" y="439">DB</text>
+  <text class="node-title" x="1398" y="435">Tiku.DbMigrator</text>
+  <text class="node-text" x="1354" y="471">EF Core Migrate</text>
+  <text class="node-text" x="1354" y="498">Development Seed</text>
+  <text class="node-text" x="1354" y="525">平台管理员安全引导</text>
+
+  <rect class="node" x="1336" y="588" width="198" height="65" rx="6"/>
+  <text class="node-title" x="1354" y="616">共享组合方式</text>
+  <text class="node-tiny" x="1354" y="638">Application + Infrastructure</text>
+
+  <path class="edge-dash" d="M1336 276H1242"/>
+  <path class="edge-dash" d="M1336 480H1242"/>
+
+  <!-- Data and external systems -->
+  <text class="group-title" x="48" y="773">数据、消息与外部服务</text>
+  <rect class="group" x="40" y="790" width="1520" height="212" rx="4"/>
+
+  <rect class="node-violet" x="70" y="826" width="270" height="138" rx="6"/>
+  <circle class="badge" cx="105" cy="859" r="20"/>
+  <text class="badge-text" x="105" y="859">PG</text>
+  <text class="node-title" x="139" y="854">PostgreSQL</text>
+  <text class="node-text" x="92" y="892">EF Core 实体 / Identity / AuthSession</text>
+  <text class="node-text" x="92" y="917">业务数据 / BackgroundJob / Outbox</text>
+  <text class="node-tiny" x="92" y="944">Query Filter · 写入拦截 · 数据库 Guard</text>
+
+  <rect class="node-violet" x="372" y="826" width="205" height="138" rx="6"/>
+  <circle class="badge" cx="407" cy="859" r="20"/>
+  <text class="badge-text" x="407" y="859">R</text>
+  <text class="node-title" x="441" y="854">Redis</text>
+  <text class="node-text" x="394" y="892">安全状态与失效广播</text>
+  <text class="node-text" x="394" y="917">分布式缓存</text>
+  <text class="node-tiny" x="394" y="944">Production 必需</text>
+
+  <rect class="node-violet" x="609" y="826" width="225" height="138" rx="6"/>
+  <circle class="badge" cx="644" cy="859" r="20"/>
+  <text class="badge-text" x="644" y="859">MQ</text>
+  <text class="node-title" x="678" y="854">RabbitMQ</text>
+  <text class="node-text" x="631" y="892">MassTransit + EF Outbox</text>
+  <text class="node-text" x="631" y="917">安全状态 / 后台任务消息</text>
+  <text class="node-tiny" x="631" y="944">API 发布 · Worker 消费</text>
+
+  <rect class="node-blue" x="866" y="826" width="205" height="138" rx="6"/>
+  <text class="node-title" x="890" y="856">对象存储</text>
+  <text class="node-text" x="890" y="892">Alibaba Cloud OSS</text>
+  <text class="node-text" x="890" y="917">预签名上传 / 资源访问</text>
+  <text class="node-tiny" x="890" y="944">IObjectStorageService</text>
+
+  <rect class="node-blue" x="1103" y="826" width="205" height="138" rx="6"/>
+  <text class="node-title" x="1127" y="856">通信与支付</text>
+  <text class="node-text" x="1127" y="892">阿里云短信 · 微信 OAuth</text>
+  <text class="node-text" x="1127" y="917">微信支付 · 支付宝</text>
+  <text class="node-tiny" x="1127" y="944">租户级配置与加密 Secret</text>
+
+  <rect class="node-blue" x="1340" y="826" width="190" height="138" rx="6"/>
+  <text class="node-title" x="1364" y="856">域名基础设施</text>
+  <text class="node-text" x="1364" y="892">DNS 所有权校验</text>
+  <text class="node-text" x="1364" y="917">HTTP 网关开通</text>
+  <text class="node-tiny" x="1364" y="944">自定义域名生命周期</text>
+
+  <path class="edge" d="M850 715C850 766 205 768 205 826"/>
+  <path class="edge" d="M930 715C930 774 474 770 474 826"/>
+  <path class="edge" d="M1010 715C1010 780 721 774 721 826"/>
+  <path class="edge" d="M1070 715C1070 766 968 770 968 826"/>
+  <path class="edge" d="M1130 715C1130 765 1205 770 1205 826"/>
+  <path class="edge" d="M1190 715C1190 756 1435 766 1435 826"/>
+  <path class="edge-dash" d="M1435 653V748C1435 778 721 784 721 826"/>
+
+  <!-- Project dependency direction -->
+  <rect class="boundary" x="40" y="1025" width="1520" height="38" rx="4"/>
+  <text class="boundary-text" x="61" y="1050">项目依赖方向：Api → Application + Infrastructure ｜ Worker → Application + Infrastructure ｜ DbMigrator → Infrastructure ｜ Infrastructure → Application + Domain + Contracts ｜ Application → Domain</text>
+</svg>