Files

wurenzhi 22308fe042 refactor: 重构项目结构并优化代码

- 删除无用的文件和错误日志
- 创建统一的 imports 模块集中管理依赖
- 重构组件使用新的 imports 方式
- 修复文档路径大小写问题
- 优化类型定义和接口导出
- 更新依赖版本
- 改进错误处理和API配置
- 统一组件导出方式

2026-03-27 16:56:06 +08:00

13 KiB

Raw Blame History

13 技术基础设施域业务闭环

本文档包含技术基础设施相关的业务闭环：技术基础设施、报表与分析、API文档、系统监控、技术债务、用户教育

4️⃣6️⃣ 技术基础设施闭环（Technical Infrastructure Loop）

目标：提供稳定、高效、可扩展的技术基础设施，支撑核心业务流程的运行。
流程：
1. 服务管理：
  - 服务注册与发现
  - 服务健康检查与监控
  - 服务版本管理与部署
2. 数据管理：
  - 缓存策略与优化
  - 数据库性能优化
  - 数据备份与恢复
3. 消息处理：
  - 消息队列管理
  - 异步操作处理
  - 事件总线管理
4. 安全与合规：
  - 数据传输加密
  - 访问控制与权限管理
  - 日志审计与追踪
决策点：
- 服务健康状态评估
- 性能瓶颈识别与优化
- 安全风险评估与应对
输入：系统配置、服务状态数据、性能指标
输出：技术基础设施状态报告、优化建议、安全审计报告

1️⃣4️⃣ 报表与分析闭环（Reporting & Analytics Loop）

目标：数据可视化 + KPI 支撑 TOC/TOB 决策
流程：
- 数据汇总 → 指标计算 → 报表生成 → 数据大屏 → 闭环反馈
输出：管理报表、异常预警、优化建议
状态机：RAW_DATA → PROCESSED → GENERATED → DISTRIBUTED → FEEDBACK_APPLIED

6️⃣4️⃣ API文档与开发者工具闭环（API Documentation & Developer Tools Loop）

目标：提供标准化的API接口和开发者工具，支持第三方集成。
流程：
1. API管理：RESTful API设计、API文档、版本控制
2. 开发者工具：SDK、开发者门户、Webhook
决策点：
- API版本管理
- 开发者权限控制
输入：API需求、开发者信息
输出：API文档、SDK、开发者工具

6️⃣5️⃣ 系统监控与运维闭环（System Monitoring & Operation Loop）

目标：监控系统健康状态，确保系统稳定运行。
流程：
1. 监控体系：系统健康、性能监控、异常监控
2. 日志管理：集中化日志、日志分析、告警机制
3. 运维工具：自动化部署、配置管理、灾备方案
决策点：
- 监控阈值设置
- 告警策略配置
输入：系统数据、日志数据、监控指标
输出：监控报告、告警通知、运维操作记录

6️⃣5️⃣.1 操作日志可视化

为业务闭环提供统一的操作日志记录和可视化追踪

日志数据模型

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
}

日志表设计

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）

目标：管理技术债务，确保代码质量和系统可维护性，支持系统长期演进。
流程：
1. 代码质量管理：
  - 代码规范制定和执行
  - 代码审查流程
  - 单元测试和集成测试
  - 代码覆盖率监控
2. 技术栈管理：
  - 依赖管理和版本控制
  - 技术选型评估
  - 技术栈更新规划
3. 架构演进：
  - 架构评估和优化
  - 技术债务识别与分类
  - 技术债务优先级排序
  - 技术债务偿还计划
决策点：
- 技术栈更新策略和时机
- 代码质量标准和指标
- 技术债务优先级排序
- 架构优化方向
输入：代码库、依赖信息、架构文档、代码质量报告、系统性能数据
输出：代码质量报告、技术债务评估、架构优化建议、技术栈更新计划
状态机：DEBT_IDENTIFIED → PRIORITY_ASSIGNED → PLAN_CREATED → DEBT_REPAID → VERIFICATION

