# 1. 准备 .env
cp .env.example .env
# 按需修改 PG / Redis / JKY_* 配置

# 2. 启动依赖
docker compose up -d postgres redis   # 或复用 baojia_src 实例

# 3. 安装依赖
pnpm install

# 4. 数据库迁移（首次）
pnpm db:migrate

# 5. 启动 API + SSE MCP
pnpm start:dev

# 6. 单独启动 stdio MCP（Claude Desktop 等本地客户端用）
pnpm mcp:stdio

src/
├── main.ts                    # NestJS 启动入口（HTTP + Swagger + SSE）
├── app.module.ts              # 全局模块
├── config/                    # 配置加载与 joi 校验
├── database/
│   ├── database.module.ts     # PG Pool + Drizzle 实例
│   ├── migrate.ts             # SQL 迁移执行器
│   └── schema/                # Drizzle TS schema（inventory / audit / source 枚举）
├── redis/
│   ├── redis.module.ts        # ioredis 客户端
│   └── redis.service.ts       # 通用 getJson/setJson/限流/分布式锁
├── common/
│   ├── scheduler/              # 统一调度器（node-cron + BullMQ）
│   ├── filters/               # 全局异常过滤
│   └── interceptors/          # 统一响应包装
├── modules/
│   ├── health/                # /health/live, /health/ready
│   ├── jky/                   # 吉客云 MCP 适配（签名/限流/重试/mock）
│   ├── supor/                 # 苏泊尔工厂适配（mock/http/csv 三模式）
│   ├── wechat-xlsx/           # 微信群 Excel 监听 + 解析 + webhook
│   ├── inventory/             # 库存核心查询（多源聚合 + 缓存 + stale 判定）
│   └── mcp-tools/             # MCP 工具注册（inventory.query 等 4 个工具）
└── mcp/
    ├── bootstrap.ts           # MCP 上下文启动器
    ├── stdio.ts               # Claude Desktop 直连入口
    └── sse.controller.ts      # 远端 MCP SSE + POST message

pnpm test          # 单元测试
pnpm test:cov      # 覆盖率