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

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

docs/blueprints/frontend-integration/finance-recon.md

@@ -0,0 +1,30 @@
+# Frontend Integration: Finance Reconciliation (财务对账引擎)
+
+## 🎨 UI Layout Sketch
+- **Page Path**: `/erp/finance/reconciliation`
+- **Component Structure**:
+  - `ReconciliationSummary`: Top stats (Total Orders, Matched Count, Discrepancy Amount).
+  - `DiscrepancyCalendar`: Calendar view of discrepancy days.
+  - `ReconTable`: Detailed reconciliation list:
+    - Order ID & Status (Matched, Discrepancy).
+    - Expected Amount (from Order) vs Actual Amount (from Settlement).
+    - Gap ($ Delta).
+    - AI Reasoning (e.g., "Logistics Fee Overcharge", "Tax Miscalculation").
+  - `DetailDrilldown`: Click order to see `DecisionExplainabilityEngine` factors (Expected, Actual, Gap).
+  - `ResolutionCenter`: "Manual Adjust" or "Dispute with Platform" buttons.
+
+## 🔄 Interaction State Machine
+- `INITIAL`: Waiting for settlement data.
+- `RECONCILING`: `FinanceReconService` processing orders.
+- `MATCHED`: Amount aligns within threshold.
+- `DISCREPANCY`: Discrepancy detected, awaiting action.
+- `RESOLVED`: Discrepancy cleared (e.g., through adjustment or refund).
+
+## 🔗 API Mapping
+- `POST /api/v1/finance/reconciliation/run`: Triggers `FinanceReconService.performReconciliation`.
+- `GET /api/v1/finance/reconciliation/list`: Fetches `cf_finance_reconciliation` records.
+- `GET /api/v1/xai/narrative?resourceId={orderId}`: Fetches `DecisionExplainabilityEngine` logic.
+
+## 📈 ROI Visualization
+- "Recovered Funds" from disputes.
+- "Revenue Leakage" trend line.