forked from erp-dev/erp
94 lines
2.5 KiB
Markdown
94 lines
2.5 KiB
Markdown
# 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)
|
||
**状态**: ✅ 已测试并正常工作
|