refactor: 重构项目结构并优化代码
- 删除无用的文件和错误日志 - 创建统一的 imports 模块集中管理依赖 - 重构组件使用新的 imports 方式 - 修复文档路径大小写问题 - 优化类型定义和接口导出 - 更新依赖版本 - 改进错误处理和API配置 - 统一组件导出方式
This commit is contained in:
@@ -70,6 +70,157 @@
|
||||
- **输入**：系统数据、日志数据、监控指标
|
||||
- **输出**：监控报告、告警通知、运维操作记录
|
||||
|
||||
### 6️⃣5️⃣.1 操作日志可视化
|
||||
|
||||
> 为业务闭环提供统一的操作日志记录和可视化追踪
|
||||
|
||||
#### 日志数据模型
|
||||
|
||||
```typescript
|
||||
interface OperationLog {
|
||||
id: string; // 唯一ID (UUID)
|
||||
timestamp: string; // ISO 8601 时间戳
|
||||
businessType: 'TOC' | 'TOB'; // 业务类型
|
||||
|
||||
// 五元组
|
||||
tenantId: string;
|
||||
shopId: string;
|
||||
taskId?: string;
|
||||
traceId: string;
|
||||
|
||||
// 操作信息
|
||||
loop: string; // 闭环标识，如 "OrderFulfillment"
|
||||
loopName: string; // 闭环名称，如 "订单履约"
|
||||
stage: string; // 当前阶段
|
||||
stageName: string; // 阶段名称
|
||||
|
||||
// 执行者
|
||||
actor: 'AI' | 'USER' | 'SYSTEM';
|
||||
actorId?: string; // 操作人ID
|
||||
actorName?: string; // 操作人名称
|
||||
|
||||
// 状态变化
|
||||
beforeState?: string;
|
||||
afterState: string;
|
||||
|
||||
// 操作详情
|
||||
action: string; // 操作类型：CREATE/UPDATE/DELETE/APPROVE/REJECT
|
||||
actionName: string; // 操作名称
|
||||
details?: Record<string, any>; // 详细信息
|
||||
|
||||
// 异常处理
|
||||
error?: string;
|
||||
errorCode?: string;
|
||||
|
||||
// 关联
|
||||
parentTraceId?: string; // 父链路追踪ID
|
||||
children?: string[]; // 子链路IDs
|
||||
}
|
||||
```
|
||||
|
||||
#### 日志表设计
|
||||
|
||||
```sql
|
||||
CREATE TABLE cf_operation_logs (
|
||||
id VARCHAR(64) PRIMARY KEY,
|
||||
timestamp DATETIME(3) NOT NULL,
|
||||
business_type ENUM('TOC', 'TOB') NOT NULL,
|
||||
|
||||
-- 五元组
|
||||
tenant_id VARCHAR(64) NOT NULL,
|
||||
shop_id VARCHAR(64) NOT NULL,
|
||||
task_id VARCHAR(64),
|
||||
trace_id VARCHAR(64) NOT NULL,
|
||||
|
||||
-- 操作信息
|
||||
loop VARCHAR(64) NOT NULL, -- 闭环标识
|
||||
loop_name VARCHAR(128) NOT NULL, -- 闭环名称
|
||||
stage VARCHAR(64) NOT NULL, -- 阶段标识
|
||||
stage_name VARCHAR(128) NOT NULL, -- 阶段名称
|
||||
|
||||
-- 执行者
|
||||
actor ENUM('AI', 'USER', 'SYSTEM') NOT NULL,
|
||||
actor_id VARCHAR(64),
|
||||
actor_name VARCHAR(128),
|
||||
|
||||
-- 状态
|
||||
before_state VARCHAR(64),
|
||||
after_state VARCHAR(64) NOT NULL,
|
||||
|
||||
-- 操作
|
||||
action VARCHAR(32) NOT NULL,
|
||||
action_name VARCHAR(128) NOT NULL,
|
||||
details JSON,
|
||||
|
||||
-- 异常
|
||||
error TEXT,
|
||||
error_code VARCHAR(32),
|
||||
|
||||
-- 关联
|
||||
parent_trace_id VARCHAR(64),
|
||||
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||
|
||||
INDEX idx_tenant_shop (tenant_id, shop_id),
|
||||
INDEX idx_trace_id (trace_id),
|
||||
INDEX idx_timestamp (timestamp),
|
||||
INDEX idx_loop_stage (loop, stage)
|
||||
);
|
||||
```
|
||||
|
||||
#### 可视化界面设计
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ 📋 操作日志中心 [导出] [筛选] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ 租户: [T001 - 测试租户 ▼] 店铺: [全部 ▼] │
|
||||
│ 闭环: [全部 ▼] 阶段: [全部 ▼] 操作: [全部 ▼] │
|
||||
│ 时间: [2026-03-26 00:00] ~ [2026-03-26 23:59] [搜索...] │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ● 14:32:15 AI 订单履约 - 订单审核 │
|
||||
│ │ tenant: T001 shop: S001 trace: TRX-789456 │
|
||||
│ │ ✅ 待审核 → 已确认 │
|
||||
│ │ 📝 AI建议：订单金额$299，低于阈值，自动通过 │
|
||||
│ ▼ │
|
||||
│ │
|
||||
│ ● 14:30:02 USER 订单履约 - 分仓 │
|
||||
│ │ tenant: T001 shop: S001 trace: TRX-789123 │
|
||||
│ │ ✅ 已确认 → 已分仓 │
|
||||
│ │ 👤 操作人: admin@company.com │
|
||||
│ │ 📦 仓库: WH-SH-01 (上海仓) │
|
||||
│ ▼ │
|
||||
│ │
|
||||
│ ● 14:28:45 SYSTEM 订单履约 - 订单确认 │
|
||||
│ │ tenant: T001 shop: S001 trace: TRX-789000 │
|
||||
│ │ ⏰ 5分钟前异常已自动恢复 │
|
||||
│ │ ⚠️ 告警: 支付回调延迟，但已自动重试成功 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
#### 日志节点状态对应
|
||||
|
||||
| 状态 | 图标 | 颜色 | 说明 |
|
||||
|------|------|------|------|
|
||||
| SUCCESS | ✅ | green | 操作成功 |
|
||||
| PENDING | ⏳ | yellow | 待处理 |
|
||||
| FAILED | ❌ | red | 操作失败 |
|
||||
| WARNING | ⚠️ | orange | 警告/异常已恢复 |
|
||||
| AI_SUGGESTION | 💡 | blue | AI建议 |
|
||||
| HUMAN_ACTION | 👤 | purple | 人工操作 |
|
||||
| SYSTEM_ACTION | 🔧 | gray | 系统自动 |
|
||||
|
||||
#### 与其他闭环的联动
|
||||
|
||||
| 闭环 | 日志记录节点 |
|
||||
|------|-------------|
|
||||
| 订单履约 (02_Order) | 订单获取、审核确认、分仓、发货、签收 |
|
||||
| 商品管理 (01_Product) | 商品上架、审核、下架、价格调整 |
|
||||
| AI自动化 (10_AI_Automation) | AI决策、人工确认、执行、日志记录 |
|
||||
| 财务结算 (04_Finance) | 对账、结算、退款、佣金 |
|
||||
| 售后逆向 (02_Order - Returns) | 退货受理、退货确认、退款 |
|
||||
|
||||
***
|
||||
|
||||
## 6️⃣8️⃣ 技术债务管理闭环（Technical Debt Management Loop）
|
||||
|
||||
Reference in New Issue
Block a user