wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d32770608700549820eba4e399bdb24519ad9be0
makemd/docs/LOOPS/13_Technical.md

324 lines
13 KiB
Markdown
Raw Normal View History

feat: 添加货币和汇率管理功能 refactor: 重构前端路由和登录逻辑 docs: 更新业务闭环、任务和架构文档 style: 调整代码格式和文件结构 chore: 更新依赖项和配置文件
2026-03-19 19:08:15 +08:00
# 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. **运维工具**：自动化部署、配置管理、灾备方案
- **决策点**：
- 监控阈值设置
- 告警策略配置
- **输入**：系统数据、日志数据、监控指标
- **输出**：监控报告、告警通知、运维操作记录
refactor: 重构项目结构并优化代码 - 删除无用的文件和错误日志 - 创建统一的 imports 模块集中管理依赖 - 重构组件使用新的 imports 方式 - 修复文档路径大小写问题 - 优化类型定义和接口导出 - 更新依赖版本 - 改进错误处理和API配置 - 统一组件导出方式
2026-03-27 16:56:06 +08:00
### 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) | 退货受理、退货确认、退款 |
feat: 添加货币和汇率管理功能 refactor: 重构前端路由和登录逻辑 docs: 更新业务闭环、任务和架构文档 style: 调整代码格式和文件结构 chore: 更新依赖项和配置文件
2026-03-19 19:08:15 +08:00
***
## 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
### 报表与分析闭环
| 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 |
Reference in New Issue Copy Permalink