docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
35
docs/blueprints/frontend-integration/crm-hub.md
Normal file
35
docs/blueprints/frontend-integration/crm-hub.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# Frontend Integration: CRM Hub (客户中枢)
|
||||
|
||||
## 🎨 UI Layout Sketch
|
||||
- **Page Path**: `/business/crm`
|
||||
- **Component Structure**:
|
||||
- `CustomerStats`: Top metrics (Total Customers, Bronze/Silver/Gold/Platinum count).
|
||||
- `CustomerFilter`: Filtering by level, tags, spend, and order count.
|
||||
- `CustomerTable`: List of customers with:
|
||||
- Level badge (e.g., `GOLD` in yellow, `PLATINUM` in purple).
|
||||
- Order count & Total Spend.
|
||||
- Credit Score (e.g., 95 in green).
|
||||
- Tags (e.g., "Frequent Buyer", "B2B", "Low Return Rate").
|
||||
- `Customer360Drawer`: Full profile on click:
|
||||
- `ProfileHeader`: Name, Email, Level, Credit Score.
|
||||
- `OrderHistory`: Timeline of past 10 orders (from `ConsumerOrderService`).
|
||||
- `TransactionHistory`: Reconciliation status of past 5 transactions (from `FinanceReconService`).
|
||||
- `DisputeHistory`: Past complaints and resolutions (from `DisputeArbitrationService`).
|
||||
- `SummaryStats`: Reliability indicator and active disputes count.
|
||||
- `ActionButtons`: "Edit Profile", "Update Credit", "Send Coupon".
|
||||
|
||||
## 🔄 Interaction State Machine
|
||||
- `INITIAL`: Fetching global customer profiles.
|
||||
- `FILTERING`: User applying criteria.
|
||||
- `VIEWING`: Drawer open with 360 view.
|
||||
- `UPDATING`: User adjusting credit score or tags.
|
||||
- `COMMUNICATING`: User sending email or coupon.
|
||||
|
||||
## 🔗 API Mapping
|
||||
- `GET /api/v1/crm/list`: Fetches `cf_customer_profiles`.
|
||||
- `GET /api/v1/crm/360?customerId={id}`: Triggers `Customer360Service.getCustomer360`.
|
||||
- `POST /api/v1/crm/credit`: Triggers `Customer360Service.updateCreditScore`.
|
||||
|
||||
## 📈 ROI Visualization
|
||||
- "Customer Lifetime Value (LTV)": Total spend per customer over time.
|
||||
- "Churn Rate": Percentage of customers without orders in 90 days.
|
||||
Reference in New Issue
Block a user