# Flower Database Access Skill - 使用总结

## 已创建的文件

```
.skills/
├── README.md                           # Skills目录说明
├── flower-db-access/
│   ├── SKILL.md                       # 主要skill文档（11KB）
│   ├── README.md                      # 使用说明
│   └── examples.sh                    # 可执行示例脚本
└── .gitkeep                           # Git占位文件
```

## Skill功能

### ✅ 允许的操作
- 读取所有业务表数据
- 执行SELECT查询
- 数据分析和统计
- 生成报告

### ❌ 禁止的操作
- 所有写操作（INSERT, UPDATE, DELETE等）
- 访问认证相关表（auth_user, auth_permission等）

## 快速测试

```bash
# 运行示例脚本
/home/f/coding/flower/.skills/flower-db-access/examples.sh

# 或手动测试连接
PGPASSWORD=postgres psql -h 127.0.0.1 -p 5432 -U postgres -d flower -c "\dt"
```

## 数据库架构概览

### 主要模块
1. **basic_info** - 基础信息（客户、供应商、产品、仓库）
2. **business** - 业务单据（采购、销售、退货、收付款）
3. **stock** - 库存管理（变动、冻结、汇总）
4. **printing** - 生产管理（开版、印染）
5. **stateflow** - 工作流引擎

### 多租户架构
⚠️ **重要**: 所有业务表都有 `merchant_id` 字段，查询时应该包含这个条件。

## 测试结果

✅ 数据库连接正常
✅ 所有示例查询成功执行
✅ 查询结果正确返回

### 查询示例输出
- ✅ 商户列表：4个商户
- ✅ 销售订单：最近4条订单
- ✅ 库存状态：4个库存记录
- ✅ 开版订单：最近10条记录
- ✅ 表大小统计：显示最大的表（basic_info_product: 674 MB）

## 下一步

### 对于开发者
1. 查看 `SKILL.md` 了解完整的查询示例
2. 运行 `examples.sh` 查看实际输出
3. 根据需要修改查询示例

### 对于AI Agent
1. 使用 `PGPASSWORD=postgres psql` 命令连接数据库
2. 只执行SELECT查询
3. 避免访问auth_*表
4. 查询时包含merchant_id条件

## 安全提示

1. **只读访问**: 此skill严格限制为只读
2. **认证保护**: auth_*表完全禁止访问
3. **多租户隔离**: 查询时考虑merchant_id
4. **性能优化**: 使用LIMIT和WHERE条件

## 故障排查

如遇问题，请检查：
1. PostgreSQL服务是否运行：`sudo systemctl status postgresql`
2. 数据库连接参数是否正确
3. 查询是否包含禁止的表或操作

---

**创建时间**: 2026-03-05
**数据库**: flower (PostgreSQL)
**状态**: ✅ 已测试并正常工作