docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

docs/blueprints/frontend-integration/multi-touch-attribution.md

@@ -0,0 +1,46 @@
+# 前端集成蓝图：多触点归因与利润分析 (Multi-Touch Attribution)
+
+> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_MKT_40 逻辑后产出。
+
+## 1. 业务意图 (Business Intent)
+- **核心价值**：识破平台广告的虚假繁荣，还原真实的流量贡献度，优化营销预算分配。
+- **关联后端 Service**：`MultiTouchAttributionService.ts`
+
+## 2. UI/UX 布局方案 (Layout Design)
+- **页面入口**：Console -> 营销中心 -> 流量归因分析
+- **展示组件**：
+    - [ ] **归因模型切换器**：支持 FIRST_CLICK, LAST_CLICK, LINEAR, TIME_DECAY。
+    - [ ] **渠道贡献饼图**：展示各 Source/Campaign 的成交金额占比。
+    - [ ] **LTV/CAC 趋势图**：对比各渠道的获客成本与长期价值。
+- **交互草图**：
+    ```text
+    +-----------------------------------------------------------+
+    | [Icon] 流量归因分析 (Multi-Touch Attribution)           |
+    +-----------------------------------------------------------+
+    | 当前模型：[ 线性归因 (LINEAR) ▼ ] | 时间范围：[ 过去 30 天 ▼ ] |
+    +-----------------------------------------------------------+
+    | [ 渠道贡献度 (Revenue Contribution) ]                     |
+    | - Google Ads: 45% ($12,000) [==========----------]       |
+    | - Facebook:   30% ($8,000)  [=======------------]       |
+    | - TikTok:     15% ($4,000)  [===----------------]       |
+    | - Organic:    10% ($2,600)  [==-----------------]       |
+    +-----------------------------------------------------------+
+    | [?] AGI 深度洞察：                                        |
+    | "TikTok 渠道虽然 LAST_CLICK 转化低，但在 FIRST_CLICK 模型 |
+    | 下贡献了 40% 的初始流量，建议保持品牌曝光预算。"          |
+    +-----------------------------------------------------------+
+    ```
+
+## 3. API 交互契约 (API Integration)
+- **数据获取**：`GET /api/v1/marketing/attribution?model=LINEAR`
+- **关键字段映射**：
+    - `source` -> 流量来源
+    - `weight` -> 贡献权重
+    - `attributed_value` -> 归因成交额
+- **状态流转**：
+    - 切换模型 -> 发起 API 请求 -> 重新渲染图表。
+
+## 4. 生产校验项 (FE Readiness)
+- [ ] 支持大数量级日志的异步聚合加载。
+- [ ] 归因模型参数配置的持久化存储。
+- [ ] 导出 PDF 格式的归因分析报告。