Data Steward 架构

/data/memory/
├── context.md               # 业务上下文（公司、目标、已知模式）
├── rules.md                 # 用户定义的关注规则
├── understanding/           # 对每个数据源的理解
│   └── {conn_id}.md
├── discoveries/             # 发现的东西
│   └── {timestamp}_{slug}.md
├── requests/                # 交给 Analysis Agent 的请求
│   └── {id}.md
├── briefings/               # 给用户的摘要
│   └── latest.md
└── docs/
    └── guide.md             # Agent 指南

# Business Context

## Company
电商公司，主营服装和配饰，B2C 模式

## What Matters
- GMV 增长
- 用户留存
- 客单价提升

## Known Patterns
- Black Friday 销售额是平时 3x
- Q4 是最大季度
- 周末订单比工作日高 20%

## Notes
正在拓展 B2B 业务线

# Watch Rules

## Active Rules
- [ ] 日收入下降超过 15%
- [ ] 订单取消率超过 5%
- [ ] 出现异常大单（>$10,000）

## Recently Triggered
- [x] 收入下降 → discoveries/2024-01-15_revenue_drop.md

# orders_db

## Overview
电商订单数据，包含订单、用户、商品信息。

## Key Tables
- orders: 订单记录
- users: 用户信息
- products: 商品目录

## Key Fields
- orders.total_amount: 订单金额（含税）
- orders.status: PENDING → PAID → SHIPPED → COMPLETED

## Business Context (Confirmed)
- 大促后通常有 10-15% 自然回落
- 周末订单量比工作日高约 20%

## Data Quirks ⚠️
重要的数据陷阱，避免重复踩坑：
- customer_id 为 NULL 表示游客订单
- status='PENDING_V2' 是历史遗留，等同于 'PENDING'
- 2020年前的数据用 UTC+8 时区

## Useful Patterns
有用的查询模式：
- 日收入：SELECT date, SUM(amount) FROM orders GROUP BY date
- 活跃用户：SELECT COUNT(DISTINCT user_id) FROM events WHERE date = today

## Open Questions
- discount_type 字段的含义？
- 为什么有些商品库存是负数？

---
status: new
type: anomaly
connection_id: orders_db
---

# 11月收入下降 12%

## What I Found
11月收入 $125k，比10月 $142k 下降 12%。

## Evidence
- 订单量持平
- 客单价下降 10%
- 大单数量减少 42%

## Possible Explanations
1. 大促结束效应
2. B2B 订单减少
3. 季节性？

## Suggested Action
需要深入调查，已创建分析请求。

---
status: pending
discovery: 2024-01-15_revenue_drop
---

# 调查11月收入下降

## Question
11月收入下降 12%，为什么？是问题还是正常现象？

## Context
见 discoveries/2024-01-15_revenue_drop.md

## For Analysis Agent
1. 是否季节性模式？
2. 什么导致客单价下降？
3. 为什么大单减少？

## Result
（Analysis Agent 完成后填写）

读取 context.md（了解业务背景）
        ↓
读取 understanding/（已有知识）
        ↓
探索数据 (sample, query)
        ↓
检查 rules.md（用户规则）
        ↓
发现有趣的东西？
        ↓ Yes
写入 discoveries/
        ↓
需要深入调查？
        ↓ Yes
创建 requests/
        ↓
更新 briefings/latest.md
        ↓
继续探索...

Continuous Learning Agent          Analysis Agent
        │                               │
        │  发现异常                      │
        │      ↓                        │
        │  创建 requests/{id}.md        │
        │      ↓                        │
        │  (status: pending)            │
        │      ↓                        │
        └──────────────────────────────→│
                                        │
                                   读取请求
                                        │
                                   深入调查
                                        │
                                   填写 Result
                                        │
                                   更新 status