6️⃣9️⃣ 用户教育与支持闭环（User Education & Support Loop）

目标：提供全面的用户教育和支持，提高用户体验和系统使用效率，促进用户成功。
流程：
1. 文档与培训：
  - 用户文档：系统操作指南、最佳实践
  - 培训课程：线上/线下培训、认证课程
  - 视频教程：操作演示、功能讲解
  - 知识库：常见问题、故障排除
2. 支持系统：
  - 客服工单：问题提交、跟踪和解决
  - 在线支持：实时聊天、邮件支持
  - 社区论坛：用户交流、经验分享
  - 自助服务：常见问题解答、自助工具
3. 反馈机制：
  - 用户反馈：问题报告、功能建议
  - 功能投票：用户需求优先级排序
  - 用户满意度调查：服务质量评估
  - 产品改进：基于反馈的功能迭代
决策点：
- 培训内容设计和优先级
- 支持请求优先级设置
- 反馈处理流程和响应时间
- 知识库内容更新策略
输入：用户需求、系统功能、反馈信息、支持请求
输出：用户文档、培训材料、支持记录、反馈处理结果
状态机：
- SUPPORT_REQUESTED → TRIAGED → IN_PROGRESS → RESOLVED → CLOSED
- FEEDBACK_SUBMITTED → REVIEWED → PRIORITIZED → IMPLEMENTED → VERIFIED

KPI 指标	描述	适用业务类型
报表生成及时率	按时生成报表的比例	TOC + TOB
数据准确率	报表数据的准确性	TOC + TOB
分析洞察价值	分析结果对业务决策的价值	TOC + TOB
异常预警准确率	异常预警的准确性	TOC + TOB
报表生成时效	从数据汇总到报表完成的时间	TOC + TOB
数据完整率	报表覆盖业务闭环输出数据的比例	TOC + TOB
KPI 准确率	计算指标与实际数据偏差率	TOC + TOB
异常响应率	异常报表触发优化措施的比例	TOC + TOB
大屏实时性	数据大屏数据更新延迟时间	TOC + TOB
决策支持率	报表建议被采纳并执行的比例	TOC + TOB

KPI 指标	描述	适用业务类型
代码质量评分	代码质量综合评分	TOC + TOB
测试覆盖率	代码测试覆盖比例	TOC + TOB
技术债务数量	待偿还技术债务数量	TOC + TOB
债务偿还率	按计划偿还债务的比例	TOC + TOB
架构健康度	架构评估健康评分	TOC + TOB

KPI 指标	描述	适用业务类型
文档完整度	功能文档覆盖比例	TOC + TOB
培训完成率	用户培训完成比例	TOC + TOB
工单响应时效	工单首次响应时间	TOC + TOB
工单解决率	工单成功解决比例	TOC + TOB
用户满意度	用户满意度评分	TOC + TOB
反馈处理率	用户反馈处理比例	TOC + TOB

13 KiB Raw Blame History Unescape Escape

13 技术基础设施域业务闭环

4️⃣6️⃣ 技术基础设施闭环（Technical Infrastructure Loop）

1️⃣4️⃣ 报表与分析闭环（Reporting & Analytics Loop）

6️⃣4️⃣ API文档与开发者工具闭环（API Documentation & Developer Tools Loop）

6️⃣5️⃣ 系统监控与运维闭环（System Monitoring & Operation Loop）

6️⃣5️⃣.1 操作日志可视化

日志数据模型

日志表设计

可视化界面设计

日志节点状态对应

与其他闭环的联动

6️⃣8️⃣ 技术债务管理闭环（Technical Debt Management Loop）

6️⃣9️⃣ 用户教育与支持闭环（User Education & Support Loop）

相关KPI

报表与分析闭环

技术债务管理闭环

用户教育与支持闭环

13 KiB

Raw Blame History